local-places

Search Google Places API via a FastAPI server for businesses by keyword, location, and filters.

Updated Jan 20, 2026
One-click install
npx skills add https://github.com/Team-Hireal/RealChat --skill local-places-team-hireal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: local-places
Source: https://github.com/Team-Hireal/RealChat/tree/main/openclaw/skills/local-places
Command: npx skills add https://github.com/Team-Hireal/RealChat --skill local-places-team-hireal

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps users find local points of interest like restaurants, cafes, and more, by leveraging the Google Places API through a local proxy.

Core Features & Use Cases

  • Search for Places: Find businesses based on keywords, location, and various filters (open now, rating, price).
  • Resolve Locations: Convert natural language location descriptions into structured geographical data.
  • Get Place Details: Retrieve in-depth information about a specific place, including address, phone number, and website.
  • Use Case: A user asks "Find a highly-rated, open Italian restaurant near me that's not too expensive." This Skill can resolve "near me" to a specific location, then search for Italian restaurants matching the criteria, and present the results.

Quick Start

Use the local-places skill to search for coffee shops near a specific latitude and longitude.

Frequently Asked Questions about local-places

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search for local businesses using the Google Places API?

To search for local businesses using the Google Places API, this Skill runs a local FastAPI server that accepts free-text queries and applies filters for open status, rating, and price level. It returns matching local points of interest instantly.

How do I resolve ambiguous location strings into precise coordinates for API requests?

Resolving ambiguous location strings into precise coordinates is handled by the Skill's location resolution functionality. It converts natural language location descriptions into structured geographical data and specific place IDs for accurate API queries.

Can I filter Google Places search results by open status, rating, and price level?

Filtering Google Places search results by open status, rating, and price level is fully supported. The Skill enables agents to apply these constraints alongside free-text queries to find highly-rated, open, and cost-appropriate local businesses.

What in-depth place details can I retrieve for a specific business using this API?

Retrieving in-depth place details for a specific business yields comprehensive information including the physical address, phone number, and website. This is achieved by fetching details through the Google Places API via the local FastAPI proxy.

Does the local-places Skill require a FastAPI server to query Google Maps data?

Querying Google Maps data with the local-places Skill does require a FastAPI server. The Skill operates by running this local server to act as a proxy for the Google Places API, handling search requests and location resolution.

What is the best way to find a highly-rated, open Italian restaurant near me that is not too expensive?

The best way to find a highly-rated, open Italian restaurant that is not too expensive is to use this Skill to resolve "near me" into precise coordinates, then search for Italian restaurants while filtering by open status, high rating, and low price level.