Documentation
MCP et application ChatGPT
Connectez Claude, ChatGPT, Cursor ou n'importe quel client MCP aux 72 outils d'AutoPSEO pour Search Console, GA4, la recherche et le moteur de contenu, par connexion à votre compte ou par clé API.
AutoPSEO exploite un serveur MCP (Model Context Protocol) à l'adresse https://app.autopseo.com/mcp. Tout assistant compatible avec MCP sur HTTP peut s'y connecter, soit en se connectant à votre compte AutoPSEO, soit avec une clé API apk_live_. Il travaille alors avec les mêmes propriétés, les mêmes autorisations et le même forfait que vous. Le serveur déclare 72 outils répartis en trois groupes : les rapports Search Console et GA4, les données de recherche, et le moteur de contenu, grâce auquel votre propre IA peut rédiger des articles pour votre site.
Se connecter avec votre compte
Les outils qui prennent en charge la connexion MCP n'ont besoin d'aucune clé. Ajoutez l'adresse, connectez-vous à AutoPSEO quand l'outil vous le demande, puis validez : l'outil conserve ensuite son propre accès et le renouvelle lui-même.
- Claude Code : exécutez
claude mcp add --transport http autopseo https://app.autopseo.com/mcp, puis saisissez/mcp, sélectionnez autopseo et choisissez Authenticate. - Claude sur le web ou sur ordinateur : Settings → Connectors → Add custom connector, collez
https://app.autopseo.com/mcp, puis cliquez sur Connect et connectez-vous. - Cursor : ajoutez le serveur à
~/.cursor/mcp.json(tous les projets) ou à.cursor/mcp.json(un seul projet), puis utilisez le bouton Connect que Cursor affiche à côté.
{ "mcpServers": { "autopseo": { "url": "https://app.autopseo.com/mcp" } } }
Chaque outil connecté de cette façon apparaît sous Signed-in tools sur la page MCP & API, où Sign out coupe aussitôt son accès. Une bonne première requête : « Liste les propriétés Search Console de mon compte ». La réponse prouve que la connexion fonctionne et donne à l'assistant les noms exacts de propriétés dont les autres outils ont besoin.
ChatGPT
ChatGPT se connecte via son mode développeur, et la page MCP & API détaille la marche à suivre sous ChatGPT app. En bref : dans ChatGPT, ouvrez Settings → Apps & Connectors → Advanced settings et activez Developer mode (l'application cite les offres ChatGPT Plus, Pro, Business, Enterprise et Edu), choisissez Create, nommez le connecteur, définissez l'URL du serveur MCP sur https://app.autopseo.com/mcp et l'authentification sur OAuth, puis connectez-vous à AutoPSEO lorsque ChatGPT vous le demande. Les connecteurs de ChatGPT ne proposent que OAuth ou l'absence d'authentification : les clés API n'y fonctionnent donc pas. Vous trouverez plus de détails sur la page ChatGPT.
Se connecter avec une clé API
Les clés sont destinées aux scripts, aux tâches planifiées et aux machines sans navigateur. Dans MCP & API → API keys, nommez la clé et choisissez sa portée :
- Read only : interroger les données et lancer des rapports ; impossible d'ajouter, de modifier ou de supprimer quoi que ce soit.
- Read & write : tout ce que permet une clé en lecture, plus les outils qui modifient des données ou consomment des crédits de recherche.
La clé complète, apk_live_ suivi de 32 caractères hexadécimaux, n'est affichée qu'une seule fois ; AutoPSEO ne conserve que son empreinte SHA-256. La liste des clés indique la date de création de chacune, sa dernière utilisation et son nombre de requêtes, et Revoke désactive une clé immédiatement. Vous pouvez avoir jusqu'à 25 clés actives. Transmettez la clé sous la forme Authorization: Bearer apk_live_... (un en-tête x-api-key fonctionne aussi) :
claude mcp add --transport http autopseo https://app.autopseo.com/mcp --header "Authorization: Bearer apk_live_..."
La page propose aussi des exemples pour l'API OpenAI Responses, pour du JSON-RPC brut avec curl (le serveur utilise le transport Streamable HTTP) et pour l'API REST à l'adresse https://app.autopseo.com/v1, qui expose les 19 outils Search Console et GA4 avec les mêmes clés, ainsi qu'un document OpenAPI 3.1 à /v1/openapi.json.
Les outils
La page MCP & API liste toujours les noms d'outils à jour ; au moment de la rédaction de cette page, il y en avait 72.
Search Console et GA4 (19 outils)
list_properties, search_analytics, top_queries, top_pages, top_countries, compare_periods, content_decay, cannibalization, ctr_benchmark, page_poaching, rank_changes, new_lost_rankings, url_inspection, sitemaps, annotations, create_annotation, ga4_overview, ga4_breakdown et ga4_key_events. Ils ne coûtent aucun crédit. Sans dates précisées, ils couvrent les 28 derniers jours consolidés, comparés aux 28 jours précédents, et chacun peut les essayer sur la propriété de démonstration sc-domain:demo.autopseo.app. Malgré son nom, content_decay appartient à ce groupe : il repère les pages qui perdent des clics.
Recherche (33 outils)
- Compte et projets :
whoami,create_project,get_project_context,update_project_context - Mots-clés :
research_keywords,get_keyword_metrics,get_ranked_keywords,get_domain_keyword_suggestions,save_keywords,list_saved_keywords - Domaines, pages de résultats et liens :
get_domain_overview,get_serp_results,find_serp_competitors,get_backlinks_overview,get_backlinks_profile - Suivi de positions :
create_rank_tracker,get_rank_tracker,add_rank_tracking_keywords,remove_rank_tracking_keywords,estimate_rank_tracker_cost,run_rank_tracker - Recherche locale :
search_local_businesses,get_local_serp_results,get_local_rank_grid,get_business_profile,get_business_reviews,get_business_updates,get_google_business_questions,list_business_categories - Audits de site :
run_site_audit,get_audit_status,get_audit_issues,get_audit_pages
Bon nombre de ces outils achètent des données à DataForSEO et consomment vos crédits de recherche : gardez donc des requêtes ciblées et vérifiez avant de lancer de gros lots.
Moteur de contenu (20 outils)
Ils permettent à votre propre IA de travailler dans la même file que le rédacteur d'AutoPSEO : content_list_tasks, content_claim, content_get_brief, content_submit, content_publish, content_unpublish, content_get_page, content_report, content_find_pages, content_add_topics, content_decline, content_merge, content_cover, content_set_cover, content_get_translation, content_submit_translation, content_instructions, content_propose_value, content_submit_value et content_remove_path. Le serveur propose également cinq prompts : write-articles, optimize-page, revise-draft, connect-repo et refresh-decayed.
Une session type consiste à lister les tâches, à en réserver une (la réservation la bloque pendant deux heures), à lire le brief, à rédiger, à soumettre et à corriger ce que les contrôles renvoient, puis à ne publier que sur votre instruction. Les images de couverture et les traductions disposent chacune de leurs propres outils. Les articles rédigés ainsi passent les mêmes contrôles que ceux d'AutoPSEO et n'entament pas votre quota d'articles, bien que le premier appel pour un brief lise les résultats de recherche en direct en consommant des crédits de recherche. Le déroulé complet est décrit dans Rédiger avec votre propre IA.
Outils de lecture, d'écriture et payants
Chaque outil appartient à une classe d'accès. Les outils read se contentent de consulter (33 outils), les outils write modifient votre espace de travail (22) et les outils paid ne font que lire, mais achètent des données de recherche (17). Une clé en lecture seule ne peut appeler que les outils de lecture. Un membre d'équipe disposant de l'accès Read ne peut lui aussi appeler que les outils de lecture, quelle que soit la clé ou la connexion utilisée, et chaque membre n'accède qu'aux propriétés citées dans son invitation (Partage et accès d'équipe).
Limites et erreurs
Les appels sont limités à 60 par minute et par clé, et à 1 000 par heure et par compte, toutes clés confondues. Au-delà de l'une ou l'autre limite, le serveur répond par un HTTP 429 accompagné d'un en-tête Retry-After, et la plupart des clients patientent puis réessaient d'eux-mêmes ; les échanges initialize et ping ne comptent pas. Une fois l'essai terminé sans abonnement, les outils répondent « subscription required ». Le fournisseur d'un assistant ne reçoit vos données que pour les requêtes que vous effectuez ; déconnectez un outil ou révoquez sa clé pour y mettre fin. Vous trouverez d'autres exemples sur la page MCP de Search Console.