goplaces for Openclaw

A modern command-line interface for the Google Places API (New) that provides both human-readable and JSON-structured location data.

steipete
v1.0.0
Jan 5, 2026
31
24.6k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install goplaces

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install goplaces using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is goplaces?

goplaces is a specialized CLI tool designed to interact with the Google Places API (New) ecosystem. It allows developers and automated agents to perform complex location searches, resolve addresses, and retrieve detailed metadata about businesses and points of interest. By integrating this tool into your collection of Openclaw Skills, you can empower your AI agents to navigate the physical world with high-precision data.

The utility focuses on providing a bridge between raw Google API responses and actionable intelligence. It supports modern API features like text search, place details, and address resolution, making it an essential component for any workflow requiring geographic context within Openclaw Skills. Whether you need a quick human-friendly summary in the terminal or structured JSON for a pipeline, goplaces handles the heavy lifting of API communication and data formatting.

goplaces Use Cases

  • Finding specific types of businesses (e.g., coffee shops or sushi restaurants) with minimum rating and distance filters.
  • Resolving ambiguous location strings into specific place IDs and geographic coordinates.
  • Retrieving detailed business information including user reviews, price levels, and opening hours for market research.
  • Building automated travel or logistics assistants that require real-time location data through Openclaw Skills.

How goplaces Works

  1. The tool authenticates with the Google Places API using a user-provided GOOGLE_PLACES_API_KEY environment variable.
  2. Users execute commands like search, resolve, or details with specific flags for filtering (e.g., --open-now, --min-rating).
  3. The CLI sends a request to the Google Places API (New) endpoints, handling parameters like latitude, longitude, and radius.
  4. The results are parsed and outputted to the terminal, either as formatted text for humans or as raw JSON for programmatic use in Openclaw Skills.

goplaces Setup

To set up the goplaces skill, you must install the binary and configure your API credentials:

# Install the CLI via Homebrew
brew install steipete/tap/goplaces

# Configure your API key
export GOOGLE_PLACES_API_KEY="your_google_api_key"

Ensure that the GOOGLE_PLACES_API_KEY is available in your environment for any Openclaw Skills that trigger these commands.

goplaces Data Schema & Taxonomy

The skill returns structured data matching the Google Places API (New) specification. When the --json flag is utilized, the output follows a consistent schema:

Property Type Description
id String Unique Google Place ID
displayName Object The name of the place including language code
formattedAddress String Full human-readable address
rating Number User rating from 0.0 to 5.0
priceLevel Integer Price category (0=Free, 4=Very Expensive)
reviews Array List of recent user reviews (optional)
location Object Latitude and Longitude coordinates

goplaces Advanced Features

  • Pagination support using --page-token to iterate through large sets of search results.
  • Geographic biasing using --lat, --lng, and --radius-m to focus searches on specific areas.
  • JSON output mode enabled via --json for seamless integration into complex Openclaw Skills automation scripts.
  • Support for ANSI color management with --no-color and NO_COLOR environment variable compatibility.
  • Multi-filter capabilities including price levels, minimum ratings, and specific place types.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*