goplaces

Query the Google Places API for search results, details, and reviews via the goplaces CLI.

Updated Apr 3, 2026
One-click install
npx skills add https://github.com/BEIRUX/agent-skills --skill goplaces-beirux
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: goplaces
Source: https://github.com/BEIRUX/agent-skills/tree/main/goplaces
Command: npx skills add https://github.com/BEIRUX/agent-skills --skill goplaces-beirux

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enable fast, human-friendly or machine-readable place lookup without writing direct API calls by using an opinionated CLI that wraps the Google Places (New) API. It removes the friction of constructing requests, handling pagination, and formatting results so you can focus on using location data in scripts, tools, or for manual inspection.

Core Features & Use Cases

  • Text Search & Biasing: Perform text searches with options for lat/lng bias, radius, open-now, and minimum rating to find relevant places.
  • Resolve & Details: Resolve ambiguous place names to candidate places and fetch detailed place information and reviews for enrichment or display.
  • Scriptable JSON Output: Produce JSON output for programmatic consumption, or use the default human-readable output for interactive exploration.
  • Pagination & Reliability: Follow API pagination via page tokens and handle repeated queries for gathering multiple pages of results.
  • Use Case: Quickly build a script to discover top-rated nearby restaurants, enrich a contact database with place details, or aggregate user reviews for sentiment analysis.

Quick Start

Use the goplaces skill to search for top-rated nearby coffee shops 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 and get JSON output?

Use a CLI tool to query the Google Places API and return structured JSON output. The goplaces CLI wraps the Google Places (New) API, handling request construction and formatting so you can retrieve place search results directly in your terminal or scripts.

Can I bias Google Places location searches using lat/lng coordinates and radius?

Yes, you can bias Google Places location searches with lat/lng coordinates and radius. The CLI supports lat/lng biasing and radius filters to narrow text search results to specific geographic areas.

What's the best way to fetch place details and reviews without writing direct API calls?

Fetch place details and reviews without direct API calls by using an opinionated CLI wrapper. The goplaces CLI resolves ambiguous place names to candidates and retrieves detailed place information and user reviews for enrichment or display.

How does pagination work when retrieving multiple pages of Google Places search results?

Pagination for multiple Google Places search results works via page tokens. The CLI follows API pagination using page tokens, allowing repeated queries to gather multiple pages of results reliably.

Do I need a Google Places API key to perform CLI-driven location discovery?

Yes, CLI-driven location discovery requires a valid GOOGLE_PLACES_API_KEY environment variable and the goplaces binary. These prerequisites enable authenticated queries to the Google Places (New) API for place lookups and review aggregation.