search-console
Skill6 starsChanged 12 days agoMITView on GitHub
Compte rendu SEO d'un site à partir de Google Search Console. Récupère les données par l'API, calcule ce qui est du signal et ce qui est du bruit (seuils calculés par script, jamais à l'œil), rend un tableau de bord HTML autonome, suit l'effet de chaque changement mis en ligne et finit par un calendrier de relecture. À utiliser quand on dit « fais-moi un compte rendu SEO de monsite.com », « rafraîchis le dashboard », « est-ce que mon changement de titre a marché ? », « pourquoi mes clics ont baissé ? », « qu'est-ce qui a bougé cette semaine ? », « mes pages sont-elles indexées ? », « analyse mes données Search Console », « branche-moi Search Console ».
9 other projects use a version of this.
Adopted by
Most recently taken up by
- vincentventalon/my-claude-skillsword for word, first seen Nov 15, 2026
- CrakSEO/crakseo-search-console-mcptheir own version, first seen Nov 15, 2026
- nowork-studio/notfair-plugintheir own version, first seen Nov 11, 2026
- oivanfelipe/claude-skillstheir own version, first seen Nov 8, 2026
- advisorppc-org/advisorseo-claude-plugintheir own version, first seen Nov 1, 2026
- Design-of-Man/claude-skillstheir own version, first seen Oct 30, 2026
Other versions9 projects use a version of this.
Word for word · 1
- vincentventalon/my-claude-skills★ 6100% same
Edited · 0
None found.
Wrote their own version · 8
- nowork-studio/notfair-plugin★ 4.2ksame name
- nowork-studio/toprank★ 4.1ksame name
- OpenClaudia/openclaudia-skills★ 731same name
- terryds/skills★ 1same name
- advisorppc-org/advisorseo-claude-plugin★ 0same name
- CrakSEO/crakseo-search-console-mcp★ 0same name
- Design-of-Man/claude-skills★ 0same name
- oivanfelipe/claude-skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
The file
Files
Search Console : le signal et le bruit
Tu lis les chiffres Search Console d'un site et tu dis ce qui a vraiment bougé. L'erreur à éviter : expliquer avec assurance un changement qui n'a pas eu lieu. La plupart des écarts d'une semaine à l'autre sont du hasard. Le seuil se calcule avant de regarder l'écart, et ce sont les scripts qui le calculent, pas toi.
Les scripts sont dans scripts/ à côté de ce fichier (<skill> ci-dessous : le dossier de base de la skill ; appelle-les par ce chemin, quel que soit le
dossier courant). Python 3 seul, aucune dépendance. Tout ce qui appartient au lecteur va dans
./seo/ du dossier courant : config.json, puis un dossier par site avec journal.csv,
groupes.csv, donnees/ et tableau-de-bord.html. Jamais dans le dossier de la skill. Seule
exception : ~/.config/search-console/dossiers.txt retient le dernier ./seo/ utilisé, pour
rafraîchir depuis n'importe où (l'effacer suffit pour l'oublier).
Déroulé
- Lance le script. Premier passage :
python3 <skill>/scripts/rapport.py monsite.com. Rafraîchir (« rafraîchis le dashboard ») :python3 <skill>/scripts/rapport.pysans site, il reprend tous les sites de./seo/, ou du dernier./seo/utilisé si on est ailleurs. Rafraîchir, c'est tout ce déroulé : le script remet un résumé générique, réécris-le à l'étape 4. Compte une minute. S'il répondERREURparce que l'accès Google n'est pas branché, guide l'utilisateur pas à pas avecreferences/installation.md: lance toi-même ce qui se lance sans lui (activer l'API, le projet de quota), et pour la connexion, qui ouvre son navigateur, dis-lui quoi valider. Une étape à la fois, puis relance le script. L'id du projet Google Cloud se pose dans./seo/config.json:{"projet_google_cloud": "mon-projet"}. - Lis le bloc imprimé (FENÊTRE, VOLUME, SEUIL, COUVERTURE, CHANGEMENTS, puis les verdicts). Chaque chiffre y porte déjà son seuil et son verdict. Tu ne refais aucun calcul de tête.
- Vérifie l'historique avant d'expliquer. Lis
journal.csv. Si le code du site est dans le dossier courant, lancegit log --since=<début de la fenêtre d'avant>; sinon, demande directement. Demande ce qui a changé et que le journal ne dit pas (titres, URL, redirections, contenu, déploiements). Propose de l'ajouter au journal, puis relance. - Écris le résumé en deux ou trois phrases : ce qui dépasse le seuil, et « non détectable »
pour le reste. Pose-le en tête de page sans rappeler l'API :
python3 <skill>/scripts/rapport.py monsite.com --resume "…"(il ne réimprime que la ligne TABLEAU, c'est normal). - Donne la page. Si tu as l'outil Artifact, publie
./seo/<site>/tableau-de-bord.htmlen Artifact. Sinon, donne son chemin absolu : elle s'ouvre hors ligne, aussi sur téléphone. - Finis par le calendrier : recopie le bloc CALENDRIER (quoi relire, quand, et pourquoi pas avant), puis rappelle que « rafraîchis le dashboard » suffit la semaine prochaine.
Le journal, c'est ta mémoire
journal.csv est ce qui reste d'un passage à l'autre (format : references/fichiers.md).
- Ajoute une ligne dès qu'un changement est en ligne : celui que l'utilisateur te décrit, et celui que tu fais toi-même dans le code du site pendant la session (un titre, une URL, une page, une redirection). Dis-lui que tu l'as noté et quand tu le reliras.
- Quand une ligne arrive à sa date de relecture, écris le verdict du script dans
constatet la date du jour dansconstat_le(entre guillemets si le texte a une virgule). La ligne sort du calendrier, et au passage suivant tu sais ce que ce changement a donné. - Avant de proposer un nouveau changement sur une page, relis ses lignes : ce qui a déjà été essayé, et ce que ça a donné.
Pour lire un cluster ou un type de page à part, remplis groupes.csv.
Les autres skills SEO du dépôt (seo-audit, competitors, keywords, internal-links)
écrivent dans le même ./seo/<site>/ et posent elles-mêmes une ligne dans journal.csv quand
elles mettent quelque chose en ligne : tu la retrouves ici au rafraîchissement suivant.
Le régime du site (le script le choisit sur les clics des 28 derniers jours)
- Établi (200 clics ou plus) : écart réel s'il dépasse 1,96 × √(avant + après).
- Petit (30 à 199) : seuil élargi, 1,96 × √(2,5 × (avant + après)), car un petit site varie plus que le hasard pur. Aucun verdict à la semaine sur les clics.
- Neuf (moins de 30) : dis-le franchement, les comparaisons ne sont pas lisibles à ce volume. Passe à l'indexation : pages indexées, « explorée, non indexée », « détectée, non explorée », requêtes qui apparaissent. Ce sont des faits oui ou non, lisibles tout de suite. Des impressions parties de presque zéro sont « pas comparables » : le site n'apparaissait pas avant, ce n'est pas une hausse mesurée.
Règles de lecture
- Seuil d'abord, écart ensuite. Sous le seuil, le verdict est « non détectable ». Ce n'est pas une version prudente de « ça monte » : c'est le verdict.
- Deux périodes de même durée, données finales seulement (Search Console a 2 à 3 jours de retard), semaines complètes du lundi au dimanche.
- Une semaine hors du seuil n'est pas une tendance. Relis la suivante avant d'agir.
- Beaucoup de pages testées d'un coup : quelques dépassements sortent par hasard. Une page ne compte qu'à |z| au-delà de 3.
- La position moyenne bouge dès que le mélange de requêtes change. Elle ne se compare que sur un panier fixe de requêtes. Le CTR ne se lit jamais à la semaine sur un petit site.
- Une ligne à moins de 10 impressions, c'est du bruit. « Position 1 sur 8 impressions » ne dit pas ce que la page tiendrait sur 500.
- La dimension requête ne montre qu'une partie des impressions (le script donne la part). Toute lecture par requête porte sur cette part, biaisée vers les grosses requêtes. Dis-le.
- Demande ou classement : sur les mêmes requêtes, des impressions qui baissent à position stable, c'est la demande qui baisse (saison, pays), pas le classement. Regarde aussi par pays et sur mobile seul.
- Sépare le stock des pages neuves : la montée des neuves peut cacher une baisse du stock.
- Impressions ordinateur qui s'effondrent ou explosent sans que les clics suivent : trafic sans humain ou changement côté Google. Ne cite alors ni CTR ni position du site, lis clics et mobile.
- Pays et appareil se lisent au niveau du site : croisés avec une page, l'API les tronque.
- Zéro impression ne veut pas dire zéro demande : Search Console ne voit que là où le site est déjà.
Après un changement
- Une ligne de journal par changement, datée du jour de la mise en ligne réelle (le déploiement, pas le commit), avec la requête ou la page visée et ce qu'on attend.
- Suis la cible, pas le total : un total qui monte peut cacher la requête visée qui s'effondre.
- Verdict au plus tôt 3 semaines après la mise en ligne, 4 pour l'accueil ou une page hub. À une semaine, c'est un test de fumée. Quatre issues seulement : amélioration détectable, pas de régression détectable, régression détectable (reviens en arrière), indécidable.
- Si le plus petit écart visible dépasse ce que le changement peut produire, annonce d'avance que seul « pas de régression » est mesurable.
- Un changement à la fois par page. Deux changements groupés ne s'attribuent pas ; revenir en arrière est le seul test de cause.
- Une URL renommée coupe son historique : l'ancienne garde ses impressions 2 à 4 semaines. Ne juge pas un groupe dont les URL ont changé dans la fenêtre, et n'empile rien sur une 301 fraîche. Pas de date dans une URL, pour ne jamais avoir à la renommer.
Clusters et cannibalisation
- Une requête servie par plusieurs pages est un constat de structure, prouvable. Qu'elle coûte des clics se prouve rarement. Écris les deux verdicts séparément ; corrige sur le premier sans le présenter comme le second.
- Une page outil et un article sur la même intention : Google en garde un, il ne partage pas.
- Avant de parler de cannibalisation, teste-la : si les deux pages baissent ensemble, ou si l'une disparaît sans que l'autre remonte, rien n'était volé.
Le détail, les chiffres de calibration et les règles de stratégie (hub et satellites, quand
découper, pages à portée) : references/regles.md.
Ce que tu rends
Le bloc d'en-tête tel que le script l'imprime, puis chaque affirmation avec son chiffre, son seuil et son verdict ; le lien ou le chemin du tableau de bord ; le calendrier. Rien qui ne dépasse le seuil n'est présenté comme une tendance, et aucune cause n'est donnée à un écart sous le seuil.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

