Scrapercity Cli

io.github.scrapercityPublished by GitHub account scrapercityv1.0.1Updated Oct 27, 2026

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

VerifiedSTDIODesktop onlyWeb Search & ScrapingData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

ScraperCity MCP server that lets an assistant run B2B lead-generation scrapes, find and validate emails and phone numbers, and download results as CSV.

What you can do
  • Run scrapers for B2B contacts, local businesses, ecommerce stores, real estate and marketplace listings
  • Find business emails and mobile numbers, and validate email deliverability
  • Skip trace people by name, email, phone or address, and search criminal records
  • Check scrape status, poll runs and download finished results as CSV
  • Query the lead and local business databases on eligible plans
When to use it
Useful when you want an assistant to build prospect or contact lists, enrich leads with emails and phone numbers, or pull business and property data from many sources without writing API calls yourself. It suits sales, recruiting and research workflows that accept asynchronous runs and per-result billing.
Requirements
Runs locally via npx from the npm package scrapercity, so Node.js is needed. Requires a ScraperCity account and an API key supplied in the SCRAPERCITY_API_KEY environment variable (or saved with the CLI login command). Network access to the ScraperCity API is required; some database tools need a paid plan.
Before you install
Every tool is billed per result or per lead against prepaid credits, so agent-driven runs can spend real money; check the wallet balance and set limits. The server handles personal data such as contact details, phone numbers, property ownership and criminal records, which carries legal and privacy obligations. Scrapes start jobs and download files, and Apollo runs can take many hours.

Installation

In SourceWeft

  1. Open Scrapercity Cli in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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. One package: the MCP server, the CLI and the JavaScript SDK. The Python SDK is pip install scrapercity.

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

bash
npx scrapercity login            # enter your API keynpx scrapercity wallet           # check balancenpx scrapercity maps -q "plumbers" -l "Denver, CO"npx scrapercity poll <runId>     # wait for resultsnpx 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):

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:

bash
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

bash
# Start a Maps scrapecurl -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 statuscurl https://app.scrapercity.com/api/v1/scrape/status/RUN_ID \  -H "Authorization: Bearer $SCRAPERCITY_API_KEY"
# Download CSV when SUCCEEDEDcurl -O https://app.scrapercity.com/api/downloads/RUN_ID \  -H "Authorization: Bearer $SCRAPERCITY_API_KEY"

Option 5: JavaScript SDK

bash
npm install scrapercity
js
import { configure, wallet, dbLeads, callTool, TOOLS, openaiTools, anthropicTools } from 'scrapercity'
configure({ apiKey: process.env.SCRAPERCITY_API_KEY })await wallet()await dbLeads({ title: 'CEO', country: ['United States'], hasEmail: 'true', limit: 25 })
// Every tool the MCP server offers, by name, with the same argumentsawait callTool('plan_search', { query: 'dentists in Austin, Texas' })
// Hand the whole tool list to OpenAI or Anthropic tool callingconst tools = openaiTools()        // or anthropicTools()

Option 6: Python SDK

bash
pip install scrapercity                 # add [langchain] or [openai] for agent tools
python
from scrapercity import ScraperCity, langchain_toolssc = ScraperCity()                      # reads SCRAPERCITY_API_KEYsc.call_tool("query_lead_database", {"title": "CEO", "limit": 10})tools = langchain_tools()               # LangChain / LangGraph

Both SDKs carry the same tool list as the MCP server, regenerated from the live API docs on every release. Guide: scrapercity.com/sdk. Python package: pypi.org/project/scrapercity.

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.0017 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$1.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
scrape_signals/api/v1/scrape/signals$0.10 per company running ads, $0.03 per website checked, $0.05 per company hiring; minimum charge per search
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 usually take 15-30 minutes. All other scrapers: 1-30 minutes. Store leads are instant.

Authentication

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

bash
# Environment variable (recommended)export SCRAPERCITY_API_KEY="your_key"
# Or save to config filenpx 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

Source: README.md at commit a17dffa

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts