HTTP · OAuth 2.0 · MCP

La API de Spytrend,
en vivo.

Las mismas 22 herramientas, sobre HTTP puro. Registra un cliente máquina, obtén un token, llama a las herramientas. Sin SDK — aunque los SDK oficiales de MCP lo dejan en un import.

Guía para máquinas (llms.txt)Ver el curl

[ GUÍA RÁPIDA ]

De cero al primer 200.

OAuth 2.0 client_credentials estándar. Tres llamadas y estás dentro.

Registra un cliente máquina

Un POST a /oauth2/register — sin humano, sin navegador, sin email. Recibes un client_id y un 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"}'

Cámbialo por un token

Grant client_credentials con autenticación HTTP Basic. Los tokens duran ~1 hora; refréscalos repitiendo la llamada.

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'

Llama a las herramientas

tools/call JSON-RPC contra el endpoint MCP con tu token Bearer. Cada herramienta del catálogo de arriba.

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

Los clientes máquina sin cuenta empiezan con un fondo compartido de 500 tokens por red de origen (/24): 1 token por fila entregada; medios de anuncio 1, medios de creativo 10, anuncio multilingüe 50, fila de TikTok 10. El precio se multiplica por el número de filtros de la solicitud (mínimo 1). Antes de una llamada de pago, la herramienta gratuita estimate_cost le dice al agente cuántos tokens costará.

[ HERRAMIENTAS QUE IMPORTAN ]

Empieza con estas.

El catálogo completo está en la página de conexión. Estas son las que la mayoría de equipos conectan primero.

01toolsearch_ads

Búsqueda filtrada de anuncios: geo, vertical, estado, dominio de destino, fechas. 1 token por anuncio devuelto (página por defecto 20).

02toolget_trends

Rankings por geo, anunciantes, webmasters, apps, cronología o creativos en escalado.

03toolsearch_webmasters

Redes de afiliados con volumen por geo y relevancia por geo dominante.

04toolget_usage

Plan, usadas, restantes. Consultar es gratis — hazlo tan a menudo como quieras.

← volver a conectarOAuth 2.0 · client_credentials · RFC 8707