Datos de Google Maps / Servidor MCP

Datos de Google Maps, dentro de su flujo de trabajo de IA.

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

Del descubrimiento de negocios al detalle del lugar.

Cada herramienta devuelve su resultado directamente. Elija la operación que su tarea necesite y mantenga las páginas solicitadas explícitas.

Encontrar negocios

search_google_maps

Busque 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 Search

Leer reseñas públicas

get_google_maps_reviews

Use 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 Reviews

Explorar medios de galería

get_google_maps_photos

Recupere 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 Photos

Reviews 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

Un endpoint. Su espacio de trabajo de API.

Su cliente gestiona la inicialización y el descubrimiento de herramientas, y luego envía su clave de API con cada solicitud.

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

Configuración del cliente

Elija el cliente en el que trabaja.

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

Conecte. Pruebe una página. Lea el resultado.

Comience con una clave de prueba y datos simulados. Cambie a una clave en vivo cuando esté listo para usar su cuota de API.

01

Prepare su espacio de trabajo

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 clave
02

Descubra y llame a una herramienta

Conecte 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 cliente
03

Use los negocios devueltos

Lea 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 campos
Llamar a search_google_maps

Sustituya 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

Registros estructurados, en la misma respuesta de la herramienta.

businesses
Hasta 20 negocios devueltos; pueden faltar campos.
params + total
La consulta normalizada y el recuento de esta página.
simulated + usage metadata
Las respuestas de prueba identifican datos fixture y usan cero unidades de solicitud en vivo.
isError
Inspeccione el error antes de informar de que una herramienta tuvo éxito.

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

Una pregunta útil. Un punto de parada claro.

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.

Cree una lista de negocios enfocada

“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.

Resuma una página de reseñas

“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.

Inspeccione una galería

“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

Una cuota de API en ambas interfaces.

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.

01

Pruebe sin uso en vivo

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 API
02

Mantenga las solicitudes delimitadas

Pida 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 uso
03

Añada instrucciones reutilizables

El 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 Skill

Explorar el centro de API → Los planes Online y Extensión tienen sus propias cuotas.

Ayuda de conexión

Llegue a la siguiente solicitud exitosa.

Use el estado de la conexión y el error devuelto para elegir el siguiente paso.

El cliente conecta pero no aparecen herramientas
Confirme que el endpoint es /api/mcp y que su cliente admite HTTP Streamable remoto con un encabezado Authorization privado. Recargue la conexión y compruebe que su proceso puede leer la clave configurada.
401 o 403
Compruebe la caducidad de la clave, las IP permitidas, el acceso activo al espacio de trabajo, el alcance scrapes:write y un plan de API que permita MCP. Las cookies de inicio de sesión del navegador no autentican el endpoint.
invalid_request
Lea el esquema de la herramienta seleccionada. Proporcione un client_request_id único de 16–128 caracteres; reviews y photos también necesitan el FID de place.dataId, en lugar de un nombre de negocio u otro identificador de lugar.
rate_limited o quota_exceeded
Respete retry_after para los límites de frecuencia. Deténgase cuando la cuota de API se agote y compruebe su uso de API; crear otra clave no añade cuota.
capability_unavailable o un fallo de la fuente
Compruebe el estado del servicio y el error devuelto. La disponibilidad la determina el servidor. Mantenga los datos faltantes o no disponibles explícitos en su resultado.
Timeout o isError: true
Inspeccione el error de la herramienta aunque la conexión HTTP haya tenido éxito. Para fallos reintentables, mantenga la misma entrada y el mismo ID de solicitud dentro del plazo de su tarea. Siga la guía de errores terminales antes de iniciar un nuevo intento.

Estado del servicio Errores y guía de reintentos

Preguntas frecuentes

¿Qué puede hacer el servidor MCP de Google Maps?

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.

¿Qué clientes puedo conectar?

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.

¿Cómo me autentico?

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.

¿Cómo encuentran reviews y photos el lugar correcto?

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 tiene una cuota separada?

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.

¿También necesito el Agent Skill?

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

Lleve los datos de Google Maps a su próxima conversación.

Cree una clave de API, conecte su cliente preferido y pruebe una búsqueda de negocios enfocada.