HTTP · OAuth 2.0 · MCP

Spytrend API,
已上线。

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

[ 快速上手 ]

从零到第一个 200。

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

01

自助注册机器客户端

向 /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"}'
02

换取 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'
03

调用工具

带上 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}}}'

机器客户端从免费试用开始 — 每个代理终身 500 代币:约 25 次默认搜索。人类所有者可随时将代理绑定到自己的计划;绑定后的代理共享所有者的余额(Pro:每月 40,000 代币)。

[ 关键工具 ]

从这些 开始。

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

01toolsearch_ads

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

02toolget_trends

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

03toolsearch_webmasters

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

04toolget_usage

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

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