maps-fetcher-mcp

MCPサーバー + CLI: リンクから任意のGoogleマップの場所を取得 — 完全なビジネスメタデータに加え、すべてのギャラリー写真と動画を最大解像度で取得します。

インストール

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（ブラウザインストールヘルパー）。