HTTP · OAuth 2.0 · MCP

Spytrend API を、
ライブで。

同じ20のツールを、素の HTTP で。マシンクライアントを自己登録し、トークンを取得して、ツールを呼び出します。SDK は不要 — 公式の MCP SDK を使えば import 1行で済みます。

マシンガイド（llms.txt）curl を見る

[ クイックスタート ]

ゼロから最初の 200 まで。

標準的な OAuth 2.0 の client_credentials。3回の呼び出しで完了です。

マシンクライアントを自己登録

/oauth2/register に POST を1回 — 人手、ブラウザ、メール不要。client_id と client_secret が返されます。

curl -X POST https://mcp.spytrend.com/oauth2/register \
  -H 'Content-Type: application/json' \
  -d '{"client_name":"my-agent","grant_types":["client_credentials"],
       "response_types":[],"token_endpoint_auth_method":"client_secret_basic",
       "scope":"mcp:read"}'

トークンと交換

HTTP Basic 認証による client_credentials グラント。トークンの有効期間は約1時間。呼び出しを繰り返して更新します。

curl -X POST https://mcp.spytrend.com/oauth2/token \
  -u "$CLIENT_ID:$CLIENT_SECRET" \
  -d 'grant_type=client_credentials&scope=mcp:read&audience=https://mcp.spytrend.com/mcp'

ツールを呼び出す

Bearer トークンを付けて MCP エンドポイントに JSON-RPC の tools/call。上記カタログのすべてのツールが使えます。

curl -X POST https://mcp.spytrend.com/mcp \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"search_ads","arguments":{"country":"BR","limit":5}}}'

マシンクライアントは無料トライアルから開始 — エージェントごとに生涯 500 トークン：標準検索で約 25 回。所有者はいつでもエージェントを自分のプランに紐付け可能。紐付けたエージェントは所有者の残高を共有します（Pro：月間 40,000 トークン）。

[ 重要なツール ]

まずはこれらから。

完全なカタログは接続ページにあります。ここに挙げたのは、多くのチームが最初に組み込むものです。

01toolsearch_ads

条件で絞り込んだ広告検索：地域、バーティカル、ステータス、ランディングドメイン、日付。返された広告 1 件につき 1 トークン（デフォルト 20 件/ページ）。

02toolget_trends

ジオ、広告主、ウェブマスター、アプリ、タイムライン、スケーリングクリエイティブ別のランキング。

03toolsearch_webmasters

ジオ別ボリュームと主要ジオの関連度を備えたアフィリエイトネットワーク。

04toolget_usage

プラン、使用済み、残り。確認は無料 — 好きなだけポーリングできます。

← 接続ページに戻るOAuth 2.0 · client_credentials · RFC 8707

Spytrend API を、ライブで。