maps-fetcher-mcp

MCP 服务器 + CLI：通过链接获取任意 Google Maps 地点 — 完整的商家元数据，以及最高分辨率下的全部相册照片和视频。

安装

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

作为 MCP 服务器使用（任意 MCP 客户端）

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

适用于：Hermes Agent、Claude Desktop、Cursor、opencode、Cline、Zed — 任何支持 MCP（stdio）的工具。

作为 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

暴露的工具（MCP）

同一地点在 24 小时内重新获取会复用抓取结果（约 2 秒）。

功能特性

• 短链接解析并规范化；搜索链接被干净地拒绝

• 伪装成照片的视频磁贴；DASH/HLS 清单与音频混合

• 过期 URL、头像垃圾、运动模糊帧、感知重复（隔离而非删除）、无间隙文件编号

• 非确定性相册懒加载：抓取重试并合并

• 机器人墙检测（reCAPTCHA / 异常流量）并给出清晰错误；通过 Patchright 使用隐身浏览器，回退到普通 Playwright

• 安全：所有媒体下载的 google 主机白名单、按文件和按地点的大小上限、解压炸弹防护、无密钥

输出

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

默认根目录：/mnt/d/Projects/maps-data-fetcher/places（WSL 布局；可通过 output_dir 或 MAPS_FETCHER_ROOT 覆盖）。

限制

非官方抓取 — 适合低量批量收集。Google 标记变更可能导致其失效（修复通常很小）。不适合高量生产环境；请使用付费的 Google Places API。CAPTCHA 会被检测并报告，但不会自动解决。

开发

源码结构：maps_fetcher/core.py（引擎）、mcp_server.py（MCP 工具）、cli.py（CLI）、setup.py（浏览器安装助手）。