OpenAI Agents SDK統合
Scavioは、 OpenAI Agents SDK向けのツールパッケージとして、PythonとTypeScriptの両方で提供されています。openai-agents-scavioをインストールし、ツールをAgentに渡すだけで、Google、YouTube、Amazon、Walmart、Reddit、TikTok、Instagramを横断したリアルタイム検索を利用できます。— 1つのパッケージ、1つのAPIキーで完結します。
前提条件
- OpenAI Agents SDK：
openai-agents（Python 3.10以降）または@openai/agents（Node 22以降）。 - dashboard.scavio.dev から取得したScavio APIキー（新規アカウントはクレジットカード不要で無料クレジットを取得できます）。
インストール
# Python
pip install openai-agents-scavio
# TypeScript
npm install openai-agents-scavio @openai/agents zodAPIキーの設定
export SCAVIO_API_KEY=sk_live_your_keyツールは環境変数からSCAVIO_API_KEYを読み取ります。あるいは、ファクトリ関数に api_key / { apiKey }を渡すこともできます。
クイックスタート（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)クイックスタート（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);必要なプロバイダーだけを有効にする
# 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,
});個々のフラグに関わらずすべてのツールを登録するには、all=True（Python）または{ all: true }（TypeScript）を渡します。
利用可能なツール
どちらのパッケージも、Scavioの各エンドポイントに対応する32個のツールを公開しており、 scavio_<provider>_<action>という名前が付けられています（例： scavio_google_search、scavio_amazon_product、 scavio_reddit_post）。各ツールは構造化されたScavioのJSONレスポンスを返します。
| プロバイダー | ツール |
|---|---|
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個のツール（profile、posts、video、comments、search、hashtag、followers、...） |
| 12個のツール（profile、posts、reels、stories、post、comments、search、followers、...） |
MCP経由ですべてのエンドポイントを利用する
インストール不要でScavio APIの全機能を利用するには、Agents SDKをホスト型のMCPサーバーに向けます：
# 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] });クレジットコスト
ほとんどの呼び出しは1クレジットです。RedditとInstagramは2クレジット、Googleはlight_requestが設定されていない場合に2クレジットかかります。プランごとの上限については レート制限のリファレンスを、リトライのガイダンスについては エラーのリファレンスを参照してください。