Outil de collecte du noyau sémantique

Collectez, nettoyez, clusterisez et enrichissez le pool de mots-clés d'un projet : Wordstat, clusters de SERP, fréquence exacte, plan hors ligne avant tout appel payant.

Essayez

Noyau sémantique SpiderHead : la barre d'étapes gratuites et payantes et le plan hors ligne d'une étape payante.

Treize étapes, un seul noyau cumulatif

Chaque étape modifie un statut et en consigne la raison : une requête n'est jamais supprimée et chaque décision reste explicable. Les étapes gratuites s'intercalent entre les étapes payantes, ce qui vous laisse vérifier le pool avant d'acheter la réponse suivante.

  • GratuitGratuit, s'exécute en local
  • PayantAppel payant à un fournisseur
  • WebPages web publiques, sans quota fournisseur
  1. Gratuit

    Import

    Apportez ce que vous avez déjà : un CSV ou une feuille d'un XLSX. Associez query, frequency, group, subgroup, URL et comment, puis choisissez add, update ou replace. L'aperçu montre les lignes nouvelles, existantes et en doublon avant toute écriture.

    phrases
  2. Payant

    Collecte · Yandex Wordstat

    Développe vos requêtes de départ par région et redéveloppe les requêtes fortes jusqu'à la profondeur définie. La file est dédupliquée, et --resume reprend une exécution interrompue sans redemander la même requête.

    phrases, expansions, provenance
  3. Gratuit

    Nettoyage

    Applique les filtres du projet (intention, mots vides, motifs informationnels), signale les valeurs aberrantes de fréquence et regroupe les requêtes par lemme. Une requête avec des impressions ou des positions observées n'est jamais écartée par les règles de fréquence.

    status, route, lemma group
  4. Gratuit

    Graphe

    Construit un graphe de mots du pool. Les candidats homonymes vont en revue et les clusters candidats arrivent dans anomalies.md, avant que vous payiez quoi que ce soit d'autre.

    anomalies.md
  5. Gratuit

    Correspondance avec le site

    Une requête n'a sa place dans le noyau que si le site la propose. Les requêtes sans aucun terme de catalog.txt partent en revue comme hors catalogue.

    review list
  6. Payant

    Clustering · Yandex Search API

    Récupère un top 10 par requête et le met en cache : une nouvelle exécution ne paie que les nouvelles requêtes. Les requêtes qui partagent des pages forment un cluster ; --method louvain regroupe les résultats en cache pour casser les longues chaînes.

    SERP cache, clusters, landing candidates
  7. Gratuit

    Pertinence

    Si aucun site de votre type listé dans vendors.txt n'apparaît dans le top 10 d'une requête, le sujet est probablement hors périmètre. La requête part en revue ; rien n'est supprimé.

    review list
  8. Gratuit

    Concurrents

    Lit les résultats en cache : quels domaines tiennent vos clusters et quels mots ils emploient dans les titres. Les candidats vont dans synonyms.txt.

    competitors.md, synonyms.txt
  9. Web

    Analyse des pages

    Ouvre les pages de concurrents les plus fréquentes dans les résultats collectés et lit leur title, leur description, leur H1 et leurs premiers titres H2. Les expressions thématiques de deux ou trois mots vont dans synonyms.txt.

    competitor_mining.md, synonyms.txt
  10. Payant

    Synonymes · Yandex Wordstat

    Vérifie les candidats de synonyms.txt. Seules les requêtes qui ont de la demande rejoignent le noyau ; ensuite, collect --resume fait grandir le pool à partir d'elles.

    checked phrases
  11. Payant

    Fréquence exacte · Arsenkin

    Achète la fréquence exacte !W une seule fois par groupe de lemmes, à la fin, quand le pool a cessé de bouger. Au-delà du seuil de budget du projet, --yes est nécessaire.

    exact frequency, task receipts
  12. Gratuit

    Rapport et Excel

    report.md et clusters.csv pour la lecture, un classeur XLSX (Summary, Core, Info, Clusters, Rejected) pour le client, pool.csv et pool.json pour d'autres outils.

    report.md, XLSX, CSV, JSON
  13. Gratuit

    Page cible et insights

    Après le lancement, choisissez la page cible de chaque cluster parmi des candidates mesurées, puis lisez les signaux hebdomadaires par cluster à partir de vos données locales Search Console, Webmaster et Metrika et transformez ceux que vous retenez en tâches de checklist.

    landing, weekly signals, tasks

La boucle qui fait grandir le noyau

Le noyau ne se collecte pas en une fois. Les concurrents et l'analyse des pages alimentent de nouveaux candidats, les synonymes les vérifient, la collecte reprend et le clustering repasse. La fréquence exacte s'achète en dernier.

  1. collect
  2. clean · graph · site match
  3. cluster
  4. competitors · mine
  5. synonyms
  6. collect --resume
  7. exact, once
  8. report

D'où viennent les données

Le pipeline de collecte s'appuie sur les données Yandex. La demande Google, le suivi de positions et les analyses de recherche sont des commandes distinctes du toolkit, qui fonctionnent à côté du noyau.

Dans le pipeline

Payant

Yandex Wordstat

collect · synonyms

Fréquence de base, affinages et requêtes similaires via l'API Yandex Cloud. Clé d'API et ID de dossier ; quota horaire.

Payant

Yandex Search API

cluster

Un top 10 par requête et par région, mis en cache avec son heure de récupération et sa région. Uniquement le point d'accès asynchrone.

Payant

Arsenkin

exact

La fréquence exacte !W que l'API Wordstat ne fournit pas. Facturée à la création de la tâche ; le task_id est conservé, donc un résultat en timeout est récupéré de nouveau, pas racheté.

À côté du noyau

Payant

DataForSEO

google-keywords

Volume de recherche Google, concurrence et expansion de requêtes de départ. Sandbox par défaut.

Payant

Wordstat à l'unité

keywords-expand · keywords-seasonality · regions-tree

Développez une requête, lisez sa demande mois par mois, parcourez l'arbre des régions (l'arbre est gratuit).

Gratuit

Topvisor

topvisor-read

Lit les projets, les mots-clés et l'historique de positions enregistré depuis votre compte existant. Les vérifications payantes ne peuvent pas être lancées depuis le toolkit.

Gratuit

Search Console · Webmaster · Metrika

semantics insights

Signaux hebdomadaires par cluster à partir de données que le toolkit a déjà synchronisées en local. L'étape insights elle-même n'effectue aucun appel à un fournisseur.

Payez une fois, voyez le plan d'abord

Chaque étape payante a un plan hors ligne : la région, le moteur, la source des requêtes et un plafond de requêtes ou de tâches. Un plan ne crée aucun client de fournisseur.

Un plan avant chaque appel payant

--dry-run --json affiche le plan. L'exécution elle-même exige --confirm-paid, même si l'estimation est nulle.

Des reçus, pas de nouvelles tentatives

Les tentatives Wordstat, les récupérations de SERP et les tâches Arsenkin sont réservées avant l'appel. Une requête ambiguë n'est jamais renvoyée automatiquement.

Des caches qui restent

Les SERP en cache et les reçus payants survivent à un remplacement du pool : relancer le clustering ne paie donc que les nouvelles requêtes.

Un seul journal des dépenses

Chaque débit arrive dans spend-report avec le projet sémantique et l'étape auxquels il se rattache.

Quand le prix d'un fournisseur ne peut pas être établi hors ligne, le plan le dit au lieu d'inventer un chiffre.

Import et export

Entrée

  • CSV ou XLSX, une feuille sélectionnée ; en-têtes associés automatiquement quand il n'y a pas d'ambiguïté
  • Champs : query, frequency, group, subgroup, URL, comment, ainsi que base, quoted, exact, impressions et positions Yandex/Google
  • Un chemin Category / Cluster est scindé en group et subgroup
  • add conserve les requêtes existantes, update applique les champs fournis, replace remplace le pool et est refusé s'il est vide
  • Entrée bornée : 32 Mio par fichier, 100 000 lignes, 128 colonnes

Sortie

  • Classeur XLSX : Summary, Core, Info, Clusters avec concurrents, Rejected
  • Synthèse report.md et matrice clusters.csv
  • pool.csv et pool.json pour d'autres outils
  • Périmètre : tout le noyau, un cluster (--cluster) ou les clusters sans page cible (--scope no-landing)
  • Un essai à blanc liste d'abord les fichiers exacts et le nombre de lignes

Sortie réelle de la CLI

Capturée depuis le projet d'exemple synthétique livré avec le toolkit. Ses requêtes sont en russe, comme la demande sur Yandex, et ses fréquences sont inventées. Aucun appel payant n'a été effectué.

Les étapes gratuites, l'une après l'autre
$ seohead semantics clean --project ./core
$ seohead semantics graph --project ./core
$ seohead semantics sitematch --project ./core
clean: kept=34 review=4 dropped=3 | lemma groups=41 (median base=720, outlier>36000)
graph: homonyms=0, to review=0, candidate clusters=7 -> anomalies.md
sitematch: catalog terms=11 | off-catalog->review=8 | kept and matching the site=26
Le plan hors ligne d'une étape payante
$ seohead semantics cluster --project ./core --dry-run
"mode": "estimate", "stage": "cluster", "paid": true,
"provider": "yandex_search",
"request_estimate": {"unit": "requests", "count": 26, "kind": "upper_bound"},
"money_estimate": null,
"money_unavailable_reason": "provider pricing is not available from this offline preflight",
"paid_calls_made": 0
Où en est le noyau
$ seohead semantics status --project ./core
dropped=3 | kept=26 | review=12 | _total=41 | _exact=0 | _expanded=0 | _clusters=0
provider units: {'yandex_requests': 0, 'arsenkin': 0}
next: seohead semantics exact --project ./core
Plan d'export, rien n'est écrit
$ seohead semantics export --project ./core --scope no-landing --dry-run
"mode": "preview", "scope": "no-landing", "rows": 41,
"planned_files": ["core/semantics/pool.csv", "core/semantics/pool.json"]
bash
seohead semantics status --project ./my-core

Commencez par installer : guide d'installation. Chaque commande fonctionne aussi comme outil MCP pour les agents IA.

Ce qu'il vous faut

  • Trois à dix requêtes de départ et les filtres du projet dans project.yaml
  • catalog.txt avec les rubriques du site, vendors.txt avec des sites de votre type
  • Clé d'API et ID de dossier Yandex Cloud pour Wordstat et l'API Search
  • Un jeton Arsenkin pour la fréquence exacte, uniquement à la fin
  • En option : une liste de mots-clés existante en CSV ou XLSX

Limites

  • La collecte et le clustering reposent sur les données Yandex ; la demande Google passe par la commande distincte google-keywords
  • Le coût n'est pas estimé hors ligne quand le prix du fournisseur est inconnu ; le plan le dit
  • Les pages cibles candidates exigent un clustering de SERP et le domaine du projet
  • Les insights ne lisent que des données déjà synchronisées dans la base locale des sources

Confiez le noyau à un agent

Dix outils MCP exposent les mêmes étapes et les mêmes lectures. Un appel payant renvoie le plan et exige confirm_paid=true pour lancer le travail.

  • seo_semantics_statusCompteurs, unités du fournisseur et étape suivante
  • seo_semantics_runÉtapes gratuites
  • seo_semantics_minePages de concurrents, sans quota fournisseur
  • seo_semantics_paidÉtapes payantes : le plan d'abord, puis confirm_paid=true
  • seo_semantics_clustersListe paginée des clusters
  • seo_semantics_cluster_showUn cluster avec ses preuves de page cible
  • seo_semantics_cluster_queriesRequêtes d'un cluster avec le top 10 conservé
  • seo_semantics_set_landingAttribuer ou retirer une page cible
  • seo_semantics_insightsSignaux hebdomadaires par cluster et par source
  • seo_semantics_insights_tasksSignaux retenus transformés en tâches de checklist

Questions

Collecte-t-il des mots-clés Google ?
Pas dans le pipeline de collecte : il repose sur Yandex Wordstat, l'API Yandex Search et Arsenkin. Le volume de recherche Google et l'expansion de requêtes de départ viennent de la commande distincte google-keywords via DataForSEO, et vous pouvez importer des positions Google dans le noyau sous forme de colonne.
Quelles étapes coûtent de l'argent ?
collect et synonyms (Yandex Wordstat), cluster pour les requêtes sans top 10 en cache (API Yandex Search) et exact (Arsenkin). mine lit des pages publiques de concurrents et n'utilise aucun quota de fournisseur. Tout le reste est gratuit et s'exécute en local.
Une exécution peut-elle me facturer deux fois ?
Le toolkit est conçu pour l'éviter. Les requêtes payantes sont réservées avant l'appel, une requête interrompue n'est pas renvoyée automatiquement, un résultat Arsenkin déjà payé est récupéré de nouveau via son task_id, et les résultats en cache restent quand vous remplacez le pool.
Des requêtes sont-elles supprimées ?
Non. Une étape change le statut d'une requête (kept, review, dropped, etc.) et enregistre la raison et l'étape. Vous pouvez toujours voir pourquoi une requête a quitté le noyau et la remettre.
Puis-je partir d'une liste de mots-clés existante ?
Oui. Importez un CSV ou une feuille XLSX en associant vos colonnes à query, frequency, group, subgroup, URL et comment. Les positions et les impressions importées protègent une requête des coupes par fréquence.
Comment la page cible d'un cluster est-elle choisie ?
Après un clustering de SERP, et seulement si le domaine du projet est connu, chaque URL candidate est notée selon la part des requêtes du cluster dont le top 10 la contenait. Vous choisissez la page cible ; le choix est écrit avec une trace d'audit.