goplaces
steipete/clawdis
Query Google Places API for text search, details, reviews, and location resolution with human-friendly or JSON output.
What is goplaces?
goplaces is a modern CLI for the Google Places API (New) that lets you search for places, get details and reviews, resolve addresses, and output results as human-readable text or JSON. Use it when you need to find businesses, restaurants, or locations programmatically with filtering by rating, distance, and opening status.
- Search places by text with filters (open now, min rating, radius, type)
- Retrieve detailed place information including reviews and ratings
- Resolve addresses and location names to place IDs
- Paginate through search results
- Output results as human-readable text or JSON for scripting
- Filter by price level (0-4 scale) and geographic bias (latitude/longitude)
How to install goplaces
npx skills add https://github.com/steipete/clawdis --skill goplaces- Google Places API key (set as GOOGLE_PLACES_API_KEY environment variable)
- goplaces binary installed (via Homebrew: brew install steipete/tap/goplaces)
How to use goplaces
- 1.Set your GOOGLE_PLACES_API_KEY environment variable with a valid Google Places API key
- 2.Install goplaces via Homebrew or your preferred method
- 3.Run goplaces search "query" to find places (e.g., goplaces search "coffee" --open-now)
- 4.Add filters like --min-rating, --radius-m, --lat, --lng, or --limit to refine results
- 5.Use goplaces details <place_id> --reviews to get full information for a specific place
- 6.Append --json to any command to get JSON output for scripting or piping to other tools
Use cases
- Find nearby restaurants or coffee shops matching specific criteria (rating, distance, open status)
- Retrieve reviews and detailed information for a specific place ID
- Resolve a business name or address to its Google Places ID for further queries
- Batch process location data by outputting JSON and piping to other tools
- Build location-aware applications that query places within a radius of coordinates
- Developers building location-based applications
- Data analysts querying business and venue information
- Automation scripts that need to find or verify places
- CLI power users who prefer command-line interfaces over web APIs
goplaces FAQ
Use --lat and --lng to set a center point, then --radius-m to specify the radius in meters. For example: goplaces search "pizza" --lat 40.8 --lng -73.9 --radius-m 3000
Yes, use --page-token with the token from the previous response to fetch the next page of results.
Append --json to any command. For example: goplaces search "sushi" --json outputs structured JSON suitable for scripting.
Price levels range from 0 (free) to 4 (very expensive). Use --price-level to filter places by affordability.
Yes, use --no-color flag or set the NO_COLOR environment variable to disable ANSI color in output.
Full instructions (SKILL.md)
Source of truth, from steipete/clawdis.
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_KEYrequired.- Optional:
GOOGLE_PLACES_BASE_URLfor 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-colororNO_COLORdisables ANSI color.- Price levels: 0..4 (free -> very expensive).
- Type filter sends only the first
--typevalue (API accepts one).
Related skills
More from steipete/clawdis and the wider catalog.

healthcheck
Audit and harden OpenClaw hosts: SSH, firewall, updates, encryption, backups, and gateway security.

himalaya
IMAP/SMTP email CLI for listing, reading, searching, composing, and organizing messages from the shell.

imsg
iMessage/SMS CLI for listing chats, history, and sending messages via Messages.app

mcporter
List, configure, and call MCP servers/tools via HTTP or stdio with mcporter.

model-usage
Summarize CodexBar local cost logs by model for Codex or Claude usage tracking.

nano-pdf
Edit PDFs with natural-language instructions via CLI.