HTTP · OAuth 2.0 · MCP
As mesmas 22 ferramentas, sobre HTTP puro. Auto-registre um cliente de máquina, pegue um token, chame as ferramentas. Nenhum SDK necessário — embora os SDKs oficiais do MCP tornem isso um só import.
[ INÍCIO RÁPIDO ]
OAuth 2.0 client_credentials padrão. Três chamadas e você está dentro.
Um POST para /oauth2/register — sem humano, sem navegador, sem e-mail. Você recebe de volta um client_id e um 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"}'Grant client_credentials com autenticação HTTP Basic. Os tokens duram ~1 hora; renove repetindo a chamada.
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'
tools/call JSON-RPC contra o endpoint MCP com seu token Bearer. Cada ferramenta do catálogo acima.
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}}}'Clientes máquina sem conta começam com um pool compartilhado de 500 tokens por rede de origem (/24): 1 token por linha entregue; mídia de anúncio 1, mídia de criativo 10, anúncio multilíngue 50, linha do TikTok 10. O preço é multiplicado pelo número de filtros da requisição (mínimo 1). Antes de uma chamada paga, a ferramenta gratuita estimate_cost informa ao agente quantos tokens ela vai custar.
[ FERRAMENTAS QUE IMPORTAM ]
O catálogo completo está na página de conexão. Estas são as que a maioria das equipes conecta primeiro.
search_adsBusca filtrada de anúncios: geo, vertical, status, domínio de destino, datas. 1 token por anúncio devolvido (página padrão 20).
get_trendsRankings por geo, anunciantes, webmasters, apps, linha do tempo ou criativos em escala.
search_webmastersRedes de afiliados com volume por geo e relevância por geo dominante.
get_usagePlano, usado, restante. Verificar é grátis — consulte quantas vezes quiser.