HTTP · OAuth 2.0 · MCP
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 ]
OAuth 2.0 client_credentials standard. Trois appels et vous y êtes.
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"}'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'
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 ]
Le catalogue complet est sur la page de connexion. Voici ceux que la plupart des équipes branchent en premier.
search_adsRecherche d'annonces filtrée : géo, verticale, statut, domaine de destination, dates. 1 token par annonce renvoyée (page par défaut 20).
get_trendsClassements par géo, annonceurs, webmasters, apps, chronologie ou créatives qui scalent.
search_webmastersRéseaux d'affiliation avec volume par géo et pertinence par géo dominante.
get_usageForfait, utilisées, restantes. Vérifier est gratuit — interrogez-le aussi souvent que vous voulez.