local-search

Original：🇺🇸 English
Translated

Search for places, businesses, and locations using Google Maps APIs via x402. USE FOR: - Finding businesses by name or type - Searching nearby places - Getting detailed place information (address, hours, reviews) - Finding restaurants, stores, services in an area - Getting business ratings and reviews TRIGGERS: - "find", "search for", "locate", "nearby" - "restaurants near", "hotels in", "stores around" - "business details", "opening hours", "reviews for" - "places in", "what's near", "directions to" Choose partial ($0.02) vs full ($0.05-0.08) based on data needs. IMPORTANT: Never guess endpoint paths. All paths follow the pattern https://enrichx402.com/api/{provider}/{action}. Use exact URLs from the Quick Reference table below or call x402.discover_api_endpoints first.

6installs
Sourcemerit-systems/x402scan-skills
Added on

NPX Install

npx skill4agent add merit-systems/x402scan-skills local-search

Tags

Translated version includes tags in frontmatter
google-maps-apix402-integrationlocal-searchplace-detailscost-optimization

SKILL.md Content

View Translation Comparison →

Local Search with Google Maps

STOP — Read before making any API call. enrichx402.com endpoints are not the same as each provider's native API. All paths use the format 
https://enrichx402.com/api/{provider}/{action}
. You MUST either:
  1. Copy exact URLs from the Quick Reference table below, OR
  2. Run 
    x402.discover_api_endpoints(url="https://enrichx402.com")
    to get the correct paths
Guessing paths will fail with 405 errors (wrong path) or 404 errors (missing 
/api/
prefix).
Access Google Maps Places API through x402-protected endpoints.

Setup

See rules/getting-started.md for installation and wallet setup.

Quick Reference

TaskEndpointPriceData Included
Text search (basic)
https://enrichx402.com/api/google-maps/text-search/partial
$0.02Name, address, rating
Text search (full)
https://enrichx402.com/api/google-maps/text-search/full
$0.08+ reviews, atmosphere
Nearby search (basic)
https://enrichx402.com/api/google-maps/nearby-search/partial
$0.02Name, address, rating
Nearby search (full)
https://enrichx402.com/api/google-maps/nearby-search/full
$0.08+ reviews, atmosphere
Place details (basic)
https://enrichx402.com/api/google-maps/place-details/partial
$0.02Core info
Place details (full)
https://enrichx402.com/api/google-maps/place-details/full
$0.05All fields
See rules/partial-vs-full.md for tier selection guidance.

Text Search

Search for places by text query:
mcp
x402.fetch(
  url="https://enrichx402.com/api/google-maps/text-search/partial",
  method="POST",
  body={
    "textQuery": "coffee shops in downtown Seattle"
  }
)
Parameters:
  • textQuery
    - Search query (required)
  • locationBias
    - Prefer results near a location
  • minRating
    - Minimum rating filter (1-5)
  • openNow
    - Only open places
  • maxResultCount
    - Limit results (default: 20)
Full tier adds: reviews, atmosphere data, photos, price level.

Nearby Search

Search for places near a location:
mcp
x402.fetch(
  url="https://enrichx402.com/api/google-maps/nearby-search/partial",
  method="POST",
  body={
    "locationRestriction": {
      "circle": {
        "center": {
          "latitude": 47.6062,
          "longitude": -122.3321
        },
        "radius": 1000
      }
    },
    "includedTypes": ["restaurant", "cafe"]
  }
)
Parameters:
  • locationRestriction
    - Circle with center (lat/lng) and radius in meters
  • includedTypes
    - Place types to include
  • excludedTypes
    - Place types to exclude
  • minRating
    - Minimum rating
  • openNow
    - Only open places

Place Details

Get detailed info for a specific place:
mcp
x402.fetch(
  url="https://enrichx402.com/api/google-maps/place-details/partial",
  method="POST",
  body={
    "placeId": "ChIJN1t_tDeuEmsRUsoyG83frY4"
  }
)
Input:
  • placeId
    - Google Place ID (from search results)
Partial returns: Name, address, phone, website, hours, rating, types.
Full returns: + reviews, atmosphere (wheelchair access, pets allowed), photos, price level.

Common Place Types

Use these with 
includedTypes
/ 
excludedTypes
:
Food & Drink: restaurant, cafe, bar, bakery, coffee_shop
Lodging: hotel, motel, lodging, guest_house
Shopping: shopping_mall, store, supermarket, clothing_store
Services: bank, atm, gas_station, car_repair, car_wash
Health: hospital, pharmacy, doctor, dentist
Entertainment: movie_theater, museum, park, gym

Workflows

Find Businesses in Area

  1. (Optional) Check balance: 
    x402.get_wallet_info
  2. Discover endpoints (required before first fetch): 
    x402.discover_api_endpoints(url="https://enrichx402.com")
  3. Text search (partial) to find options
  4. Review results and select top picks
  5. Get full details for selected places
mcp
x402.fetch(
  url="https://enrichx402.com/api/google-maps/text-search/partial",
  method="POST",
  body={"textQuery": "Italian restaurants downtown Portland"}
)
mcp
x402.fetch(
  url="https://enrichx402.com/api/google-maps/place-details/full",
  method="POST",
  body={"placeId": "ChIJ..."}
)

Nearby Search with Filters

  • Get coordinates for the area
  • Search with location restriction and filters
  • Present sorted results
mcp
x402.fetch(
  url="https://enrichx402.com/api/google-maps/nearby-search/partial",
  method="POST",
  body={
    "locationRestriction": {
      "circle": {
        "center": {"latitude": 40.7128, "longitude": -74.0060},
        "radius": 500
      }
    },
    "includedTypes": ["restaurant"],
    "minRating": 4.0,
    "openNow": true
  }
)

Compare Places with Reviews

  • Search to get place IDs
  • Fetch full details for each candidate
  • Compare ratings, reviews, and amenities
mcp
x402.fetch(
  url="https://enrichx402.com/api/google-maps/place-details/full",
  method="POST",
  body={"placeId": "place_id_here"}
)

Cost Optimization

Use Partial Tier When:

  • Just need name, address, basic info
  • Browsing/discovering options
  • Initial search before drilling down

Use Full Tier When:

  • Need reviews/ratings details
  • Need atmosphere info (accessibility, etc.)
  • Final decision-making

Efficient Patterns

  1. Search partial, detail full:
    • Text search (partial) to find places
    • Place details (full) for the one you care about
  2. Batch searches:
    • Combine filters to reduce calls
    • Use 
      maxResultCount
      to limit results
  3. Cache place IDs:
    • Place IDs are stable
    • Re-fetch details only when needed

Response Data

Partial Tier Fields

  • name
    - Place name
  • formattedAddress
    - Full address
  • location
    - Lat/lng coordinates
  • rating
    - Average rating (1-5)
  • userRatingCount
    - Number of ratings
  • types
    - Place type categories
  • businessStatus
    - OPERATIONAL, CLOSED, etc.
  • regularOpeningHours
    - Hours of operation
  • nationalPhoneNumber
    - Phone number
  • websiteUri
    - Website URL

Full Tier Additional Fields

  • reviews
    - User reviews with text and ratings
  • priceLevel
    - $ to $$$$
  • accessibilityOptions
    - Wheelchair accessible, etc.
  • parkingOptions
    - Parking availability
  • paymentOptions
    - Accepted payment methods
  • photos
    - Photo references