English Français العربية

io.github.scrapercity/scrapercity-cli

السجل الرسمي البحث والويب

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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 (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "scrapercity-cli": {
            "command": "npx",
            "args": [
                "-y",
                "scrapercity@1.0.1"
            ],
            "env": {
                "SCRAPERCITY_API_KEY": "<your scrapercity_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • SCRAPERCITY_API_KEY إلزامي سري Your ScraperCity API key

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو io.github.scrapercity/scrapercity-cli؟

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

كيف أثبّت io.github.scrapercity/scrapercity-cli؟

يعمل على جهازك. في Claude Code: claude mcp add scrapercity-cli -e 'SCRAPERCITY_API_KEY=<your scrapercity_api_key>' -- npx -y scrapercity@1.0.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.scrapercity/scrapercity-cli إلى مفتاح API؟

نعم. يتطلب SCRAPERCITY_API_KEY، وتضبطها في إعداداته.

هل io.github.scrapercity/scrapercity-cli مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.scrapercity/scrapercity-cli؟

ينشره scrapercity. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.