GridWhy
officielHistorique des classements sur la grille géographique de Google Maps pour le SEO local : consultez l’historique des scans, demandez pourquoi un classement a changé (concurrents, avis, changements de catégorie) et obtenez des formulations prêtes à envoyer aux clients ainsi que les prochaines étapes, puis lancez un nouveau scan de la grille.
Que pouvez-vous faire avec GridWhy MCP ?
- Consulter l’historique des scans — Demandez les emplacements et mots-clés suivis avec leurs derniers scans, notamment le nombre de positions dans le top 20 et le top 3, le classement moyen et le meilleur classement, ainsi que les scans manuels restants.
- Expliquer les changements de classement — Obtenez des conclusions sur les raisons pour lesquelles un mot-clé a changé de position entre deux scans, en tenant compte de la couverture, des concurrents, de la vitesse d’obtention des avis, de la note et des changements de catégorie ou de nom, avec des formulations prêtes à être communiquées aux clients.
- Lancer un scan de grille — Lancez immédiatement un scan pour un mot-clé suivi. Celui-ci sera décompté de votre quota de scans manuels et renverra un ID de scan pour le suivi.
- Se connecter via OAuth ou une clé — Ajoutez
https://gridwhy.com/mcpdans Claude ou ChatGPT en vous connectant, ou utilisez une clégw_avec Claude Code, Cursor et des scripts.
Serveur MCP hébergé
npx add-mcp 'https://gridwhy.com/mcp'S’installe dans Claude Code, Codex, Cursor et plus
Documentation
Connectez-vous en un clic
Claude et ChatGPT ont uniquement besoin de l’URL https://gridwhy.com/mcp. Ils ouvrent une page GridWhy où vous vous connectez comme d’habitude (lien par e-mail ou Google) et choisissez ce que l’application peut faire : lire (emplacements, historique des analyses, changements) et analyser (lancer des analyses, qui utilisent votre quota d’analyses manuelles). Aucune clé à copier.
- Claude (claude.ai et l’application de bureau, tous les forfaits) : Customize → Connectors → Add → Add custom connector. Nommez-le GridWhy, collez
https://gridwhy.com/mcp, cliquez sur Continue, conservez les options d’authentification que Claude indique comme Detected (il s’enregistre automatiquement), cliquez sur Add, puis sur Connect. Avec les forfaits Team et Enterprise, un Owner l’ajoute sous Organization settings → Connectors, puis chaque membre se connecte. - ChatGPT : ouvrez chatgpt.com/plugins, sélectionnez +, puis Add custom MCP server. Saisissez GridWhy, collez
https://gridwhy.com/mcpsous Connection, choisissez OAuth pour l’authentification, confirmez, puis sélectionnez Create as a plugin. Les politiques de votre espace de travail déterminent si les serveurs personnalisés sont autorisés.
Les applications connectées sont répertoriées sous Settings → API and MCP, où vous pouvez les déconnecter ; elles cessent de fonctionner immédiatement. Elles sont soumises aux mêmes limites qu’une clé API (ci-dessous). À la fin d’un essai ou en cas d’annulation d’un abonnement, elles renvoient une erreur explicite jusqu’à ce que vous choisissiez un forfait. Les noms des menus dans Claude et ChatGPT changent de temps à autre ; l’URL reste la même.
1. Ou utilisez une clé
Connectez-vous, ouvrez Settings → API and MCP et créez une clé. Elle commence par gw_ et ne s’affiche qu’une seule fois. Une clé agit pour l’ensemble de votre espace de travail ; vous pouvez la révoquer à tout moment depuis cette page.
Pour Claude Code, Cursor, les scripts et l’API REST. Point de terminaison MCP : https://gridwhy.com/mcp (Streamable HTTP). Envoyez la clé sous la forme Authorization: Bearer gw_…. Découverte OAuth pour les clients qui la prennent en charge : https://gridwhy.com/.well-known/oauth-protected-resource/mcp.
2. Connectez votre client
Claude Code (terminal)
claude mcp add --transport http gridwhy https://gridwhy.com/mcp \
--header "Authorization: Bearer gw_your_key"
Claude Desktop : Settings → Developer → Edit config (claude_desktop_config.json), puis redémarrez
{
"mcpServers": {
"gridwhy": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://gridwhy.com/mcp", "--header", "Authorization:${GRIDWHY_AUTH}"],
"env": { "GRIDWHY_AUTH": "Bearer gw_your_key" }
}
}
}
Node.js est requis. La clé se trouve dans une variable d’environnement afin que l’espace après « Bearer » soit conservé sous Windows.
Cursor : ~/.cursor/mcp.json (ou .cursor/mcp.json dans un projet)
{
"mcpServers": {
"gridwhy": {
"url": "https://gridwhy.com/mcp",
"headers": { "Authorization": "Bearer gw_your_key" }
}
}
}
Modèles ChatGPT via l’API OpenAI Responses
curl https://api.openai.com/v1/responses \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "<model>",
"tools": [{
"type": "mcp",
"server_label": "gridwhy",
"server_url": "https://gridwhy.com/mcp",
"headers": { "Authorization": "Bearer gw_your_key" },
"require_approval": { "never": { "tool_names": ["get_history", "explain_change"] } }
}],
"input": "Which of my clients lost ground on Google Maps this week, and why?"
}'
Dans l’application ChatGPT, utilisez plutôt la connexion en un clic ci-dessus ; l’appel API présenté ici utilise directement une clé.
3. Outils
get_historyEmplacements, mots-clés suivis et leurs analyses, du plus récent au plus ancien : nombre de points de la grille classés dans le top 20 et le top 3, classement moyen et meilleur classement, résumé d’une ligne des « changements » et lien vers le rapport. Sans arguments : chaque mot-clé avec sa dernière analyse, ainsi que le nombre d’analyses manuelles restantes. Arguments : location, keyword, keyword_id, limit (tous facultatifs)explain_changePourquoi le classement a changé entre une analyse et la précédente : constats (couverture, concurrents en hausse ou nouvellement apparus, rythme des avis, note, changements de catégorie ou de nom), chacun accompagné d’une phrase à transmettre au client, ainsi que les prochaines étapes. Indiquez scan_id, ou un emplacement et un mot-clé pour obtenir leur dernière analyse terminée. Arguments : scan_id, location, keyword, keyword_id (tous facultatifs)run_scanLance immédiatement une analyse de grille pour un mot-clé suivi (en plus de la programmation). Elle est décomptée du quota d’analyses manuelles du compte (par jour et par période de 30 jours) ; la première analyse d’un mot-clé est gratuite. L’opération prend 15 à 30 secondes ; appelez ensuite explain_change avec le scan_id renvoyé. Arguments : location, keyword, keyword_id (tous facultatifs)
Essayez : « Explique ce qui a changé pour Wilson Plumbing sur “plumber” et rédige la mise à jour pour le client. »
4. REST
Les trois mêmes opérations, la même clé, les mêmes limites et les mêmes réponses (JSON).
get_history
curl "https://gridwhy.com/api/v1/history?location=Wilson&keyword=plumber&limit=5" \
-H "Authorization: Bearer gw_your_key"
explain_change
curl "https://gridwhy.com/api/v1/explain?scan_id=<scan id>" \
-H "Authorization: Bearer gw_your_key"
run_scan (202 Accepted ; l’analyse prend 15 à 30 secondes)
curl -X POST "https://gridwhy.com/api/v1/scans" \
-H "Authorization: Bearer gw_your_key" -H "Content-Type: application/json" \
-d '{ "location": "Wilson Plumbing", "keyword": "plumber" }'
Les erreurs sont renvoyées sous la forme { "error": "…" } avec les codes 400, 401, 403, 404, 409 ou 429 (avec Retry-After).
5. Limites
| Forfait | Appels API par heure | run_scan (analyses manuelles) |
|---|---|---|
| Solo | 100 | 5 par jour, 30 par période de 30 jours |
| Agency | 500 | 20 par jour, 100 par période de 30 jours |
| Agency+ | 2,000 | 50 par jour, 250 par période de 30 jours |
Les analyses programmées ne sont jamais limitées par l’API. L’essai gratuit est soumis aux limites du forfait Solo. Une clé cesse de fonctionner à la fin d’un essai ou en cas d’annulation d’un abonnement.