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 (브라우저 설치 도우미).