Mastra統合
Scavioは、TypeScript製のエージェントフレームワークである Mastraのツールパッケージとして提供されています。mastra-scavioをインストールし、任意のMastraのAgentにツールを渡すだけで、Google、YouTube、Amazon、Walmart、Reddit、TikTok、Instagramを横断したリアルタイム検索が手に入ります。— 1つのパッケージ、1つのAPIキーで完結します。
前提条件
- Node.js 20.9以降と、Mastraプロジェクト（
@mastra/core）。 - dashboard.scavio.devから取得したScavio APIキー（新規アカウントには無料クレジットが付与され、クレジットカードは不要です）。
インストール
Bash
npm install mastra-scavio @mastra/core zodAPIキーの設定
Bash
export SCAVIO_API_KEY=sk_live_your_keyツールは環境変数からSCAVIO_API_KEYを読み取ります。明示的に渡すこともできます：createScavioTools({ apiKey: "sk_live_..." })。
クイックスタート
createScavioTools()は、すべてのScavioツールをキー付きのオブジェクトとして返すため、そのままエージェントに渡せます：
import { Agent } from "@mastra/core/agent";
import { createScavioTools } from "mastra-scavio";
export const agent = new Agent({
id: "web-search-agent",
name: "Web Search Agent",
model: "openai/gpt-5.5",
instructions: "Search the web, shopping sites, and social platforms with Scavio.",
tools: createScavioTools(), // reads SCAVIO_API_KEY
});単一のツールを使う
すべてのツールではなく、必要なツールだけをインポートできます：
import { Agent } from "@mastra/core/agent";
import { createScavioGoogleSearchTool, createScavioRedditSearchTool } from "mastra-scavio";
export const agent = new Agent({
id: "research-agent",
model: "openai/gpt-5.5",
instructions: "Research with Google and Reddit before answering, and cite sources.",
tools: {
googleSearch: createScavioGoogleSearchTool(),
redditSearch: createScavioRedditSearchTool(),
},
});利用可能なツール
各ツールはMastraのcreateTool()で作成され、構造化されたScavioのJSONレスポンスを返します。
| プロバイダー | ツール |
|---|---|
scavioGoogleSearch | |
| Amazon | scavioAmazonSearch, scavioAmazonProduct |
| Walmart | scavioWalmartSearch, scavioWalmartProduct |
| YouTube | scavioYoutubeSearch, scavioYoutubeMetadata |
scavioRedditSearch, scavioRedditPost | |
| TikTok | scavioTiktokSearch, scavioTiktokProfile |
scavioInstagramSearch, scavioInstagramProfile |
MCP経由ですべてのエンドポイントを使う
Scavio API全体（33エンドポイント）をインストール不要で利用するには、MastraのMCPクライアントをホスト型のScavioサーバーに向けます：
import { MCPClient } from "@mastra/mcp";
const mcp = new MCPClient({
id: "scavio",
servers: {
scavio: {
url: new URL("https://mcp.scavio.dev/mcp"),
requestInit: { headers: { "x-api-key": process.env.SCAVIO_API_KEY! } },
},
},
});
const tools = await mcp.listTools();クレジットコスト
ほとんどの呼び出しは1クレジットです。RedditとInstagramは2クレジット、Googleはlight_requestが設定されていない場合に2クレジットかかります。プランごとの上限については レート制限のリファレンスを、リトライのガイダンスについては エラーのリファレンスを参照してください。