Connecter Search Console à Claude Code en une commande
Claude Code
Pour connecter Search Console à Claude Code, ajoutez PaidSync.ai : lancez claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp, tapez /mcp et connectez-vous avec vos identifiants PaidSync.
Claude Code accède ensuite à vos propriétés Search Console via 6 outils : clics, impressions, CTR et position par requête, page, pays et appareil, plus la couverture d'indexation des sitemaps. Claude Code demande avant d'exécuter chaque outil.
Niveau suivi. Search Console est en lecture seule dans PaidSync, donc Claude Code lit vos données de recherche et ne change rien.
La commande
Claude Code communique avec des serveurs MCP distants via Streamable HTTP. PaidSync en fait partie. Ajoutez-le une fois et le terminal qui édite votre code peut aussi suivre et gérer vos campagnes Search Console.
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpPar défaut, cela enregistre le serveur pour le projet courant seulement. Ajoutez --scope user pour le rendre disponible dans tous les projets de votre machine.
Exécutez claude mcp list pour confirmer qu'il est là, puis lancez une session et tapez /mcp pour vous connecter.
Configuration en 5 étapes
1Inscrivez-vous sur paidsync.ai/signup
Cela prend 10 secondes. Connexion avec Google ou e-mail. Le forfait gratuit offre 100 tâches par mois, d'une valeur de $50, à $0, sans carte.
2Connectez Search Console dans le tableau de bord PaidSync
Cliquez sur Connecter pour Search Console et connectez-vous avec le compte Google qui a accès à vos propriétés. Search Console s'autorise via Google OAuth, et PaidSync ne voit jamais votre mot de passe Google.
Déjà dans Claude Code ? Demandez-lui d'exécuter connect_google_search_console. L'outil renvoie un lien à ouvrir dans votre navigateur.
3Choisissez le compte publicitaire sur lequel Claude Code doit travailler
Dans une session, list_gsc_properties affiche toutes les propriétés que votre identifiant Google peut ouvrir. Nommez la propriété dans votre prompt.
4Ajoutez PaidSync à Claude Code
Dans votre terminal, lancez :
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpDémarrez une session, tapez /mcp, choisissez paidsync et connectez-vous avec votre compte PaidSync dans la fenêtre du navigateur qui s'ouvre. Claude Code stocke le jeton OAuth pour vous. Aucune clé n'est collée nulle part.
Vous configurez pour une équipe ? Validez un .mcp.json à la racine du dépôt pour que chaque ingénieur ait le même connecteur :
{
"mcpServers": {
"paidsync": { "type": "http", "url": "https://mcp.paidsync.ai/mcp" }
}
}Vous préférez une clé API, par exemple pour des exécutions sans interface ? Envoyez-la dans un en-tête, jamais dans l'URL, où elle finirait dans les journaux :
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp --header "Authorization: Bearer $PAIDSYNC_API_KEY"Dans un .mcp.json validé, ajoutez "headers": { "Authorization": "Bearer ${PAIDSYNC_API_KEY}" } pour que la clé reste dans l'environnement de chaque ingénieur et n'entre jamais dans git. Appliquer un changement à Google Ads exige toujours la connexion OAuth. Sur les autres plateformes, une clé peut aussi appliquer des changements, donc traitez-la comme un mot de passe et préférez OAuth.
5Testez la connexion
Dans une session Claude Code, demandez : “Quelles sont mes 20 principales requêtes organiques par clics ce mois-ci, avec la position moyenne de chacune”
Claude Code renvoie clics, impressions, CTR et position moyenne pour chaque requête. La connexion est active.
Le forfait gratuit comprend 100 tâches par mois. Pro à partir de $99 par mois, Team à partir de $249.
Prompts Search Console dans Claude Code
Chaque prompt ci-dessous correspond à des outils du groupe Search Console de PaidSync. Claude Code choisit l'outil. La dernière colonne indique si l'appel peut modifier quelque chose dans le compte publicitaire.
| Demande | Outils appelés | Modifie votre compte ? |
|---|---|---|
| “Liste mes propriétés Search Console” | list_gsc_properties | Non |
| “Quelles sont mes 20 principales requêtes organiques par clics ce mois-ci” | get_gsc_search_analytics | Non |
| “Quelles pages obtiennent beaucoup d'impressions mais un faible taux de clics” | get_gsc_search_analytics | Non |
| “Combien d'URL de mes sitemaps sont indexées” | get_gsc_index_coverage | Non |
| “Compare mes performances organiques ce mois-ci avec le même mois l'an dernier” | get_gsc_search_analytics | Non |
| “Quels mots-clés Google Ads est-ce que je paie alors que je suis déjà dans le top cinq” | analyze_paid_organic_overlap | Non |
| “Ventile mes clics et impressions organiques par pays sur les 90 derniers jours” | get_gsc_search_analytics | Non |
Exécuter sans interface avec claude -p
L'option -p lance Claude Code sans la session interactive. Connectez-vous une fois via /mcp et le jeton OAuth stocké est repris. Un rapport qui atterrit dans un fichier ressemble à ceci :
claude -p "Pull last 28 days Search Console top queries by clicks and list the pages with high impressions and low CTR." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/search-console-$(date +%F).jsonLes lectures s'exécutent directement, et les écritures aussi. --allowedTools "mcp__paidsync" autorise tous les outils PaidSync, écritures comprises, sans invite.
Pour une tâche sans surveillance, n'autorisez que les outils de lecture nécessaires, chacun par son nom sous la forme mcp__paidsync__tool_name.
Ce qui se lit et ce qui s'écrit
Search Console est en lecture seule dans PaidSync : aucun des 6 outils Search Console ne peut écrire.
Ils couvrent la liste des propriétés, les analyses de recherche par requête, page, pays et appareil, et la couverture d'indexation des sitemaps. Search Console conserve 16 mois de données.
Lire la suite
Via MCP, l'étape d'approbation est l'invite propre à Claude Code. Il demande une confirmation avant d'exécuter un outil, sauf si vous l'avez autorisé avec --allowedTools ou dans vos paramètres. PaidSync ajoute des contrôles de son côté. Les suppressions, mises en pause et changements de budget exigent confirm_destructive, et un contrôle de règles avant écriture bloque les arguments dangereux. La carte d'approbation, et l'annulation sur une carte appliquée dont la modification a un inverse sûr, ne s'appliquent que dans l'espace de travail PaidSync.
Ajouter à ChatGPT : ouvrez PaidSync.ai dans l'annuaire des plugins de ChatGPT, installez-le, puis connectez-vous.
Ajouter à Claude : ouvrez PaidSync.ai dans l'annuaire des connecteurs de Claude, cliquez sur Connecter, puis connectez-vous.
Limites de Claude Code sur Search Console
- PaidSync ne modifie jamais votre propriété. L'API de Google peut aussi soumettre des sitemaps et ajouter des sites ; PaidSync ne le fait pas.
- PaidSync ne lit ni le rapport d'indexation des pages ni l'inspection d'URL.
- Les analyses de recherche reviennent avec une ventilation par requête, par exemple par pays ou par appareil.
- La couverture d'indexation des sitemaps compare les nombres de pages soumises et indexées pour chaque sitemap.
- Les comparaisons payant et organique exigent aussi que Google Ads soit connecté.
Questions fréquentes
Comment connecter Search Console à Claude Code ?
Inscrivez-vous sur paidsync.ai, connectez Search Console dans le tableau de bord, puis exécutez claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp dans votre terminal. Tapez /mcp dans une session, choisissez paidsync et connectez-vous avec votre identifiant PaidSync.
Claude Code peut-il modifier ma propriété Search Console ?
Non. Search Console est en lecture seule dans PaidSync. Claude Code lit vos données de recherche et ne modifie jamais votre propriété.
Claude Code peut-il comparer Search Console avec Google Ads ?
Oui. Avec Google Ads également connecté, analyze_paid_organic_overlap estime la dépense mensuelle sur les mots-clés où vous êtes déjà dans le top cinq, et Claude Code peut comparer les principales requêtes organiques à vos mots-clés payants.
Cela fonctionne-t-il en mode sans interface avec claude -p ?
Oui. Une fois connecté via /mcp, claude -p réutilise le jeton OAuth stocké. Les lectures s'exécutent directement. Les écritures demandent de la prudence. Personne n'est là pour répondre à l'invite de Claude Code : tout outil d'écriture que vous avez autorisé avec --allowedTools s'exécute donc directement. Pour une tâche sans surveillance, n'autorisez que les outils de lecture nécessaires.
Est-ce gratuit ?
Oui. Le forfait gratuit coûte $0 pour 100 tâches par mois, sans carte. Pro démarre à $99 par mois et Team à $249 par mois.
Rapports Search Console. Une commande dans Claude Code.