Skip to main content
Glama

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: Local Business Data MCP 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)

도구

용도

일반 소요 시간

get_place_info

메타데이터만: 이름, 전화번호, 평점, 주소, 영업시간, 좌표

~20초

get_place_media

미디어만 (kind: photos / videos / both)

40-220초

fetch_maps_place

원샷 전체 (include: all/info/photos/videos/media)

60-220초

list_maps_places

이전에 가져온 장소

즉시

동일한 장소를 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 (브라우저 설치 도우미).

Available Tools

4 tools
fetch_maps_placeA

Fetch a Google Maps place by link (maps.app.goo.gl/... or full google.com/maps URL). Downloads gallery media at max resolution plus business metadata (name, phone, website, rating, address, plus code, hours, coordinates).

Args: url: Google Maps place link (single place only, not search links). output_dir: optional root directory (default: /mnt/d/Projects/maps-data-fetcher/places). A per-place subfolder is created with photos/, videos/, info_pw.json, contact_sheet.jpg. include: "all" (default) | "info" (metadata only, fast) | "photos" | "videos" | "media" (photos+videos). meta_only: deprecated alias for include="info".

Returns JSON summary: place data, media counts, output paths. Typical run: info ~20-40s, full fetch 60-220s.

Inputs: url (required), include, meta_only, output_dir. Returns: result

get_place_infoA

Fast metadata-only fetch: name, phone, website, rating, address, plus code, hours, coordinates. No media downloaded. Use when the agent only needs business info. ~20-40s.

Inputs: url (required), output_dir. Returns: result

get_place_mediaA

Media-only fetch: downloads gallery photos and/or videos, skips verbose metadata in the response. Use when the agent only needs the images/videos.

Args: kind: "both" (default) | "photos" | "videos". Returns JSON: place name, counts, output dirs.

Inputs: url (required), kind, output_dir. Returns: result

list_maps_placesC

List previously fetched places under the output root with photo/video counts and metadata.

Inputs: output_dir. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 4 tools

    Disambiguation2/5

    There is significant overlap: fetch_maps_place with include='info' does exactly what get_place_info does, and with include='media' does what get_place_media does. While the descriptions clarify the intended use cases, an agent may struggle to pick the right tool since fetch_maps_place is a superset. The tools are not clearly distinct in purpose.

    Naming Consistency2/5

    The naming mixes conventions: 'get_place_info' and 'get_place_media' follow a get_place_N pattern, but 'fetch_maps_place' uses a different verb (fetch) and noun order, and 'list_maps_places' uses plural. The pattern is not consistent across all tools, though the tools are readable.

    Tool Count4/5

    At 4 tools, the server is well-scoped for a maps fetcher. However, the presence of get_place_info and get_place_media is redundant given fetch_maps_place can achieve the same via its include parameter, suggesting the count could be trimmed to 2–3 tools without losing functionality.

    Completeness4/5

    The core lifecycle for fetching Google Maps place data is covered: retrieving metadata, media, or both, plus listing previously fetched places. There are no obvious dead ends for the stated purpose. Missing delete/update operations are not essential for a fetcher, so the surface feels complete.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables web searching via Google Search and AI Mode, plus advanced web scraping capabilities including content extraction in multiple formats, link extraction, and batch scraping of multiple URLs.
      14 npm
      MIT
    • A
      license
      B
      quality
      Not graded
      maintenance
      Enables access to Google Maps business data including search, reviews, photos, and geocoding. Supports searching businesses by location, area, or coordinates, retrieving detailed business information, reviews, and performing reverse geocoding operations.
      13
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables advanced web crawling and content extraction with JavaScript support, AI-powered analysis, PDF/Office document processing, YouTube transcript extraction, Google search integration, and multi-format data export capabilities.
      2
      -