maps-fetcher-mcp

MCP server + CLI: fetch any Google Maps place by link — full business metadata plus ALL gallery photos and videos at max resolution.

Install

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

Use as an MCP server (any MCP client)

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

Works in: Hermes Agent, Claude Desktop, Cursor, opencode, Cline, Zed — anything that speaks MCP (stdio).

Use as a 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

Tools exposed (MCP)

Same place re-fetched within 24h reuses the scrape (~2s).

What it handles

• Short links resolved + canonicalized; search links rejected cleanly

• Video tiles disguised as photos; DASH/HLS manifests muxed with audio

• Expired URLs, avatar junk, motion-blur frames, perceptual duplicates (quarantined, not deleted), gapless file numbering

• Nondeterministic gallery lazy-loading: scrape retried and merged

• Bot-wall detection (reCAPTCHA / unusual-traffic) with clean errors; stealth browser via Patchright, plain Playwright fallback

• Security: google-host allowlist for all media downloads, per-file and per-place size caps, decompression-bomb guard, no secrets

Output

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

Default root: /mnt/d/Projects/maps-data-fetcher/places (WSL layout; override with output_dir or MAPS_FETCHER_ROOT).

Limits

Unofficial scraping — good for batch collection at low volume. Google markup changes can break it (fixes usually small). Not for high-volume production; use the paid Google Places API for that. CAPTCHAs are detected and reported, not auto-solved.

Dev

Source layout: maps_fetcher/core.py (engine), mcp_server.py (MCP tools), cli.py (CLI), setup.py (browser install helper).