비즈니스 찾기
search_google_maps카테고리와 지역으로 검색하세요. 사용 가능한 리스팅, 연락처, 평점, 리뷰 수 필드가 있는 최대 20개의 비즈니스를 받습니다.
q · page · extra
Search API 살펴보기사용 중인 MCP 클라이언트와 함께 작동
원격 Streamable HTTP · 비공개 API 키 · 무료 및 유료 API 플랜
세 개의 도구 / 하나의 연결
각 도구는 결과를 직접 반환합니다. 작업에 필요한 작업을 선택하고 요청된 페이지를 명시적으로 유지하세요.
search_google_maps카테고리와 지역으로 검색하세요. 사용 가능한 리스팅, 연락처, 평점, 리뷰 수 필드가 있는 최대 20개의 비즈니스를 받습니다.
q · page · extra
Search API 살펴보기get_google_maps_reviews장소의 feature ID를 사용해 최대 10개의 리뷰를 요청하세요. 관련성, 최신순, 높은 평점순, 낮은 평점순을 선택할 수 있습니다.
fid · page · sort_by
Reviews API 살펴보기get_google_maps_photos한 장소의 사진 및 동영상 메타데이터 레코드를 최대 20개까지 가져옵니다. 반환된 미디어 URL과 페이지네이션 플래그를 읽으세요.
fid · page
Photos API 살펴보기Reviews와 photos는 검색 결과의 place.dataId에서 Maps feature ID를 허용합니다. Search는 1~10페이지를 사용하고 미디어 도구는 next를 반환해 에이전트가 다른 페이지가 필요한지 결정할 수 있습니다.
MCP 연결
클라이언트가 초기화와 도구 검색을 처리한 다음 각 요청과 함께 API 키를 보냅니다.
POST https://gmapscrawl.com/api/mcp
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json
Accept: application/json, text/event-stream클라이언트 설정
API 키를 만든 다음 클라이언트의 구성을 복사하세요. 키는 환경이나 보호된 입력 설정에 보관하세요.
이 서버를 .mcp.json에 추가하세요. Claude Code를 실행하는 환경에서 GMSCRAPER_API_KEY를 사용할 수 있게 하세요.
{
"mcpServers": {
"google-maps-data": {
"type": "http",
"url": "https://gmapscrawl.com/api/mcp",
"headers": {
"Authorization": "Bearer ${GMSCRAPER_API_KEY}"
}
}
}
}구성을 저장한 후 다시 연결하고 세 가지 도구가 나타나는지 확인하세요. 단계별 설정 가이드를 따르세요.
첫 워크플로
테스트 키와 시뮬레이션된 데이터로 시작하세요. API 사용량을 사용할 준비가 되면 라이브 키로 전환하세요.
API 제품을 선택하고 scrapes:write로 테스트 키를 만드세요. API 플랜이 MCP를 허용해야 하며 Online과 Extension은 별도의 사용량을 가집니다.
키 만들기클라이언트를 연결하고 search_google_maps를 검사한 후 한 페이지를 요청하세요. 새 작업에는 새 요청 ID를 생성하고 동일한 요청을 재시도할 때는 보존하세요.
클라이언트 설정 보기structuredContent.businesses와 total을 읽으세요. 테스트 결과를 시뮬레이션으로 표시하고 누락된 값을 보존하며 요청된 페이지 후에 중지하세요.
필드 이해하기각 새 검색에 대해 요청 ID를 교체하세요. 이 예시는 페이지에서 요청을 실행하지 않습니다.
{
"q": "coffee shops in Seattle",
"page": 1,
"hl": "en",
"extra": false,
"client_request_id": "replace-with-a-fresh-uuid"
}돌아오는 것
결과는 직접 반환되며 작업 폴링이 필요하지 않습니다. JSON을 테이블이나 보고서로 변환할 때 소스 관측 날짜를 유지하세요.
예시 프롬프트
연결 후 이 프롬프트를 사용하세요. 필요한 곳에 실제 feature ID를 제공하고 에이전트에게 테스트 결과를 시뮬레이션으로 표시하도록 요청하세요.
“search_google_maps를 시애틀 커피숍, 페이지 1, extra false로 한 번 사용하세요. 반환된 비즈니스에서 이름, 웹사이트, 전화번호, 평점, 리뷰 수를 반환하세요. 누락된 필드는 비워 두고 관측 날짜를 표시하세요. 이 페이지 후에 중지하세요.”
예상 결과
소스 타임스탬프와 누락된 값이 보존된 최대 20개의 반환된 비즈니스 테이블.
“내가 선택한 비즈니스에 대해 place.dataId를 fid로 사용하세요. sort_by 2로 get_google_maps_reviews의 1페이지를 요청하세요. 반환된 이 리뷰들만의 테마를 요약하고 날짜를 인용하세요. 추가 페이지를 가져오지 마세요.”
예상 결과
한 페이지를 모든 고객의 경험으로 취급하지 않는 최대 10개 리뷰의 제한된 요약.
“제공된 이 feature ID에 대해 get_google_maps_photos를 1페이지만 사용하세요. 반환된 photoUrl과 선택적 videoUrl 필드를 나열하고 next가 true인지 보고하세요. 파일을 다운로드하거나 다음 페이지를 가져오지 마세요.”
예상 결과
자체 애플리케이션에서 검사할 준비가 된 최대 20개의 갤러리 레코드와 반환된 페이지네이션 상태.
REST + MCP
MCP는 무료 및 유료 API 플랜에서 사용할 수 있습니다. 성공한 각 라이브 소스 페이지는 빈 페이지를 포함해 하나의 API 요청 단위를 사용합니다.
테스트 키는 0 요청 단위로 시뮬레이션된 픽스처를 반환합니다. 실제 비즈니스 잠재 고객을 생성하는 것이 아니라 통합을 검증합니다.
API 키 관리작업에 필요한 페이지와 위치만 요청하세요. 새 작업에는 새 요청 ID를 사용하고 불확실한 요청은 동일한 입력과 ID로 재시도하세요.
사용 지침 읽기Google Maps Data Agent Skill은 동일한 도구에 워크플로 지침, 작업 참조, REST 폴백을 추가합니다.
Agent Skill 살펴보기API 허브 살펴보기 → Online과 Extension 플랜은 자체 사용량을 가집니다.
연결 도움말
연결 상태와 반환된 오류를 사용해 다음 단계를 선택하세요.
search_google_maps, get_google_maps_reviews, get_google_maps_photos를 노출합니다. Search는 최대 20개의 비즈니스를 반환하고, 리뷰는 페이지당 최대 10개, 사진은 최대 20개의 갤러리 레코드를 반환합니다. 도구는 구조화된 데이터를 직접 반환합니다.
원격 Streamable HTTP와 비공개 Authorization 헤더를 지원하는 Claude Code, Cursor, VS Code, Codex 또는 다른 MCP 클라이언트 버전을 사용하세요. 위의 네 가지 클라이언트 구성은 동일한 엔드포인트와 API 워크스페이스 키를 사용합니다.
API 워크스페이스에서 scrapes:write가 있는 API 키를 만들고 Bearer 헤더로 비공개로 구성하세요. 브라우저 쿠키는 MCP를 인증하지 않습니다. 키는 프롬프트, URL, 커밋된 소스 코드 밖에 보관하세요.
Maps feature ID를 fid로 전달하세요. 반환된 비즈니스의 place.dataId를 사용할 수 있습니다. 리뷰는 sort_by도 허용합니다: 관련성은 1, 최신순은 2, 높은 평점순은 3, 낮은 평점순은 4입니다. 다른 미디어 페이지를 고려하기 전에 next를 읽으세요.
MCP는 REST API 사용량을 공유하며 무료 및 유료 API 플랜에서 사용할 수 있습니다. 성공한 라이브 페이지는 빈 페이지를 포함해 하나의 요청 단위를 사용합니다. 테스트 자격 증명은 0 단위로 시뮬레이션된 데이터를 반환합니다. Online과 Extension 사용량은 별도입니다.
MCP 서버는 자체적으로 작동합니다. 선택적 Google Maps Data Agent Skill은 구성된 MCP 연결을 사용할 수 없을 때 재사용 가능한 지침, 작업 참조, REST 폴백을 위한 도우미를 추가합니다.
다음 단계로 이동
API 키를 만들고 선호하는 클라이언트를 연결한 다음 집중된 비즈니스 검색 하나를 테스트하세요.