Ayyouboss0011/SherlockMaps

Google Maps에서 회사 정보를 자동으로 수집하는 오픈소스 웹 크롤러

설치형 도구맘대로 써도 됨 · MIT데이터·크롤링Python난이도
81+2이번 주0 찜
8포크0이슈

중간맛 분석

Python 3.9+ 기반의 객체지향 설계로 구축된 크롤러입니다. 기술 스택: Playwright(브라우저 자동화), FastAPI(REST 서버), (배포). 난이도: 중간 수준. 바로 쓸 수 있나요: 네, Compose로 한 번에 시작 가능합니다. 데모: 검색어를 보내면 회사명, 카테고리, 주소, 전화, 웹사이트, 별점, 리뷰 수, 영업시간, 접근성 정보 등을 JSON/CSV 형식으로 반환합니다. , Python 라이브러리, REST 세 가지 모드를 지원합니다.

이런 레포예요

이럴 때 쓰면 좋아요

  • 부동산, 식당, 매장 등의 지역 기반 비즈니스 정보 대량 수집
  • 경쟁사 분석을 위한 업계별 기업 정보 및 연락처 수집
  • 지역별 비즈니스 디렉토리 구축 및 데이터 마이그레이션

핵심 기능

Google Maps 검색어 기반 자동 데이터 추출(이름, 주소, 전화, 웹사이트, 별점, 영업시간)중복 제거 및 URL 검증을 통한 데이터 정제Docker, REST API, CLI, Python 라이브러리 다중 인터페이스 지원

대안 대비 차별점

Google Maps API 비용 없이 비동기 REST API 기반 프로덕션급 크롤러를 제공하며, 구조화된 데이터 모델과 자동 중복 제거·URL 검증으로 엔터프라이즈 운영이 가능합니다.

준비물

  • Python 3.9 이상 (Docker 사용 시 불필요)
  • Git
  • Docker & Docker Compose (권장)

바로 시작하기

  1. 저장소 클론
git clone https://github.com/Ayyouboss0011/SherlockMaps.git
cd SherlockMaps
  1. Docker Compose로 API 서버 실행
docker compose up -d
  1. 크롤링 작업 시작
curl -X POST http://localhost:8000/crawl \
  -H "Content-Type: application/json" \
  -d '{"prompt": "restaurants berlin"}'
  1. 결과 확인
curl http://localhost:8000/results
  1. 컨테이너 종료
docker compose down

별 추이 · 7일

81+2 / 7일

활용성 · 따라 만들기 좋은가

샘플 점수 34/100
  • 관대한 라이선스
  • 테스트 있음
  • 예제 디렉토리
  • 최근 활동
  • AGENTS.md
  • llms.txt
  • 템플릿

🟢 최근 활동 있음 · 2026년 생성

이 레포에 깃밥 배지 달기

[![깃밥](https://www.gitbap.com/badge/Ayyouboss0011/SherlockMaps.svg)](https://www.gitbap.com/r/Ayyouboss0011/SherlockMaps)

🔌 클로드에서 바로 써보기

깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.

방법 ① 커넥터 URL

클로드 설정 → 커넥터에 이 주소를 붙여넣기.

https://www.gitbap.com/api/mcp
방법 ② 플러그인 (체험까지)

플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
연결 방법 자세히 →

AI가 README 기반으로 요약했습니다 · 원문 보기