REST + MCP

L’API REST et le serveur MCP.

Créez une clé dans votre espace. Lisez la liste des outils. Appelez un outil avec les paramètres décrits par son schéma JSON.

Démarrer

  1. Créez une clé personnelle dans Clés API.
  2. Appelez GET /v1/tools pour obtenir le nom et les paramètres de chaque outil.
  3. Appelez POST /v1/execute avec un outil du catalogue.
Gérer mes clés

REST API

API : https://api.tagavo.com

TAGAVO_URL="https://api.tagavo.com"
curl "$TAGAVO_URL/v1/execute" \
  -H "Authorization: Bearer $TAGAVO_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: research-unique-request-001" \
  --data '{"tool":"TOOL_FROM_CATALOGUE","arguments":{}}'

Remplacez TOOL_FROM_CATALOGUE par le nom d’un outil et mettez ses paramètres obligatoires dans arguments. Envoyez une Idempotency-Key unique par analyse (16 à 128 caractères : lettres, chiffres, - ou _). La clé API et la connexion au compte sont deux moyens d’accès distincts.

RouteUsage
GET /v1/toolsListe des outils et leur JSON Schema
POST /v1/executeLance une analyse. En-tête Idempotency-Key obligatoire
GET /v1/historyVos analyses passées
GET /v1/usageCompteurs d’usage et limites
GET /v1/watchlistRecherches enregistrées et état de leur suivi
GET /v1/export?id=REQUEST_ID&format=csvRésultat d’une analyse en CSV (ou format=json)
POST /v1/reportsRapport JSON ou PDF à partir de 1 à 10 de vos analyses réussies
GET /v1/alertsVos alertes de changement

OpenAPI 3.1 ↗

Rapports et suivi

POST /v1/reports réunit de 1 à 10 de vos analyses réussies, désignées par leur requestId. Choisissez kind (niche, tags ou seo), format (json ou pdf) et locale (fr ou en). Le rapport relit les résultats enregistrés : il ne lance aucune nouvelle analyse. Une partie sans données est signalée comme manquante. Le rapport ne garantit ni ventes ni bénéfice. Une analyse qui n’est pas à vous renvoie 404. Une analyse sans résultat réussi renvoie 409.

GET /v1/alerts renvoie vos alertes, les plus récentes d’abord (50 par défaut, 100 au plus). Chaque alerte donne la recherche, la date et chaque chiffre avant et après. Activer le suivi, lancer une vérification et marquer une alerte comme lue se font depuis le site. Avec une clé API, ces actions renvoient 403.

MCP

https://api.tagavo.com/mcp

Point d’entrée HTTP : /mcp. Authentifiez-vous avec votre clé personnelle en Bearer. Le protocole MCP 2026 utilise server/discover, tools/list et tools/call, sans initialize. Utilisez un SDK compatible : il fournit les en-têtes et métadonnées requis. Les anciens clients peuvent négocier 2025-11-25 avec initialize. tools/list renvoie seulement les outils actifs.

Dans tools/call, mettez les paramètres de l’outil dans input et ajoutez un idempotencyKey unique. Le schéma de chaque outil figure dans la réponse de tools/list.

Relancer sans lancer deux analyses

Une réponse 202 donne le requestId de votre analyse en attente ou en cours. Lisez GET /v1/history?id=REQUEST_ID pour suivre ce même résultat, sans nouvelle analyse. Attendez au moins 5 secondes entre lectures, puis espacez-les si nécessaire. Respectez Retry-After après une réponse 429 ou 503. Après une coupure sans requestId, reprenez la même requête avec la même clé d’idempotence. Si le résultat reste unknown, relisez son état avec le même identifiant. Une nouvelle clé lancerait une autre analyse. La même clé avec des paramètres différents renvoie 409.

Un échec confirmé restitue les crédits réservés. Les tentatives restent soumises aux protections de débit et contre les abus. Un résultat incertain garde sa réservation pendant vérification. Une donnée indisponible n’est jamais remplacée par une valeur inventée.