Encontrar negocios
search_google_mapsBusque una categoría y una ubicación. Reciba hasta 20 negocios con los campos disponibles de ficha, contacto, calificación y recuento de reseñas.
q · page · extra
Explorar la API de SearchDatos de Google Maps / Servidor MCP
Encuentre negocios, lea reseñas públicas y explore galerías de lugares con Claude Code, Cursor, VS Code o Codex. Tres herramientas remotas. La misma clave de API.
Funciona con su cliente MCP
HTTP Streamable remoto · Clave de API privada · Planes de API gratuitos y de pago
Tres herramientas / Una conexión
Cada herramienta devuelve su resultado directamente. Elija la operación que su tarea necesite y mantenga las páginas solicitadas explícitas.
search_google_mapsBusque una categoría y una ubicación. Reciba hasta 20 negocios con los campos disponibles de ficha, contacto, calificación y recuento de reseñas.
q · page · extra
Explorar la API de Searchget_google_maps_reviewsUse el feature ID de un lugar para solicitar hasta 10 reseñas. Elija relevancia, más recientes, mejor calificación o peor calificación.
fid · page · sort_by
Explorar la API de Reviewsget_google_maps_photosRecupere hasta 20 registros de metadatos de fotos y vídeos de un lugar. Lea las URLs de medios devueltas y la marca de paginación.
fid · page
Explorar la API de PhotosReviews y Photos aceptan el feature ID de Maps del place.dataId de un resultado de búsqueda. Search usa las páginas 1–10; las herramientas de medios devuelven next para que su agente decida si se necesita otra página.
Conexión MCP
Su cliente gestiona la inicialización y el descubrimiento de herramientas, y luego envía su clave de API con cada solicitud.
POST https://gmapscrawl.com/api/mcp
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json
Accept: application/json, text/event-streamConfiguración del cliente
Cree una clave de API y luego copie la configuración de su cliente. Mantenga la clave en su entorno o en el ajuste de entrada protegido.
Añada este servidor a .mcp.json. Haga que GMSCRAPER_API_KEY esté disponible en el entorno que inicia Claude Code.
{
"mcpServers": {
"google-maps-data": {
"type": "http",
"url": "https://gmapscrawl.com/api/mcp",
"headers": {
"Authorization": "Bearer ${GMSCRAPER_API_KEY}"
}
}
}
}Tras guardar la configuración, reconecte y confirme que aparecen las tres herramientas. Siga la guía de configuración paso a paso.
Su primer flujo de trabajo
Comience con una clave de prueba y datos simulados. Cambie a una clave en vivo cuando esté listo para usar su cuota de API.
Seleccione el producto API y cree una clave de prueba con scrapes:write. Su plan de API debe permitir MCP; Online y Extensión tienen cuotas separadas.
Crear una claveConecte su cliente, inspeccione search_google_maps y pida una página. Genere un ID de solicitud nuevo para trabajo nuevo y consérvelo al reintentar la misma solicitud.
Ver la configuración del clienteLea structuredContent.businesses y total. Etiquete los resultados de prueba como simulados, conserve los valores faltantes y deténgase tras la página solicitada.
Entender los camposSustituya el ID de solicitud para cada nueva búsqueda. Este ejemplo no ejecuta una solicitud desde la página.
{
"q": "coffee shops in Seattle",
"page": 1,
"hl": "en",
"extra": false,
"client_request_id": "replace-with-a-fresh-uuid"
}Lo que vuelve
Los resultados se devuelven directamente; no se necesita sondeo de trabajos. Conserve las fechas de observación de la fuente al convertir el JSON en una tabla o un informe.
Prompts de ejemplo
Use estos prompts después de conectar. Proporcione un feature ID real donde sea necesario y pida a su agente que etiquete los resultados de prueba como simulados.
“Use search_google_maps una vez para cafeterías en Seattle, página 1, extra false. Devuelva nombres, sitios web, números de teléfono, calificaciones y recuentos de reseñas de los negocios devueltos. Deje los campos faltantes en blanco y muestre las fechas de observación. Deténgase tras esta página.”
Resultado esperado
Una tabla de hasta 20 negocios devueltos, con marcas de tiempo de origen y valores faltantes conservados.
“Para el negocio que seleccioné, use su place.dataId como fid. Solicite la página 1 de get_google_maps_reviews con sort_by 2. Resuma los temas solo de estas reseñas devueltas y cite sus fechas. No obtenga páginas adicionales.”
Resultado esperado
Un resumen delimitado de hasta 10 reseñas, sin tratar una página como la experiencia de todos los clientes.
“Use get_google_maps_photos para este feature ID proporcionado, solo página 1. Enumere los campos photoUrl devueltos y los videoUrl opcionales, e informe si next es true. No descargue archivos ni obtenga la página siguiente.”
Resultado esperado
Hasta 20 registros de galería y el estado de paginación devuelto, listos para que su propia aplicación los inspeccione.
REST + MCP
MCP está disponible en los planes de API gratuitos y de pago. Cada página de origen en vivo exitosa usa una unidad de solicitud de API, incluida una página vacía.
Las claves de prueba devuelven fixtures simulados con cero unidades de solicitud. Verifican su integración en lugar de producir leads de negocios reales.
Gestionar claves de APIPida solo las páginas y ubicaciones que su tarea necesita. Use un nuevo ID de solicitud para trabajo nuevo; reintente las solicitudes inciertas con la misma entrada e ID.
Leer la guía de usoEl Agent Skill de Google Maps Data añade guía de flujos de trabajo, referencias de operaciones y un respaldo REST a las mismas herramientas.
Explorar el Agent SkillExplorar el centro de API → Los planes Online y Extensión tienen sus propias cuotas.
Ayuda de conexión
Use el estado de la conexión y el error devuelto para elegir el siguiente paso.
Expone search_google_maps, get_google_maps_reviews y get_google_maps_photos. La búsqueda devuelve hasta 20 negocios; las reseñas devuelven hasta 10 registros y las fotos hasta 20 registros de galería por página. Las herramientas devuelven datos estructurados directamente.
Use una versión de Claude Code, Cursor, VS Code, Codex u otro cliente MCP que admita HTTP Streamable remoto y un encabezado Authorization privado. Las cuatro configuraciones de cliente anteriores usan el mismo endpoint y la clave del espacio de trabajo de API.
Cree una clave de API con scrapes:write en su espacio de trabajo de API y configúrela de forma privada como encabezado Bearer. Las cookies del navegador no autentican MCP. Mantenga las claves fuera de prompts, URLs y código fuente confirmado.
Pase el feature ID de Maps como fid. Puede usar place.dataId de un negocio devuelto. Reviews también acepta sort_by: 1 para relevancia, 2 para más recientes, 3 para mejor calificación o 4 para peor calificación. Lea next antes de considerar otra página de medios.
MCP comparte la cuota de la API REST y está disponible en los planes de API gratuitos y de pago. Una página en vivo exitosa usa una unidad de solicitud, incluida una página vacía. Las credenciales de prueba devuelven datos simulados con cero unidades. Las cuotas de Online y Extensión son separadas.
El servidor MCP funciona por sí solo. El Agent Skill de Google Maps Data opcional añade instrucciones reutilizables, referencias de operaciones y un auxiliar de respaldo REST para cuando su conexión MCP configurada no esté disponible.
Dé el siguiente paso
Cree una clave de API, conecte su cliente preferido y pruebe una búsqueda de negocios enfocada.