Connectez DataForSEO à ChatGPT avec MCP
Transformez ChatGPT en agent SEO surpuissant avec accès direct aux données de mots-clés, tendances et volumes de recherche via le Model Context Protocol.
Qu'est-ce que le Model Context Protocol (MCP) ?
MCP est le protocole développé par Anthropic qui permet aux LLMs de se connecter à des sources de données externes en temps réel.
Le Model Context Protocol (MCP) est un standard ouvert qui permet à un LLM (comme GPT-4, Claude, etc.) de se connecter à des outils, bases de données et APIs externes pour enrichir ses capacités.
Au lieu d'être limité aux données de son entraînement, le LLM peut maintenant aller chercher des données en temps réel depuis des sources comme DataForSEO, Google Analytics, bases de données SQL, etc.
Connexion Temps Réel
Plus besoin de copier-coller des données manuellement. Le LLM interroge directement l'API et obtient les données à jour.
Contexte Enrichi
Le LLM comprend le contexte de votre requête et sait exactement quel endpoint API appeler avec quels paramètres.
Automatisation Intelligente
Combinez plusieurs requêtes API, analysez les données et générez des insights actionnables en une seule conversation.
| Sans MCP | Avec MCP |
|---|---|
| Copier-coller manuel des données | Connexion directe en temps réel |
| Données potentiellement obsolètes | Données toujours à jour |
| Process en 3-4 étapes | Tout en une seule conversation |
| Risque d'erreurs de saisie | Zéro erreur, API directe |
| Limité aux connaissances du LLM | Accès à toutes les données externes |
Pourquoi Connecter DataForSEO à ChatGPT ?
DataForSEO est l'API SEO la plus complète du marché avec accès à Google Ads, Google Trends, SERP analysis et bien plus.
Volume de Recherche
Obtenez le volume de recherche mensuel moyen, CPC et niveau de concurrence pour n'importe quel mot-clé depuis Google Ads.
- Données Google Ads officielles
- CPC estimé par pays
- Indice de concurrence
- Tendances sur 12 mois
Google Trends
Analysez la popularité d'un mot-clé sur Google Trends avec données temporelles, démographiques et géographiques.
- Intérêt dans le temps (0-100)
- Pics de popularité
- Requêtes associées
- Sujets connexes
Analyse Géographique
Découvrez quelles régions d'un pays sont les plus intéressées par votre mot-clé.
- Score d'intérêt par région
- Top régions identifiées
- Données sub-régionales
- Comparaison multi-pays
Données Démographiques
Comprenez qui recherche vos mots-clés : répartition par âge et genre.
- Tranches d'âge détaillées
- Distribution homme/femme
- Segment d'audience principal
- Insights comportementaux
- → Recherche de mots-clés : "Trouve-moi 5 keywords avec volume > 10k/mois et faible concurrence dans la niche marketing digital"
- → Analyse de tendances : "Montre-moi l'évolution de 'AI automation' vs 'marketing automation' sur 12 mois"
- → Stratégie locale : "Quelles régions de France sont les plus intéressées par 'formation SEO' ?"
- → Persona building : "Quel est le profil démographique des gens qui recherchent 'logiciel CRM' ?"
Guide Étape par Étape : Configuration MCP + DataForSEO
Suivez ce guide pour connecter DataForSEO à votre GPT personnalisé en 15 minutes
- → Compte ChatGPT Plus ou Team (requis pour créer des GPTs personnalisés)
- → Compte DataForSEO avec crédits API (créer un compte)
- → Connaissances de base en JSON (le guide est très détaillé, pas besoin d'être développeur)
Créer un Compte DataForSEO
DataForSEO offre 5000 crédits gratuits à l'inscription. Suffisant pour tester et valider le setup.
- Aller sur https://app.dataforseo.com/register
- Créer un compte avec votre email professionnel
- Valider votre email
- Dans le dashboard, aller dans Settings → API Access
- Noter votre Login et Password (ce ne sont PAS vos identifiants de connexion, mais des clés API dédiées)
Créer un GPT Personnalisé sur ChatGPT
ChatGPT Plus et Team permettent de créer des GPTs personnalisés avec des instructions et capacités spécifiques.
- Aller sur https://chat.openai.com/gpts/editor
- Cliquer sur "Create a GPT"
- Donner un nom : "Agent DataForSEO"
- Description : "Agent SEO utilisant l'API DataForSEO pour analyser mots-clés, tendances et volumes de recherche"
- Choisir une image de profil (optionnel)
Configurer les Instructions du GPT
Les instructions définissent le comportement, les capacités et les limitations de votre agent SEO. Copiez-collez le JSON complet ci-dessous dans la section "Instructions".
Configurer les Actions (API Connections)
Les Actions permettent à votre GPT de faire des appels API externes. C'est ici que la magie MCP opère.
- Dans l'éditeur GPT, aller dans l'onglet "Configure"
- Scroller jusqu'à la section "Actions"
- Cliquer sur "Create new action"
- Dans le champ "Authentication", sélectionner "API Key" puis "Basic"
- Entrer votre Login API (username) et Password API DataForSEO
Type : Basic Auth
Username : Votre email DataForSEO (login API)
Password : Votre mot de passe API DataForSEO
Définir les Endpoints API (Actions)
Vous devez créer une Action pour chaque endpoint DataForSEO. Nous recommandons de commencer avec le premier endpoint (Google Ads Search Volume) pour tester, puis d'ajouter les autres.
Tester la Configuration
Avant de publier votre GPT, testez que les connexions API fonctionnent correctement.
- Dans l'éditeur GPT, cliquer sur le bouton "Test" en haut à droite
- Essayer une requête simple : "Quel est le volume de recherche pour 'marketing digital' en France ?"
- Vérifier que le GPT appelle bien l'API et retourne des données
- Si erreur d'authentification → Vérifier vos credentials DataForSEO
- Si erreur de format → Vérifier la structure JSON de vos Actions
- SEO automation : 2,400 recherches/mois, CPC €2.30, Concurrence Moyenne
- Marketing automation : 8,100 recherches/mois, CPC €3.80, Concurrence Élevée
Publier et Utiliser
Une fois les tests validés, publiez votre GPT et commencez à l'utiliser pour vos analyses SEO.
- Cliquer sur "Save" en haut à droite
- Choisir le niveau de visibilité :
- Only me : Privé (recommandé pour débuter)
- Anyone with the link : Partage avec votre équipe
- Public : Visible sur le GPT Store
- Votre GPT est maintenant accessible depuis la sidebar ChatGPT
- Commencez à l'utiliser pour toutes vos analyses de mots-clés !
JSON Complets pour la Configuration
Tous les JSON nécessaires pour configurer votre Agent DataForSEO (sans les clés API)
1. Instructions GPT (JSON Complet)
À coller dans la section "Instructions" de votre GPT
{
"name": "Agent DataForSEO",
"description": "Agent SEO utilisant exclusivement l'API DataForSEO pour récupérer, analyser et visualiser les données de mots-clés, tendances, démographie et volumes de recherche.",
"model": "GPT-4",
"default_language": "fr",
"capabilities": {
"keywords_data": {
"keywords_data_google_ads_search_volume": {
"description": "Récupère le volume de recherche mensuel moyen, CPC et concurrence d'un ou plusieurs mots-clés depuis Google Ads.",
"parameters": {
"location_name": "Nom complet du pays (ex: 'France')",
"language_code": "Code langue ISO (ex: 'fr')",
"keywords": ["Liste de mots-clés (max: 5)"]
},
"returns": {
"keyword": "Mot-clé analysé",
"search_volume": "Volume de recherche moyen",
"cpc": "Coût par clic estimé",
"competition": "Indice de concurrence",
"trend": "Évolution mensuelle sur 12 mois"
}
},
"keywords_data_dataforseo_trends_explore": {
"description": "Analyse la popularité d'un mot-clé sur Google Trends (web, news, ecommerce) sur une période donnée.",
"parameters": {
"location_name": "Pays ciblé (optionnel)",
"keywords": ["Liste de mots-clés (max: 5)"],
"type": "Type de recherche (web | news | ecommerce)",
"time_range": "Plage temporelle (ex: 'past_12_months', 'past_5_years')"
},
"returns": {
"keyword": "Mot-clé",
"interest_over_time": "Série temporelle d'intérêt (0-100)",
"peak_interest_date": "Date du pic d'intérêt",
"average_interest": "Moyenne de popularité sur la période"
}
},
"keywords_data_dataforseo_trends_demography": {
"description": "Fournit la répartition démographique (âge et genre) de la popularité du mot-clé.",
"parameters": {
"location_name": "Pays ciblé",
"keywords": ["Liste de mots-clés (max: 5)"],
"type": "Type de recherche (web, news, ecommerce)",
"time_range": "Période analysée (par défaut : 'past_7_days')"
},
"returns": {
"age_distribution": "Répartition par tranches d'âge",
"gender_distribution": "Répartition par genre (homme/femme)",
"top_audience_segment": "Segment le plus intéressé par le mot-clé"
}
},
"keywords_data_dataforseo_trends_subregion_interests": {
"description": "Analyse la popularité du mot-clé selon les régions d'un pays.",
"parameters": {
"location_name": "Nom complet du pays",
"keywords": ["Liste de mots-clés (max: 5)"],
"type": "Type de recherche (web, news, ecommerce)",
"time_range": "Période analysée (ex: 'past_12_months')"
},
"returns": {
"regions": [
{
"name": "Nom de la région",
"interest_score": "Niveau d'intérêt (0-100)"
}
],
"top_region": "Région avec le plus haut score"
}
},
"keywords_data_google_trends_explore": {
"description": "Fournit les données brutes de Google Trends pour un ou plusieurs mots-clés.",
"parameters": {
"location_name": "Pays ciblé (optionnel)",
"language_code": "Code langue (ex: 'fr')",
"keywords": ["Liste de mots-clés (max: 5)"],
"type": "Plateforme (web, news, youtube, images, froogle)",
"time_range": "Plage temporelle (ex: 'past_12_months')",
"item_types": ["google_trends_graph", "google_trends_map", "google_trends_topics_list", "google_trends_queries_list"]
},
"returns": {
"interest_graph": "Série de popularité temporelle (0-100)",
"related_topics": "Liste des sujets associés",
"related_queries": "Liste des recherches associées",
"map_data": "Carte des régions selon intérêt"
}
}
}
},
"rules": {
"max_keywords": 5,
"default_type": "web",
"default_time_range": "past_7_days",
"do_not_invent_data": true,
"respect_api_constraints": true,
"combine_endpoints": false,
"language_handling": "Ne pas traduire automatiquement les paramètres.",
"error_handling": "Si aucune donnée n'est disponible, retourner 'aucune donnée disponible'."
},
"examples": {
"1": {
"action": "Obtenir le volume de recherche",
"input": {
"location_name": "France",
"language_code": "fr",
"keywords": ["marketing digital"]
},
"endpoint": "keywords_data_google_ads_search_volume"
},
"2": {
"action": "Analyser la tendance sur 12 mois",
"input": {
"location_name": "France",
"keywords": ["seo automation"],
"time_range": "past_12_months"
},
"endpoint": "keywords_data_dataforseo_trends_explore"
},
"3": {
"action": "Voir la popularité par région",
"input": {
"location_name": "France",
"keywords": ["chatbot"],
"time_range": "past_12_months"
},
"endpoint": "keywords_data_dataforseo_trends_subregion_interests"
}
},
"integration_notes": {
"authentication": "Utiliser les clés API DataForSEO (login + mot de passe HTTP Basic Auth).",
"rate_limit": "Limiter les requêtes pour éviter le throttling.",
"data_format": "Les résultats sont renvoyés en JSON structuré.",
"best_practices": [
"Limiter à 5 mots-clés par requête.",
"Toujours préciser le pays et la langue.",
"Utiliser 'past_12_months' pour des analyses SEO stables.",
"Croiser les données volume + tendance pour évaluer l'opportunité d'un mot-clé."
]
}
}
2. Schémas OpenAPI pour les Actions
Créez une Action pour chaque endpoint. Collez le schéma OpenAPI correspondant dans chaque Action.
- Dans l'éditeur GPT, section "Actions", cliquer sur "Create new action"
- Coller le schéma OpenAPI dans le champ prévu
- Configurer l'authentification (Basic Auth avec vos credentials DataForSEO)
- Répéter pour chaque endpoint
Action 1 : Google Ads Search Volume
openapi: 3.1.0
info:
title: DataForSEO - Google Ads Search Volume
description: Récupère le volume de recherche, CPC et concurrence
version: 1.0.0
servers:
- url: https://api.dataforseo.com
paths:
/v3/keywords_data/google_ads/search_volume/live:
post:
operationId: getGoogleAdsSearchVolume
summary: Obtenir le volume de recherche Google Ads
requestBody:
required: true
content:
application/json:
schema:
type: array
items:
type: object
properties:
location_name:
type: string
description: Nom du pays (ex France)
language_code:
type: string
description: Code langue ISO (ex fr)
keywords:
type: array
items:
type: string
description: Liste de mots-clés (max 5)
responses:
'200':
description: Données de volume de recherche
content:
application/json:
schema:
type: object
Action 2 : Google Trends Explore
openapi: 3.1.0
info:
title: DataForSEO - Google Trends Explore
description: Analyse la popularité sur Google Trends
version: 1.0.0
servers:
- url: https://api.dataforseo.com
paths:
/v3/keywords_data/google_trends/explore/live:
post:
operationId: getGoogleTrendsExplore
summary: Obtenir les données Google Trends
requestBody:
required: true
content:
application/json:
schema:
type: array
items:
type: object
properties:
location_name:
type: string
description: Nom du pays
language_code:
type: string
description: Code langue ISO
keywords:
type: array
items:
type: string
description: Liste de mots-clés
type:
type: string
description: Type (web, news, youtube, images, froogle)
default: web
time_range:
type: string
description: Période (past_12_months, past_5_years, etc)
default: past_12_months
item_types:
type: array
items:
type: string
description: Types de données à retourner
responses:
'200':
description: Données Google Trends
content:
application/json:
schema:
type: object
Action 3 : DataForSEO Trends Explore
openapi: 3.1.0
info:
title: DataForSEO - Trends Explore
description: Popularité sur période donnée
version: 1.0.0
servers:
- url: https://api.dataforseo.com
paths:
/v3/keywords_data/dataforseo_trends/explore/live:
post:
operationId: getDataForSEOTrendsExplore
summary: Analyser la popularité dans le temps
requestBody:
required: true
content:
application/json:
schema:
type: array
items:
type: object
properties:
location_name:
type: string
description: Nom du pays
keywords:
type: array
items:
type: string
type:
type: string
default: web
time_range:
type: string
default: past_12_months
responses:
'200':
description: Données de tendance
content:
application/json:
schema:
type: object
Action 4 : Trends Demography
openapi: 3.1.0
info:
title: DataForSEO - Trends Demography
description: Répartition démographique (âge et genre)
version: 1.0.0
servers:
- url: https://api.dataforseo.com
paths:
/v3/keywords_data/dataforseo_trends/demography/live:
post:
operationId: getTrendsDemography
summary: Obtenir les données démographiques
requestBody:
required: true
content:
application/json:
schema:
type: array
items:
type: object
properties:
location_name:
type: string
keywords:
type: array
items:
type: string
type:
type: string
default: web
time_range:
type: string
default: past_7_days
responses:
'200':
description: Données démographiques
content:
application/json:
schema:
type: object
Action 5 : Subregion Interests
openapi: 3.1.0
info:
title: DataForSEO - Subregion Interests
description: Popularité par région géographique
version: 1.0.0
servers:
- url: https://api.dataforseo.com
paths:
/v3/keywords_data/dataforseo_trends/subregion_interests/live:
post:
operationId: getSubregionInterests
summary: Obtenir la popularité par région
requestBody:
required: true
content:
application/json:
schema:
type: array
items:
type: object
properties:
location_name:
type: string
keywords:
type: array
items:
type: string
type:
type: string
default: web
time_range:
type: string
default: past_12_months
responses:
'200':
description: Données géographiques
content:
application/json:
schema:
type: object
10 Exemples d'Utilisation Avancés
Découvrez comment exploiter votre agent DataForSEO pour des analyses SEO sophistiquées
Problèmes Courants et Solutions
Erreur "Authentication Failed"
Cause : Credentials DataForSEO incorrects
Solution :
- Vérifier login API (email) et password API dans Settings → API Access
- Ne pas utiliser vos credentials de connexion au dashboard
- Regénérer un nouveau mot de passe API si nécessaire
Erreur "Insufficient Credits"
Cause : Crédits API épuisés
Solution :
- Vérifier votre balance dans le dashboard DataForSEO
- Recharger des crédits si nécessaire
- Optimiser vos requêtes (max 5 keywords par call)
Le GPT ne retourne aucune donnée
Cause : Paramètres de requête incorrects
Solution :
- Vérifier le format des paramètres (location_name, language_code)
- Utiliser les noms complets de pays ("France" pas "FR")
- Tester l'endpoint directement dans Postman/curl
Requêtes très lentes
Cause : Trop de keywords ou timerange trop long
Solution :
- Limiter à 5 keywords max par requête
- Réduire le time_range (ex: past_12_months au lieu de past_5_years)
- Faire plusieurs requêtes séquentielles si nécessaire
Données incomplètes ou manquantes
Cause : Certains keywords n'ont pas de données Trends
Solution :
- Vérifier que le keyword a assez de volume (min 1000/mois)
- Tester avec un keyword plus populaire pour valider le setup
- Certains keywords de niche n'ont pas de données démographiques
Mauvais pays ou langue détecté
Cause : Paramètres location/language mal configurés
Solution :
- Toujours spécifier explicitement location_name et language_code
- Format correct : location_name="France", language_code="fr"
- Ne pas compter sur la détection automatique
Si vous rencontrez un problème non listé ici, plusieurs ressources sont disponibles :
Vous Voulez 2x Plus de Leads SEO avec nos Agents IA ?
Notre équipe configure et optimise vos agents SEO (DataForSEO, automations Make.com, SEO AI Systems) pour générer un flux constant de leads qualifiés. Résultats garantis ou remboursé.
Dans cette consultation de 45min, nous auditerons votre situation actuelle et créerons un plan d'action personnalisé pour doubler vos leads SEO.