scrapercity-cli
OfficialThis server is a B2B lead-generation and data-scraping toolkit: start scrapes, poll runs, and download lead CSVs from ~20 sources.
Account:
check_walletfor balance/plan/billing,list_runsfor recent runs, costs and lead countsB2B contacts:
scrape_apollo/scrape_apollo_filters(title, seniority, industry, location, size) andquery_lead_databaseLocal business:
scrape_maps(names, phones, emails, ratings),scrape_yelp,scrape_angi,scrape_store_leadsContact discovery:
find_emails,find_mobiles,find_people(skip trace),scrape_website_finder,scrape_youtube_email,scrape_airbnbValidation:
validate_emailsfor deliverability, catch-all and MX checksReal estate / property:
scrape_zillow_agents,scrape_property_lookup,scrape_crexi,scrape_bizbuysellOther data:
scrape_builtwith(tech stack),search_criminal_recordsRun management:
check_run_status,download_results(CSV),cancel_run
Allows for the extraction of local business data, including phone numbers, emails, and reviews, directly from Google Maps.
Enables the identification and extraction of contact and business data from ecommerce stores built on the Shopify platform.
Enables the identification and extraction of contact and business data from ecommerce stores built on the WooCommerce platform.
Enables the identification and extraction of contact and business data from ecommerce stores built on the WooCommerce platform.
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.
Start Here (no API key needed)
npx scrapercity start "dentists in Austin"Or have your agent call the start_here MCP tool, or GET https://app.scrapercity.com/api/v1/start?query=.... With no key you get a guided tour: what ScraperCity is, how to sign up, the plans and the trial with their live terms, and real searches with live counts. With a key it plans for your account and returns the exact next call.
The trial, plainly: The trial is real usage, not a demo or a free tier: $5 of credit for 7 days that works on every tool and database at the normal prices, so you can pull real records on day one and judge the data. A card is required at signup. When the 7 days end, the plan picked at signup starts; cancel before then from billing and nothing more is charged. If the credit runs out sooner, database pulls wait (nothing is charged for them); a scraper run that goes past the credit starts the plan early. Planning searches and checking counts are free. start_here returns the live terms.
Related MCP server: Salesforce Marketing MCP Server by CData
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 CSVOption 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.mdOr 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"Option 5: JavaScript SDK
npm install scrapercityimport { 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 arguments
await callTool('plan_search', { query: 'dentists in Austin, Texas' })
// Hand the whole tool list to OpenAI or Anthropic tool calling
const tools = openaiTools() // or anthropicTools()Option 6: Python SDK
pip install scrapercity # add [langchain] or [openai] for agent toolsfrom scrapercity import ScraperCity, langchain_tools
sc = ScraperCity() # reads SCRAPERCITY_API_KEY
sc.call_tool("query_lead_database", {"title": "CEO", "limit": 10})
tools = langchain_tools() # LangChain / LangGraphBoth 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)
Tool | Endpoint | Price |
| /api/v1/scrape/apollo | $0.0039 per lead |
| /api/v1/scrape/website-finder | $0.0499 per contact found |
| /api/v1/scrape/skip-trace | $0.0199 per result (searches with 0 matches are billed as 1 result) |
| /api/v1/scrape/distress-list | $0.05 per property |
| /api/v1/scrape/email-validator | $0.0017 per email |
| /api/v1/scrape/maps | $0.0099 per business |
| /api/v1/scrape/airbnb-email | $0.019 per result ($19.00 per 1,000) |
| /api/v1/scrape/bizbuysell-scraper | $0.0099 per listing |
| /api/v1/scrape/crexi-scraper | $0.029 per property |
| /api/v1/scrape/angi-angies-list-scraper | $0.0099 per listing |
| /api/v1/scrape/yelp-scraper | $0.0099 per result |
| /api/v1/scrape/zillow-agents | $0.029 per agent |
| /api/v1/scrape/property-lookup | $0.15 per property (+$0.10 for owner contact) |
| /api/v1/scrape/criminal-records | $1.00 per search (only charged if records found) |
| /api/v1/scrape/store-leads | $0.0039 per lead |
| /api/v1/scrape/techstack | $4.99 per technology |
| /api/v1/scrape/signals | $0.0094 per company running ads, $0.0009 per website per platform checked, $0.0043 per company hiring; minimum charge per search |
| /api/v1/scrape/ucc-filings | $0.0028 per filing |
| /api/v1/scrape/email-finder | $0.05 per email found (FREE if not found) |
| /api/v1/scrape/mobile-finder | $0.25 per number found (FREE if not found) |
Available Tools
Tool | What it does | Cost |
Apollo | B2B contacts by job title, industry, location | $0.0039/lead |
Google Maps | Local businesses with phones, emails, reviews | $0.01/place |
Email Validator | Verify deliverability, catch-all, MX records | $0.0036/email |
Email Finder | Find business email from name + company | $0.05/contact |
Mobile Finder | Phone numbers from LinkedIn or email | $0.25/input |
People Finder | Skip trace by name, email, phone, address | $0.02/result |
Store Leads | Shopify/WooCommerce stores with contacts | $0.0039/lead |
BuiltWith | All sites using a technology | $4.99/search |
Criminal Records | Background check by name | $1.00 if found |
Lead Database | B2B contacts, instant query | Included on $149/mo and up; per new lead from credits below it |
Local Business Database | Local businesses with phones, emails and ratings, instant query | Included on $149/mo and up; per new business from credits below it |
Before You Send
Leads from any database: check them before outreach. Every record carries email_check_status (our own email checker: valid, valid_catch_all, invalid, unknown, not_checked): send ONLY to valid emails checked in the last 30 days (email_checked_on), and put every other email through validate_emails first. For people (Lead Database), pass replaceLeftContacts: true to query_lead_database (query_local_business_database and query_ecommerce_database take it too, for each business's or store's contact person); the response adds replacement.run_id, a run that checks every email and swaps each person who has left for the person in that role now. Wait for it with check_run_status, then send the CSV from download_results ($0.02 per contact replaced, free on the $649 plan). At minimum, run the emails through validate_emails and send only to the valid ones.
How It Works
Start a scrape → get a
runIdPoll status (or use webhooks) → wait for
SUCCEEDEDDownload 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
# Environment variable (recommended)
export SCRAPERCITY_API_KEY="your_key"
# Or save to config file
npx scrapercity loginWebhooks
For Apollo and long-running scrapes, configure a webhook at app.scrapercity.com/dashboard/webhooks to get notified when results are ready.
Plans
Plan | Price | Credits |
Trial | 7 days, card required, then the plan picked at signup | $5 of usage credit |
Starter | $49/mo | $49 (databases per record from credits) |
Growth | $149/mo | $149 + 10% bonus, databases included |
Scale | $649/mo | $649 + 30% bonus, databases included, higher limits |
Buy additional credits anytime. scrapercity.com/pricing
Links
Agent Docs - setup guide
API Reference - full documentation
SDK guide - JavaScript and Python SDKs
Python SDK on PyPI -
pip install scrapercitySkill File - for Claude Code
MCP Server Listing - configuration
License
MIT
Available Tools
25 toolscancel_runB
Cancel a running scraper job.
Inputs: runId (required).
check_run_statusA
Check the status of a scraper run. Returns status (RUNNING/SUCCEEDED/FAILED/CANCELLED), lead count, and download URL when complete.
Inputs: runId (required).
check_walletA
Check account balance, plan, and billing info. Call this FIRST to verify credits before running any scrape.
Inputs: no named parameters.
download_resultsA
Download the CSV results of a completed scraper run. Only works when status is SUCCEEDED.
Inputs: runId (required), outputPath.
find_emailsB
Find business email addresses given a person name and company. Provide first/last name + domain or company name.
Inputs: contacts (required), autoValidateEmails, autoFindMobiles.
find_mobilesB
Find mobile phone numbers from LinkedIn URLs or work emails.
Inputs: inputs (required).
find_peopleB
Skip trace / people finder. Look up personal info by name, email, phone, or address.
Inputs: name, email, phone_number, street_citystatezip, +1 more.
list_runsA
List recent scraper runs with status, lead counts, and costs.
Inputs: hours, limit.
query_lead_databaseA
Query the B2B lead database directly (requires $649/mo plan). Returns contacts with names, emails, phones, titles, companies. 100 per request, paginate with page param.
Inputs: title, industry, country, state, +9 more.
scrape_airbnbB
Scrape Airbnb host emails by city or listing URL. Returns host contact info including email addresses.
Inputs: mode, city, listingUrl, bulkListings, +6 more.
scrape_angiB
Scrape service provider listings from Angi (Angie's List). Search by keyword and zip codes.
Inputs: keyword (required), zipCodes, maxItems.
scrape_apolloA
Scrape leads from Apollo.io using a search URL. IMPORTANT: Apollo delivery takes 11-48+ hours. Use webhooks (configure at app.scrapercity.com/dashboard/webhooks) instead of polling. Returns a runId to check status later.
Inputs: url (required), count, fileName.
scrape_apollo_filtersA
Scrape leads from Apollo.io using filter parameters instead of a URL. Same 4-day delivery - use webhooks. At least one filter required.
Inputs: seniorityLevel, functionDept, companyIndustry, personCountry, +12 more.
scrape_bizbuysellC
Scrape business-for-sale listings from BizBuySell. Provide search result URLs.
Inputs: startUrls (required), maxItems.
scrape_builtwithB
Find all websites using a specific technology. Returns domains with contact info. $4.99 per search.
Inputs: technology (required), fileName.
scrape_crexiA
Scrape commercial real estate listings from Crexi. Provide search result URLs.
Inputs: startUrls (required).
scrape_mapsA
Scrape businesses from Google Maps. Returns businesses with names, addresses, phone numbers, websites, emails, ratings. Typically completes in 5-30 minutes.
Inputs: query (required), location (required), limit.
scrape_property_lookupB
Look up property data by address. Optionally include owner contact information. $0.15 per address.
Inputs: addresses (required), includeOwnerContact.
scrape_store_leadsA
Get ecommerce store data (Shopify, WooCommerce, etc). Returns domains, emails, phones, social profiles, revenue estimates. Instant results from cached database.
Inputs: platform, countryCode, category, city, +7 more.
scrape_website_finderC
Find contact info (emails, phones, social links) from a list of website domains. Optionally filter by job title.
Inputs: domains (required), jobTitle.
scrape_yelpB
Scrape business listings from Yelp. Search by keyword + location, or provide direct Yelp URLs.
Inputs: searchTerms, locations, directUrls, searchLimit.
scrape_youtube_emailB
Find business emails for YouTube channels. Pass channel handles (@ChannelName) or URLs.
Inputs: channels (required).
scrape_zillow_agentsC
Scrape real estate agent listings from Zillow by location.
Inputs: location (required), specialty, language, searchLimit.
search_criminal_recordsA
Search criminal records by name. $1 per search, only charged if records found.
Inputs: name (required), state, dob.
validate_emailsA
Validate a list of email addresses. Returns deliverability status, catch-all detection, MX records, and company info. Typically completes in 1-10 minutes.
Inputs: emails (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 25 tools
Most tools target distinct sources or specific data types (e.g., scrape_airbnb vs scrape_yelp), and find_* tools are separated from scrape_* tools. However, scrape_apollo and scrape_apollo_filters are very similar, and multiple tools return contact info (find_emails, query_lead_database, scrape_apollo), which could cause misselection.
Tool names follow a clear pattern with verbs like scrape_, find_, check_, search_, etc. The pattern is consistent per category (e.g., all scraping tools use scrape_), but verbs vary across categories. No mixing of naming conventions, and names are readable.
25 tools is on the high side for a single server, but the domain (multi-source scraping and data enrichment) is broad enough to justify many specialized endpoints. Still, some tools could potentially be combined (e.g., scrape_apollo and scrape_apollo_filters).
The tool set covers the full lifecycle of scraping runs (cancel, check, download, list) and provides a wide range of data sources (real estate, business listings, people search, email validation). Minor gaps: no generic web scraper or tool to manage account settings beyond check_wallet.
Maintenance
Related MCP Connectors
Local business & Google Maps B2B lead extractor MCP: phone, email, website, DNS & SaaS tech stack.
Sales MCP server for AI agents: find, enrich, score and reach leads on LinkedIn, track replies.
All HasData scraping tools in one MCP server: Google, TikTok, Instagram, maps, e-commerce and more.
LinkedIn outreach MCP server — 19 tools for AI agents to prospect, sequence, and manage contacts.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceThis read-only MCP Server allows you to connect to HubSpot data from Claude Desktop through CData JDBC Drivers. For full CRUD support, check out the first managed MCP platform: CData Connect AI (https://www.cdata.com/ai/).MIT
- AlicenseNot gradedqualityFmaintenanceThis read-only MCP Server allows you to connect to Salesforce Marketing data from Claude Desktop through CData JDBC Drivers. For full CRUD support, check out the first managed MCP platform: CData Connect AI (https://www.cdata.com/ai/).1MIT
- AlicenseNot gradedqualityCmaintenanceAn MCP server providing real-time access to comprehensive B2B company and contact data for lead generation and business intelligence. It enables AI tools to search firmographics, discover key contacts, and automate personalized outreach workflows.294MIT
- AlicenseAqualityBmaintenanceEnables AI assistants to manage marketing campaigns, Facebook accounts, and lead generation tasks through the MessengerFlow platform. It provides tools for interacting with messaging inboxes, scraping leads, and accessing real-time performance analytics.525 npm1MIT