local-places

Resolve locations and retrieve nearby place details via a local Google Places proxy.

Updated Jan 28, 2026
One-click install
npx skills add https://github.com/xcriminal1/Xcriminal-bot --skill local-places-xcriminal1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: local-places
Source: https://github.com/xcriminal1/Xcriminal-bot/tree/main/skills/local-places
Command: npx skills add https://github.com/xcriminal1/Xcriminal-bot --skill local-places-xcriminal1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Search for places using a local Google Places API proxy on localhost, enabling private testing and offline-friendly workflows without exposing API keys to external services.

Core Features & Use Cases

  • Local Places API proxy for searching and resolving locations.
  • Two-step flow: resolve a location first, then search for places.
  • Use cases include finding coffee shops, restaurants, and other venues near a given area, with details like names, addresses, and ratings.

Quick Start

Start the local Places API proxy by exporting your GOOGLE_PLACES_API_KEY and running the uvicorn server.

Frequently Asked Questions about local-places

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

FAQPage Schema
How do I set up a local Google Places proxy for testing on localhost?

A FastAPI local proxy handles location resolution, nearby place search, and place details retrieval using your Google Places API key. It provides structured responses with input validation, letting you find coffee shops, restaurants, and other venues near a given area.

Can I search for nearby places without exposing my Google Places API key externally?

The Google Places proxy uses a two-step flow: resolve a location first, then search for nearby places. This structured approach returns validated results including names, addresses, and ratings for venues like coffee shops and restaurants in the specified area.

Does the local Places proxy require FastAPI and a Google Places API key to run?

Yes, the local Places proxy requires a Google Places API key and uses FastAPI to expose REST endpoints via a uvicorn server. These dependencies are necessary to handle location resolution and nearby place searches with input validation and structured responses.

Why does my local Google Places proxy need location resolution before searching nearby places?

The local Places proxy is limited to localhost deployments and requires a valid Google Places API key. It is designed for private testing and offline-friendly workflows, so it does not expose API keys externally and relies on FastAPI REST endpoints for structured responses.