Comment utiliser Codex pour analyser le trafic des sites concurrents : Ahrefs, Semrush et DataForSEO

Comment utiliser Codex pour analyser le trafic des sites concurrents : Ahrefs, Semrush et DataForSEO

Si vous n'avez besoin que d'une seule analyse de trafic concurrentiel, vous pouvez donner cet article entier à Codex et dire : Suis le processus de cet article pour analyser competitor.com. Il utilisera le skill ci-dessous pour vérifier les fournisseurs de données disponibles, gérer la connexion Ahrefs, Semrush ou DataForSEO, puis ne vous demandera que les éléments qui influencent réellement le résultat : le domaine, le marché, la langue et votre propre domaine si vous voulez comparer des lacunes de contenu.

D'abord, une limite importante : sauf si un concurrent partage Google Analytics, Search Console ou ses journaux de serveur, vous ne pouvez pas voir son nombre réel de visites. Ahrefs, Semrush et DataForSEO produisent des estimations à partir de leurs bases de mots-clés, classements, modèles de clics et données de crawl. Cela ne rend pas ces données inutiles. Elles servent à comparer les domaines qui progressent sur le même marché et pendant la même période, ainsi qu'à repérer les pages et requêtes qui méritent une recherche. Ce n'est pas le bilan financier d'un concurrent.

Quand ce workflow mérite d'être utilisé

Vous n'avez pas besoin d'une analyse complète chaque fois que vous remarquez un autre site. Les données de trafic concurrentiel sont particulièrement utiles dans les situations suivantes :

Ce workflow ne répond pas à « Combien de visiteurs réels ont-ils eus hier ? » ni à « Combien de trafic obtiendrons-nous si nous les copions ? ». Sans données analytics de première main du concurrent, aucun outil tiers ne peut répondre à ces questions.

Les décisions que vous pouvez prendre après l'analyse

La valeur ne se trouve pas dans un chiffre de trafic séduisant. Elle consiste à transformer une observation floue sur un concurrent en décisions vérifiables :

1. Savoir qui surveiller. Distinguez les concurrents commerciaux directs des concurrents en recherche organique. Un éditeur, un site de modèles ou un outil peut capter votre demande de recherche la plus importante sans vendre le même produit.
2. Savoir d'où vient la croissance. Recherchez les groupes de pages, mots-clés et pays qui entraînent une visibilité estimée au lieu de regarder une seule courbe ascendante.
3. Savoir si l'opportunité vous appartient. Comparez les thèmes du concurrent à vos URL, aux besoins clients et aux capacités de votre produit ; retirez les mots-clés non pertinents.
4. Savoir quoi faire ensuite. Choisissez entre améliorer une page existante, créer un actif de contenu, étudier une opportunité d'outil ou ne rien faire délibérément, puis conservez la raison.

L'objectif d'une recherche de trafic concurrentiel n'est pas une suite de nombres. C'est un ensemble de pages, thèmes et choix d'action que votre équipe peut discuter.

Ce que vous aurez terminé

Il s'agit d'un workflow en lecture seule pour une personne qui utilise Codex pour la recherche SEO pour la première fois.

Considérez-le comme une feuille de preuves, pas comme un bouton « vérifier le trafic ». Le total suggère seulement qui paraît plus grand. Les meilleures pages, les mots-clés classés, les évolutions et les lacunes de contenu vous aident à décider quoi écrire, améliorer ou ignorer.

Choisissez d'abord un seul fournisseur de données

Les trois fournisseurs peuvent se recouper, mais ce ne sont pas des vues différentes de la même base. Commencez avec celui dont vous possédez déjà l'accès API. Ajoutez une seconde source seulement lorsque l'écart change une décision ou que la première ne fournit pas un rapport nécessaire.

N'additionnez pas les chiffres de trafic des fournisseurs et ne concluez pas qu'un fournisseur a tort parce que les nombres diffèrent. Vérifiez d'abord que le domaine racine, le marché, la langue et la métrique sont les mêmes : trafic organique, visites totales ou trafic payant. La comparaison n'a de sens que lorsque les définitions correspondent.

Chemin minimal viable : DataForSEO seul peut réaliser ce tutoriel. Il est particulièrement utile si vous voulez que Codex organise des fichiers CSV et Markdown reproductibles. Ajoutez Ahrefs ou Semrush lorsque leurs rapports de concurrents, de pages ou d'historique apportent les preuves dont vous avez besoin.

Donnez à Codex une mission stable et répétable

Un skill Codex est un dossier contenant SKILL.md. Il indique à Codex quand lancer un workflow, quelles entrées sont nécessaires, dans quel ordre travailler et quelles limites respecter. Les conseils actuels de Codex prennent en charge les skills au niveau du dépôt dans .agents/skills/ du projet courant ou d'un parent, et les skills personnels dans ~/.agents/skills/. Le premier convient à la réutilisation en équipe, le second à vos projets.

Dans un dépôt de recherche ou un dossier de travail dédié, créez le répertoire :

mkdir -p .agents/skills/competitor-traffic-research

Créez ensuite .agents/skills/competitor-traffic-research/SKILL.md. Copiez exactement le fichier complet ci-dessous. Le skill gère les connexions fournisseurs, les identifiants, le marché par défaut et les scripts fournisseurs afin qu'un débutant n'ait pas à configurer chaque clé à la main dans l'article.

Fichier complet SKILL.md

Copiez tout le bloc de code ci-dessous dans .agents/skills/competitor-traffic-research/SKILL.md. Ne copiez pas le texte de l'article situé hors du bloc. Le SKILL.md reste en anglais car c'est une instruction exécutable pour Codex ; cela préserve précisément les noms de fournisseurs, d'API, de variables et de fichiers.

---
name: competitor-traffic-research
description: Analyze a public competitor domain's estimated search traffic, top pages, ranked keywords, trends, and content gaps with Ahrefs, Semrush, or DataForSEO data. Use when a user asks to check competitor website traffic, competitor organic keywords, top pages, or organic search competitors. Set up any required provider connection, then produce a read-only, sourced report without inventing metrics.
---

# Competitor traffic research

## Purpose and boundary

Turn a public domain into a reviewable competitor-search report. This is research only. Do not edit a website, create a provider project, alter billing, change account settings, publish content, send email, or make any other external write action.

All third-party traffic values are estimates unless the user supplies first-party analytics for a domain they own. Never call an estimated value "actual traffic," "sessions," "revenue," or "conversions."

## Required input

Ask only for what is missing:

1. Competitor domain, subdomain, path, or exact URL. Normalize it and state which scope will be measured.
2. At least one available authorized provider: Ahrefs, Semrush, or DataForSEO.

Use `United States` and `English` when market and language are not supplied. State this default prominently in the final report. Optional inputs are the user's domain, additional competitors, device, date range, seed topic, and business goal.

## Provider connection and setup

Handle the provider setup so the user does not have to read API documentation or write request code.

1. Inspect installed provider skills and local integration scripts first. Prefer an existing authorized connection.
2. If no connection is ready, tell the user which provider connection is needed and guide them through its ordinary setup one step at a time. Use the provider's official documentation and configuration method; do not invent endpoints or settings.
3. Store provider settings in the location expected by the installed integration. Use `AHREFS_API_KEY`, `SEMRUSH_API_KEY`, `DATAFORSEO_LOGIN`, and `DATAFORSEO_PASSWORD` when a local script expects those names. Set DataForSEO's `DATAFORSEO_DEFAULT_LOCATION` and `DATAFORSEO_DEFAULT_LANGUAGE` to the selected market and language when the installed toolkit uses them.
4. Do not copy provider credentials into research artifacts, report tables, CSV output, or user-facing summaries. Keep connection setup out of the analysis report.
5. Use read-only reports/endpoints. Before a potentially billable request, state the provider, report or endpoint class, market, language, intended request count, and any known quota/credit uncertainty. Stop if the user declines.
6. On a 401, 403, quota, coverage, or provider error, record the provider as `unavailable` with the safe error category and a recovery suggestion. Do not retry repeatedly, switch providers silently, or invent a substitute metric.

## Provider query map

Choose the least complicated available route. Do not force all three providers into one run.

| Provider | First lookup | Extend the analysis with | Use it when |
| --- | --- | --- | --- |
| Ahrefs | Site Explorer domain overview or the installed Ahrefs connector's closest equivalent | Top pages, Organic keywords, Organic competitors, Content Gap | The connection exposes these reports and the user needs page-level competitor research |
| Semrush | Domain Overview or the installed Semrush connector's closest equivalent | Organic Research, Organic Competitors, Keyword Gap, historical position data | The connection exposes the target database and the user needs a second point of view or keyword-gap workflow |
| DataForSEO | `bulk_traffic_estimation` and `ranked_keywords` from the installed `dataforseo-toolkit` | `keywords_for_site`, `google_organic_serp`, `backlinks_summary`, `referring_domains` | A scriptable local workflow is available or a reproducible CSV is the main need |

For DataForSEO, use the installed toolkit before writing new HTTP code. Its normal sequence for a domain is:

```text
bulk_traffic_estimation -> ranked_keywords -> keywords_for_site
```

Run `google_organic_serp` only for a small, human-selected set of important keywords to validate intent and result-page format. Run backlink reports only when the user asks about referral or link opportunities. If an Ahrefs or Semrush connector uses different report names, use the closest documented read-only equivalent and record the exact report name.

## Data collection order

1. Create a timestamped folder under `competitor-research/` using a safe normalized domain name. Do not overwrite an existing run.
2. Create `research-scope.md` before any API call. Record target scope, market, language, date/time in UTC, available providers, user goal, and the meanings of requested metrics.
3. Inspect installed provider skills, local scripts, and official provider documentation before choosing a report/endpoint. Use only capabilities that are actually available to the authorized account. Do not guess an endpoint from memory.
4. Collect the smallest useful evidence set from each available provider:
   - domain-level estimated organic traffic or visibility and any available trend;
   - top organic pages with their leading keyword or traffic contribution when the provider supplies it;
   - ranked organic keywords with position, volume, and URL when available;
   - organic competitors or intersecting keywords when available;
   - paid-search or backlink signals only when the user asks for them, and label them separately.
5. If the user provides their own domain, run a content-gap comparison only when the provider supports it. Return only relevant keyword opportunities; do not treat every missing keyword as a content brief.
6. Normalize domains, country/database, language, device, date window, URL scope, and metric definitions before comparing providers. Keep each provider's original metric in a separate column. Never average or sum traffic estimates across providers.
7. Save concise normalized CSV files only: `competitor-pages.csv`, `competitor-keywords.csv`, and, when applicable, `content-gap.csv`. Omit unavailable fields rather than filling them with zero.

## Output schemas

Write a `field-dictionary.md` beside the report. Use these columns where the provider returns them; preserve blanks as blanks.

### `competitor-pages.csv`

`url, page_role, leading_keyword, estimated_organic_traffic, ranking_keywords, traffic_change, provider, report_or_endpoint, retrieved_at_utc, market, language, scope, metric_definition, notes`

### `competitor-keywords.csv`

`keyword, intent, position, previous_position, search_volume, estimated_traffic, ranking_url, keyword_group, provider, report_or_endpoint, retrieved_at_utc, market, language, scope, metric_definition, relevance_note`

### `content-gap.csv`

Create this file only when the user's domain is supplied and a provider supports a comparison. Use:

`keyword, intent, competitor_domains, competitor_urls, user_domain_status, search_volume, position_gap, recommended_action, existing_url_risk, provider, report_or_endpoint, retrieved_at_utc, market, language, human_review_reason`

Do not manufacture a top-pages table from ranked keywords alone. If a provider cannot supply page-level estimated traffic, include the ranking URL and label the traffic field `not_available`.

## Analysis rules

- Separate a direct business competitor from an organic search competitor. A publisher, marketplace, directory, or tool can compete for keywords without selling the same product.
- Treat abrupt changes as observations, not causal claims. Check the changed pages and keywords before suggesting a reason.
- Prefer page groups, intent, relevance, and trend direction over one headline traffic number.
- For every quantitative field, retain `provider`, `report_or_endpoint`, `retrieved_at_utc`, `market`, `language`, `scope`, and `metric_definition` in the relevant output or its data dictionary.
- Label data `not_available`, `not_comparable`, or `estimated` rather than guessing. Explain why it cannot be compared when possible.
- Do not claim that an SEO metric predicts ranking, traffic, revenue, conversion, market share, or AI citations.

## Required report

Write `competitor-traffic-report.md` with these sections:

1. **Executive answer:** target, scope, market, language, retrieval time, provider coverage, and the shortest useful conclusion.
2. **What the numbers mean:** which metrics are estimates, what they do and do not measure, and comparison limits.
3. **Traffic and visibility snapshot:** a provider-by-provider table. Do not merge values.
4. **Trend and change check:** observed movement, relevant changed pages/keywords, and confidence or gaps.
5. **Top pages:** a compact table with URL, apparent page role, leading keyword when available, estimated contribution, provider, and a human interpretation.
6. **Keyword and intent patterns:** group a limited set of relevant keywords by searcher job. Identify themes, not a dump of thousands of rows.
7. **Competitors and gaps:** distinguish direct competitors from organic competitors. If the user's domain is supplied, show only review-worthy content gaps and cannibalization risks.
8. **Prioritized actions:** no more than five actions. Each must cite the evidence, likely owner, expected output, and a human approval gate.
9. **Data availability and caveats:** unavailable providers, errors, scope mismatches, freshness limits, and exact recovery steps.
10. **Artifact index:** paths to generated CSVs and a field dictionary.

## Quality gates before finishing

- Verify that target scope is explicit: root domain, subdomain, path, or exact URL.
- Verify market and language are stated; highlight defaults.
- Verify provider connection details do not appear in research artifacts, report tables, CSV output, or the final summary.
- Verify every headline metric names its provider and says `estimated` when it is not first-party data.
- Verify provider values were not added, averaged, or compared across mismatched markets, languages, scopes, or dates.
- Verify all recommended actions are evidence-backed and require human approval before website changes or publishing.
- If data is unavailable, complete the report with the availability log and the exact next input needed; do not return a fictional analysis.

## Final response to the user

State the target, market, language, available providers, top three observations, most important caveat, generated artifact paths, and the one decision the user should make next.

Après l'enregistrement, redémarrez Codex ou lancez une nouvelle session et invoquez explicitement $competitor-traffic-research. L'invocation explicite est plus fiable au premier lancement ; ensuite Codex peut aussi faire correspondre automatiquement la description de la tâche.

Premier lancement : commencez avec un domaine, pas dix

Ouvrez Codex depuis le dossier de recherche. Si une source n'est pas connectée, le skill s'occupe de la configuration correspondante ; vous n'avez pas à parcourir des clés dans l'article. Saisissez ensuite :

$competitor-traffic-research
Analyse le trafic de recherche organique de competitor.com. Utilise tous les fournisseurs disponibles et le marché et la langue par défaut. Avant de commencer, indique les types de rapports, le marché, la langue et le nombre possible de requêtes facturables que tu prévois d'utiliser.

Si vous avez votre propre site, ajoutez-le lors du second lancement. Codex pourra ainsi effectuer une véritable comparaison de lacunes de contenu au lieu de deviner que vous ne couvrez pas un thème :

$competitor-traffic-research
Mon site est mysite.com et le concurrent est competitor.com. Sur le même marché et dans la même langue, vérifie les lacunes de contenu en recherche organique. Ne conserve que les opportunités liées à des logiciels B2B de gestion de projet qui méritent une revue humaine. Ne recommande pas encore de publier des pages ; livre d'abord le rapport de recherche.

« Livre d'abord le rapport de recherche » est important. Cela sépare la collecte de preuves des modifications du site. Codex peut trouver rapidement des opportunités, mais décider d'écrire un article, de mettre à jour une page produit ou d'investir dans des liens exige toujours votre revue de l'intention, du contenu existant et de la valeur métier.

Lisez le résultat : ne regardez pas seulement le trafic mensuel

Un rapport fiable traduit les chiffres en preuves que votre équipe peut discuter.

Vérifiez d'abord, puis agissez. Les données de trafic tierces vous aident à poser de meilleures questions ; elles ne tirent pas la conclusion à votre place.

Exemple de lecture fictif

Supposons que le rapport montre que rival.example a surtout progressé grâce à dix pages sous /templates/, avec des requêtes orientées tâche telles que proposal template et project brief template. La bonne étape suivante n'est pas de copier dix titres. Vérifiez si vos clients ont réellement besoin de modèles, si vous pouvez proposer une version téléchargeable, modifiable ou générée en ligne, et si une page de ressources existante peut être améliorée. L'idée ne doit entrer au planning de contenu que lorsque les trois réponses sont cohérentes.

Traitez les échecs courants dans cet ordre

Transformez une analyse ponctuelle en intelligence concurrentielle mensuelle

Le premier rapport répond à « Que voyons-nous maintenant ? ». Les relances mensuelles indiquent si un changement mérite d'agir. Ne commencez pas par surveiller cinquante domaines. Pour une petite équipe, trois à cinq concurrents directs ou organiques dans le même marché et la même langue suffisent.

Chaque mois, relancez le même skill et posez quatre questions supplémentaires :

1. Quelles pages ont connu le plus grand changement de visibilité estimée ou de mots-clés classés ?
2. Le changement vient-il de nouvelles pages, de mises à jour de pages existantes ou de variations de classement, et les données étayent-elles ce jugement ?
3. Quels trois thèmes sont les plus pertinents pour l'activité mais restent mal traités par vos URL actuelles ?
4. Quelle opportunité doit être « améliorer une page existante », « créer un actif de contenu » ou « ne rien faire », et pourquoi ?

Conservez chaque research-scope.md et chaque rapport, pas seulement le tableur final. Le marché, la langue, le fournisseur, l'heure de collecte et les lacunes de données rendent une comparaison trois mois plus tard interprétable.

Checklist de fin

• [ ] Vous avez confirmé si le périmètre est un domaine racine, sous-domaine, chemin ou URL exacte.
• [ ] Vous avez choisi et enregistré le pays/marché et la langue ; si vous avez utilisé les valeurs par défaut, vous l'avez signalé.
• [ ] Les sources requises ont été connectées par le skill et le rapport ne mélange pas d'instructions de configuration.
• [ ] Codex a indiqué fournisseur, type de rapport et périmètre de facturation possible avant d'appeler une API.
• [ ] Le rapport conserve fournisseur, heure de collecte et définition de métrique pour chaque estimation.
• [ ] Vous n'avez pas additionné les estimations Ahrefs, Semrush et DataForSEO, ni ne les avez qualifiées d'analytics réelles.
• [ ] Les meilleures pages et mots-clés sont devenus un petit ensemble d'actions vérifiables par des humains, pas une liste infinie.
• [ ] Toute mise à jour de contenu, publication ou modification du site reste soumise à une approbation humaine ultérieure.

Questions fréquentes

Puis-je vraiment donner à Codex un seul domaine ?

Oui. Le skill utilise par défaut la base United States / English ; le minimum est donc un domaine et une source de données configurée. Cette valeur par défaut n'est peut-être pas celle de vos clients. Pour une activité locale, non anglophone ou ciblant un pays, indiquez explicitement pays et langue.

Dois-je acheter Ahrefs, Semrush et DataForSEO en même temps ?

Non. Un fournisseur autorisé qui couvre votre marché cible suffit pour commencer. Une seconde source sert à recouper une décision importante ou à combler une lacune de rapport ; n'achetez pas d'unités API juste pour qu'un rapport paraisse complet.

Pourquoi le trafic total d'un concurrent dans Similarweb ou un autre tableau de bord est-il différent ?

Le périmètre de la métrique diffère. Ce workflow se concentre sur la visibilité de recherche organique, les pages et les mots-clés ; certains produits estiment les visites directes, de référence, sociales et payantes. Vérifiez la définition du canal avant de comparer. Dans tous les cas, des données tierces ne sont pas les analytics first-party du concurrent.

Codex peut-il décider quels articles je dois écrire ?

Il peut proposer un ensemble limité de candidats et de risques étayés par des preuves, mais ne devrait pas les publier seul. Les données de mots-clés et de pages ne voient ni vos échanges commerciaux, ni les capacités produit, ni les exigences légales, ni vos ressources éditoriales. Traitez la sortie de Codex comme une note d'assistant de recherche et faites-la approuver par le responsable du contenu, du produit ou des ventes.

Auteur : Theo Langford, analyste de visibilité concurrentielle en AI pour plus de 120 marchés chez Auspia. Theo écrit sur la recherche de concurrents, les cartes de marché et les limites de preuve dans les comparaisons de visibilité en recherche.