fetch-stores

vm0-ai's avatarfrom vm0-ai

Fetch store leads from Google Maps using Dumpling AI API. Use this skill when the user wants to search for businesses, stores, restaurants, or any places on Google Maps.

⭐4stars🔀1forks📁View on GitHub🕐Updated Jan 1, 2026
[Lead Research]

When & Why to Use This Skill

This Claude skill automates the process of gathering business leads and local intelligence from Google Maps using the Dumpling AI API. It empowers users to search for specific business categories across any location, retrieving essential data points like ratings, contact information, and physical addresses to streamline market research and sales prospecting.

Use Cases

  • Sales Lead Generation: Quickly compile lists of potential B2B clients by searching for specific business types (e.g., 'Real Estate Agencies') in target geographic regions.
  • Competitive Market Analysis: Evaluate the local business landscape by comparing ratings and review volumes of competitors in a specific area to identify market gaps.
  • Local Business Discovery: Identify top-rated services, restaurants, or retail locations for personal or professional needs based on real-time Google Maps data.
  • Contact Information Extraction: Efficiently gather phone numbers and website URLs for local businesses to support outreach, networking, or database enrichment.
namefetch-stores
descriptionFetch store leads from Google Maps using Dumpling AI API. Use this skill when the user wants to search for businesses, stores, restaurants, or any places on Google Maps.

Fetch Stores from Google Maps

This skill allows you to search for businesses and places using the Dumpling AI API, which queries Google Maps data.

When to Use

Use this skill when the user:

  • Wants to find stores, restaurants, or businesses in a specific area
  • Asks for "best [type of business] in [location]"
  • Needs to collect business leads or listings
  • Wants to search Google Maps for places

How to Use

Execute the script located at scripts/fetch-stores.sh:

fetch-stores.sh "search query" ["optional location"]

Examples

# Search for restaurants in New York
fetch-stores.sh "best restaurants in New York"

# Search with separate location parameter
fetch-stores.sh "coffee shops" "San Francisco, CA"

Prerequisites

The DUMPLING_AI_API_KEY environment variable must be set:

export DUMPLING_AI_API_KEY=your_api_key

Output

  • Results are saved to /tmp/data/stores_[timestamp].json
  • The script displays:
    • Number of places found
    • Top 10 rated places with ratings and addresses
    • The best rated place with full details

Response Format

The API returns places with the following information:

  • title: Business name
  • rating: Star rating (1-5)
  • ratingCount: Number of reviews
  • address: Full address
  • phoneNumber: Contact phone
  • website: Business website URL

Guidelines

  1. Always ask the user for their search query if not provided
  2. Suggest adding a location for more relevant results
  3. After fetching, summarize the top results for the user
  4. If the API key is not set, guide the user to set it up