Données SERP en direct pour les agents IA : Comment nous avons ajouté l’intelligence de recherche en temps réel à TeamDay
Février 2026. Votre agent IA affirme que vous êtes en 3e position pour un mot-clé. Mais quand a-t-il vérifié pour la dernière fois ?
Les données historiques sont excellentes pour les tendances. Mais le SEO évolue vite. Google déploie des AI overviews, les concurrents lancent de nouvelles pages, les extraits en vedette changent quotidiennement. Vous devez voir à quoi ressemble le SERP en ce moment précis.
Nous avons donc construit un serveur MCP qui fournit aux agents IA des données SERP en direct.
Le manque dans notre stack SEO
TeamDay disposait déjà d’outils SEO puissants :
- Ahrefs — backlinks, domain rating, difficulté des mots-clés, analyse concurrentielle
- SE Ranking — suivi des mots-clés, audits de site, surveillance des positions dans le temps
- Google Search Console — vos données réelles de clics et d’impressions
Mais aucun d’entre eux ne vous montre à quoi ressemble la page de résultats de recherche en ce moment. Ahrefs vous donne des métriques de mots-clés. SE Ranking suit votre position dans le temps. Search Console affiche les clics d’hier.
Ce qu’ils ne vous disent pas : Y a-t-il un extrait en vedette ? Google a-t-il ajouté un AI overview ? Des résultats de pack local font-ils descendre les résultats organiques ? Votre concurrent fait-il de la publicité sur votre marque ?
Ce sont des données SERP en direct. Et maintenant les agents TeamDay les ont.
Ce que nous avons construit : DataForSEO SERP MCP Server
Nous avons encapsulé l’API SERP de DataForSEO dans un serveur MCP — le protocole standard qui connecte les outils aux agents IA. Six outils couvrant tout ce dont vous avez besoin :
Les outils
| Outil | Ce qu’il fait | Coût |
|---|---|---|
| google_serp_live | SERP Google complet — chaque type d’élément | ~0,0025 $ |
| google_serp_regular | Résultats organiques + payants rapides uniquement | ~0,001 $ |
| google_locations | Trouver les codes de ciblage géographique | Gratuit |
| google_languages | Codes de langues disponibles | Gratuit |
| bing_serp_live | Résultats SERP Bing complets | ~0,002 $ |
| youtube_serp_live | Classements des vidéos YouTube | ~0,002 $ |
Le coût est négligeable. Une recherche SERP complète coûte 0,0025 $. Soit 400 recherches pour un dollar. Les nouveaux comptes DataForSEO reçoivent 1 $ de crédit gratuit — suffisant pour 400+ recherches lors de l’évaluation.
Ce que vous obtenez en retour
Quand un agent interroge google_serp_live, il reçoit chaque élément de la page de résultats :
- Résultats organiques — rang, titre, URL, domaine, description
- Extraits en vedette — la boîte de réponse en haut
- Knowledge graph — le panneau d’information à droite
- AI overview — le résumé généré par l’IA de Google
- Les gens demandent aussi — questions connexes
- Pack local — résultats de carte avec annuaires d’entreprises
- Annonces payantes — qui enchérit sur le mot-clé
- Images, vidéos, actualités — carrousels de médias
Le tout réduit aux champs essentiels pour que votre agent ne se noie pas dans les tokens.
Comment ça fonctionne dans TeamDay
Configuration : 2 minutes
- Allez dans Paramètres → Intégrations dans votre espace TeamDay
- Trouvez DataForSEO SERP dans le marketplace
- Entrez votre email de connexion DataForSEO et le mot de passe API
- Terminé — vos agents IA ont maintenant accès aux données SERP en direct
Workflows réels
Voici ce que vos agents peuvent vraiment faire avec ça :
1. Audit SERP concurrentiel
« Montrez-moi qui se classe pour “gestion de projet ia” et quelles fonctionnalités SERP apparaissent. »
Votre agent appelle google_serp_live et obtient le tableau complet : classements organiques, si un extrait en vedette existe (et qui le détient), si Google affiche un AI overview et quelles annonces sont actives. En secondes, pas des heures de vérification manuelle.
2. Analyse des écarts de contenu
« Comparez nos classements sur Google vs. Bing pour nos 10 mots-clés principaux. »
L’agent interroge google_serp_live et bing_serp_live pour chaque mot-clé, puis résume les différences. Bing affiche souvent des résultats différents — et sa part de marché croissante (surtout via Copilot) mérite d’être surveillée.
3. Comparaison mobile vs. bureau
« Vérifiez si nos classements diffèrent entre mobile et bureau pour “outils de collaboration en équipe”. »
Passez device: "mobile" vs. device: "desktop" et l’agent rapporte les différences. Les SERPs mobiles ressemblent souvent à quelque chose de très différent — moins de places organiques, plus de résultats locaux, des extraits en vedette différents.
4. SEO YouTube
« Qu’est-ce qui se classe sur YouTube pour “tutoriel claude code” ? Où apparaissent nos vidéos ? »
youtube_serp_live retourne les classements de vidéos, chaînes et résultats de playlists. Indispensable pour la stratégie de contenu vidéo.
5. Surveillance SERP locale
« À quoi ressemblent les résultats de recherche pour “conseil ia” à Paris vs. Lyon ? »
Utilisez google_locations pour trouver les codes de localisation, puis exécutez des requêtes SERP pour chaque ville. Les résultats locaux peuvent varier considérablement selon la géographie.
La pile complète d’intelligence SEO
Avec DataForSEO SERP ajouté, les agents TeamDay disposent maintenant d’un pipeline complet d’intelligence SEO :
┌─────────────────────────────────────────────────────────┐
│ 1. Snapshot SERP (DataForSEO) │
│ À quoi ressemble la page de résultats EN CE MOMENT ?│
│ → Classements, fonctionnalités, annonces, AI overviews│
├─────────────────────────────────────────────────────────┤
│ 2. Intelligence des mots-clés (Ahrefs) │
│ Quelle est la difficulté ? Quel est le trafic ? │
│ → Volume, difficulté, potentiel de trafic, CPC │
├─────────────────────────────────────────────────────────┤
│ 3. Suivi historique (SE Ranking) │
│ Comment notre position a-t-elle évolué dans le temps?│
│ → Suivi quotidien, surveillance concurrentielle │
├─────────────────────────────────────────────────────────┤
│ 4. Performance réelle (Search Console) │
│ Quels clics et impressions avons-nous obtenus ? │
│ → CTR, impressions, requêtes de recherche réelles │
├─────────────────────────────────────────────────────────┤
│ 5. Comportement des utilisateurs (Google Analytics) │
│ Les visiteurs provenant de la recherche s'engagent- │
│ ils vraiment ? → Taux de rebond, durée, conversions │
└─────────────────────────────────────────────────────────┘
Chaque outil répond à une question différente. Un agent IA avec les cinq peut effectuer une analyse SEO complète de manière autonome — de l’analyse SERP à la recherche de mots-clés jusqu’à la validation des performances.
Détails techniques (pour les curieux)
Architecture
Le serveur MCP est un processus Node.js léger qui communique via stdio (entrée/sortie standard) :
Claude Agent ←→ Protocole MCP (stdio) ←→ DataForSEO SERP Server ←→ DataForSEO API v3
Aucune dépendance au-delà du SDK MCP. Utilise fetch natif pour HTTP, Basic Auth pour l’API. Le serveur démarre instantanément et n’a aucune empreinte mémoire au repos.
Réduction des réponses
DataForSEO renvoie des données SERP très détaillées. Une seule requête peut produire 50 Ko+ de JSON avec des structures d’éléments profondément imbriquées. Nous réduisons chaque résultat aux champs dont les agents ont réellement besoin :
- type — organic, featured_snippet, knowledge_graph, local_pack, etc.
- rank_group et rank_absolute — position sur la page
- title, url, domain, description — le contenu
- rating, price, snippet — inclus lorsque présents
Cela maintient les coûts de tokens raisonnables tout en préservant toutes les informations exploitables.
Live vs. basé sur des tâches
DataForSEO propose à la fois des endpoints live (synchrones) et basés sur des tâches (asynchrones). Nous utilisons exclusivement les endpoints live car :
- Résultats instantanés — pas de polling, pas d’attente
- Sans état — les serveurs MCP stdio ne persistent pas entre les appels
- Plus simple — une requête, une réponse
- Couvre 95 % des cas — basé sur des tâches uniquement nécessaire pour les opérations en masse
Démarrer
Si vous êtes déjà sur TeamDay
- Ouvrez Paramètres → Intégrations de votre espace
- Recherchez « DataForSEO »
- Ajoutez vos identifiants (inscrivez-vous ici — 1 $ de crédit gratuit)
- Demandez à votre agent : « À quoi ressemble le SERP Google pour [votre mot-clé] ? »
Si vous utilisez Claude Code directement
Ajoutez à votre .mcp.json :
{
"mcpServers": {
"dataforseo-serp": {
"command": "npx",
"args": ["-y", "@teamday/mcp-dataforseo-serp"],
"env": {
"DATAFORSEO_LOGIN": "[email protected]",
"DATAFORSEO_PASSWORD": "votre_mot_de_passe_api"
}
}
}
}
Puis utilisez des outils comme :
mcp__dataforseo-serp__google_serp_live(keyword="votre mot-clé", location_code=2250)
Codes de localisation courants
| Code | Localisation |
|---|---|
| 2840 | États-Unis |
| 2826 | Royaume-Uni |
| 2276 | Allemagne |
| 2250 | France |
| 2392 | Japon |
| 2036 | Australie |
| 2124 | Canada |
| 2208 | Belgique |
Utilisez google_locations avec une requête pour trouver n’importe quel code de localisation dont vous avez besoin.
La suite
Il s’agit de la v1 — endpoints live couvrant les cas d’usage les plus courants. Les ajouts futurs pourraient inclure :
- Screenshots SERP — instantanés visuels des pages de résultats de recherche
- Surveillance SERP planifiée — vérifications quotidiennes automatiques via les missions TeamDay
- Rapports diff SERP — « qu’est-ce qui a changé depuis la semaine dernière ? »
- Analyse par lots multi-mots-clés — vérifier 50 mots-clés en une fois
Le serveur MCP est open source dans le dépôt des agents TeamDay. Les pull requests sont les bienvenues.
DataForSEO SERP est disponible maintenant dans tous les espaces TeamDay. Ajoutez-le depuis Paramètres → Intégrations, ou installez directement via npx -y @teamday/mcp-dataforseo-serp.