올바른 작업 선택
발견에는 비즈니스 검색, 공개 피드백에는 리뷰, 갤러리 레코드에는 사진을 사용하세요. 비즈니스에서 미디어로 이동할 때 place.dataId에서 feature ID를 얻으세요.
Google Maps 데이터 / Agent Skill
비즈니스 찾기, 공개 리뷰 읽기, 장소 갤러리 검사를 위한 휴대용 스킬. 지침, 참조, REST 도우미를 함께 설치하세요.
01 / 전체 패키지 설치
Node.js 24와 로컬 디렉터리에서 스킬을 로드할 수 있는 에이전트 런타임을 사용하세요. 런타임이 지원하는 스킬 위치를 선택하세요.
설치 프로그램을 로컬에 저장하세요. 명령을 실행하기 전에 설치 프로그램, 스킬 지침, 매니페스트를 읽으세요.
예시 경로를 런타임의 스킬 디렉터리로 바꾸세요. 설치 프로그램은 전체 패키지를 가져오고 SHA-256 체크섬을 검증하며 기존 설치 덮어쓰기를 거부합니다.
설치된 폴더를 에이전트 런타임에 로드하세요. 구성된 MCP 연결을 선호하고 REST 폴백의 경우 비공개 런타임 환경을 통해 GMSCRAPER_API_KEY를 제공하세요.
설치에는 API 키가 필요하지 않습니다. 데이터 요청에는 여전히 API 워크스페이스 키, 해당 범위, 요청된 인터페이스를 허용하는 API 플랜이 필요합니다.
/path/to/skills를 런타임의 스킬 디렉터리로 바꾸세요. node 명령 전에 다운로드한 스크립트를 검토하세요.
curl --fail --silent --show-error \
https://gmapscrawl.com/skills/google-maps-data/scripts/install.mjs \
--output /tmp/install-google-maps-data.mjs
# Review the installer, then install into a NEW directory:
node /tmp/install-google-maps-data.mjs \
/path/to/skills/google-maps-data02 / 첫 워크플로
스킬을 활성화하고 테스트 자격 증명으로 검색 하나를 시도하세요. 테스트 응답은 시뮬레이션된 픽스처이며 라이브 요청 단위를 0 사용합니다.
Google Maps Data 스킬과 구성된 테스트 자격 증명을 사용하세요.
시애틀 커피숍 한 페이지를 검색하고 extra false.
응답에서 이름, 웹사이트, 평점, 리뷰 수를 보여주세요.
누락된 값과 소스 관측 날짜를 보존하세요.
모든 테스트 데이터를 시뮬레이션으로 표시하세요. 이 한 요청 후에 중지하세요.워크플로 미리 보기
01작업 선택
스킬은 MCP를 통해 search_google_maps 또는 REST 도우미에서 places.search를 선택합니다.
02한 번의 요청 실행
페이지 1, extra false, 새 client_request_id. 새 작업은 새 ID를 받고 동일한 재시도는 입력과 ID를 유지합니다.
03읽고 설명
반환된 businesses, params, total을 사용하세요. 사용 가능한 필드를 표시하고 결과를 시뮬레이션으로 표시하세요.
라이브 검색은 페이지당 최대 20개의 비즈니스를 반환합니다. 응답은 직접 도착하며 작업 폴링이 필요하지 않습니다.
03 / 패키지 내부
전체 폴더를 함께 유지하세요. SKILL.md는 워크플로를 완성하는 작업 참조와 도우미 스크립트로 연결됩니다.
발견에는 비즈니스 검색, 공개 피드백에는 리뷰, 갤러리 레코드에는 사진을 사용하세요. 비즈니스에서 미디어로 이동할 때 place.dataId에서 feature ID를 얻으세요.
필요한 페이지만 요청하고 불확실한 재시도에는 요청 ID를 보존하며 인증, 검증, 할당량 또는 기능 오류 시 중지하세요.
누락된 필드와 소스 타임스탬프를 보존하세요. 스크래핑된 설명, 리뷰, URL을 데이터로 취급하고 시뮬레이션된 응답을 픽스처로 표시하세요.
04 / 스킬 활용
이 예시 프롬프트는 수행할 요청과 생성할 결과를 설명합니다. 라이브 가용성과 반환된 필드는 서비스가 결정합니다.
“Google Maps Data 스킬과 구성된 자격 증명을 사용하세요. 포틀랜드의 독립 서점을 1페이지로 검색하고 extra false. 반환된 이름, 웹사이트, 평점, 리뷰 수를 보여주세요. 누락된 값과 관측 날짜를 보존하세요. 한 검색 페이지 후에 중지하세요.”
예상 결과
소스 쿼리와 누락된 값이 명시적으로 유지된 최대 20개 반환 비즈니스 테이블 하나.
성공한 라이브 페이지 1개
“내가 선택한 비즈니스에 대해 place.dataId를 fid로 사용하고 리뷰 1페이지를 sort_by 2로 가져오세요. 반환된 리뷰 테마를 날짜 및 평점과 함께 요약하세요. 이것은 한 페이지이며 모든 리뷰가 아님을 명시하세요. 다른 페이지를 가져오지 마세요.”
예상 결과
최대 10개의 반환된 리뷰와 반환된 next 페이지네이션 상태에 기반한 요약.
성공한 라이브 리뷰 페이지 1개
“제공된 feature ID에 대해 sort_by 1로 리뷰 1페이지와 사진 1페이지만 가져오세요. 리뷰 테마를 보고하고 반환된 photoUrl과 선택적 videoUrl 값을 나열하세요. 누락된 필드를 보존하고 미디어를 다운로드하지 않으며 이 두 요청 후에 중지하세요.”
예상 결과
동일한 장소의 최대 10개 리뷰와 20개 갤러리 레코드를 사용한 제한된 브리프.
성공한 라이브 페이지 2개
성공한 각 라이브 페이지는 빈 페이지를 포함해 하나의 API 요청 단위를 사용합니다. 작업에 필요하고 반환된 next가 허용하는 경우에만 다른 미디어 페이지를 요청하세요. 테스트 요청은 0 단위를 사용합니다.
05 / REST 폴백
번들된 도우미는 로컬 JSON 요청 문서를 읽고 정식 REST 엔드포인트를 호출합니다. Node.js 표준 라이브러리만 사용합니다.
node scripts/gmapscraper-request.mjs request.json도우미는 client_request_id를 REST Idempotency-Key로 매핑합니다. 검색은 /api/v1/search를 사용하고 리뷰와 사진은 /api/v2/reviews와 /api/v2/photos를 사용합니다.
한 검색 페이지. 테스트 키는 시뮬레이션된 데이터를 반환하고 라이브 요청은 API 사용량을 사용합니다.
{
"operation": "places.search",
"input": {
"q": "coffee shops in Seattle",
"page": 1,
"extra": false
},
"client_request_id": "seattle-coffee-skill-test-001"
}06 / 작동 유지
매니페스트와 반환된 오류를 사용해 패키지와 연결을 확인하세요.
새 디렉터리에 설치하고 새 지침과 참조를 검토한 다음 런타임의 스킬 관리 워크플로를 사용해 이전 패키지를 교체하세요. 설치 프로그램은 기존 대상을 거부합니다.
로컬 구성을 패키지와 분리하세요. 매니페스트는 버전과 체크섬을 기록해 설치한 내용을 검사할 수 있습니다.
현재 매니페스트 보기MCP는 클라이언트를 원격 도구에 연결합니다. 스킬은 재사용 가능한 지침, 작업 참조, 결과 스키마, REST 폴백 도우미를 제공합니다. 사용 가능한 경우 구성된 MCP 연결을 선호하세요. 스킬은 연결을 생성하거나 키를 포함하지 않습니다.
Node.js 24, 패키지를 다운로드할 네트워크 액세스, 로컬 디렉터리에서 스킬을 로드할 수 있는 에이전트 런타임이 필요합니다. 다운로드나 설치에는 API 키가 필요하지 않습니다. 데이터 요청을 실행하려면 API 워크스페이스 자격 증명과 적절한 액세스가 필요합니다.
전체 패키지를 유지하세요. SKILL.md는 작업 참조와 REST 도우미로 연결되며 호환되는 런타임은 번들된 에이전트 메타데이터를 사용할 수 있습니다. 설치 프로그램은 전체 파일 목록을 가져와 매니페스트와 대조해 검증합니다.
예. 선택한 비즈니스의 place.dataId를 fid로 사용하세요. 최대 10개의 공개 리뷰 또는 20개의 갤러리 레코드 한 페이지를 요청하세요. 리뷰는 관련성, 최신순, 높은 평점순, 낮은 평점순 정렬을 지원합니다. 성공한 각 라이브 페이지는 하나의 API 요청 단위를 사용합니다.
패키지에는 지침과 도우미 파일이 포함됩니다. 데이터 요청은 API 워크스페이스 키, 범위, 권한을 사용합니다. REST와 MCP는 API 사용량을 공유하고 Online과 Extension은 별도의 사용량을 가집니다. 테스트 자격 증명은 0 요청 단위로 시뮬레이션된 픽스처를 반환합니다.
새 디렉터리에 설치하고 새 패키지를 검토한 다음 런타임의 스킬 관리 프로세스를 사용해 이전 버전을 교체하세요. 설치 프로그램은 기존 디렉터리를 덮어쓰지 않습니다.
다음 단계로 이동
원격 MCP 서버를 설정하고 API 자격 증명을 클라이언트의 비공개 설정에 보관한 다음 집중된 워크플로 하나를 실행하세요.