Trouver des entreprises
search_google_mapsRecherchez 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 SearchDonnées Google Maps / Serveur MCP
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
Chaque outil renvoie son résultat directement. Choisissez l’opération dont votre tâche a besoin et gardez les pages demandées explicites.
search_google_mapsRecherchez 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 Searchget_google_maps_reviewsUtilisez 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 Reviewsget_google_maps_photosRé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 PhotosReviews 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
Votre client gère l’initialisation et la découverte des outils, puis envoie votre clé API avec chaque requête.
POST https://gmapscrawl.com/api/mcp
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json
Accept: application/json, text/event-streamConfiguration client
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}"
}
}
}
}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
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.
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é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 clientLisez 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 champsRemplacez 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
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
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.
“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.
“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.
“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
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.
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 APINe 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’utilisationL’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 SkillExplorer le hub API → Les plans Online et Extension ont leurs propres quotas.
Aide à la connexion
Utilisez l’état de connexion et l’erreur renvoyée pour choisir l’étape suivante.
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.
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.
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é.
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 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.
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
Créez une clé API, connectez votre client préféré et testez une recherche d’entreprise ciblée.