English Français العربية

io.github.scrapercity/scrapercity-cli

Official registry Search and web

B2B lead generation MCP server - 20+ scrapers, email finder, skip trace, and more.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package scrapercity
Claude Code 
claude mcp add scrapercity-cli -e 'SCRAPERCITY_API_KEY=<your scrapercity_api_key>' -- npx -y scrapercity@1.0.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "scrapercity-cli": {
            "command": "npx",
            "args": [
                "-y",
                "scrapercity@1.0.1"
            ],
            "env": {
                "SCRAPERCITY_API_KEY": "<your scrapercity_api_key>"
            }
        }
    }
}

Environment variables

  • SCRAPERCITY_API_KEY required secret Your ScraperCity API key

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. ScraperCity - B2B Lead Generation for AI Agents
  2. Quick Start
  3. Pricing (auto-generated from the live catalog — do not edit)
  4. Available Tools
  5. How It Works
  6. Authentication
  7. Webhooks
  8. Plans
  9. Links
  10. License

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
Local Business DatabaseLocal businesses with phones, emails and ratings, 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

License

MIT

Frequently asked questions

What is io.github.scrapercity/scrapercity-cli?

B2B lead generation MCP server - 20+ scrapers, email finder, skip trace, and more.

How do I install io.github.scrapercity/scrapercity-cli?

It runs on your machine. In Claude Code: claude mcp add scrapercity-cli -e 'SCRAPERCITY_API_KEY=<your scrapercity_api_key>' -- npx -y scrapercity@1.0.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.scrapercity/scrapercity-cli need an API key?

Yes. It expects SCRAPERCITY_API_KEY, which you set in its configuration.

Is io.github.scrapercity/scrapercity-cli open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.scrapercity/scrapercity-cli?

It is published by scrapercity. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.