goplaces

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

1|Updated Jun 9, 2026
One-click install
npx skills add https://github.com/JEROME-PRAKASH-L/openclaw --skill goplaces-jerome-prakash-l
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: goplaces
Source: https://github.com/JEROME-PRAKASH-L/openclaw/tree/main/skills/goplaces
Command: npx skills add https://github.com/JEROME-PRAKASH-L/openclaw --skill goplaces-jerome-prakash-l

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding and retrieving structured information about real-world places—such as restaurants, shops, or landmarks—requires manual Google Maps searches or writing custom API integrations. This Skill wraps the Google Places API (New) in a simple CLI so you can search, resolve, and inspect places directly from the terminal or scripts. ## Core Features & Use Cases - Text Search with Filters: Search places by keyword with filters like open-now, minimum rating, location bias, radius, and price level. - Place Details & Reviews: Fetch full details and reviews for a specific place using its place ID. - Scriptable JSON Output: Use --json to pipe structured results into other tools or automation workflows. - Use Case: Ask your assistant to find the top-rated coffee shops near a location that are currently open, then pull reviews for the best match to help decide where to go. ## Quick Start Use the goplaces skill to search for highly rated pizza places near coordinates 40.8, -73.9 that are open now and return 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 supports filters for rating, open status, location bias, radius, and price level, with human-readable output by default.

How do I get Google Places API results as JSON for scripting?

Add the `--json` flag to any goplaces command, such as `goplaces search "sushi" --json`. This returns structured JSON output suitable for piping into jq or other automation tools.

What do I need to set up before using goplaces?

Install the binary via Homebrew with `brew install steipete/tap/goplaces` and set the GOOGLE_PLACES_API_KEY environment variable. Optionally set GOOGLE_PLACES_BASE_URL for testing or proxying.

Can I fetch reviews for a specific Google Maps place?

Yes, run `goplaces details <place_id> --reviews` to retrieve full place details including reviews. You can obtain the place ID first using the search or resolve commands.

What are the limitations of goplaces search filters?

The type filter only sends the first `--type` value because the Google Places API accepts a single type per request. Price levels range from 0 to 4, and pagination requires passing the next page token manually with `--page-token`.