Back to Skills

goplaces

Query Google Places for text search, place details, resolve, reviews, or scriptable JSON via goplaces.

378,969stars79,302forksUpdated 6/16/2026

Security Assessment

Safe(100/100)
Security Score100/100

About goplaces

goplaces is a modern command-line interface for the Google Places API (New) that enables developers and system administrators to query location-based information directly from the terminal. It provides a streamlined way to search for places, retrieve detailed information, resolve location queries, and access place reviews without writing custom API integration code. The tool outputs human-readable results by default while offering a `--json` flag for programmatic use in scripts and automation pipelines.

The skill supports comprehensive place search functionality with filtering options including minimum ratings, operating hours (open now), location bias with latitude/longitude coordinates, and radius-based searches. It handles pagination for large result sets, allows querying specific place details by ID, and can resolve ambiguous location strings into structured place data. Price level filtering (0-4 scale from free to very expensive) and type-based filtering provide fine-grained control over search results. The tool respects standard terminal conventions with `--no-color` and `NO_COLOR` environment variable support for ANSI color output control.

This skill is ideal for developers building location-aware applications, DevOps engineers automating location-based workflows, data analysts gathering place information for research, and system administrators who need quick terminal access to Google Places data without switching to web interfaces or writing API integration code. It's particularly useful for testing location features, generating location datasets, and integrating place search into shell scripts and CI/CD pipelines.

FAQ

What API key do I need to use goplaces?

You need a Google Places API key set in the GOOGLE_PLACES_API_KEY environment variable. You can obtain this from the Google Cloud Console with the Places API (New) enabled.

How do I install goplaces?

Install via Homebrew with the command: brew install steipete/tap/goplaces. The goplaces binary will be available in your PATH after installation.

Can I use goplaces in automated scripts?

Yes, use the --json flag with any command to get JSON output suitable for parsing in scripts and automation pipelines instead of the default human-readable format.

How do I search for places near a specific location?

Use the --lat, --lng, and --radius-m flags together with your search query. For example: goplaces search "pizza" --lat 40.8 --lng -73.9 --radius-m 3000 to search within 3000 meters of the specified coordinates.

What's the difference between search, resolve, and details commands?

The search command finds places matching text queries with optional filters. The resolve command converts location strings (like "Soho, London") into structured place data. The details command retrieves comprehensive information about a specific place using its place_id, optionally including reviews.

Install goplaces

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill