seo-google

Présentation de seo-google

Ce que fait seo-google

Le skill seo-google vous donne un accès direct aux API SEO de Google, au lieu de vous baser sur des prompts génériques ou des estimations de tiers. Il est conçu pour les personnes qui ont besoin de vraies données de terrain pour Search Console, PageSpeed Insights, CrUX, Indexing API et le trafic organique GA4, le tout dans un seul workflow.

Pour qui et pour quels usages

Utilisez le skill seo-google si vous devez vérifier l’indexation, inspecter des URL, comparer les impressions et les clics, auditer les Core Web Vitals avec de vraies données utilisateurs ou extraire les tendances du trafic organique depuis GA4. Il est particulièrement utile pour les équipes SEO, les SEO techniques, les équipes contenu et les agents qui ont besoin de preuves issues de Google avant de formuler des recommandations.

Ce qui le distingue

La valeur principale de seo-google n’est pas la théorie SEO généraliste, mais la donnée source de vérité. Le skill fait le lien entre l’analyse de crawl et les propres API de Google, ce qui permet de passer de « cette page a l’air correcte » à « Search Console montre un CTR faible » ou « CrUX indique un mauvais INP sur mobile ». Pour la prise de décision, il est donc plus solide qu’un simple prompt libre.

Quand seo-google est le bon choix

Choisissez seo-google lorsque la tâche dépend de vraies données Google, d’une configuration de compte ou de diagnostics appuyés par une API. Il est moins utile si vous voulez seulement brainstormer du contenu, trouver des idées de mots-clés sans accès à Google Ads, ou obtenir une explication SEO ponctuelle qui ne nécessite pas de données en direct.

Comment utiliser le skill seo-google

Installer et vérifier les prérequis

Pour l’étape seo-google install, ajoutez le skill via votre workflow de skills, puis vérifiez les identifiants avant de lancer l’analyse. Le repo attend la présence d’une authentification Google API, et la première dépendance concrète du skill est une configuration fonctionnelle dans ~/.config/claude-seo/google-api.json.

Partir avec la bonne forme d’entrée

Le pattern seo-google usage fonctionne mieux si vous fournissez une URL précise, une propriété ou un objectif clair. De bons exemples d’entrée : « Auditer https://example.com/pricing pour l’indexation et le CWV », « Comparer les requêtes GSC pour sc-domain:example.com sur les 28 derniers jours », ou « Vérifier les landing pages organiques GA4 pour la section blog ». Évitez les demandes floues comme « améliore mon SEO », car les API ont besoin d’une cible et d’une plage de dates.

Lire d’abord ces fichiers

Pour un guide seo-google fiable, consultez d’abord SKILL.md, puis references/auth-setup.md, references/search-console-api.md, references/pagespeed-crux-api.md et references/ga4-data-api.md. Si votre tâche implique des notifications ou des flux submit/inspect, lisez aussi references/indexing-api.md; pour la recherche de mots-clés, utilisez references/keyword-planner-api.md.

Un workflow qui donne de meilleurs résultats

Un workflow pratique consiste à : confirmer l’authentification, identifier la source de données, définir la propriété ou l’URL, choisir une fenêtre de dates, puis ne demander que les métriques nécessaires. Exemple : « Avec seo-google, vérifie Search Analytics GSC pour sc-domain:example.com sur les 28 derniers jours, fais ressortir les pages avec beaucoup d’impressions mais un CTR faible, et explique quels titres il faudrait probablement réécrire. » C’est préférable à une revue SEO trop large, parce que cela indique au skill quoi récupérer et comment cadrer la sortie.

FAQ du skill seo-google

seo-google sert-il uniquement à Search Console ?

Non. Search Console est au cœur du skill, mais seo-google couvre aussi PageSpeed Insights, CrUX, Indexing API et les données organiques GA4. C’est important si vous voulez un seul skill pour l’indexation, la performance et le diagnostic du trafic, plutôt que des prompts séparés.

Faut-il à la fois une clé API et un service account ?

En général oui pour couvrir l’ensemble des usages. L’accès par clé API suffit pour PageSpeed Insights et CrUX ; Search Console, Indexing API et GA4 exigent un service account. Le skill est le plus utile quand les deux sont configurés.

Peut-on utiliser seo-google pour la recherche de mots-clés ?

Oui, mais avec une limite : la recherche de mots-clés via seo-google dépend de l’accès à Google Ads/Keyword Planner, qui est plus complexe que pour les autres API. C’est surtout utile si vous avez besoin de volumes ou de données de prévision issues de Google, pas si vous cherchez seulement des idées de sujets rapides.

Quand ne faut-il pas utiliser ce skill ?

N’utilisez pas seo-google si vous n’avez pas les identifiants nécessaires, si vous ne disposez pas d’une propriété vérifiée ou si vous avez seulement besoin d’une checklist SEO générique. Ce n’est pas non plus le meilleur choix pour générer du contenu, car sa force réside dans les preuves appuyées par des API, pas dans la rédaction.

Comment améliorer le skill seo-google

Donner au skill un contexte qui permet de décider

Le moyen le plus rapide d’améliorer les résultats est d’indiquer le type de propriété, le motif d’URL, la plage de dates, le focus appareil et l’indicateur de succès. Par exemple : « CWV mobile sur les pages /blog/ », « pages GSC avec plus de 1 000 impressions et un CTR inférieur à 2 % », ou « trafic organique GA4 sur les 90 derniers jours en excluant les landing pages brandées ». Cela permet à seo-google de renvoyer des segments actionnables plutôt que des résumés trop larges.

Demander un seul axe d’analyse à la fois

Le skill fonctionne mieux quand vous séparez indexation, positions, Core Web Vitals et trafic en tâches distinctes. Une demande comme « vérifie l’inspection d’URL, puis GSC, puis GA4 » produit souvent une sortie brouillonne ; mieux vaut demander d’abord un seul axe, puis itérer à partir de ce qu’il révèle.

Surveiller les modes d’échec fréquents

Les blocages les plus courants sont l’absence d’authentification, un mauvais format de propriété et le fait de demander au skill d’inférer des données qu’il ne peut pas récupérer. Un autre problème fréquent est la requête de mots-clés trop large, sans assez de termes de départ ou sans identifiants Google Ads. Si vous voulez que seo-google aide à faire de la recherche de mots-clés, précisez si vous avez besoin d’idées, de volumes historiques ou de prévisions.

Itérer à partir des preuves, pas de l’intuition

Après le premier résultat, affinez avec l’anomalie exacte que vous avez observée : « Pages avec beaucoup d’impressions mais peu de clics », « URL avec un INP mauvais uniquement sur mobile », ou « échecs d’indexation pour des pages publiées récemment ». Cela transforme seo-google en boucle de diagnostic et rend le second passage bien plus utile qu’un audit générique unique.