API et serveur MCP de Citevana

API REST

Toutes les réponses sont en JSON. Les réponses réussies contiennent "ok": true. Les outils gratuits renvoient un résumé en langage clair et une liste de tâches classée par importance, avec des estimations de durée.

Exemple de requête

curl -s https://citevana.com/api/v1/tools/ai-crawlers \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

curl -s https://citevana.com/api/v1/sites \
  -H "Authorization: Bearer $CITEVANA_API_KEY"

Erreurs

Toutes les erreurs suivent la même structure JSON, présentée ci-dessous. Les codes incluent invalid_request, invalid_url, blocked_host, fetch_failed, unauthorized, insufficient_scope, not_found, rate_limited et quota_exceeded.

{
  "ok": false,
  "error": {
    "code": "quota_exceeded",
    "message": "Daily api_calls quota reached."
  },
  "requestId": "req_…"
}

Limites et en-têtes

Chaque réponse décomptée contient X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset (secondes Unix). Une réponse 429 contient aussi Retry-After. Les appels avec clé sont décomptés du quota quotidien api_calls de votre espace de travail, et chaque clé peut avoir sa propre limite quotidienne, plus basse.

Les navigateurs peuvent appeler les outils gratuits depuis n’importe quel site sans clé. Les endpoints qui exigent une clé n’acceptent pas les requêtes de navigateur cross-origin : appelez-les depuis votre serveur.

Ajoutez ?locale=es, pt-BR, de, fr, ja, id, hi, tr, vi ou ar à un endpoint d’outil pour obtenir le résumé dans cette langue.

Source, vérifiée le 16 septembre 2026 : https://spec.openapis.org/oas/v3.1.1.html

Serveur MCP

Connectez n’importe quel client MCP compatible avec les serveurs distants à https://citevana.com/api/mcp. Il utilise le transport Streamable HTTP, répond en JSON et ne conserve aucune session.

• check_ai_crawlers — Quels robots d’IA de recherche, d’assistant et d’entraînement un site autorise. Gratuit.
• audit_page — Audit SEO on-page et de préparation à l’IA d’une URL. Gratuit.
• generate_llms_txt — Crée un fichier llms.txt à partir du nom du site, d’un résumé et de liens. Gratuit ; rien n’est téléchargé.
• get_site_audit_summary — Dernier audit d’un de vos sites. Nécessite une clé d’API avec read:audits.

Le serveur prend en charge la révision 2026-07-28 du protocole (métadonnées par requête et server/discover). Il accepte aussi la poignée de main initialize des révisions 2025-11-25, 2025-06-18 et 2025-03-26.

Les trois outils gratuits fonctionnent sans authentification. Pour get_site_audit_summary, votre client doit envoyer votre clé d’API dans un en-tête Authorization: Bearer. Citevana ne propose pas encore de connexion OAuth pour MCP.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "check_ai_crawlers",
    "arguments": {
      "url": "https://example.com"
    },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}

Source, vérifiée le 16 septembre 2026 : https://modelcontextprotocol.io/specification/2026-07-28/basic/transports/streamable-http

Autres clients MCP et vos propres agents

Si votre client permet de définir des en-têtes HTTP pour un serveur distant, ajoutez Authorization: Bearer suivi de votre clé pour activer get_site_audit_summary. Chaque appel est décompté du même quota quotidien api_calls que l’API REST.

Extension Chrome

L’extension Chrome de Citevana lance, via cette API, la vérification des robots d’IA et l’audit de l’onglet ouvert. Aucun compte n’est nécessaire ; avec une clé facultative, vous voyez les audits de vos propres sites. Elle est en préparation pour le Chrome Web Store.

Elle ne demande que les autorisations activeTab et storage, ainsi que l’accès à l’API Citevana. Elle n’envoie l’adresse de la page que lorsque vous cliquez sur une vérification, et jamais la chaîne de requête.

Source, vérifiée le 16 septembre 2026 : https://developer.chrome.com/docs/extensions/develop/concepts/activeTab

Sécurité et confidentialité

• Tous les outils sont en lecture seule. Rien n’est jamais modifié sur votre site.
• Le texte copié depuis les pages récupérées est marqué comme donnée non fiable, afin que les assistants d’IA ne suivent jamais les instructions qu’il contient.
• Nous ne récupérons que des pages publiques, en tant que CitevanaBot, et nous bloquons les adresses de réseaux privés et réservés.
• Nous ne stockons qu’un hachage SHA-256 de chaque clé d’API. La clé est affichée une seule fois et peut être révoquée à tout moment. La création et la révocation des clés sont consignées dans le journal d’audit.

CitevanaBot

Questions fréquentes

Sources

• https://modelcontextprotocol.io/specification/2026-07-28/basic/transports/streamable-http
• https://modelcontextprotocol.io/specification/2026-07-28/basic/versioning
• https://developers.openai.com/apps-sdk/deploy/connect-chatgpt
• https://developers.openai.com/apps-sdk/build/auth
• https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp
• https://spec.openapis.org/oas/v3.1.1.html
• https://developer.chrome.com/docs/extensions/develop/concepts/activeTab
• https://developer.chrome.com/docs/webstore/program-policies/policies