ScraperCity

official

B2B lead generation MCP server - Apollo, Google Maps, email finder, skip trace, and 15+ more tools.

What can you do with ScraperCity MCP?

  • Find B2B leads by criteria — Ask your AI to pull contacts from Apollo filtered by job title, industry, or location.
  • Extract local business data — Have your AI scrape Google Maps for businesses with phone numbers, emails, and reviews in a specific area.
  • Validate email deliverability — Ask your AI to check if email addresses are valid, catch-all, or have proper MX records.
  • Find contact details from names — Have your AI locate business emails or mobile numbers from a person's name and company.
  • Run skip-trace lookups — Ask your AI to find people by name, email, phone, or address for lead enrichment.
  • Scrape ecommerce store leads — Have your AI pull Shopify or WooCommerce store contacts for outreach campaigns.

Documentation

ScraperCity - B2B Lead Generation for AI Agents

Pull leads, validate emails, find mobile numbers, and scrape business data - all from your AI agent, CLI, or code.

ScraperCity gives AI agents access to 15+ B2B data tools: Apollo scraping, Google Maps extraction, email finding/validation, mobile number lookup, skip tracing, ecommerce store data, criminal records, and more.

Quick Start

Option 1: CLI

npx scrapercity login            # enter your API key
npx scrapercity wallet           # check balance
npx scrapercity maps -q "plumbers" -l "Denver, CO"
npx scrapercity poll <runId>     # wait for results
npx scrapercity download <runId> # save CSV

Option 2: MCP Server (Claude Code, Cursor, Windsurf, etc.)

Add to your MCP config (e.g. ~/.claude/claude_desktop_config.json):

{
  "mcpServers": {
    "scrapercity": {
      "command": "npx",
      "args": ["-y", "--package", "scrapercity", "scrapercity-mcp"],
      "env": {
        "SCRAPERCITY_API_KEY": "your_api_key_here"
      }
    }
  }
}

Then tell your AI: "Find 1000 plumbers in Denver with emails using ScraperCity"

Option 3: Skill File (Claude Code)

Copy the skill file into your project:

npx scrapercity-mcp --print-skill > SCRAPERCITY_SKILL.md

Or download from: https://scrapercity.com/agents/SKILL.md

Then in Claude Code: "Read SCRAPERCITY_SKILL.md and find me 2000 marketing directors at SaaS companies in California, validate their emails, and save to leads.csv"

Option 4: Direct API

# Start a Maps scrape
curl -X POST https://app.scrapercity.com/api/v1/scrape/maps \
  -H "Authorization: Bearer $SCRAPERCITY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"searchStringsArray":["plumbers"],"locationQuery":"Denver, CO","maxCrawledPlacesPerSearch":500}'

# Check status
curl https://app.scrapercity.com/api/v1/scrape/status/RUN_ID \
  -H "Authorization: Bearer $SCRAPERCITY_API_KEY"

# Download CSV when SUCCEEDED
curl -O https://app.scrapercity.com/api/downloads/RUN_ID \
  -H "Authorization: Bearer $SCRAPERCITY_API_KEY"

Pricing (auto-generated from the live catalog — do not edit)

ToolEndpointPrice
scrape_apollo/api/v1/scrape/apollo$0.0039 per lead
scrape_website_finder/api/v1/scrape/website-finder$0.0499 per contact found
find_people/api/v1/scrape/skip-trace$0.0199 per result (searches with 0 matches are billed as 1 result)
scrape_distress_list/api/v1/scrape/distress-list$0.05 per property
validate_emails/api/v1/scrape/email-validator$0.0072 per email
scrape_maps/api/v1/scrape/maps$0.0099 per business
scrape_airbnb/api/v1/scrape/airbnb-email$0.019 per result ($19.00 per 1,000)
scrape_bizbuysell/api/v1/scrape/bizbuysell-scraper$0.0099 per listing
scrape_crexi/api/v1/scrape/crexi-scraper$0.029 per property
scrape_angi/api/v1/scrape/angi-angies-list-scraper$0.0099 per listing
scrape_yelp/api/v1/scrape/yelp-scraper$0.0099 per result
scrape_zillow_agents/api/v1/scrape/zillow-agents$0.029 per agent
scrape_property_lookup/api/v1/scrape/property-lookup$0.15 per property (+$0.10 for owner contact)
search_criminal_records/api/v1/scrape/criminal-records.00 per search (only charged if records found)
scrape_store_leads/api/v1/scrape/store-leads$0.0039 per lead
scrape_builtwith/api/v1/scrape/techstack$4.99 per technology
find_emails/api/v1/scrape/email-finder$0.05 per email found (FREE if not found)
find_mobiles/api/v1/scrape/mobile-finder$0.25 per number found (FREE if not found)

Available Tools

ToolWhat it doesCost
ApolloB2B contacts by job title, industry, location$0.0039/lead
Google MapsLocal businesses with phones, emails, reviews$0.01/place
Email ValidatorVerify deliverability, catch-all, MX records$0.0036/email
Email FinderFind business email from name + company$0.05/contact
Mobile FinderPhone numbers from LinkedIn or email$0.25/input
People FinderSkip trace by name, email, phone, address$0.02/result
Store LeadsShopify/WooCommerce stores with contacts$0.0039/lead
BuiltWithAll sites using a technology$4.99/search
Criminal RecordsBackground check by name$1.00 if found
Lead Database3M+ B2B contacts, instant query ($149/mo plan and up)Included

How It Works

  1. Start a scrape → get a runId
  2. Poll status (or use webhooks) → wait for SUCCEEDED
  3. Download CSV → leads with full contact info

Apollo scrapes take 11-48+ hours. All other scrapers: 1-30 minutes. Store leads are instant.

Authentication

Get your API key at app.scrapercity.com/dashboard/api-docs

# Environment variable (recommended)
export SCRAPERCITY_API_KEY="your_key"

# Or save to config file
npx scrapercity login

Webhooks

For Apollo and long-running scrapes, configure a webhook at app.scrapercity.com/dashboard/webhooks to get notified when results are ready.

Plans

PlanPriceCredits
TrialFree$5
Starter$49/mo$49
Growth$149/mo$149 + 10% bonus
Professional$649/mo$649 + 30% bonus + Database API

Buy additional credits anytime. scrapercity.com/pricing

Links

License

MIT