goplaces

• 근처 비즈니스나 관심 장소를 찾는 에이전트가 필요한 경우 — 예: "1km 이내에 있는 별점 4점 이상의 영업 중인 커피숍"
• 사람이 읽을 수 있는 위치 이름(예: "Soho, London")을 다운스트림 API 호출을 위한 Google Place ID로 변환하려는 경우
• 구조화된 장소 세부 정보(영업 시간, 주소, 리뷰)를 JSON 출력을 통해 스크립트나 워크플로우로 전달해야 하는 경우
• 에이전트가 영업 여부, 가격대, 유형 또는 지리적 반경으로 결과를 필터링해야 하는 경우

• Google Places API 키가 없거나 얻을 수 없는 경우 — 키 없이는 스킬이 작동하지 않습니다
• 지도 렌더링, 길 안내 또는 경로 탐색이 필요한 경우 — 이 스킬은 조회 전용이며, 완전한 Maps SDK가 아닙니다
• 대량 또는 고용량 장소 데이터가 필요한 경우 — 표준 Google Places API 할당량 및 요금이 적용됩니다

열림 여부, 최소 평점, 가격 수준, 유형, 결과 수 제한 등의 필터를 사용하여 자연어로 장소를 검색할 수 있습니다. 예시: goplaces search "coffee" --open-now --min-rating 4 --limit 5.

특정 위도/경도를 기준으로 검색 결과에 편향을 적용하고, 설정 가능한 반경(미터 단위)으로 결과를 제한하여 위치 인식 검색을 정확하고 관련성 높게 만들 수 있습니다.

resolve 명령어를 사용하여 사람이 읽을 수 있는 위치 이름(예: "Soho, London")을 하나 이상의 Google Place ID로 변환하세요. 이를 통해 수동으로 ID를 찾지 않고도 이후 세부 정보 조회를 원활하게 수행할 수 있습니다.

goplaces details <place_id> --reviews를 통해 리뷰를 포함한 모든 장소 ID의 종합적인 세부 정보를 가져옵니다. 권위 있는 장소 데이터로 에이전트 응답을 풍부하게 만드는 데 이상적입니다.

기본적으로 가독성을 위해 사람이 읽기 쉬운 ANSI 컬러 텍스트를 출력하거나, 스크립트 및 자동화 파이프라인에서 안정적인 파싱을 위해 --json 옵션으로 깔끔한 JSON으로 전환할 수 있습니다. --no-color 옵션 또는 NO_COLOR 환경 변수를 통해 색상을 비활성화할 수 있습니다.

--page-token을 통해 여러 페이지로 구성된 결과 집합을 지원하며, 에이전트가 기본 페이지 크기를 초과하는 대규모 결과 목록을 순차적으로 탐색할 수 있습니다.

사용자의 저녁 외출 계획을 도와주는 에이전트는 특정 동네 내에서 평점이 높고 영업 중인 음식점을 검색하고, 요리 유형과 가격대로 필터링한 후, 상위 결과를 읽기 쉬운 형식으로 제공할 수 있습니다.

데이터 파이프라인 에이전트는 모호한 위치 문자열(예: 도시 구역, 랜드마크)을 공식적인 Google Place ID로 변환하며, 이후 해당 ID는 다른 API 호출에 전달되거나 데이터베이스에 저장됩니다.

장소를 조사하는 에이전트는 goplaces details <id> --reviews를 통해 Google Places 리뷰를 직접 가져와, 브라우저 없이도 감정을 요약하거나 특정 피드백을 추출할 수 있습니다.

배치 자동화 스크립트는 --json 출력을 활용하여 비즈니스 이름 목록에 구조화된 장소 데이터(주소, 평점, 영업시간)를 보강하고, 그 결과를 후속 처리 도구로 전달합니다.