PluginBench
Skill
Review
Audit score 70

goplaces

openclaw/openclaw

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

What is goplaces?

goplaces is a modern command-line interface to the Google Places API (New). Use it to search for places by text or location, fetch detailed place information and reviews, resolve addresses, and output results as human-readable text or JSON for scripting.

  • Search places by text with filters (open now, min rating, price level, type)
  • Bias search results by geographic coordinates and radius
  • Paginate through large result sets
  • Resolve addresses and location names to place IDs
  • Fetch detailed place information including reviews
  • Output results as formatted text or machine-readable JSON

How to install goplaces

npx skills add https://github.com/openclaw/openclaw --skill goplaces
Prerequisites
  • Google Places API key (set as GOOGLE_PLACES_API_KEY environment variable)
  • Homebrew (for installation via `brew install steipete/tap/goplaces`)
Claude Code
Cursor
Windsurf
Cline

How to use goplaces

  1. 1.Install goplaces via Homebrew: `brew install steipete/tap/goplaces`
  2. 2.Set your Google Places API key: `export GOOGLE_PLACES_API_KEY=your_key`
  3. 3.Run a text search: `goplaces search "coffee" --open-now --min-rating 4`
  4. 4.Add geographic bias with `--lat` and `--lng` flags to narrow results
  5. 5.Use `--json` flag to output results as JSON for parsing in scripts
  6. 6.Fetch place details and reviews: `goplaces details <place_id> --reviews`

Use cases

Good for
  • Find nearby restaurants or services filtered by rating and hours
  • Build location-aware applications that query place details programmatically
  • Resolve ambiguous location names to canonical place IDs
  • Aggregate and analyze place reviews and ratings
  • Create scripts that batch-query multiple locations and export results
Who it's for
  • Developers building location-based applications
  • Data analysts researching place information at scale
  • DevOps engineers automating location queries in workflows
  • Anyone needing programmatic access to Google Places data

goplaces FAQ

What API does goplaces use?

goplaces uses the Google Places API (New), the current version of Google's place search and details service.

How do I filter search results?

Use flags like `--open-now`, `--min-rating`, `--type`, `--price-level`, and geographic bias with `--lat`, `--lng`, and `--radius-m`.

Can I use goplaces in scripts?

Yes, add the `--json` flag to any command to output machine-readable JSON instead of human-formatted text.

What does the resolve command do?

The resolve command converts an address or location name (e.g., 'Soho, London') into place IDs and details, useful for disambiguating user input.

How do I handle large result sets?

Use pagination with the `--page-token` flag, passing the token from the previous response to fetch the next page of results.

Full instructions (SKILL.md)

Source of truth, from openclaw/openclaw.


name: goplaces description: "Query Google Places for text search, place details, resolve, reviews, or scriptable JSON via goplaces." homepage: https://github.com/steipete/goplaces metadata: { "openclaw": { "emoji": "📍", "requires": { "bins": ["goplaces"], "env": ["GOOGLE_PLACES_API_KEY"] }, "primaryEnv": "GOOGLE_PLACES_API_KEY", "install": [ { "id": "brew", "kind": "brew", "formula": "steipete/tap/goplaces", "bins": ["goplaces"], "label": "Install goplaces (brew)", }, ], }, }

goplaces

Modern Google Places API (New) CLI. Human output by default, --json for scripts.

Install

  • Homebrew: brew install steipete/tap/goplaces

Config

  • GOOGLE_PLACES_API_KEY required.
  • Optional: GOOGLE_PLACES_BASE_URL for testing/proxying.

Common commands

  • Search: goplaces search "coffee" --open-now --min-rating 4 --limit 5
  • Bias: goplaces search "pizza" --lat 40.8 --lng -73.9 --radius-m 3000
  • Pagination: goplaces search "pizza" --page-token "NEXT_PAGE_TOKEN"
  • Resolve: goplaces resolve "Soho, London" --limit 5
  • Details: goplaces details <place_id> --reviews
  • JSON: goplaces search "sushi" --json

Notes

  • --no-color or NO_COLOR disables ANSI color.
  • Price levels: 0..4 (free -> very expensive).
  • Type filter sends only the first --type value (API accepts one).