maps-fetcher-mcp

Servidor MCP + CLI: obtén cualquier lugar de Google Maps mediante enlace — metadatos completos del negocio, además de TODAS las fotos y videos de la galería en máxima resolución.

Instalación

pip install maps-fetcher-mcp          # or: uv pip install maps-fetcher-mcp
maps-fetcher-setup                    # one-time: browser download (~120MB)

Related MCP server: MCP WebSearch Server

Uso como servidor MCP (cualquier cliente MCP)

{
  "mcpServers": {
    "maps_fetcher": {
      "command": "maps-fetcher-mcp"
    }
  }
}

Funciona en: Hermes Agent, Claude Desktop, Cursor, opencode, Cline, Zed — cualquier cosa que hable MCP (stdio).

Uso como CLI

maps-fetcher "https://maps.app.goo.gl/XXXX"                  # everything
maps-fetcher "https://maps.app.goo.gl/XXXX" --include info   # metadata only (~20s)
maps-fetcher "https://maps.app.goo.gl/XXXX" --include photos
maps-fetcher "https://maps.app.goo.gl/XXXX" --include videos
maps-fetcher --list                                          # what's been fetched

Herramientas expuestas (MCP)

El mismo lugar re-obtenido dentro de 24h reutiliza el scrape (~2s).

Qué maneja

• Enlaces cortos resueltos + canonicalizados; enlaces de búsqueda rechazados limpiamente

• Mosaicos de video disfrazados como fotos; manifiestos DASH/HLS multiplexados con audio

• URLs expiradas, basura de avatares, fotogramas con desenfoque de movimiento, duplicados perceptuales (en cuarentena, no eliminados), numeración de archivos sin huecos

• Carga perezosa no determinista de la galería: scrape reintentado y fusionado

• Detección de muro anti-bot (reCAPTCHA / tráfico inusual) con errores limpios; navegador sigiloso mediante Patchright, respaldo con Playwright simple

• Seguridad: lista blanca de dominios de Google para todas las descargas de medios, límites de tamaño por archivo y por lugar, protección contra bombas de descompresión, sin secretos

Salida

<root>/<place-slug>/
  photos/photo_01.jpg ...   videos/video_01.mp4 ...   quarantine/
  info_pw.json              contact_sheet.jpg

Raíz predeterminada: /mnt/d/Projects/maps-data-fetcher/places (estructura WSL; se puede sobrescribir con output_dir o MAPS_FETCHER_ROOT).

Límites

Scraping no oficial — bueno para recolección por lotes a bajo volumen. Los cambios en el marcado de Google pueden romperlo (las correcciones suelen ser pequeñas). No es para producción de alto volumen; usa la API de Google Places de pago para eso. Los CAPTCHA se detectan y se informan, no se resuelven automáticamente.

Desarrollo

Estructura del código: maps_fetcher/core.py (motor), mcp_server.py (herramientas MCP), cli.py (CLI), setup.py (asistente de instalación del navegador).