goplaces

Query Google Places API for text search, place details, and reviews via CLI.

Updated Jun 19, 2026
One-click install
npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill goplaces-amirulandalib
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: goplaces
Source: https://github.com/AmirulAndalib/Vilvona-AI/tree/main/skills/goplaces
Command: npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill goplaces-amirulandalib

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding and retrieving structured information about real-world places—restaurants, shops, landmarks—requires calling the Google Places API directly, which involves authentication, pagination, and response parsing. This Skill wraps the goplaces CLI so you can search places, resolve locations, and pull details or reviews with simple commands. ## Core Features & Use Cases - Text Search with Filters: Search places by keyword with filters like open-now, minimum rating, price level, and location bias with radius. - Place Details & Reviews: Resolve a location name to candidates, then fetch full details and reviews for a specific place ID. - Scriptable JSON Output: Use the --json flag to pipe structured results into scripts or other tools. - Use Case: Ask for the top-rated coffee shops near a coordinate that are currently open, then fetch reviews for the best match to summarize customer sentiment. ## Quick Start Use the goplaces skill to search for highly rated pizza places near latitude 40.8, longitude -73.9 within 3 kilometers and show the results as JSON.

Frequently Asked Questions about goplaces

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search Google Places from the command line?

Use the goplaces CLI with a command like goplaces search "coffee" --open-now --min-rating 4 --limit 5. It returns human-readable results by default, and you can add --json for machine-readable output.

How do I get reviews for a specific Google Places location?

Run goplaces details <place_id> --reviews to fetch details and reviews for a place. You can obtain the place ID first by resolving a name with goplaces resolve "Soho, London" --limit 5.

What API key does goplaces need to work?

goplaces requires a Google Places API key set in the GOOGLE_PLACES_API_KEY environment variable. You can optionally set GOOGLE_PLACES_BASE_URL for testing or proxying requests.

How do I install the goplaces CLI?

Install goplaces via Homebrew with brew install steipete/tap/goplaces. After installation, verify the goplaces binary is on your PATH and set your API key before running searches.

Can I filter Google Places search results by location and rating?

Yes, goplaces supports location bias with --lat, --lng, and --radius-m flags, plus --min-rating and --open-now filters. Note that only the first --type value is sent because the API accepts a single type filter.

How do I paginate through Google Places search results?

Pass the next page token from a previous response using goplaces search "pizza" --page-token "NEXT_PAGE_TOKEN". This retrieves the following page of results from the Google Places API.