local-places

Search and resolve local places via the Google Places API with flexible filters and pagination.

Updated Jan 29, 2026

Search Tags:#api #fastapi #search #location #places #google maps

Ready to run

npx skills add https://github.com/douglasjs/clawdbot_plugin_tools --skill local-places-douglasjs

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: local-places
Source: https://github.com/douglasjs/clawdbot_plugin_tools/tree/main/local-places
Command: npx skills add https://github.com/douglasjs/clawdbot_plugin_tools --skill local-places-douglasjs

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps users find and get information about local places 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 queries and filters (e.g., "italian restaurants open now").
Resolve Locations: Convert natural language location descriptions (e.g., "Soho, London") into structured data.
Get Place Details: Retrieve specific information about a place, such as its address, rating, and phone number.
Use Case: A user asks, "Find a highly-rated coffee shop near me that's open now." The skill first resolves "near me" to a specific location, then searches for coffee shops with the specified criteria, and finally presents the results.

Quick Start

Use the local-places skill to search for a "coffee shop" near "Soho, London" that is open now and has a minimum rating of 4.0.

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 places using the Google Places API and FastAPI?▼

To search local places, you run a local FastAPI server that proxies Google Places API requests. You can filter results by business type, open status, minimum rating, and price level using location bias and pagination.

Can I resolve natural language location descriptions into structured data with Google Places API?▼

Yes, you can resolve natural language location descriptions like "Soho, London" into structured data. The skill processes these descriptions through the Google Places API to return specific geographic coordinates and place details.

What environment variables do I need to filter places by rating and price level?▼

You need to configure environment variables for your Google Places API keys to filter by rating and price level. Specific Python libraries for API interaction and schema validation are also required to process the search parameters.

How do I retrieve specific place details like address and phone number from a search query?▼

You retrieve specific place details by first resolving the search query to a target location, then applying filters like open status or minimum rating. The FastAPI server queries Google Places to return the address, rating, and phone number.

Does the local-places skill support pagination for large Google Places API search results?▼

Yes, the local-places skill supports pagination for Google Places API search results. This allows you to fetch multiple pages of local places data when your initial search query returns a large list of businesses.