Données Google Maps / Serveur MCP

Les données Google Maps, dans votre workflow IA.

Trouvez des entreprises, lisez des avis publics et explorez les galeries des lieux avec Claude Code, Cursor, VS Code ou Codex. Trois outils distants. La même clé API.

Fonctionne avec votre client MCP

HTTP streamable distant · Clé API privée · Plans API gratuits et payants

Trois outils / Une connexion

De la découverte d’entreprises au détail des lieux.

Chaque outil renvoie son résultat directement. Choisissez l’opération dont votre tâche a besoin et gardez les pages demandées explicites.

Trouver des entreprises

search_google_maps

Recherchez une catégorie et un lieu. Recevez jusqu’à 20 entreprises avec les champs de fiche, contact, note et nombre d’avis disponibles.

q · page · extra

Explorer l’API Search

Lire des avis publics

get_google_maps_reviews

Utilisez le feature ID d’un lieu pour demander jusqu’à 10 avis. Choisissez pertinence, plus récents, meilleure note ou plus basse note.

fid · page · sort_by

Explorer l’API Reviews

Parcourir les médias de galerie

get_google_maps_photos

Récupérez jusqu’à 20 enregistrements de métadonnées photo et vidéo pour un lieu. Lisez les URL de médias et le flag de pagination renvoyés.

fid · page

Explorer l’API Photos

Reviews et Photos acceptent le feature ID Maps du place.dataId d’un résultat de recherche. Search utilise les pages 1 à 10 ; les outils média renvoient next pour que votre agent puisse décider si une autre page est nécessaire.

Connexion MCP

Un endpoint. Votre espace de travail API.

Votre client gère l’initialisation et la découverte des outils, puis envoie votre clé API avec chaque requête.

Connexion MCP distante
POST https://gmapscrawl.com/api/mcp
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json
Accept: application/json, text/event-stream

Configuration client

Choisissez le client dans lequel vous travaillez.

Créez une clé API, puis copiez la configuration pour votre client. Gardez la clé dans son environnement ou son paramètre d’entrée protégé.

Ajoutez ce serveur à .mcp.json. Rendez GMSCRAPER_API_KEY disponible dans l’environnement qui lance Claude Code.

{
  "mcpServers": {
    "google-maps-data": {
      "type": "http",
      "url": "https://gmapscrawl.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${GMSCRAPER_API_KEY}"
      }
    }
  }
}
Documentation Claude Code ↗

Après avoir enregistré la configuration, reconnectez-vous et confirmez que les trois outils apparaissent. Suivez le guide de configuration étape par étape.

Votre premier workflow

Connectez. Testez une page. Lisez le résultat.

Commencez avec une clé de test et des données simulées. Passez à une clé réelle quand vous êtes prêt à utiliser votre quota API.

01

Préparez votre espace de travail

Sélectionnez le produit API et créez une clé de test avec scrapes:write. Votre plan API doit autoriser MCP ; Online et Extension ont des quotas séparés.

Créer une clé
02

Découvrez et appelez un outil

Connectez votre client, inspectez search_google_maps et demandez une page. Générez un nouvel ID de requête pour un nouveau travail et conservez-le lors d’une nouvelle tentative de la même requête.

Voir la configuration client
03

Utilisez les entreprises renvoyées

Lisez structuredContent.businesses et total. Étiquetez les résultats de test comme simulés, préservez les valeurs manquantes et arrêtez après la page demandée.

Comprendre les champs
Appeler search_google_maps

Remplacez l’ID de requête pour chaque nouvelle recherche. Cet exemple n’exécute pas de requête depuis la page.

{
  "q": "coffee shops in Seattle",
  "page": 1,
  "hl": "en",
  "extra": false,
  "client_request_id": "replace-with-a-fresh-uuid"
}

Ce qui revient

Des enregistrements structurés, dans la même réponse d’outil.

businesses
Jusqu’à 20 entreprises renvoyées ; des champs peuvent manquer.
params + total
La requête normalisée et le nombre sur cette page.
simulated + usage metadata
Les réponses de test identifient les données de fixture et utilisent zéro unité de requête réelle.
isError
Inspectez l’erreur avant de signaler qu’un outil a réussi.

Les résultats reviennent directement ; aucun polling de job n’est nécessaire. Gardez les dates d’observation source quand vous transformez le JSON en tableau ou rapport.

Exemples de prompts

Une question utile. Un point d’arrêt clair.

Utilisez ces prompts après la connexion. Fournissez un vrai feature ID si nécessaire, et demandez à votre agent d’étiqueter les résultats de test comme simulés.

Construire une liste d’entreprises ciblée

“Utilisez search_google_maps une fois pour coffee shops in Seattle, page 1, extra false. Renvoyez les noms, sites web, numéros de téléphone, notes et nombres d’avis des entreprises renvoyées. Gardez les champs manquants vides et affichez les dates d’observation. Arrêtez après cette page.”

Résultat attendu

Un tableau de jusqu’à 20 entreprises renvoyées, avec les horodatages source et les valeurs manquantes préservées.

Résumer une page d’avis

“Pour l’entreprise que j’ai sélectionnée, utilisez son place.dataId comme fid. Demandez la page 1 de get_google_maps_reviews avec sort_by 2. Résumez les thèmes de ces avis renvoyés uniquement et citez leurs dates. Ne récupérez pas de pages supplémentaires.”

Résultat attendu

Un résumé borné de jusqu’à 10 avis, sans traiter une page comme l’expérience de tous les clients.

Inspecter une galerie

“Utilisez get_google_maps_photos pour ce feature ID fourni, page 1 uniquement. Listez les champs photoUrl renvoyés et videoUrl optionnels et indiquez si next est true. Ne téléchargez pas de fichiers et ne récupérez pas la page suivante.”

Résultat attendu

Jusqu’à 20 enregistrements de galerie et l’état de pagination renvoyé, prêts à être inspectés par votre propre application.

REST + MCP

Un seul quota API pour les deux interfaces.

MCP est disponible sur les plans API gratuits et payants. Chaque page source réelle réussie utilise une unité de requête API, y compris une page vide.

01

Testez sans utilisation réelle

Les clés de test renvoient des fixtures simulées avec zéro unité de requête. Elles vérifient votre intégration plutôt que de produire de vrais leads d’entreprises.

Gérer les clés API
02

Gardez les requêtes bornées

Ne demandez que les pages et lieux dont votre tâche a besoin. Utilisez un nouvel ID de requête pour un nouveau travail ; réessayez les requêtes incertaines avec la même entrée et le même ID.

Lire les conseils d’utilisation
03

Ajoutez des instructions réutilisables

L’Agent Skill Google Maps Data ajoute des conseils de workflow, des références d’opérations et une solution REST de repli aux mêmes outils.

Explorer l’Agent Skill

Explorer le hub API → Les plans Online et Extension ont leurs propres quotas.

Aide à la connexion

Arrivez à la prochaine requête réussie.

Utilisez l’état de connexion et l’erreur renvoyée pour choisir l’étape suivante.

Le client se connecte mais aucun outil n’apparaît
Confirmez que l’endpoint est /api/mcp et que votre client prend en charge le HTTP streamable distant avec un en-tête Authorization privé. Rechargez la connexion et vérifiez que son processus peut lire la clé configurée.
401 ou 403
Vérifiez l’expiration de la clé, les IP autorisées, l’accès actif à l’espace de travail, le scope scrapes:write et un plan API autorisant MCP. Les cookies de connexion du navigateur n’authentifient pas l’endpoint.
invalid_request
Lisez le schéma de l’outil sélectionné. Fournissez un client_request_id unique de 16 à 128 caractères ; les avis et photos ont aussi besoin du FID de place.dataId, plutôt qu’un nom d’entreprise ou un autre identifiant de lieu.
rate_limited ou quota_exceeded
Respectez retry_after pour les limites de débit. Arrêtez quand le quota API est épuisé et vérifiez votre utilisation API ; créer une autre clé n’ajoute pas de quota.
capability_unavailable ou un échec de source
Vérifiez le statut du service et l’erreur renvoyée. La disponibilité est déterminée par le serveur. Gardez les données manquantes ou indisponibles explicites dans votre résultat.
Timeout ou isError: true
Inspectez l’erreur de l’outil même quand la connexion HTTP a réussi. Pour les échecs réessayables, gardez la même entrée et le même ID de requête dans le délai de votre tâche. Suivez les conseils d’erreur terminale avant de lancer une nouvelle tentative.

Statut du service Erreurs et conseils de nouvelle tentative

Questions fréquentes

Que peut faire le serveur MCP Google Maps ?

Il expose search_google_maps, get_google_maps_reviews et get_google_maps_photos. Search renvoie jusqu’à 20 entreprises ; reviews jusqu’à 10 enregistrements et photos jusqu’à 20 enregistrements de galerie par page. Les outils renvoient des données structurées directement.

Quels clients puis-je connecter ?

Utilisez une version de Claude Code, Cursor, VS Code, Codex ou un autre client MCP prenant en charge le HTTP streamable distant et un en-tête Authorization privé. Les quatre configurations client ci-dessus utilisent le même endpoint et la même clé d’espace de travail API.

Comment m’authentifier ?

Créez une clé API avec scrapes:write dans votre espace de travail API et configurez-la en privé comme en-tête Bearer. Les cookies de navigateur n’authentifient pas MCP. Gardez les clés hors des prompts, des URL et du code source commité.

Comment les avis et photos trouvent-ils le bon lieu ?

Passez le feature ID Maps comme fid. Vous pouvez utiliser place.dataId d’une entreprise renvoyée. Les avis acceptent aussi sort_by : 1 pour la pertinence, 2 pour les plus récents, 3 pour la meilleure note ou 4 pour la plus basse note. Lisez next avant d’envisager une autre page de médias.

MCP a-t-il un quota séparé ?

MCP partage le quota de l’API REST et est disponible sur les plans API gratuits et payants. Une page réelle réussie utilise une unité de requête, y compris une page vide. Les identifiants de test renvoient des données simulées avec zéro unité. Les quotas Online et Extension sont séparés.

Ai-je aussi besoin de l’Agent Skill ?

Le serveur MCP fonctionne seul. L’Agent Skill Google Maps Data optionnel ajoute des instructions réutilisables, des références d’opérations et un helper de repli REST quand votre connexion MCP configurée est indisponible.

Passez à l’étape suivante

Intégrez les données Google Maps dans votre prochaine conversation.

Créez une clé API, connectez votre client préféré et testez une recherche d’entreprise ciblée.