HTTP · OAuth 2.0 · MCP
同样的 20 个工具,通过纯 HTTP。自助注册机器客户端、获取 token、调用工具。无需 SDK — 不过官方 MCP SDK 只需一次 import 即可接入。
[ 快速上手 ]
标准 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"}'使用 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}}}'机器客户端从免费试用开始 — 每个代理终身 500 代币:约 25 次默认搜索。人类所有者可随时将代理绑定到自己的计划;绑定后的代理共享所有者的余额(Pro:每月 40,000 代币)。
[ 关键工具 ]
完整目录在连接页面上。这些是大多数团队最先接入的工具。
search_ads按条件筛选的广告搜索:地区、垂直领域、状态、落地域名、日期。每条返回的广告 1 代币(默认每页 20 条)。
get_trends按地区、广告主、站长、应用、时间线或放量创意排名。
search_webmasters联盟网络,含各地区投放量和主导地区相关性。
get_usage套餐、已用、剩余。查询免费 — 可随意轮询。