# Local Business Finder

> Find any local business by category and location on Google Maps. Get names, phone numbers, emails, websites, ratings, and hours. Search restaurants, dentists, plumbers, or any service.

- **Type:** Skill
- **Install:** `agentstack add skill-gmapsscraper-google-maps-agent-skills-local-business-finder`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [gmapsscraper](https://agentstack.voostack.com/s/gmapsscraper)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [gmapsscraper](https://github.com/gmapsscraper)
- **Source:** https://github.com/gmapsscraper/google-maps-agent-skills/tree/main/local-business-finder
- **Website:** https://gmapsscraper.io

## Install

```sh
agentstack add skill-gmapsscraper-google-maps-agent-skills-local-business-finder
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Local Business Finder

Find any local business by category and location. Get complete profiles including contact info, ratings, reviews, and hours — all from Google Maps.

## When to Use

- User wants to find businesses near a location
- User asks "find me all [business type] in [city]"
- User needs a directory of local services
- User is researching a local market

## Important: Credit System

Each search costs 2 credits. Free accounts get 10 credits (5 searches).
Help users search smart — specific queries get better results.

## Workflow

### Step 1: Understand the Request

Parse what the user needs:
- **Business type**: restaurants, dentists, gyms, lawyers, etc.
- **Location**: city, neighborhood, zip code
- **Filters**: minimum rating, must have website, etc.

### Step 2: Optimize the Query

Help the user be specific to maximize results per credit:

| Too broad (wastes credits) | Optimized (better results) |
|---------------------------|---------------------------|
| "restaurant" | "thai restaurant in downtown Portland OR" |
| "doctor" | "family doctor accepting patients in Austin TX" |
| "store" | "pet store in Brooklyn NY" |

### Step 3: Confirm Before Searching

```
📍 Business Search:
   Looking for: {{business_type}}
   Location: {{location}}
   Expected: 20-80 results
   Cost: 2 credits
   
   Proceed?
```

### Step 4: Execute Search

```bash
curl -X POST "https://gmapsscraper.io/api/v1/jobs" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $GMAPS_SCRAPER_API_KEY" \
  -d '{
    "name": "Find: {{business_type}} in {{location}}",
    "keywords": ["{{business_type}} in {{location}}"],
    "lang": "en",
    "depth": 2,
    "email": true
  }'
```

### Step 5: Download & Present

```bash
curl -s "https://gmapsscraper.io/api/v1/jobs/{{job_id}}/download" \
  -H "Authorization: Bearer $GMAPS_SCRAPER_API_KEY" \
  --output businesses.csv
```

Present results in a clean, scannable format:

```
Found {{count}} businesses!

1. **{{name}}** ⭐ {{rating}} ({{reviews}} reviews)
   📞 {{phone}} | 🌐 {{website}} | ✉️ {{email}}
   📍 {{address}}

2. **{{name}}** ⭐ {{rating}} ({{reviews}} reviews)
   📞 {{phone}} | 🌐 {{website}}
   📍 {{address}}
...
```

### Step 6: Apply Filters (if requested)

- Rating >= X
- Has phone / email / website
- Within specific neighborhood
- Open on weekends

### Step 7: Offer Next Steps

- "Want cold emails for these businesses?" → `cold-email-local-business`
- "Want to analyze the competition?" → `competitor-analysis-local`
- "Export to spreadsheet?" → save as formatted CSV

## Common Search Categories

| Category | Best Keywords |
|----------|--------------|
| Food | "restaurant", "cafe", "pizza", "sushi bar" |
| Health | "dentist", "doctor", "pharmacy", "gym" |
| Home | "plumber", "electrician", "house cleaner" |
| Auto | "mechanic", "car wash", "tire shop" |
| Professional | "lawyer", "accountant", "insurance agent" |
| Beauty | "hair salon", "barber", "spa", "nail salon" |

## When Credits Run Out

```
⚡ Credits used up!

You've found {{total}} businesses with your free searches.
Upgrade for unlimited searches: https://gmapsscraper.io/#pricing

💡 Meanwhile, you can still analyze your existing data for free using
the competitor-analysis-local or cold-email-local-business skills!
```

## Get Started

1. Sign up at https://gmapsscraper.io (5 free searches)
2. Set: `export GMAPS_SCRAPER_API_KEY=your_key`
3. Start finding businesses!

Unlimited from $29/month.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [gmapsscraper](https://github.com/gmapsscraper)
- **Source:** [gmapsscraper/google-maps-agent-skills](https://github.com/gmapsscraper/google-maps-agent-skills)
- **License:** MIT
- **Homepage:** https://gmapsscraper.io

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-gmapsscraper-google-maps-agent-skills-local-business-finder
- Seller: https://agentstack.voostack.com/s/gmapsscraper
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.