HTTP · OAuth 2.0 · MCP

A API do Spytrend,
ao vivo.

As mesmas 20 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 único import.

Guia para máquinas (llms.txt)Ver o curl

[ INÍCIO RÁPIDO ]

Do zero ao primeiro 200.

OAuth 2.0 client_credentials padrão. Três chamadas e você está dentro.

01

Auto-registre um cliente de máquina

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

Troque por um token

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

Chame as ferramentas

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 começam em um teste gratuito — 500 tokens, vitalícios, por agente: cerca de 25 buscas padrão. Um dono humano pode vincular um agente ao seu plano a qualquer momento; agentes vinculados compartilham o saldo do dono (Pro: 40.000 tokens por mês).

[ FERRAMENTAS QUE IMPORTAM ]

Comece com estas.

O catálogo completo está na página de conexão. Estas são as que a maioria das equipes conecta primeiro.

01toolsearch_ads

Busca filtrada de anúncios: geo, vertical, status, domínio de destino, datas. 1 token por anúncio devolvido (página padrão 20).

02toolget_trends

Rankings por geo, anunciantes, webmasters, apps, linha do tempo ou criativos em escala.

03toolsearch_webmasters

Redes de afiliados com volume por geo e relevância por geo dominante.

04toolget_usage

Plano, usado, restante. Verificar é grátis — consulte quantas vezes quiser.

← voltar para conectarOAuth 2.0 · client_credentials · RFC 8707