Intégration du SDK OpenAI Agents
Scavio est livré comme un package d'outils pour le SDK OpenAI Agents, en Python comme en TypeScript. Installez openai-agents-scavio, confiez les outils à un Agent et il bénéficie d'une recherche en temps réel sur Google, YouTube, Amazon, Walmart, Reddit, TikTok et Instagram — un seul package, une seule clé API.
Prérequis
- Le SDK OpenAI Agents :
openai-agents(Python 3.10+) ou@openai/agents(Node 22+). - Une clé API Scavio depuis dashboard.scavio.dev (les nouveaux comptes reçoivent des crédits gratuits, sans carte bancaire).
Installation
# Python
pip install openai-agents-scavio
# TypeScript
npm install openai-agents-scavio @openai/agents zodDéfinir votre clé API
export SCAVIO_API_KEY=sk_live_your_keyLes outils lisent SCAVIO_API_KEY depuis l'environnement, ou vous pouvez passer api_key / { apiKey } à la factory.
Démarrage rapide (Python)
from agents import Agent, Runner
from openai_agents_scavio import get_scavio_tools
agent = Agent(
name="Search Assistant",
instructions="Search the web, shopping sites, and social platforms with Scavio.",
tools=get_scavio_tools(), # reads SCAVIO_API_KEY
)
result = Runner.run_sync(agent, "Find the top budget laptops on Amazon")
print(result.final_output)Démarrage rapide (TypeScript)
import { Agent, run } from "@openai/agents";
import { buildScavioTools } from "openai-agents-scavio";
const agent = new Agent({
name: "Search Assistant",
instructions: "Search the web, shopping sites, and social platforms with Scavio.",
tools: buildScavioTools(), // reads SCAVIO_API_KEY
});
const result = await run(agent, "Find the top budget laptops on Amazon");
console.log(result.finalOutput);Activer uniquement les fournisseurs dont vous avez besoin
# Python
tools = get_scavio_tools(
enable_google=True,
enable_reddit=True,
enable_amazon=False,
enable_walmart=False,
enable_youtube=False,
enable_tiktok=False,
enable_instagram=False,
)// TypeScript
const tools = buildScavioTools({
enableGoogle: true,
enableReddit: true,
enableAmazon: false,
enableWalmart: false,
enableYoutube: false,
enableTiktok: false,
enableInstagram: false,
});Passez all=True (Python) ou { all: true } (TypeScript) pour enregistrer tous les outils, indépendamment des indicateurs individuels.
Outils disponibles
Les deux packages exposent 32 outils, un par point de terminaison Scavio, nommés scavio_<provider>_<action> (par exemple scavio_google_search, scavio_amazon_product, scavio_reddit_post). Chacun renvoie la réponse JSON structurée de Scavio.
| Fournisseur | Outils |
|---|---|
scavio_google_search | |
| Amazon | scavio_amazon_search, scavio_amazon_product |
| Walmart | scavio_walmart_search, scavio_walmart_product |
| YouTube | scavio_youtube_search, scavio_youtube_metadata |
scavio_reddit_search, scavio_reddit_post | |
| TikTok | 11 outils (profil, posts, vidéo, commentaires, recherche, hashtag, abonnés, ...) |
| 12 outils (profil, posts, reels, stories, post, commentaires, recherche, abonnés, ...) |
Utiliser tous les points de terminaison via MCP
Pour disposer de l'API Scavio complète sans installation, pointez le SDK Agents vers le serveur MCP hébergé :
# Python
from agents import Agent
from agents.mcp.server import MCPServerStreamableHttp
server = MCPServerStreamableHttp(
name="scavio",
params={"url": "https://mcp.scavio.dev/mcp", "headers": {"x-api-key": "sk_live_..."}},
)
agent = Agent(name="Search Assistant", mcp_servers=[server])// TypeScript
import { Agent, MCPServerStreamableHttp } from "@openai/agents";
const server = new MCPServerStreamableHttp({
url: "https://mcp.scavio.dev/mcp",
name: "scavio",
requestInit: { headers: { "x-api-key": process.env.SCAVIO_API_KEY! } },
});
const agent = new Agent({ name: "Search Assistant", mcpServers: [server] });Coûts en crédits
La plupart des appels coûtent 1 crédit. Reddit et Instagram coûtent 2 crédits, et Google coûte 2 sauf si light_request est défini. Consultez la référence des limites de débit pour les limites de plan et la référence des erreurs pour les conseils de réessai.