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, мусорные аватары, кадры с motion blur, перцептивные дубликаты (карантин, а не удаление), бесшовная нумерация файлов

• Недетерминированная ленивая загрузка галереи: повторный скрейпинг и объединение

• Обнаружение бот-стены (reCAPTCHA / необычный трафик) с понятными ошибками; скрытый браузер через Patchright, запасной вариант — обычный Playwright

• Безопасность: белый список google-хостов для всех загрузок медиа, лимиты на размер файла и места, защита от decompression bomb, никаких секретов

Вывод

<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 (хелпер установки браузера).