keyword-fanout-map

Carte de Mots-Clés et Questions d'Approfondissement

Étape 1 sur 5. Produit la carte de mots-clés que toutes les compétences ultérieures liront, afin de ne rien avoir à répéter.

Avant de commencer

Requis : le connecteur DataForSEO. Sans lui, il n'y a pas de volumes de recherche réels et cette compétence ne ferait que deviner, ce qui est pire qu'inutile car les suppositions ressemblent à des données.

Vérifiez la présence d'un outil DataForSEO. S'il n'y en a pas, arrêtez-vous et dites :

Cette compétence a besoin de données de recherche réelles. Connectez d'abord DataForSEO : Personnalisation → Connecteurs → Ajouter un connecteur personnalisé → https://mcp.dataforseo.com/mcp → Connecter → approuver. Cela prend environ une minute, puis relancez cette compétence.

Lisez également site-brief.md depuis le Projet. Prenez SEARCH_COUNTRY, SEARCH_LANGUAGE, la zone de service, la liste des services et les concurrents à partir de ce fichier. S'il est manquant, dites-le et proposez d'exécuter d'abord site-brief-builder. Vous pouvez continuer sans lui, mais vous devez alors demander explicitement le pays et la langue et prévenir que les volumes ne sont corrects que pour les valeurs fournies.

Entrée

Un mot-clé seed, ou un type d'entreprise plus un lieu, ou simplement un sujet. Si l'utilisateur ne vous donne rien, proposez trois seeds à partir de la liste des services du brief.

Processus

Étape 1 : Expansion

Utilisez le connecteur DataForSEO. Les endpoints dont vous avez besoin, par chemin API :

• dataforseo_labs/google/keyword_ideas, l'expansion principale
• dataforseo_labs/google/related_keywords, voisins sémantiques
• keywords_data/google_ads/search_volume, volume, CPC, concurrence
• ai_optimization/ai_keyword_data/keyword_data, volume de recherche IA, c'est-à-dire la fréquence à laquelle les gens saisissent ceci dans un LLM plutôt que dans une barre de recherche
• serp/google/organic, qui se classe actuellement (optionnel mais améliore le rapport)

Les noms d'outils dans le connecteur correspondent à ces chemins. Choisissez l'outil correspondant par sa description plutôt qu'en supposant un nom exact.

Transmettez toujours le lieu et la langue du brief. Ne prenez jamais les États-Unis par défaut parce que c'est pratique.

Étape 2 : Filtrer et regrouper

Supprimez : les mots-clés avec un volume nul et un volume IA nul, les fautes d'orthographe évidentes, et les termes de marque appartenant à des concurrents.

Regroupez ce qui reste en clusters thématiques. Étiquetez chaque mot-clé avec une intention :

• informational, veut comprendre ("qu'est-ce que", "comment fonctionne")
• commercial, compare avant d'acheter ("meilleur", "vs", "avis")
• transactionnel, prêt à agir ("près de moi", "réserver", "acheter", "prix")
• navigationnel, cherche une marque spécifique

Attribuez ensuite à chaque mot-clé un rôle :

• primary, exactement un. Le sujet du H1.
• secondary, mérite son propre H2.
• support, à utiliser naturellement dans le corps du texte.
• skip, bon sujet, mauvaise intention pour cette page. Gardez-le visible pour que l'utilisateur puisse voir qu'il a été considéré et rejeté plutôt que manqué.

Choisissez le primary sur la correspondance d'intention, pas seulement sur le volume. Un mot-clé informationnel à 2400/mois est le mauvais primary pour une page de service, et le choisir est l'erreur de recherche de mots-clés la plus courante.

Étape 3 : Questions d'approfondissement

Obtenez les requêtes de suivi que les moteurs IA développent à partir de ce sujet :

• ai_optimization/llm_mentions pour les requêtes d'approfondissement attachées au sujet
• le bloc "Les gens demandent aussi" de l'endpoint SERP
• dataforseo_labs/google/related_keywords résultats sous forme de questions

Conservez celles auxquelles une seule page pourrait réellement répondre. Chacune devient un H2 avec une réponse de deux phrases directement en dessous. Supprimez tout ce qui appartient à une autre page et dites-le.

Sortie

Écrivez deux fichiers.

01-keyword-map.csv, colonnes exactement : cluster,keyword,intent,role,search_volume,ai_search_volume,competition,cpc Triez par rôle (primary, secondary, support, skip) puis volume décroissant. C'est le fichier que seo-content-writer lit, donc les noms de colonnes sont importants.

01-keyword-map.html, remplissez templates/keyword-map.html.template.

Construisez un data.json et lancez le rendu :

python3 scripts/render.py templates/keyword-map.html.template data.json 01-keyword-map.html

Forme de data.json :

{
  "tokens": { "SUBJECT": "...", "KW_TOTAL": 42, "...": "..." },
  "rows": {
    "KEYWORD_ROW": [{ "ROW_CLUSTER": "...", "ROW_KEYWORD": "...", "...": "..." }],
    "FANOUT_ROW": [{ "ROW_QUESTION": "...", "ROW_QUESTION_NOTE": "..." }],
    "SERP_ROW": [{ "ROW_POSITION": 1, "ROW_DOMAIN": "...", "...": "..." }]
  }
}

Notes sur les tokens :

• ROW_INTENT_CLASS doit être l'un de info, comm, trans, nav.
• Si vous avez sauté la vérification SERP, définissez SERP_TABLE_DISPLAY sur none et SERP_EMPTY_DISPLAY sur block. Sinon block et none.
• DATA_WINDOW est la fenêtre de volume, normalement "Moyenne sur 12 mois".
• DATA_NOTES doit indiquer le lieu et la langue utilisés. C'est ainsi que l'utilisateur détecte une exécution sur un mauvais marché.

Ne refaites pas le style du modèle. N'ajoutez pas de polices, couleurs ou graphiques.

Règles d'honnêteté

• N'écrivez jamais un volume que vous n'avez pas obtenu de l'API. Si un mot-clé n'a renvoyé aucun volume, affichez "pas de données", pas 0 et pas une estimation.
• Le volume de recherche IA est plus récent et plus restreint que le volume Google. Là où il est manquant, dites manquant plutôt que d'impliquer une demande nulle.
• Si le nombre total de mots-clés est faible parce que la niche est petite, dites-le. Une carte courte et honnête vaut mieux qu'une carte gonflée.

Remise

Terminez en disant à l'utilisateur :

Suivant : exécutez seo-content-writer. Il lit 01-keyword-map.csv tout seul, donc vous n'aurez pas besoin de répéter le mot-clé. Il vous posera trois questions, et l'une d'elles, seul vous pouvez y répondre.