L'API Spytrend,
en direct.

Les 22 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.

Guide machine (llms.txt)Voir le curl

[ DÉMARRAGE RAPIDE ]

De zéro au premier 200.

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

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

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

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 sans compte démarrent avec un pool partagé de 500 tokens par réseau source (/24) : 1 jeton par ligne livrée ; médias d’une annonce 1, médias d’un créatif 10, annonce multilingue 50, ligne TikTok 10. Le prix est multiplié par le nombre de filtres de la requête (minimum 1). Avant un appel payant, l'outil gratuit estimate_cost indique à l'agent combien de jetons il coûtera.

[ 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