{
  "markdown": "# ScraperCity - B2B Lead Generation for AI Agents\n\nPull leads, validate emails, find mobile numbers, and scrape business data - all from your AI agent, CLI, or code.\n\nScraperCity 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.\n\n## Quick Start\n\n### Option 1: CLI\n\n```bash\nnpx scrapercity login            # enter your API key\nnpx scrapercity wallet           # check balance\nnpx scrapercity maps -q \"plumbers\" -l \"Denver, CO\"\nnpx scrapercity poll <runId>     # wait for results\nnpx scrapercity download <runId> # save CSV\n```\n\n### Option 2: MCP Server (Claude Code, Cursor, Windsurf, etc.)\n\nAdd to your MCP config (e.g. `~/.claude/claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"scrapercity\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"--package\", \"scrapercity\", \"scrapercity-mcp\"],\n      \"env\": {\n        \"SCRAPERCITY_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\nThen tell your AI: *\"Find 1000 plumbers in Denver with emails using ScraperCity\"*\n\n### Option 3: Skill File (Claude Code)\n\nCopy the skill file into your project:\n\n```bash\nnpx scrapercity-mcp --print-skill > SCRAPERCITY_SKILL.md\n```\n\nOr download from: `https://scrapercity.com/agents/SKILL.md`\n\nThen 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\"*\n\n### Option 4: Direct API\n\n```bash\n# Start a Maps scrape\ncurl -X POST https://app.scrapercity.com/api/v1/scrape/maps \\\n  -H \"Authorization: Bearer $SCRAPERCITY_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"searchStringsArray\":[\"plumbers\"],\"locationQuery\":\"Denver, CO\",\"maxCrawledPlacesPerSearch\":500}'\n\n# Check status\ncurl https://app.scrapercity.com/api/v1/scrape/status/RUN_ID \\\n  -H \"Authorization: Bearer $SCRAPERCITY_API_KEY\"\n\n# Download CSV when SUCCEEDED\ncurl -O https://app.scrapercity.com/api/downloads/RUN_ID \\\n  -H \"Authorization: Bearer $SCRAPERCITY_API_KEY\"\n```\n\n## Available Tools\n\n| Tool | What it does | Cost |\n|------|-------------|------|\n| **Apollo** | B2B contacts by job title, industry, location | $0.0039/lead |\n| **Google Maps** | Local businesses with phones, emails, reviews | $0.01/place |\n| **Email Validator** | Verify deliverability, catch-all, MX records | $0.0036/email |\n| **Email Finder** | Find business email from name + company | $0.05/contact |\n| **Mobile Finder** | Phone numbers from LinkedIn or email | $0.25/input |\n| **People Finder** | Skip trace by name, email, phone, address | $0.02/result |\n| **Store Leads** | Shopify/WooCommerce stores with contacts | $0.0039/lead |\n| **BuiltWith** | All sites using a technology | $4.99/search |\n| **Criminal Records** | Background check by name | $1.00 if found |\n| **Lead Database** | 3M+ B2B contacts, instant query ($649 plan) | Included |\n\n## How It Works\n\n1. **Start a scrape** → get a `runId`\n2. **Poll status** (or use webhooks) → wait for `SUCCEEDED`\n3. **Download CSV** → leads with full contact info\n\nApollo scrapes take 11-48+ hours. All other scrapers: 1-30 minutes. Store leads are instant.\n\n## Authentication\n\nGet your API key at [app.scrapercity.com/dashboard/api-docs](https://app.scrapercity.com/dashboard/api-docs)\n\n```bash\n# Environment variable (recommended)\nexport SCRAPERCITY_API_KEY=\"your_key\"\n\n# Or save to config file\nnpx scrapercity login\n```\n\n## Webhooks\n\nFor Apollo and long-running scrapes, configure a webhook at [app.scrapercity.com/dashboard/webhooks](https://app.scrapercity.com/dashboard/webhooks) to get notified when results are ready.\n\n## Plans\n\n| Plan | Price | Credits |\n|------|-------|---------|\n| Trial | Free | $5 |\n| Starter | $49/mo | $49 |\n| Growth | $149/mo | $149 + 10% bonus |\n| Professional | $649/mo | $649 + 30% bonus + Database API |\n\nBuy additional credits anytime. [scrapercity.com/pricing](https://scrapercity.com/pricing)\n\n## Links\n\n- [Agent Docs](https://scrapercity.com/agents) - setup guide\n- [API Reference](https://scrapercity.com/api-docs) - full documentation\n- [Skill File](https://scrapercity.com/agents/SKILL.md) - for Claude Code\n- [MCP Server Listing](https://scrapercity.com/agents) - configuration\n\n## License\n\nMIT\n",
  "bytes": 4290,
  "sha": "19e185d700151ff0ae84cd341911a0d933a82a8df2988eb5362df4ff9e298fa5",
  "repo_slug": "scrapercity/scrapercity-cli",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_scrapercity_scrapercity_cli_1b02e9f6/readme"
}