HTTP · OAuth 2.0 · MCP

La API de Spytrend,
en vivo.

Las mismas 20 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.

01

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

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

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 empiezan con una prueba gratuita — 500 tokens, de por vida, por agente: unas 25 búsquedas estándar. Un propietario humano puede vincular un agente a su plan en cualquier momento; los agentes vinculados comparten el saldo del propietario (Pro: 40 000 tokens al mes).

[ 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