HTTP · OAuth 2.0 · MCP

L'API Spytrend,
en direct.

Les 20 mêmes outils, en HTTP simple. Enregistrez un client machine, récupérez un token, appelez les outils. Aucun SDK requis — même si les SDK MCP officiels le réduisent à un seul import.

[ DÉMARRAGE RAPIDE ]

De zéro au premier 200.

OAuth 2.0 client_credentials standard. Trois appels et vous y êtes.

01

Enregistrez un client machine

Un POST vers /oauth2/register — sans humain, sans navigateur, sans e-mail. Vous récupérez un client_id et 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

Échangez contre un token

Grant client_credentials avec auth HTTP Basic. Les tokens vivent ~1 heure ; renouvelez en répétant l'appel.

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

Appelez les outils

tools/call en JSON-RPC vers l'endpoint MCP avec votre token Bearer. Chaque outil du catalogue ci-dessus.

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

Les clients machine démarrent sur un essai gratuit — 500 tokens, à vie, par agent : environ 25 recherches standard. Un propriétaire humain peut rattacher un agent à son forfait à tout moment ; les agents rattachés partagent le solde du propriétaire (Pro : 40 000 tokens par mois).

[ LES OUTILS QUI COMPTENT ]

Commencez par ceux-ci.

Le catalogue complet est sur la page de connexion. Voici ceux que la plupart des équipes branchent en premier.

01toolsearch_ads

Recherche d'annonces filtrée : géo, verticale, statut, domaine de destination, dates. 1 token par annonce renvoyée (page par défaut 20).

02toolget_trends

Classements par géo, annonceurs, webmasters, apps, chronologie ou créatives qui scalent.

03toolsearch_webmasters

Réseaux d'affiliation avec volume par géo et pertinence par géo dominante.

04toolget_usage

Forfait, utilisées, restantes. Vérifier est gratuit — interrogez-le aussi souvent que vous voulez.

← retour à la connexionOAuth 2.0 · client_credentials · RFC 8707