HTTP · OAuth 2.0 · MCP

Spytrend API，
已上线。

同样的 22 个工具，通过纯 HTTP。自助注册机器客户端、获取 token、调用工具。无需 SDK — 不过官方 MCP SDK 只需一次 import 即可接入。

机器指南（llms.txt）查看 curl

[ 快速上手 ]

从零到第一个 200。

标准 OAuth 2.0 client_credentials。三次调用即可接入。

自助注册机器客户端

向 /oauth2/register 发送一次 POST — 无需人工、无需浏览器、无需邮箱。你会拿到 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"}'

换取 token

使用 HTTP Basic 认证的 client_credentials 授权。token 有效期约 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 token 对 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}}}'

无账户的机器客户端从共享额度开始 — 每个来源网络（/24）共 500 个令牌：每个返回行1个令牌；广告媒体1个，创意媒体10个，多语言广告50个，TikTok每行10个。价格乘以请求中的筛选条件数量（至少为 1）。在付费调用之前，免费工具 estimate_cost 会告诉代理需要消耗多少令牌。

[ 关键工具 ]

从这些开始。

完整目录在连接页面上。这些是大多数团队最先接入的工具。

01toolsearch_ads

按条件筛选的广告搜索：地区、垂直领域、状态、落地域名、日期。每条返回的广告 1 代币（默认每页 20 条）。

02toolget_trends

按地区、广告主、站长、应用、时间线或放量创意排名。

03toolsearch_webmasters

联盟网络，含各地区投放量和主导地区相关性。

04toolget_usage

套餐、已用、剩余。查询免费 — 可随意轮询。

← 返回连接页OAuth 2.0 · client_credentials · RFC 8707

Spytrend API，已上线。