Scavio について
Scavioは、AIエージェント向けにウェブ検索、ページ抽出、構造化データを提供し、検索、EC、ソーシャル、旅行、求人などを扱います。MCPサーバーでは読み込むプラットフォームのツールを選べ、ホスト型またはローカルで利用できます。
主な機能
- 01複数プラットフォームのウェブ検索
- 02Markdown、テキスト、HTMLでページ抽出
- 03サイトのマップ、クロール、バッチ抽出
- 04EC・ソーシャルの構造化データ取得
- 05読み込むプラットフォームツールの選択
活用シーン
- 01ECサイトでの商品検索
- 02ソーシャルメディアデータの収集と分析
- 03ページやサイトのコンテンツ抽出
- 04求人、旅行、不動産情報の検索
MCP 対応
MCPクライアントに検索、抽出、プラットフォーム別データ取得ツールを提供します。ホスト型HTTPエンドポイントへの接続、またはstdioでのローカル実行に対応し、ホスト型ではOAuthまたはAPIキーを使えます。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://mcp.scavio.dev/mcpclaude mcp add --transport http scavio https://mcp.scavio.dev/mcp{"mcpServers":{"scavio":{"type":"http","url":"https://mcp.scavio.dev/mcp"}}}Cursor で開く{"servers":{"scavio":{"type":"http","url":"https://mcp.scavio.dev/mcp"}}}VS Code で開く{"mcpServers":{"scavio":{"type":"http","url":"https://mcp.scavio.dev/mcp"}}}{"mcpServers":{"scavio":{"serverUrl":"https://mcp.scavio.dev/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
106| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| url | string | はい | 読み取るページ。http(s) のみ対応します。'example.com' のようなホスト名のみの入力は https に切り替えられます。内部、ループバック、プライベートネットワークのホストは拒否され、400 が返されます。 |
| format | enum | いいえ | 出力形式。'markdown' = メインコンテンツを可読性重視で抽出(既定値。閲覧に最適)。'text' = Markdown を平文に変換。'html' = 未処理のページ。html | markdown | text |
| mode | enum | いいえ | 料金を左右するパラメーターです。'normal' = 通常の取得、1 credit(既定値)。'advanced' = レンダリングなしでは空になるページを JavaScript で完全にレンダリング、1 credit。'ultra' = 強固なボット遮断向けの住宅用プロキシ、2 credits。より安価なモードで空の内容またはブロックされた内容が返された場合にのみ切り替えてください。normal | advanced | ultra |
詳細
Scavio MCP サーバー
Scavio は、AI エージェントにウェブ検索、ページ抽出、eコマース、ソーシャル、旅行、求人、不動産、アプリストア、広告ライブラリ、企業提出書類のソースからの構造化データを提供する、統合型のウェブ検索 APIおよび MCP サーバーです。40 のプラットフォームにまたがる 272 個のツールに加え、Extract、map、crawl、batch を、1 つの API キーで利用できます。
0.13.0 で追加された 22 のプラットフォームは、オプトイン方式です。 272 個すべてのツールを登録すると、入力を始める前に、各セッションに約 260KB のツール定義(約 65k トークン)が含まれます。そのため、デフォルトでは 0.12.x で利用できたプラットフォームに Extract を加えた構成になり、142 個のツール、112KB となります。アップグレードによって、使用中のツールが削除されることはありません。それ以外のツールも環境変数 1 つで利用できます。読み込むツールの選択をご覧ください。
リモート MCP サーバー
ローカルにインストールせず、Scavio のリモート MCP サーバーに直接接続できます。
https://mcp.scavio.dev/mcp
認証方法は 2 つあります。
- キーをコピーせずに OAuth でサインイン。 Claude Desktop、claude.ai、Claude Code から、サーバー経由で Scavio アカウントにサインインします。Claude Desktop または claude.ai の場合:Settings > Connectors > Add custom connector を開き、Scavio と名前を付けて URL を貼り付け、Connect をクリックして Authorize します。Claude Code の場合:
claude mcp add --transport http scavio https://mcp.scavio.dev/mcpを実行し、続けて/mcpを実行して Authenticate を選択します。 - API キー。
x-api-keyヘッダーで渡します。scavio.devでキーを取得してください。
ローカルで実行する(npx)
サーバーを自分のマシンで実行したい場合は、クローンやビルドをせずに npx を使用できます。サーバーは stdio 経由で実行され、必要なのは SCAVIO_API_KEY のみです。
Claude Code
claude mcp add scavio -e SCAVIO_API_KEY=YOUR_SCAVIO_API_KEY -- npx -y @scavio/mcp-server
MCP 対応クライアント(Claude Desktop、Cursor、Windsurf、VS Code など)
{
"mcpServers": {
"scavio": {
"command": "npx",
"args": ["-y", "@scavio/mcp-server"],
"env": {
"SCAVIO_API_KEY": "YOUR_SCAVIO_API_KEY"
}
}
}
}
Node.js 20 以降が必要です。scavio.devで API キーを取得してください。
インストール
Claude Code
OAuth でサインインしてから、Claude Code 内で /mcp を実行し、Authenticate を選択します。
claude mcp add --transport http scavio https://mcp.scavio.dev/mcp
または、API キーを渡します。
claude mcp add --transport http scavio https://mcp.scavio.dev/mcp --header "x-api-key: YOUR_SCAVIO_API_KEY"
Claude Desktop
API キーは不要です。Settings > Connectors > Add custom connector を開き、Scavio と名前を付けて https://mcp.scavio.dev/mcp を貼り付け、Connect をクリックして Scavio アカウントにサインインします。claude.ai でも同じ手順で設定できます。
または、サーバーをローカルで実行します。claude_desktop_config.json に追加してください(macOS では ~/Library/Application Support/Claude/claude_desktop_config.json、Windows では %APPDATA%\Claude\claude_desktop_config.json)。
{
"mcpServers": {
"scavio": {
"command": "npx",
"args": ["-y", "@scavio/mcp-server"],
"env": {
"SCAVIO_API_KEY": "YOUR_SCAVIO_API_KEY"
}
}
}
}
Node.js 20 以降が必要です。保存後、Claude Desktop を再起動してください。
Cursor
プロジェクトのルートにある .cursor/mcp.json、またはグローバル設定用の ~/.cursor/mcp.json に追加します。
{
"mcpServers": {
"scavio": {
"type": "http",
"url": "https://mcp.scavio.dev/mcp",
"headers": {
"x-api-key": "YOUR_SCAVIO_API_KEY"
}
}
}
}
Windsurf
~/.codeium/windsurf/mcp_config.json に追加します。
{
"mcpServers": {
"scavio": {
"type": "http",
"url": "https://mcp.scavio.dev/mcp",
"headers": {
"x-api-key": "YOUR_SCAVIO_API_KEY"
}
}
}
}
VS Code
プロジェクトのルートに .vscode/mcp.json を作成します。
{
"servers": {
"scavio": {
"type": "http",
"url": "https://mcp.scavio.dev/mcp",
"headers": {
"x-api-key": "YOUR_SCAVIO_API_KEY"
}
}
}
}
ChatGPT
- ChatGPT > Settings > Apps & Connectors に移動します
- Add custom connector をクリックします
- MCP サーバーの URL を入力します:
https://mcp.scavio.dev/mcp - API キーを使用して認証を設定します
Cline
cline_mcp_settings.json に追加します(Cline サイドバー > MCP Servers > Configure から開きます)。
{
"mcpServers": {
"scavio": {
"type": "http",
"url": "https://mcp.scavio.dev/mcp",
"headers": {
"x-api-key": "YOUR_SCAVIO_API_KEY"
}
}
}
}
Zed
設定(Cmd+,)に追加します。
{
"assistant": {
"mcp_servers": {
"scavio": {
"type": "http",
"url": "https://mcp.scavio.dev/mcp",
"headers": {
"x-api-key": "YOUR_SCAVIO_API_KEY"
}
}
}
}
}
MCP 対応クライアント
{
"type": "http",
"url": "https://mcp.scavio.dev/mcp",
"headers": {
"x-api-key": "YOUR_SCAVIO_API_KEY"
}
}
読み込むツールの選択
Scavio は 272 個のツールを公開しています。すべてを読み込むと、tools/list に約 260KB を要します。ユーザーが何かを発言する前から、各セッションのコンテキストを約 64k トークン消費し、一部のクライアントでは受け付けられるツール数を超えてしまいます。そのため、サーバーはデフォルトで厳選したサブセットを登録し、残りは必要に応じて選択できるようにしています。以下のサイズは推定ではなく実測値です。npm run toolslist を実行すると、同じ値を確認できます。
SCAVIO_PLATFORMS は、プラットフォームキーをカンマ区切りで指定する許可リストです。
| 値 | 登録されるもの |
|---|---|
(未設定) または default | 0.12.x にあったすべてのプラットフォームに extract を追加 — 142 個のツール、112KB |
all | すべてのプラットフォーム — 272 個のツール、約 260KB |
extract,sec,g2 | 指定したプラットフォームのみ — 18 個のツール、21KB |
default,zillow,metaads | デフォルトのセットに 2 つを追加 — 148 個のツール、120KB |
default,chatgpt,gemini | デフォルトのセットに ChatGPT と Gemini を追加 — 144 個のツール、115KB |
none | プラットフォームのツールなし。get_usage のみ |
キーは大文字・小文字と句読点を区別せずに照合されるため、meta-ads、metaads、META_ADS はすべて同じものとして扱われ、twitter は x に解決されます。不明なキーはサーバーを停止させるのではなく、標準エラー出力に記録してスキップされます。
get_usage は常に登録されます。追加コストはかからず、すべてのインストールガイドでサーバーが動作することを確認するために呼び出すよう案内されています。
プラットフォームキー: extract、google、chatgpt、gemini、youtube、tiktok、instagram、
reddit、x、linkedin、threads、kuaishou、amazon、walmart、ebay、
target、homedepot、costco、heb、kroger、mercadolibre、tiktok-shop、booking、airbnb、
tripadvisor、yelp、zillow、redfin、realtor、rightmove、indeed、glassdoor、
appstore、googleplay、g2、capterra、trustpilot、googleads、metaads、sec、companieshouse
ローカル(stdio)
{
"mcpServers": {
"scavio": {
"command": "npx",
"args": ["-y", "@scavio/mcp-server"],
"env": {
"SCAVIO_API_KEY": "YOUR_SCAVIO_API_KEY",
"SCAVIO_PLATFORMS": "extract,google,zillow,redfin"
}
}
}
}
リモート(HTTP)
ホスト型サーバーは環境変数を読み取れないため、接続ごとに許可リストを渡します。ヘッダーまたはクエリパラメーターを使用できます。
{
"scavio": {
"type": "http",
"url": "https://mcp.scavio.dev/mcp",
"headers": {
"x-api-key": "YOUR_SCAVIO_API_KEY",
"x-scavio-platforms": "extract,google,sec,companieshouse"
}
}
}
https://mcp.scavio.dev/mcp?platforms=all
0.12.x からのアップグレード
対応は不要です。デフォルトのセットは、0.12.x で登録されていた 10 個のプラットフォームに Extract を追加したものとまったく同じなので、これまで使っていたツールはすべて引き続き読み込まれます。これらのプラットフォームではツールが増え続けています(Walmart は 2 個から 7 個に増加、TikTok、YouTube、Reddit、X は 0.20.0 で 19 個追加、Extract は 0.21.0 で map、crawl、batch を追加、Instagram は 0.22.0 で 8 個追加、Google は 0.23.0 で google_custom_search を追加)。そのため、デフォルトのツール数は現在 142 個です。
0.13.0 で追加された 22 個のプラットフォームは、オプトイン方式です。次のように追加できます。
SCAVIO_PLATFORMS=default,zillow,redfin,sec
知っておくべき互換性を破る修正が 1 つあります。以前の search_walmart は、すべての呼び出しで fulfillment_speed: "anytime" を送信していましたが、API に拒否されていました。このパラメーターは today または tomorrow になり、デフォルト値はなくなりました。
利用可能なツール
各ツールの呼び出しには 1 クレジットが必要です。ただし、各セクションに別途記載がある場合は除きます。複数のプラットフォームでは、エンドポイント単位(YouTube、Instagram、LinkedIn、Kuaishou)またはリクエスト本文単位(Extract、Threads、Walmart)で料金が設定されています。get_amazon_options と get_usage は無料です。
抽出
| ツール | 説明 |
|---|---|
extract_url | 任意のウェブページを読み取り、整形済みの Markdown、プレーンテキスト、または生の HTML として返します |
map_website | サイトマップとスタートページからサイトのページ URL を一覧表示します。パスで絞り込みでき、判明している場合は lastmod も含まれます |
crawl_website | 1 つの URL からサイトをクロールし、同じサイト内のすべてのページを抽出します。最大 wait_seconds まで待機して結果を返すか、ジョブ ID を返します |
get_crawl_status | クロールのステータス、ページ数、使用クレジット、ページの結果をカーソルでページ分割して返します。完了まで待機することもできます |
cancel_crawl | 実行中のクロールを停止します。それ以降の料金は発生せず、それまでの結果は引き続き閲覧できます |
batch_extract | URL のリストを 1 つのジョブで抽出し、入力順に結果を返します。最大 wait_seconds まで待機します |
get_batch_status | バッチのステータスと結果をカーソルでページ分割して返します。完了まで待機することもできます |
cancel_batch | 実行中のバッチを停止します |
Extract の料金は一律ではなく、mode パラメーターに応じて決まります。normal(デフォルト)と advanced(JavaScript をレンダリング)は 1 クレジット、ultra(特に難しいページ向け)は 2 クレジットです。まずは normal を使い、コンテンツが空、またはブロックされた場合にのみ上位モードに切り替えてください。料金が発生するのは抽出に成功した場合のみです。リンク切れ、ボット対策のページ、タイムアウトでは料金はかかりません。ページネーションはなく、ページ全体が 1 回の呼び出しで返されます。
マップ、クロール、バッチ(0.21.0 で追加)は複数ページを対象とする操作です。
- 料金。
map_websiteは 1 クレジットです。クロールとバッチは、Extract の各ティアの料金(normal は 1、advanced は 1、ultra は 2)に基づき、成功したページごとに課金されます。失敗したページとスキップされたページは無料で、ステータス確認とキャンセルの呼び出しも無料です。クレジットはページごとに消費され、残高がなくなるとジョブはstopped_reason: "insufficient_credits"で正常に停止します。 - プランの上限(クロールあたりの最大ページ数/アクティブなジョブ数/バッチあたりの URL 数):Free は 10 / 1 / 10、PAYG は 100 / 1 / 50、Project は 500 / 2 / 100、Bootstrap は 2,000 / 3 / 500、Startup は 5,000 / 5 / 1,000、Growth は 10,000 / 10 / 1,000 です。アクティブなジョブの上限を超えてジョブを開始すると、実行中のジョブ名を示す 429 が返されます。
- 動作。
map_websiteとクロールでは、常に Robots.txt の指示に従います。クロールはスタート URL と同じサイト内にとどまり(サブドメインは任意)、スタートパス以下のページを優先して訪問します。結果は 3 日間保持され、ジョブは最長 6 時間実行されます。 - ツール呼び出しの時間制限に対応。 MCP クライアントは通常、約 60 秒後にツール呼び出しをキャンセルするため、クロールは 1 回の長時間呼び出しではなくジョブとして実行されます。
crawl_website/batch_extractはジョブを開始し、最大wait_seconds(デフォルトは 30、上限は 50)まで待機します。小規模なジョブは最初のページの結果とともに完了状態で返され、大規模なジョブはジョブ ID を返します(webhook_urlを設定した場合は、1 回限り表示されるwebhook_secretも返します)。get_crawl_status/get_batch_statusでは、同じwait_secondsを指定してロングポーリングし、cursorでページを指定します。 - 出力をコンパクトに維持。 ステータス確認の呼び出しでは、デフォルトで 1 回あたり 10 件の結果が返され(
limitは最大 100)、各ページのコンテンツはmax_content_chars(デフォルトは 4,000)で切り詰められます。切り詰められたページには、元のcontent_lengthとともにcontent_clipped: trueが含まれます。map_websiteでは、limitを指定しない場合は 200 件のリンクが要求されます(API のデフォルトは 1,000 です)。続きがあるレスポンスにはすべて、次に呼び出す正確な内容を示す_hintが含まれます。開始時と同じidempotency_keyを指定して再度呼び出すと、2 つ目のジョブが作成されず、元のジョブが返されます。
Google Search API
| ツール | 説明 |
|---|---|
search_google | オーガニック検索結果、広告、AI Overview を含むウェブ検索(v2) |
google_custom_search | CSE から移植したコード向けの、Custom Search JSON API 形式(items[]、searchInformation、queries.nextPage)の Google 検索結果 |
google_ai_mode | 出典を引用した AI Mode の対話型回答 |
google_maps_search | Google Maps で地域のビジネスを検索 |
google_maps_place | 場所の詳細:住所、電話番号、営業時間、評価 |
google_maps_reviews | ページネーション対応の場所のレビュー |
google_shopping | 価格、販売店、評価を含む商品一覧 |
google_shopping_product | 商品の詳細と販売者 |
google_shopping_stores | 商品の追加販売者(ページネーション) |
google_flights | 価格と乗り継ぎを含む航空券の旅程 |
google_hotels | 価格と評価を含むホテル検索 |
google_hotels_detail | ホテル施設の詳細 |
google_news | クエリ、トピック、ニュース記事、または発行元別のニュース検索結果 |
google_trends | 期間ごとの関心度と関連クエリ |
google_trending | 急上昇中の検索 |
ChatGPT and Gemini
| ツール | 説明 |
|---|---|
chatgpt_prompt | ChatGPT にプロンプトを送信:Markdown 形式の回答全文、引用された各ページ(タイトル、発行元、日付)、実行したウェブ検索、おすすめした商品 |
gemini_prompt | Google Gemini にプロンプトを送信:Markdown 形式の回答全文、引用された URL、おすすめした商品 |
AI におけるブランドの露出度やブランドモニタリングには、購入者が尋ねそうな質問(「小規模な代理店に最適な CRM」など)をして、ブランドがおすすめされるか、競合他社はどこか、回答でどのページが引用されるかを確認します。両方のツールは同じ形式(answer.markdown、sources[]、search_queries[]、shopping[])で結果を返すため、アシスタントを比較する際に必要なパーサーは1つだけです。呼び出すたびに新しい回答が生成され、所要時間は10~40秒です。回答が得られたプロンプトは ChatGPT が2クレジット、Gemini が5クレジットかかります。失敗したプロンプトは無料です。
オプトインするには、SCAVIO_PLATFORMS に chatgpt と gemini を追加します(例:default,chatgpt,gemini)。
ドキュメント:ChatGPT、
Gemini。
YouTube Data API
| ツール | 説明 |
|---|---|
search_youtube | 動画、チャンネル、再生リストを検索します |
search_youtube_shorts | ショート動画を検索します |
youtube_search_suggestions | 検索のオートコンプリート候補を取得します |
get_youtube_video | 動画の詳細、チャプター、字幕を取得します |
get_youtube_metadata | get_youtube_video の非推奨の別名です |
get_youtube_comments | ページネーション付きで動画のコメントを取得します |
get_youtube_comment_replies | 特定のコメントへの返信を取得します |
get_youtube_transcript | 動画の文字起こしをプレーンテキストまたはSRT形式で取得します |
get_youtube_related | 関連動画を取得します |
search_youtube_channels | キーワードでチャンネルを検索します |
get_youtube_channel | ID、ハンドル、またはURLでチャンネルのプロフィールを取得します |
get_youtube_channel_videos | チャンネルの動画一覧を取得します |
get_youtube_channel_shorts | チャンネルのShorts一覧を取得します |
get_youtube_channel_community | チャンネルのコミュニティ投稿一覧を取得します |
resolve_youtube_channel | ハンドルまたはURLからチャンネルIDを特定します |
get_youtube_streams | 動画の直接メディアストリームURLを取得します |
get_youtube_community_post | コミュニティ投稿1件のテキスト、投稿者、いいね数、画像、コメントカーソルを取得します |
get_youtube_community_post_comments | ページネーション付きでコミュニティ投稿のコメントを取得します |
クレジットの消費量はツールによって異なります。get_youtube_transcript は5、get_youtube_streams は3、
search_youtube と search_youtube_shorts は2、その他のYouTubeツールはすべて1です。
get_youtube_related はカーソルを受け付けますが、カーソルを返さないため、
1ページのみの取得として扱ってください。
Amazon Product API
| ツール | 説明 |
|---|---|
search_amazon | 22のマーケットプレイスで商品リストを検索します(並べ替えオプションなし) |
get_amazon_product | ASINで商品の詳細を取得します |
get_amazon_offers | ASINを出品しているすべての販売者を、カートボックスの獲得者とともに一覧表示します |
get_amazon_options | 対応しているマーケットプレイスと国コードを一覧表示します(無料) |
Walmart API
| ツール | 説明 |
|---|---|
search_walmart | 価格や配送条件で絞り込んで商品を検索します |
get_walmart_product | 商品 ID で商品の詳細情報を取得します |
get_walmart_reviews | 評価、本文、投稿者、日付、評価の内訳を含む顧客レビューを取得します |
get_walmart_category | カテゴリー内の商品を取得します。商品データの形式は検索結果と同じです |
get_walmart_offers | 商品の購入ボックスのオファーを取得します。価格、販売者、状態、購入ボックスのフラグが含まれます |
get_walmart_seller | マーケットプレイスの販売者のストアフロントを取得します。名前、評価、Pro Seller バッジ、事業者情報が含まれます |
get_walmart_seller_products | 販売者の商品カタログを取得します。実際の商品数は total_count で確認できます |
get_walmart_stores | 米国の ZIP コードまたはカナダの郵便番号の近くにある店舗を、最寄りの順に取得します。store_id、住所、距離、営業時間が含まれます |
Walmart の料金は定額ではなく、リクエスト本文によって決まります。com(米国、デフォルト)と
ca は 1 クレジット、com.mx は 2 クレジットです。すべての domain に対応するのは
search_walmart と get_walmart_category のみです。
店舗の指定:search_walmart または get_walmart_product に delivery_zip と
store_id を一緒に渡すと、指定した店舗の品揃えと在庫状況を取得できます。同じドメイン
(walmart.com または walmart.ca)の get_walmart_stores から store_id を取得してください。
店舗を指定した呼び出しは 2 クレジットで、完了まで 10~60 秒かかります。また、使用した店舗が
data.location に返されます。get_walmart_product で domain: "ca" を指定できるのは、
店舗の組み合わせを指定した場合のみです。
2 つのデータ形式に注意してください。get_walmart_offers が返すのは購入ボックスの勝者のみです。
Walmart はサーバー側でそのオファーのみをレンダリングするため、total_offer_count がそれより多くても
1 行だけが返されます。また、get_walmart_seller_products が返すのはおよそ先頭 40 件までで、
ページやカーソルのパラメーターはありません。total_count を確認して、結果が一部のみであることを
把握してください。どちらの販売者ツールでも、商品、検索、またはオファーのレスポンスに含まれる
数値形式の seller_catalog_id が必要です。同じレスポンスに含まれる GUID 形式の seller_id を使うと
404 エラーになります。
TikTok API
| ツール | 説明 |
|---|---|
get_tiktok_profile | ユーザープロフィールを取得します(自己紹介、フォロワー数・フォロー数、いいね数) |
get_tiktok_user_posts | ユーザーの動画を統計情報付きで一覧表示します |
get_tiktok_video | 1 本の動画の詳細情報を取得します |
get_tiktok_video_comments | 動画へのコメントを取得します |
get_tiktok_comment_replies | 特定のコメントへの返信を取得します |
search_tiktok_videos | キーワードで動画を検索します |
search_tiktok_users | キーワードでユーザーを検索します |
get_tiktok_hashtag | ハッシュタグの詳細と統計情報を取得します |
get_tiktok_hashtag_videos | ハッシュタグに関連する動画を一覧表示します |
get_tiktok_user_followers | ユーザーのフォロワー一覧を取得します |
get_tiktok_user_followings | ユーザーがフォローしているアカウント一覧を取得します |
get_tiktok_trending_searches | 現在トレンドの検索語を取得します(約 90 件、地域フィルターなし) |
get_tiktok_trending_videos | トレンド動画のサンプルを取得します(1 回の呼び出しにつき約 6 件) |
get_tiktok_search_suggestions | キーワードの検索オートコンプリート候補を取得します |
get_tiktok_music | 楽曲の情報を取得します:アーティスト、アルバム、再生時間、使用動画、チャート順位 |
get_tiktok_music_videos | 楽曲を使用している動画を一覧表示します(1 ページあたり約 14 件) |
search_tiktok_music | キーワードで楽曲を検索します |
get_tiktok_music_chart | トップ 50 またはバイラル 50 の楽曲チャートを取得します(グローバル) |
get_tiktok_user_similar | あるユーザーに似たクリエイターを取得します(1 ページあたり約 30 件) |
get_tiktok_user_playlists | ユーザーのプレイリスト(シリーズ)を一覧表示します |
get_tiktok_playlist_videos | プレイリスト内の動画を一覧表示します |
get_tiktok_user_live | ユーザーが現在ライブ配信中かどうかを確認します:ルームの状態、タイトル、視聴者数 |
get_tiktok_user_region | アカウントが登録されている地域と sec_user_id を取得します |
TikTok の各ツールは 1 クレジットを消費します。トレンド、楽曲、プレイリスト、類似クリエイター、ライブ、地域に関するツールは、コンテキストに合わせてトリミングされた TikTok 独自のペイロード形式を返します。大きな数値 ID は JSON の数値として精度が失われる場合があるため、文字列形式(id_str、sec_uid、sec_user_id)を使用してください。get_tiktok_trending_videos は count の値にかかわらず、1 回の呼び出しにつき約 6 件の動画を返します。また、get_tiktok_music_videos は count を無視し、1 ページあたり約 14 件を返します。検索候補は、ニッチなキーワードでは空になる場合がありますが、その場合も課金されます。存在しないユーザー名を指定すると、get_tiktok_user_live では課金対象の 404 が、get_tiktok_user_region では課金対象外の 404 が返されます。
Instagram API
| ツール | 説明 |
|---|---|
get_instagram_profile | ユーザープロフィールを取得します(自己紹介、フォロワー数、フォロー中の人数、投稿数) |
get_instagram_user_posts | ページネーションを使用してユーザーの投稿を一覧表示します |
get_instagram_user_reels | ページネーションを使用してユーザーのリールを一覧表示します |
get_instagram_user_tagged | ユーザーがタグ付けされた投稿を一覧表示します |
get_instagram_user_stories | ユーザーの公開中のストーリーズを取得します |
get_instagram_post | URL、media_id、または shortcode を指定して投稿を1件取得します |
get_instagram_post_comments | 投稿へのコメントを取得します |
get_instagram_comment_replies | 特定のコメントへの返信を取得します |
search_instagram_users | キーワードでユーザーを検索します |
search_instagram_hashtags | キーワードでハッシュタグを検索します |
get_instagram_user_followers | ユーザーのフォロワー一覧を取得します |
get_instagram_user_followings | ユーザーがフォローしているアカウントの一覧を取得します |
get_instagram_user_highlights | ユーザーのストーリーハイライトを一覧表示します(id、タイトル、カバー、アイテム数) |
get_instagram_highlight_stories | 1つのハイライトに含まれるすべてのストーリーをメディア URL 付きで取得します |
search_instagram_reels | ページネーションを使用してキーワードでリールを検索します |
search_instagram_music | 曲名またはアーティスト名で音声トラックを検索します |
get_instagram_music_posts | 音声トラックを使用しているリールを一覧表示し、リールの合計数も取得します |
search_instagram_locations | 場所を名前で検索します(id、住所、座標) |
get_instagram_user_similar | クリエイターに類似したアカウントを取得します |
get_instagram_post_likers | 投稿に「いいね!」したアカウントと「いいね!」の合計数を取得します |
Instagram の料金はエンドポイントごとに設定されています。get_instagram_profile、get_instagram_user_reels、
get_instagram_user_tagged、get_instagram_music_posts は1クレジットです(リールと
タグ付き投稿は、ユーザー名を初めて検索するときに2クレジットかかります)。その他のツールは2クレジットです。
search_instagram_users と search_instagram_hashtags は、次のページの cursor を渡すと8クレジットかかります。
追加処理が必要な場合、いずれのリクエストも最大10クレジットかかることがあります。
レスポンスの credits_used には、実際に請求されたクレジット数が常に示されます。
Reddit API
| ツール | 説明 |
|---|---|
search_reddit | クエリで Reddit の投稿を検索します。関連度順で、カーソルによるページネーションに対応します |
get_reddit_post | URL または id で投稿を1件取得します(コメントは含まれません。詳細は下記を参照) |
get_reddit_search_suggestions | 検索のオートコンプリート候補を取得します |
get_reddit_post_comments | 投稿のトップレベルコメントをページネーション付きで取得します |
get_reddit_comment_replies | 特定のコメントへの返信を取得します |
get_reddit_subreddit | サブレディットのメタデータと登録者数を取得します |
get_reddit_subreddit_posts | サブレディットの投稿フィードを一覧表示します |
get_reddit_user | Reddit ユーザーのプロフィールを取得します |
get_reddit_user_posts | Reddit ユーザーが投稿した投稿を一覧表示します |
get_reddit_user_comments | Reddit ユーザーのコメントを一覧表示します |
get_reddit_popular | サイト全体の人気フィードを取得します |
get_reddit_trending | 現在トレンドの検索クエリを取得します |
search_reddit_comments | キーワードでコメントを検索し、コメントが投稿された投稿とサブレディットも表示します |
search_reddit_subreddits | キーワードでサブレディットを検索し、登録者数も表示します |
Reddit の各ツールは1クレジットです。知っておくべき点が2つあります。search_reddit ではクエリとカーソルのみを指定できます。並べ替えや投稿タイプのフィルターはなく、結果は関連度順で返されます(search_reddit_comments では、関連度順、人気順、上位順、新着順で並べ替えできます)。また、get_reddit_post が返すのはコメントを含まないフラットな投稿オブジェクトです。コメントを取得するには、投稿 id を指定して get_reddit_post_comments を呼び出してください。Reddit はここで扱うプラットフォームの中で最も遅く、通常、1回の呼び出しに5~15秒かかります。
X API
| ツール | 説明 |
|---|---|
search_x | キーワードでツイートやユーザーを検索します |
get_tweet | 1件のツイートの詳細を取得します |
get_tweet_comments | ツイートへの返信を取得します(ランキング順または時系列順) |
get_tweet_retweeters | ツイートをリツイートしたユーザーの一覧を取得します |
get_x_user | ハンドル名でユーザーのプロフィールを取得します |
get_x_user_tweets | ユーザーのツイート一覧を取得します |
get_x_user_replies | ユーザーのツイートと返信の一覧を取得します |
get_x_user_media | ユーザーのメディア付きツイートの一覧を取得します |
get_x_user_followers | ユーザーのフォロワー一覧を取得します |
get_x_user_followings | ユーザーがフォローしているアカウントの一覧を取得します |
get_x_trending | 国別のトレンドトピックを取得します |
search_x_communities | X コミュニティをキーワードで検索し、メンバー数を取得します |
get_x_community | コミュニティの説明、メンバー数、トピック、ルールを取得します |
get_x_community_tweets | 関連度順または新しい順でコミュニティの投稿一覧を取得します |
get_x_user_tweets、get_x_user_replies、get_x_user_media は
next_cursor を返しますが、has_more は返しません。そのため、カーソルが
なくなるか、タイムラインが空になるまでページを取得してください。
LinkedIn API
| ツール | 説明 |
|---|---|
get_linkedin_person | メンバーのプロフィール、職歴、学歴の詳細を取得します |
get_linkedin_person_about | メンバーの自己紹介/概要セクションを取得します |
get_linkedin_person_posts | メンバーの最近の投稿一覧を取得します(最大50件) |
get_linkedin_company | 企業のプロフィール、所在地、関連企業を取得します |
get_linkedin_company_posts | 企業の最近の投稿一覧を取得します(最大50件) |
search_linkedin_jobs | キーワードと勤務地で求人を検索します |
get_linkedin_job | 求人情報の詳細を取得します |
get_linkedin_post | 1件の投稿の詳細を取得します |
get_linkedin_post_comments | 投稿へのコメントを取得します(1ページあたり10件) |
すべて、バニティハンドル、スラッグ、ID、またはLinkedInの完全なURLを指定して
利用できます。クレジットの消費量は次のとおりです。
get_linkedin_person、get_linkedin_person_about、get_linkedin_company、
get_linkedin_post は1クレジット、get_linkedin_person_posts、
get_linkedin_company_posts、search_linkedin_jobs、
get_linkedin_post_comments は1ページあたり10クレジット、
get_linkedin_job は30クレジットです。
メンバーの連絡先情報、企業の従業員ディレクトリ、企業別の求人情報、
人物検索、投稿検索は利用できなくなったため、これら5つのツールは
削除されました。get_linkedin_company は引き続き注目の従業員の
サンプルを少数返し、企業名を指定した search_linkedin_jobs は
企業別の求人情報の代替となります。
TikTok Shop API
| ツール | 説明 |
|---|---|
search_tiktok_shop | キーワードでTikTok Shopの商品を検索します(米国のカタログ、正確な価格) |
get_tiktok_shop_search_suggestions | 部分的なクエリに対するキーワードのオートコンプリート(8地域) |
get_tiktok_shop_product | 商品の詳細情報(価格なし。検索IDの約44%を解決できます) |
get_tiktok_shop_product_reviews | ページ分割された商品レビュー。1回あたり最大200件 |
get_tiktok_shop_categories | グローバルなカテゴリー階層(最上位28件、ノード240件) |
get_tiktok_shop_category_products | カテゴリーID配下の商品一覧(正確な価格付き) |
get_tiktok_shop_shop_products | 販売者のカタログ一覧。1ページあたり30件(正確な価格付き) |
resolve_tiktok_shop_url | TikTok ShopのURLまたは共有リンクを商品/ショップIDに解決します |
知っておくべき点が2つあります。get_tiktok_shop_product は価格を返しません(TikTokが商品ページ上で価格を非表示にしているため)。正確な価格は search_tiktok_shop、get_tiktok_shop_shop_products、get_tiktok_shop_category_products から取得できます。また、検索で返される商品IDのうち、get_tiktok_shop_product で解決できるのは約44%(測定した25件中11件)にすぎません。残りの商品にはTikTok Shop上に詳細データがないためです。この未解決はレスポンス本文内のフィールドではなく、HTTP 404ステータスで示されます。再試行すべきエラーではなく、通常の結果です。このツールは status: "no_detail_data" を含む通常の結果として返すため、エージェントはループせずにその商品をスキップできます。解決できないIDでも、get_tiktok_shop_product_reviews は引き続き利用できることがよくあります。詳細情報の取得に失敗した測定済みID 8件のうち、8件すべてでレビュー取得時にHTTP 200が返り、7件では少なくとも1件のレビューが返されました。
Threads
| ツール | 説明 |
|---|---|
get_threads_profile | user_id または username で指定したThreadsユーザーのプロフィール詳細 |
get_threads_user_posts | ユーザーのThreads投稿(カーソルによるページネーション) |
get_threads_user_replies | ユーザーの返信(カーソルによるページネーション) |
get_threads_post | IDまたはthreads.netのURLで指定した単一の投稿 |
get_threads_post_comments | 投稿への返信(カーソルによるページネーション) |
search_threads_users | 名前またはハンドルに一致するプロフィール(Threadsが提供する唯一の検索機能) |
Threadsの料金はエンドポイントごとではなく、ユーザーの指定方法によって決まります。user_id を渡すと2クレジット、username を渡すと4クレジットです。get_threads_profile、get_threads_user_posts、get_threads_user_replies のみ username を受け付けます。他の3つは常に2クレジットです。user_id を優先してください。ハンドルを使うと、追加の検索が1回必要になります。
Kuaishou(China)
| ツール | 説明 |
|---|---|
get_kuaishou_profile | Kuaishou ユーザーのプロフィール詳細(10 クレジット) |
get_kuaishou_user_posts | ユーザーの人気投稿。カーソルによるページネーションに対応 |
get_kuaishou_user_live | ユーザーの現在のライブ配信状況 |
resolve_kuaishou_user | Kuaishou の共有リンクをユーザー ID に変換 |
get_kuaishou_video | 写真 ID または URL で指定した単一の動画(2 クレジット) |
get_kuaishou_video_comments | 動画へのコメント。カーソルによるページネーションに対応 |
get_kuaishou_comment_replies | ルートコメントへの返信 |
get_kuaishou_videos_batch | 1 回の呼び出しで最大 20 件の動画を取得(40 クレジット) |
search_kuaishou | Kuaishou 全体を対象とした複合検索(10 クレジット) |
search_kuaishou_videos | 動画の検索結果(10 クレジット) |
search_kuaishou_users | ユーザーの検索結果(10 クレジット) |
search_kuaishou_live | ライブ配信の検索結果(10 クレジット) |
get_kuaishou_tag_feed | ハッシュタグ付き投稿。カーソルによるページネーションに対応 |
get_kuaishou_trending | 人気、ライブ配信、ショッピング、ブランド、音楽のランキング |
Kuaishou は定額ではなく、エンドポイントごとに料金が設定されています。get_kuaishou_profile と 4 つの検索ツールは 10 クレジット、get_kuaishou_video は 2 クレジット、get_kuaishou_videos_batch は 40 クレジットで、その他のツールはすべて 1 クレジットです。
eBay
| ツール | 説明 |
|---|---|
search_ebay | 出品中または売却済みの出品を検索:価格、状態、入札、送料、出品者の評価 |
get_ebay_product | 1 件の出品の詳細:価格、状態、画像、商品固有情報、送料、返品、オークションの状態 |
get_ebay_seller | 出品者のプロフィールカード:ストア名、評価スコア、販売済み商品数、フォロワー数、所在地 |
1 回の呼び出しにつき 1 クレジットです。get_ebay_seller はプロフィールカードを取得するもので、カタログ全体を列挙することはできません。出品者の在庫一覧を取得するには、seller を指定し、キーワードを指定せずに search_ebay を使用してください。sold: true を指定すると、実際に売れた終了済み出品を検索します。この表示では eBay が全件数を公開しないため、total_results は null です。per_page には 60、120、240 のみ指定できます。
Target
| ツール | 説明 |
|---|---|
search_target_products | Target.com を検索:価格、評価、バッジ、プロモーション |
get_target_category | カテゴリー内の商品。検索と同じ形式で、パンくずリストも含みます |
get_target_product | TCIN で商品詳細を取得:価格、画像、仕様、バリエーション、受け取り方法 |
get_target_reviews | 評価の内訳、属性ごとの平均、ゲストの写真を含むレビュー |
get_target_availability | ZIP コード周辺のすべての Target 店舗の在庫:数量、店頭在庫、店舗受け取り、カーブサイド受け取り、店舗配送の状況、距離、住所、営業時間 |
1 回の呼び出しにつき 1 クレジットです。get_target_product、get_target_reviews、get_target_availability は単一リクエストで完了します。検索とカテゴリーは page と count を指定してページ分けできます。検索、カテゴリー、商品、レビューで store_id を指定すると、価格に適用する店舗を設定できます。店舗在庫を取得するツールは get_target_availability です。
Home Depot
| ツール | 説明 |
|---|---|
search_home_depot | Home Depot を検索:価格、ブランドとモデル、評価、店舗ごとの受け取り・配送 |
get_home_depot_product | 商品の詳細情報:価格、メディア、仕様表、寸法、書類、返品ポリシー |
get_home_depot_reviews | レビュー本文、評価の分布、属性ごとの評価、出品者の返信 |
1 回の呼び出しにつき 2 クレジットです。検索のページサイズは 12 に固定されており、変更できません。レビューは 1 ページあたり 30 件を返します。total_pages は実在する最終ページを示し、そのページを超えてリクエストすると 404 になります。
Costco
| ツール | 説明 |
|---|---|
search_costco | キーワードまたは商品番号で検索します。オンライン価格と通常価格、評価、会員限定・在庫フラグ、プロモーション、絞り込み項目を取得します |
get_costco_category | カテゴリー内の商品を取得します。検索と同じフィルターおよび形式です |
get_costco_categories | 部門一覧、または指定した部門のサブカテゴリーのツリー全体を取得します |
get_costco_product | 最大20商品の詳細を取得します。説明、特徴、仕様、バリエーション、購入制限、配送料、プロモーション期間を含みます |
get_costco_prices | 最大10倉庫のオンライン価格と倉庫価格を取得します。割引、最終価格、プロモーション期間、会員ごとの購入制限、価格コードを含みます |
get_costco_availability | 最大10倉庫における1商品の倉庫在庫状況を取得します。店舗受け取りと当日配送も含みます |
get_costco_reviews | 評価の分布とおすすめ件数を含むレビューを取得します。並べ替え、星による絞り込み、1ページ最大100件に対応します |
get_costco_warehouses | 米国の郵便番号または座標の近くにある倉庫を取得します。warehouse_id、住所、営業時間、部門、サービス、ガソリン価格を含みます |
get_costco_gas_prices | 場所の近く、または指定した倉庫にあるCostcoのガソリンスタンドのレギュラー、プレミアム、ディーゼル価格を取得します |
get_costco_coupons | 現在の会員向けクーポンブックを取得します。商品番号、割引額、最終価格、対象範囲、制限、有効期間を含みます |
get_costco_deals | 新商品、在庫限り、トレジャーハント、会員のお気に入り、オンライン限定、セール中の商品などの特価情報を取得します |
get_costco_clearance | 1倉庫のクリアランス商品とマネージャー値下げ商品を取得します。棚札の価格末尾から価格コードを判別します |
get_costco_search_suggestions | 入力途中のクエリに対する検索候補と、一致する倉庫を取得します |
複数倉庫に対応するツールを除き、1回の呼び出しにつき1クレジットです。複数倉庫ツールでは、get_costco_prices は場所2か所ごとに1回(オンラインは1か所としてカウント)、get_costco_availability は倉庫1か所ごとに1回の照会を行い、照会5回につき1クレジットが課金されます。そのため、倉庫10か所では2クレジットです。get_costco_warehouses と get_costco_gas_prices は country: "ca" の場合2クレジットです。warehouse_ids によるガソリン価格の取得は倉庫5か所ごとに1クレジット(caでは倉庫1か所につき2クレジット)です。
search_costco、get_costco_category、get_costco_deals では warehouse_id を指定すると、各結果にその倉庫の店頭価格、在庫、価格コードが追加されます。IDは get_costco_warehouses で取得してください。get_costco_coupons を除き、country は us(デフォルト)または ca です。search_costco、get_costco_product、get_costco_warehouses では、キーワード、並べ替え、ページ指定に限り uk、au、mx、jp、kr、tw も指定できます。get_costco_clearance の価格コードは、会員コミュニティによる解読(クリアランスは .97、マネージャー値下げは .00/.88、リクエストによる特別仕入れは .49/.79/.89)であり、Costcoが公表しているものではありません。また、Costcoがオンラインに掲載している商品だけが対象です。get_costco_coupons はデフォルトで約200件のクーポンブックから最初の50件を返します。さらに取得するには limit を指定してください。
HEB
| ツール | 説明 |
|---|---|
search_heb | HEBの食料品を検索します。価格(セント)、セール状況、単価、サイズ、UPC、在庫、EBT/SNAP、通路の場所を取得します |
get_heb_product | 商品の詳細を取得します。栄養成分、原材料、画像、類似商品、クーポン、EBT/SNAP、パンくずリストを含みます |
get_heb_stores | ZIPコードまたは市区町村で店舗を検索します。住所、営業時間、薬局、受け取り方法、距離を取得します |
1回の呼び出しにつき2クレジットです。HEBはテキサス州を拠点とする食料品チェーンです。商品詳細を取得するには、search_heb から取得した product_url、または slug と product_id を指定してください。
Kroger
| ツール | 説明 |
|---|---|
search_kroger | Krogerの食料品を検索します。価格(セント)、プロモーション/複数個購入の特価、単価、UPC、在庫、SNAP、食事に関する情報、評価を取得します |
get_kroger_product | 商品の詳細を取得します。アレルゲン・原材料を含む栄養情報、評価の分布、店舗内の通路、食事に関するフラグ、SNAP、寸法を含みます |
1回の呼び出しにつき2クレジットです。KrogerはKroger、Ralphs、Fred Meyer、Harris Teeter、King Soopers、Fry'sなどのブランドを運営しています。search_kroger から取得した product_url、または upc を指定してください。
Mercado Libre
メキシコ、ブラジル、アルゼンチン、コロンビア向けのMercado Libre(ブラジルではMercado Livre)の商品データです。OAuth アプリを登録せずに、出品、価格、販売者、レビュー、購入者からの質問、カテゴリー別ベストセラーを取得できます。
| ツール | 説明 |
|---|---|
search_mercadolibre | mx、br、ar、coでキーワードまたは販売者を指定して出品を検索します。価格、定価、割引、分割払い、表示される場合は販売者、評価、販売数、送料無料とFullのフラグ、スポンサー付きフラグを取得します。コンディション、価格帯、最低割引率、送料無料、Full、公式ストア、金利なしの分割払いで絞り込み、関連度または価格で並べ替えられます。1ページあたり約48件です |
get_mercadolibre_product | URL、product_id、またはitem_idで商品または出品1件の情報を取得します。価格、プロモーション、評価、在庫、配送情報、評価の星別分布、バリエーション、仕様、説明、写真、カテゴリーに加え、購入ボックスの販売者を取得します |
get_mercadolibre_reviews | 1ページあたり15件のレビューを取得します。評価、本文、翻訳された場合は原文、日付、「いいね」数、レビュアーの国、写真を含みます。星評価で絞り込めます |
get_mercadolibre_questions | 出品に関する購入者からの質問と販売者の回答、回答日を取得します。next_offsetでページを指定します |
get_mercadolibre_best_sellers | カテゴリー別のランキング上位20件を取得します(mx、ar、co。ブラジルを除く) |
1回の呼び出しにつき2クレジットです。get_mercadolibre_reviewsは1クレジットです。検索ではクエリごとに最大42ページ(約2,000件)の結果が返されます。さらに検索するには、価格帯、コンディション、販売者で絞り込んでください。並べ替え方法は関連度または価格のみです。販売数は正確な件数ではなく、「500件以上」のような下限値です。検索結果に販売者名が表示されるのは、Mercado Libreが表示している場合のみです。get_mercadolibre_productでは購入ボックスの販売者を取得できますが、商品の全販売者リストは取得できません。Mercado Libre側でクエリが絞り込まれる場合があります(ブラジルとアルゼンチンでは「新品」が適用されることがあります)。適用されたフィルターはauto_applied_filtersに表示されます。商品、レビュー、質問の取得ではcountryを指定しません。IDの接頭辞(MLM、MLB、MLA、MCO)またはURLで国が決まります。チリには対応していません。検索結果が0件の場合も、課金対象となる空のページが返されます。不明な商品、出品、販売者のニックネーム、または質問のない出品では、その旨を示す課金対象の404が返されます。
Booking.com
| ツール | 説明 |
|---|---|
search_booking | 目的地と宿泊日程に合う宿泊施設を検索します。現在の1泊あたりの料金、レビュー評価、客室タイプを取得します |
get_booking_hotel | 宿泊施設1件の詳細を取得します。客室と料金プラン、設備、ハウスルール、ポリシー、画像を含みます |
get_booking_reviews | カテゴリー別の評価内訳とBooking独自の要約を含む、宿泊客のレビューを取得します |
1回の呼び出しにつき1クレジットです。検索では1ページあたり25件の宿泊施設が返されます。get_booking_hotelとget_booking_reviewsは一度の呼び出しで完了します。
Airbnb
| ツール | 説明 |
|---|---|
search_airbnb | 宿泊施設を検索し、宿泊料金の合計と1泊あたりの料金、割引の全内訳、評価、座標を取得します |
get_airbnb_listing | 出品1件の詳細を取得します。説明、定員、グループ別のアメニティ、ホスト、ハウスルール、評価の内訳を含みます |
get_airbnb_reviews | レビュー本文、各レビューの評価、日付、レビュアーのプロフィールを取得します |
1回の呼び出しにつき1クレジットです。search_airbnbではpageまたはcursorのどちらか一方を指定します。両方を送ると拒否され、cursorが優先されます。1ページあたり18件です。get_airbnb_reviewsはlimitとoffsetでページを指定します。
Tripadvisor
| ツール | 説明 |
|---|---|
resolve_tripadvisor_location | 最初に実行してください。場所またはビジネス名から、geo_id と location_id のペアを解決します |
search_tripadvisor | 地域内のレストラン、ホテル、観光スポットをTripAdvisorのランキング順で検索します |
get_tripadvisor_location | 1件の場所の詳細情報:評価の分布、サブ評価、市内ランキング、設備、レビューの最初のページ |
get_tripadvisor_reviews | レビューの1ページ分:評価、旅行の日付と種類、レビュアーのプロフィール、施設側の返信 |
1回の呼び出しにつき2クレジットです。ほかのすべてのツールで必要となる geo_id と location_id のペアを取得するため、最初に resolve_tripadvisor_location を実行してください。検索結果は1ページあたり30件です。最後のページを超えてリクエストすると、空の結果ではなく404が返されます。レビューはレストランでは1ページあたり15件、ホテルと観光スポットでは10件返されるため、2ページ目以降では category を場所自体の種類に合わせる必要があります。
Yelp
| ツール | 説明 |
|---|---|
search_yelp | Yelpのランキング順にビジネスを検索します:評価、レビュー数、価格帯、カテゴリ、営業時間 |
get_yelp_business | 1件のビジネスの詳細情報:星ごとの評価分布、連絡先、営業時間、設備、衛生検査、Q&A |
get_yelp_reviews | レビューの1ページ分:評価、全文、投稿者のプロフィール、写真、オーナーの返信 |
1回の呼び出しにつき2クレジットです。Yelpのページサイズは10件に固定されています。get_yelp_business には、追加料金なしでレビューの最初のページが含まれています。最後のページを超えてリクエストすると、空の結果ではなく404が返されます。
Zillow
| ツール | 説明 |
|---|---|
search_zillow | 地域内の物件情報:価格、ベッドルーム数、バスルーム数、居住面積、Zestimate、座標、市場に出てからの日数 |
get_zillow_property | 物件情報の詳細:価格と価格履歴、Zestimate、税履歴、RESO物件情報、学校、写真 |
get_zillow_agent_reviews | Zillow AGENTのプロフィールとレビュー、専門分野、免許、サービス提供地域、販売件数 |
1回の呼び出しにつき1クレジットです。ページネーションに対応しているのは search_zillow のみです。get_zillow_agent_reviews はAGENTのプロフィールであり、物件情報ではありません。
Redfin
| ツール | 説明 |
|---|---|
search_redfin | 物件情報:価格、平方フィートあたりの価格、ベッドルーム数、バスルーム数、居住面積、敷地面積、築年、写真 |
get_redfin_property | 物件情報の詳細:Redfin査定額、MLS物件情報、価格と税の履歴、学校、気候リスク、類似物件 |
get_redfin_market | 地域の市場統計:平均販売価格、平均成約価格、売出価格に対する成約価格の比率、市場に出てからの日数、競争スコア |
1回の呼び出しにつき1クレジットです。search_redfin は page と limit を使ったページネーションに対応しており、1ページあたり最大350件の物件を取得できます。ほかの2つは一括で結果を返します。
Realtor.com
| ツール | 説明 |
|---|---|
search_realtor | 米国の売り出し中、購入申し込み中、賃貸中、または売却済みの物件を、場所、半径、エージェントで検索します。価格、寝室数、浴室数、床面積、敷地面積、築年、ガレージ、HOA、物件種別、過去 N 日以内の掲載・売却・値下げ、物件説明文に含まれるキーワード(すべて一致が必要)、新築、差し押さえ、オープンハウスで絞り込めます。1 回あたり最大 200 件です |
get_realtor_property | ID または URL で物件を 1 件取得します。価格と税金の履歴、履歴と予測を含む 3 種類の価格査定、学校、洪水・山火事・騒音のリスク、掲載エージェントと事務所を確認できます |
get_realtor_locations | 市、郡、ZIP コード、近隣地域、学校、住所の候補を取得します。市場用の slug_id と住所用の property_id が含まれます |
get_realtor_market | 市、郡、ZIP コードの市場統計を取得します。物件種別ごとの掲載価格・売却価格・賃料の中央値、平方フィートあたりの価格、市場掲載日数、前年同月比と前月比の変化を確認できます |
search_realtor_agents | 市、ZIP コード、名前でエージェントを検索します。評価、レビュー、掲載中の物件と価格帯、昨年の売却件数、仲介会社と事務所を確認できます |
get_realtor_agent | 1 人のエージェントの完全なプロフィールを取得します。すべてのレビューと 4 種類のサブ評価を確認できます |
1 回の呼び出しにつき 1 クレジットです。search_realtor は 1 ページあたり最大 200 件(デフォルトは 50 件)の物件を返し、検索結果の先頭 10,000 件を提供します(page x page_size <= 10,000)。より多くの結果を取得するには、価格帯、物件種別、または半径で広いエリアを分割してください。米国の非開示州(テキサス州、ユタ州、ワイオミング州、その他約 9 州)では売却価格は null ですが、売却日は引き続き返されます。不明な物件 ID またはエージェント ID へのリクエストも課金対象の 404 になります。
Rightmove
| ツール | 説明 |
|---|---|
get_rightmove_locations | 英国の場所、アウトコード、郵便番号、駅から、検索とエージェント取得に使う location_id を取得します |
search_rightmove | 英国の売り出し中または賃貸中の物件を検索します。価格(GBP)、寝室数、浴室数、物件種別、必須条件、除外条件、所有権形態、追加日数、購入申し込み中、半径、家具の有無、賃貸種別で絞り込めます。1 ページあたり 24~25 件です |
get_rightmove_property | 1 件の物件情報をすべて取得します。所有権形態と残存リース年数、カウンシルタックスの課税区分、管理費、地代、EPC、部屋、間取り図、洪水リスク、ブロードバンド、駅、エージェントを確認できます |
get_rightmove_sold | 町、アウトコード、郵便番号の売却価格を取得します。1 ページあたり 25 件の住所について、1995 年以降の売却履歴と、過去 1 年間の地域の平均価格を確認できます |
get_rightmove_sold_property | 売却済み住所を 1 件取得します。価格、日付、所有権形態、新築フラグ、変動率を含むすべての売却記録と、最後に掲載された物件情報のアーカイブを確認できます |
search_rightmove_agents | 場所ごとに不動産仲介会社と賃貸仲介会社の支店を検索します。電話番号、住所、ブランドと会社の ID、プロフィール URL を確認できます |
get_rightmove_agent | ID または URL で支店を 1 件取得します。住所、電話番号、所属、掲載件数、概要を確認できます |
1 回の呼び出しにつき 1 クレジットです。Rightmove の検索にはキーワードフィルターがありません。代わりに、返される summary と key_features を対象に照合してください。検索ごとのページ上限は、search_rightmove が 42 ページ(約 1,000 件)、get_rightmove_sold が 40 ページ、search_rightmove_agents が 50 ページです。より多くの結果を取得するには、価格帯、物件種別、またはより狭いエリアで絞り込んでください。売却価格を取得できるのはイングランドとウェールズのみです(スコットランドと北アイルランドは対象外)。掲載中の物件には価格履歴がないため、住所の過去の売却記録には get_rightmove_sold_property を使用してください。削除済みの掲載情報または不明な ID へのリクエストは、課金対象の 404 になります。
Indeed
| ツール | 説明 |
|---|---|
search_indeed_jobs | 求人情報:職種名、雇用主、評価、勤務地、給与範囲、雇用形態、応募先 |
get_indeed_job | 求人情報1件の全詳細:説明文とHTML、構造化された給与、福利厚生、元のATSリンク |
get_indeed_company | 雇用主のプロフィール:業種、本社、規模、収益、CEOへの評価、カテゴリ別評価、募集中の求人 |
get_indeed_company_reviews | 従業員レビュー:カテゴリ別評価、良い点と悪い点、投稿者の職種と勤務地 |
1回の呼び出しにつき2クレジットです。求人検索では1ページにつき10件、企業レビューでは1ページにつき20件を返します。get_indeed_job と get_indeed_company は1回の呼び出しで完了します。
Glassdoor
| ツール | 説明 |
|---|---|
resolve_glassdoor_company | 最初に使用します。企業名を、他のツールで必要となる employer_id に解決します |
get_glassdoor_company | 雇用主のプロフィール:評価、星評価の分布、CEOへの評価、規模と収益の範囲、受賞歴 |
get_glassdoor_reviews | 軸ごとのスコアと雇用主の返信を含む最大3件の詳細なレビューに加え、評価統計全体 |
get_glassdoor_salaries | 職種別の給与:基本給と総給与のP10~P90パーセンタイル、サンプル数、給与の支払い期間 |
1回の呼び出しにつき1クレジットです。まず resolve_glassdoor_company で employer_id を取得します。ページ分割に対応しているのは get_glassdoor_salaries のみです(1ページにつき10職種。page_count は存在するページ数です)。get_glassdoor_reviews は最大3件の詳細なレビューと評価統計全体を返します。ページ分割されたレビューフィードではありません。
Apple App Store
| ツール | 説明 |
|---|---|
search_app_store | 詳細な情報を含む最大200件のアプリ。メタデータの一括取得とパブリッシャー検索を兼ねます |
get_app_store_app | 掲載情報の全詳細:開発者情報、価格、全期間および現行バージョンの評価、リリースノート、スクリーンショット |
get_app_store_reviews | レビューの1ページ分:星評価、タイトル、全文、投稿者、レビュー対象のアプリバージョン |
1回の呼び出しにつき1クレジットです。レビューは1~10ページを1ページにつき50件取得でき、10ページ目で必ず終了します。1ストアフロントあたり500件という上限は、Appleが匿名ユーザーに設けている制限です。さらに取得するには、別の country を指定してください。検索とアプリの詳細情報はページ分割されません。
Google Play
| ツール | 説明 |
|---|---|
search_google_play | ランキング順のアプリ:パッケージ名、開発者、評価、インストール数、価格とアプリ内購入の範囲、スクリーンショット |
get_google_play_app | ストア掲載情報の全詳細:実際のインストール数、星評価の分布、アプリ内購入、権限、データセーフティ表 |
get_google_play_reviews | レビューの1ページ分:星評価、全文、「役に立った」数、開発者の返信、アプリバージョン |
1回の呼び出しにつき2クレジットです。google とは別の名前空間であり、Google向けの免除価格は適用されません。レビューはカーソルでページ分割されます。カーソルは不透明で、1回のみ使用でき、位置だけでなく並び順もエンコードされるため、取得時と同じ sort とともに渡してください。最後のレビューを過ぎたカーソルを指定すると404が返されます。検索とアプリの詳細情報はページ分割されません。
G2 Software Reviews
| ツール | 説明 |
|---|---|
search_g2_software | B2B ソフトウェアを検索します。星評価、レビュー数、ベンダー、カテゴリーを確認できます。各行には product_id が含まれます |
get_g2_product | 詳細なプロフィール:星ごとの分布、価格プラン、機能グループ、連携、代替製品、AI による長所と短所 |
get_g2_reviews | レビューページ:評価、高評価/低評価、解決した課題、レビュアーの企業属性、検証済みフラグ |
1 回の呼び出しにつき 5 クレジットです。Scavio で最も高額なプラットフォームです。search_g2_software は page と limit でページ分割します(こちら側の上限は 100 件)。get_g2_reviews は 1 ページあたり 10 件固定で、G2 のウィジェットにリンクされている 10 ページをはるかに超えてページ分割できます。get_g2_product は 1 回の呼び出しで完了します。
Capterra Software Reviews
| ツール | 説明 |
|---|---|
search_capterra_software | B2B ソフトウェアを検索します。評価、レビュー数、有料掲載フラグ付きのランキング上位 20 製品を確認できます |
get_capterra_product | 詳細なプロフィール:星ごとの分布、4 項目の評価基準、価格表、機能に加え、最近のレビュー 25 件 |
get_capterra_reviews | レビューページ:全体評価と 5 項目の評価基準、長所、短所、検討した代替製品 |
1 回の呼び出しにつき 2 クレジットです。ページ分割できるのは get_capterra_reviews のみで、1 ページあたり 25 件、最大 100 ページです。それを超えると、Capterra は 200 件のステータスで 1 ページ目を返すため、返された内容を確認してください。get_capterra_product には、最近のレビュー 25 件がすでに含まれています。
Trustpilot
| ツール | 説明 |
|---|---|
search_trustpilot | 1 か国のキーワードで企業を検索します。ドメイン、TrustScore、星評価、レビュー数、カテゴリー、ウェブサイト、公開済みのメールアドレス/電話番号/住所を確認できます。1 ページあたり最大 100 件 |
get_trustpilot_business | ドメインまたは URL で詳細なプロフィールを取得します。評価分布、言語ごとのレビュー数、登録状況と認証状況、返信率と返信までの日数、消費者向け警告、AI による概要とトピック、類似企業、最新レビュー 20 件 |
get_trustpilot_reviews | 星評価、言語、期間、トピック、テキスト、認証済みのみ、返信ありで絞り込んだレビュー 20 件のページです。新しさまたは関連性で並べ替えます |
get_trustpilot_categories | カテゴリーツリー(最上位カテゴリー 22 件、サブカテゴリー 189 件)、または名前に一致するカテゴリー |
get_trustpilot_category | 国別にカテゴリー内の企業をランキング表示します。並べ替え、最低星評価(TrustScore を星評価に四捨五入するため、4 は 3.8 以上)、登録済みプロフィールのみを指定できます。1 ページあたり 20 件 |
get_trustpilot_review | 24 文字の ID でレビューを 1 件取得し、対象の企業も確認できます |
1 回の呼び出しにつき 2 クレジットです。get_trustpilot_reviews は 20 件ずつ 10 ページを提供するため、フィルターの組み合わせごとに最大 200 件のレビューを取得できます。さらに読むには、ページを進めるのではなく、個別の値(各 stars の値、各 language、各 date_range)ごとに分けてください。date_range を指定した場合の total_filtered は、レビュー投稿頻度としても使えます。メールアドレスと電話番号は企業が公開している場合にのみ表示されます。AI による概要とトピックは、選択した language(デフォルトは en)に Trustpilot が対応している場合にのみ表示されます。TrustScore の履歴はありません。不明なドメイン、カテゴリー、レビュー ID を指定すると、見つからなかった対象を示す、課金対象の 404 が返されます。
Google Ads Transparency
| ツール | 説明 |
|---|---|
resolve_google_ads_advertiser | 最初に使用します。ブランド名またはドメインから advertiser_id を特定します |
search_google_ads | ある広告主が Google で掲載しているすべての広告を、初回・最終確認日および実際の掲載日数とともに取得します |
get_google_ads_creative | 1件のクリエイティブの詳細を取得します。サイズのバリエーション、インプレッションの範囲、地域別内訳を取得できる唯一のツールです |
呼び出しごとに1クレジットを消費します。まず resolve_google_ads_advertiser を使い、ブランド名またはドメインから advertiser_id を特定してください。search_google_ads は1ページあたり100件の広告をカーソルでページ分割します。カーソルとともに同じフィルターを再送信してください。get_google_ads_creative は、クリエイティブの掲載履歴、地域別内訳、インプレッションの範囲を取得できる唯一のツールです。
Meta Ad Library
| ツール | 説明 |
|---|---|
search_meta_ads | Meta Ad Library を検索し、広告コピー、見出し、CTA、メディア、プラットフォーム、掲載日を含むクリエイティブの詳細を取得します |
get_meta_ads_advertiser | 数値のページ ID を指定し、Facebook ページが掲載しているすべての広告を同じクリエイティブ詳細とともに取得します |
get_meta_ad | アーカイブ ID を指定し、1件の広告のクリエイティブ、広告主、掲載日、プラットフォーム、政治広告に関する開示情報をすべて取得します |
呼び出しごとに1クレジットを消費し、カーソルで次のページを取得するたびに1クレジットが追加されます。1ページ目では30件、その後は1ページあたり10件の広告が返されるため、クエリ全体をたどるコストはページ数に応じて増加します。search_meta_ads と get_meta_ads_advertiser はどちらもカーソルでページ分割されます。has_next_page をたどってください。get_meta_ad は1回の呼び出しで完了します。
SEC EDGAR
| ツール | 説明 |
|---|---|
resolve_sec_company | 最初に使用します。会社名またはティッカーから、ほかのすべての情報のキーとなる CIK を特定します |
get_sec_company | 申告者のプロフィールを取得します。正式名称と旧名称、SIC 業種、EIN、LEI、会計年度末、ティッカーが含まれます |
get_sec_filings | 申告者の提出書類を1ページ分取得します。アクセッション番号、フォーム、日付、8-K 項目コード、書類へのリンクが含まれます |
get_sec_concept | 申告者が1つの XBRL 概念について報告したすべての値を、新しい順に、出典となる提出書類とともに取得します |
get_sec_facts | 申告者が報告するすべての XBRL 概念の索引です。get_sec_concept で照会する項目を見つけるために使用します |
search_sec_filings | EDGAR の全文検索です。2001年から現在までを対象とし、会社、フォーム、業種、州で絞り込めます |
公式の無料 EDGAR JSON API では、呼び出しごとに1クレジットを消費します。まず resolve_sec_company を使い、会社名またはティッカーから CIK を特定してください。get_sec_filings は page と limit でページ分割します。search_sec_filings は最大100件ずつページ分割します。インデックスが10,000件を超える検索結果ウィンドウを拒否するためです。
Companies House
| ツール | 説明 |
|---|---|
search_companies_house | 最初に使用します。英国の登記簿を名前で検索し、company_number を特定します |
get_companies_house_company | 登記情報の全項目を取得します。ステータス、種類、日付、登記上の本店所在地、SIC コード、会計報告書の提出期限が含まれます |
get_companies_house_officers | 現任および退任した役員を取得します。役職、就任日と退任日、国籍、生年月日が含まれます |
get_companies_house_filing_history | 提出書類を新しい順に取得します。日付、種類コード、説明、提出済み PDF へのリンクが含まれます |
公式の英国登記簿では、呼び出しごとに1クレジットを消費します。まず search_companies_house を使って company_number を取得してください。検索結果は1ページあたり20件で、最大50ページまでです。登記簿は、表示されるヒット件数にかかわらず、検索語ごとに1,000件の結果ウィンドウを提供し、51ページ目へのリクエストには416を返します。役員(1ページあたり35件)と提出書類の履歴にはページ数の上限がありません。最終ページを過ぎると、通常の200レスポンスと空のリストが返されます。これは該当なしの場合と同じように見えます。
アカウント
| ツール | 説明 |
|---|---|
get_usage | クレジット残高、プラン、使用状況の統計を確認します |
Scavio について
Scavio は、AI エージェント向けの統合検索 APIであり、開発者向けのデータ API です。1 つのキーで、構造化された JSON を利用できます。
- Google Search API — SERP の検索結果、ニュース、画像、地図、ナレッジグラフ
- Extract — 任意の URL を Markdown、プレーンテキスト、または生の HTML として読み取ります
- Amazon Product API と Walmart Product API — 商品の検索と詳細情報に加え、eBay、Target、Home Depot、Costco(倉庫ごとの価格、在庫、ガソリン価格、クーポンブック)、Mercado Libre(メキシコ、ブラジル、アルゼンチン、コロンビアの出品、販売者、レビュー、質問、ベストセラー)
- TikTok API、Instagram API、Reddit API、X API、LinkedIn API、YouTube API — ソーシャルメディアと動画のデータ
- 旅行と地域情報 — Booking.com、Airbnb、Tripadvisor、Yelp
- 不動産 — Zillow、Redfin、Realtor.com(物件情報、売却済み物件の比較データ、市場統計、エージェント)、Rightmove(英国の物件情報、1995年以降のイングランドとウェールズの売却価格、エージェント)
- 求人と雇用主のデータ — Indeed、Glassdoor
- アプリ、ソフトウェアレビュー、広告ライブラリ — App Store、Google Play、G2、Capterra、Trustpilot(企業プロフィール、絞り込み可能なレビュー、カテゴリ別ランキング)、Google Ads Transparency、Meta Ad Library
- 企業の提出書類 — SEC EDGAR、Companies House チームでは、構造化されたマルチプラットフォームデータを利用できるSerpAPI の代替として使用しています。直接比較については、Tavily と Scavio の比較をご覧ください。
scavio.devで無料のSearch APIキーを取得できます。
ライセンス
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。