maps-fetcher-mcp

MCP-Server + CLI: Rufe jeden Google-Maps-Ort per Link ab – vollständige Geschäftsdaten plus ALLE Galerie-Fotos und -Videos in maximaler Auflösung.

Installation

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

Als MCP-Server verwenden (beliebiger MCP-Client)

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

Funktioniert mit: Hermes Agent, Claude Desktop, Cursor, opencode, Cline, Zed – alles, was MCP (stdio) spricht.

Als CLI verwenden

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

Verfügbare Tools (MCP)

Derselbe Ort, der innerhalb von 24 Stunden erneut abgerufen wird, nutzt das Scrape erneut (~2s).

Was es verarbeitet

• Kurzlinks werden aufgelöst und kanonisiert; Suchlinks werden sauber abgelehnt

• Video-Kacheln, die als Fotos getarnt sind; DASH/HLS-Manifeste mit Audio gemuxt

• Abgelaufene URLs, Avatar-Müll, Bewegungsunschärfe-Frames, wahrnehmungsbezogene Duplikate (unter Quarantäne, nicht gelöscht), lückenlose Dateinummerierung

• Nichtdeterministisches Lazy-Loading der Galerie: Scrape wird wiederholt und zusammengeführt

• Bot-Erkennung (reCAPTCHA / ungewöhnlicher Datenverkehr) mit sauberen Fehlern; Stealth-Browser über Patchright, einfacher Playwright-Fallback

• Sicherheit: Google-Host-Allowlist für alle Medien-Downloads, Größenlimits pro Datei und pro Ort, Schutz vor Dekompressionsbomben, keine Geheimnisse

Ausgabe

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

Standard-Root: /mnt/d/Projects/maps-data-fetcher/places (WSL-Layout; überschreibbar mit output_dir oder MAPS_FETCHER_ROOT).

Grenzen

Inoffizielles Scraping – gut für Batch-Sammlungen bei geringem Volumen. Google-Markup-Änderungen können es brechen (Fixes sind meist klein). Nicht für Produktion mit hohem Volumen; nutze dafür die kostenpflichtige Google Places API. CAPTCHAs werden erkannt und gemeldet, nicht automatisch gelöst.

Entwicklung

Quellcode-Layout: maps_fetcher/core.py (Engine), mcp_server.py (MCP-Tools), cli.py (CLI), setup.py (Browser-Installationshelfer).