local-search_skill

Overview

This skill lets you search for places, businesses, and locations using Google Maps data accessed via x402-protected endpoints. It supports text and nearby searches, plus place details in partial or full tiers to balance cost and data depth. Use it to find restaurants, stores, services, addresses, hours, ratings, and reviews quickly.

How this skill works

The skill calls enrichx402.com API endpoints that proxy Google Maps Places functionality. Use text-search or nearby-search to locate places and then request place-details to obtain core or full fields (reviews, photos, accessibility, etc.). Always discover the correct x402 endpoints first or copy the exact URLs from the quick reference before making requests.

When to use it

• Finding businesses by name or type (e.g., "Italian restaurant")
• Searching for places near coordinates or an address
• Gathering core place info for listings (name, address, rating)
• Fetching full details when reviews or accessibility matter
• Filtering results by rating, open-now, types, or radius

Best practices

• Call x402.discover_api_endpoints(url="https://enrichx402.com") before your first fetch to get exact paths or use the exact quick-reference URLs
• Start with partial tier for discovery to save cost, then request full place-details for finalists
• Use locationRestriction (circle) with a reasonable radius to limit results and cost
• Apply includedTypes, minRating, and openNow filters to reduce noise and API calls
• Cache stable placeId values and only re-fetch full details when needed

Example use cases

• Find coffee shops near downtown for a meetup and get addresses and hours
• Search nearby pharmacies open now with a minimum 4.0 rating
• List hotels in a neighborhood, then fetch full details and reviews for top candidates
• Compare multiple restaurants by fetching full place-details to read reviews, price level, and accessibility
• Build a local business directory that displays name, address, rating, and a link to full details