Skip to main content
Glama
scrapercity-cli

scrapercity-cli

Official
by scrapercity

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 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"

Option 5: JavaScript SDK

npm install scrapercity
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 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 tools
from 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 / 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)

Tool

Endpoint

Price

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.0094 per company running ads, $0.0009 per website per platform checked, $0.0043 per company hiring; minimum charge per search

scrape_ucc_filings

/api/v1/scrape/ucc-filings

$0.0028 per filing

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

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

  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

# 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

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

License

MIT

Available Tools

25 tools
cancel_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

    B3.4/5.0

    Scored across 25 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count3/5

    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).

    Completeness4/5

    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

    ActivityActive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      F
      maintenance
      This 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
    • A
      license
      Not graded
      quality
      F
      maintenance
      This 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/).
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      An 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.
      294
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      5
      25 npm
      1
      MIT