goplaces

Query the Google Places API for searchable place results with JSON output.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/JOHNNYWHITEMIKE/openclaw --skill goplaces-johnnywhitemike
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: goplaces
Source: https://github.com/JOHNNYWHITEMIKE/openclaw/tree/main/openclaw/.openclaw/openclaw/skills/goplaces
Command: npx skills add https://github.com/JOHNNYWHITEMIKE/openclaw --skill goplaces-johnnywhitemike

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Searching for nearby or specific locations and then pulling reliable details usually requires switching between websites, tabs, and manual copy-paste, which is slow and error-prone.

Core Features & Use Cases

  • Text search for places: Look up businesses and points of interest using human-friendly queries like “coffee” or “pizza”, with filters such as open-now, minimum rating, and location bias via latitude/longitude and radius.
  • Place resolution and details: Convert an address or name into a place result, then fetch structured details (optionally including reviews) using place IDs.
  • Script-friendly JSON output: Use the same workflow non-interactively with --json when you want machine-readable results for automation.

Quick Start

Run goplaces search "coffee" --open-now --min-rating 4 --limit 5 after setting GOOGLE_PLACES_API_KEY.

Frequently Asked Questions about goplaces

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

FAQPage Schema
How do I query Google Places API for nearby businesses using the command line?▼

You can query Google Places API for nearby businesses by running a text search like goplaces search "coffee" with optional filters such as --open-now and --min-rating. This requires setting the GOOGLE_PLACES_API_KEY environment variable.

Can I get machine-readable JSON output from Google Places search results for automation?▼

Yes, you can get machine-readable JSON output from Google Places search results by passing the --json flag. This enables script-friendly automation workflows without interactive prompts.

How do I fetch place details and reviews from Google Places API using a place ID?▼

You fetch structured place details and optional reviews by resolving an address or name into a place ID, then querying the Google Places API. The goplaces CLI handles this resolution and detail extraction automatically.

What environment variables do I need to set up to run Google Places text searches?▼

To run Google Places text searches, you must set the GOOGLE_PLACES_API_KEY environment variable. You can also optionally set GOOGLE_PLACES_BASE_URL to override the default API endpoint.

Does Google Places CLI support filtering search results by location bias and minimum rating?▼

Yes, Google Places CLI supports filtering search results by location bias using latitude, longitude, and radius parameters. You can also apply a minimum rating filter to refine your business queries.

What is the best way to avoid manual copy-paste when pulling reliable location details from Google Places?▼

The best way to avoid manual copy-paste when pulling location details is to use a CLI tool that queries Google Places API directly. This returns structured text search results and detailed review data in one workflow.