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.