Scrapercity Cli

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

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

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

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

pip install scrapercity                 # add [langchain] or [openai] for agent tools

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)

Available Tools

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

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 scrapercity
• Skill File - for Claude Code
• MCP Server Listing - configuration

License

MIT