ScraperCity

chính thức

Máy chủ MCP tạo khách hàng tiềm năng B2B - Apollo, Google Maps, công cụ tìm email, skip trace và hơn 15 công cụ khác.

Bạn có thể làm gì với ScraperCity MCP?

Thu thập dữ liệu doanh nghiệp địa phương — Lấy danh sách trên Google Maps kèm số điện thoại, email và đánh giá theo từ khóa tìm kiếm và địa điểm, sau đó kiểm tra tiến trình và tải xuống tệp CSV.
Tìm liên hệ B2B — Tra cứu cơ sở dữ liệu khách hàng tiềm năng hoặc thu thập dữ liệu từ Apollo để tìm người theo chức danh, ngành nghề và địa điểm.
Xác thực và tìm email — Xác minh khả năng gửi email bằng validate_emails hoặc tìm email doanh nghiệp từ tên và công ty.
Tra cứu số điện thoại di động — Tìm số điện thoại từ hồ sơ LinkedIn hoặc email, hoặc truy tìm thông tin theo tên, email, số điện thoại hoặc địa chỉ.
Kiểm tra trạng thái tiến trình và tải xuống — Theo dõi tiến độ thu thập dữ liệu và lưu kết quả hoàn tất dưới dạng CSV khi thành công.

Tài liệu

ScraperCity - Tạo khách hàng tiềm năng B2B cho AI Agent

Tìm khách hàng tiềm năng, xác thực email, tìm số điện thoại di động và thu thập dữ liệu doanh nghiệp — tất cả từ AI agent, CLI hoặc mã của bạn. Một gói duy nhất: MCP server, CLI và JavaScript SDK. Python SDK là pip install scrapercity.

ScraperCity cung cấp cho AI agent quyền truy cập vào hơn 15 công cụ dữ liệu B2B: thu thập dữ liệu Apollo, trích xuất dữ liệu Google Maps, tìm kiếm/xác thực email, tra cứu số điện thoại di động, truy tìm thông tin cá nhân, dữ liệu cửa hàng thương mại điện tử, hồ sơ hình sự và nhiều công cụ khác.

Bắt đầu tại đây (không cần khóa API)

npx scrapercity start "dentists in Austin"

Hoặc yêu cầu agent gọi công cụ MCP start_here hoặc GET https://app.scrapercity.com/api/v1/start?query=.... Không có khóa, bạn sẽ được hướng dẫn: ScraperCity là gì, cách đăng ký, các gói và chương trình dùng thử với điều khoản hiện hành, cùng các lượt tìm kiếm thực tế với số lượng trực tiếp. Có khóa, công cụ sẽ lập kế hoạch cho tài khoản của bạn và trả về chính xác lệnh gọi tiếp theo.

Nói rõ về chương trình dùng thử: Đây là trải nghiệm sử dụng thực tế, không phải bản demo hay gói miễn phí: bạn có $5 tín dụng trong 7 ngày, dùng được với mọi công cụ và cơ sở dữ liệu theo mức giá thông thường, để bạn có thể lấy dữ liệu thực ngay từ ngày đầu và đánh giá chất lượng dữ liệu. Khi đăng ký, bạn cần cung cấp thẻ thanh toán. Khi hết 7 ngày, gói đã chọn lúc đăng ký sẽ bắt đầu; hãy hủy trong phần thanh toán trước thời điểm đó để không bị tính thêm phí. Nếu tín dụng hết sớm hơn, các lượt truy vấn cơ sở dữ liệu sẽ tạm dừng (không tính phí); nếu một lượt chạy scraper vượt quá số tín dụng còn lại, gói sẽ bắt đầu sớm. Tìm kiếm để lập kế hoạch và kiểm tra số lượng đều miễn phí. start_here trả về điều khoản hiện hành.

Bắt đầu nhanh

Tùy chọn 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

Tùy chọn 2: MCP Server (Claude Code, Cursor, Windsurf, v.v.)

Thêm vào cấu hình MCP của bạn (ví dụ: ~/.claude/claude_desktop_config.json):

{
  "mcpServers": {
    "scrapercity": {
      "command": "npx",
      "args": ["-y", "--package", "scrapercity", "scrapercity-mcp"],
      "env": {
        "SCRAPERCITY_API_KEY": "your_api_key_here"
      }
    }
  }
}

Sau đó yêu cầu AI: "Tìm 1000 thợ sửa ống nước ở Denver có email bằng ScraperCity"

Tùy chọn 3: Tệp Skill (Claude Code)

Sao chép tệp skill vào dự án của bạn:

npx scrapercity-mcp --print-skill > SCRAPERCITY_SKILL.md

Hoặc tải xuống từ: https://scrapercity.com/agents/SKILL.md

Sau đó trong Claude Code: "Đọc SCRAPERCITY_SKILL.md và tìm cho tôi 2000 giám đốc tiếp thị tại các công ty SaaS ở California, xác thực email của họ và lưu vào leads.csv"

Tùy chọn 4: API trực tiếp

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

Tùy chọn 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()

Tùy chọn 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

Cả hai SDK đều có cùng danh sách công cụ như MCP server; danh sách được tạo lại từ tài liệu API trực tiếp trong mỗi bản phát hành. Hướng dẫn: scrapercity.com/sdk. Gói Python: pypi.org/project/scrapercity.

Giá (tự động tạo từ danh mục trực tiếp — không chỉnh sửa)

Công cụ	Endpoint	Giá
`scrape_apollo`	/api/v1/scrape/apollo	$0.0039 mỗi khách hàng tiềm năng
`scrape_website_finder`	/api/v1/scrape/website-finder	$0.0499 mỗi liên hệ tìm được
`find_people`	/api/v1/scrape/skip-trace	$0.0199 mỗi kết quả (tìm kiếm không có kết quả khớp vẫn được tính phí như 1 kết quả)
`scrape_distress_list`	/api/v1/scrape/distress-list	$0.05 mỗi bất động sản
`validate_emails`	/api/v1/scrape/email-validator	$0.0017 mỗi email
`scrape_maps`	/api/v1/scrape/maps	$0.0099 mỗi doanh nghiệp
`scrape_airbnb`	/api/v1/scrape/airbnb-email	$0.019 mỗi kết quả ($19.00 mỗi 1.000)
`scrape_bizbuysell`	/api/v1/scrape/bizbuysell-scraper	$0.0099 mỗi tin đăng
`scrape_crexi`	/api/v1/scrape/crexi-scraper	$0.029 mỗi bất động sản
`scrape_angi`	/api/v1/scrape/angi-angies-list-scraper	$0.0099 mỗi tin đăng
`scrape_yelp`	/api/v1/scrape/yelp-scraper	$0.0099 mỗi kết quả
`scrape_zillow_agents`	/api/v1/scrape/zillow-agents	$0.029 mỗi đại lý
`scrape_property_lookup`	/api/v1/scrape/property-lookup	$0.15 mỗi bất động sản (+$0.10 nếu có thông tin liên hệ chủ sở hữu)
`search_criminal_records`	/api/v1/scrape/criminal-records	$1.00 mỗi lượt tìm kiếm (chỉ tính phí nếu tìm thấy hồ sơ)
`scrape_store_leads`	/api/v1/scrape/store-leads	$0.0039 mỗi khách hàng tiềm năng
`scrape_builtwith`	/api/v1/scrape/techstack	$4.99 mỗi công nghệ
`scrape_signals`	/api/v1/scrape/signals	$0.0094 mỗi công ty đang chạy quảng cáo, $0.0009 mỗi website trên mỗi nền tảng được kiểm tra, $0.0043 mỗi công ty đang tuyển dụng; mức phí tối thiểu cho mỗi lượt tìm kiếm
`find_emails`	/api/v1/scrape/email-finder	$0.05 mỗi email tìm được (MIỄN PHÍ nếu không tìm thấy)
`find_mobiles`	/api/v1/scrape/mobile-finder	$0.25 mỗi số điện thoại tìm được (MIỄN PHÍ nếu không tìm thấy)

Công cụ hiện có

Công cụ	Chức năng	Chi phí
Apollo	Tìm liên hệ B2B theo chức danh, ngành nghề, địa điểm	$0.0039/khách hàng tiềm năng
Google Maps	Tìm doanh nghiệp địa phương cùng số điện thoại, email, đánh giá	$0.01/địa điểm
Email Validator	Xác minh khả năng gửi thư, phát hiện catch-all, kiểm tra bản ghi MX	$0.0036/email
Email Finder	Tìm email công việc từ tên và công ty	$0.05/liên hệ
Mobile Finder	Tìm số điện thoại từ LinkedIn hoặc email	$0.25/đầu vào
People Finder	Truy tìm thông tin theo tên, email, số điện thoại, địa chỉ	$0.02/kết quả
Store Leads	Tìm cửa hàng Shopify/WooCommerce cùng thông tin liên hệ	$0.0039/khách hàng tiềm năng
BuiltWith	Tìm tất cả website sử dụng một công nghệ	$4.99/lượt tìm kiếm
Criminal Records	Kiểm tra lý lịch theo tên	$1.00 nếu tìm thấy
Lead Database	Liên hệ B2B, truy vấn tức thì	Đã bao gồm trong gói $149/tháng trở lên; các khách hàng tiềm năng mới được tính theo từng bản ghi bằng tín dụng ở các gói thấp hơn
Local Business Database	Doanh nghiệp địa phương cùng số điện thoại, email và xếp hạng, truy vấn tức thì	Đã bao gồm trong gói $149/tháng trở lên; các doanh nghiệp mới được tính theo từng bản ghi bằng tín dụng ở các gói thấp hơn

Trước khi gửi

Với khách hàng tiềm năng từ bất kỳ cơ sở dữ liệu nào: hãy kiểm tra trước khi liên hệ. Mỗi bản ghi đều có email_check_status (công cụ kiểm tra email của chúng tôi: valid, valid_catch_all, invalid, unknown, not_checked): CHỈ gửi đến email valid đã được kiểm tra trong 30 ngày gần nhất (email_checked_on), và trước tiên hãy đưa mọi email khác qua validate_emails. Với người liên hệ (Lead Database), truyền replaceLeftContacts: true vào query_lead_database (query_local_business_database và query_ecommerce_database cũng nhận tham số này, cho người liên hệ của từng doanh nghiệp hoặc cửa hàng); phản hồi sẽ bổ sung replacement.run_id, một lượt chạy kiểm tra mọi email và thay thế những người đã rời vị trí bằng người hiện đang đảm nhiệm vai trò đó. Chờ bằng check_run_status, sau đó gửi CSV từ download_results ($0.02 cho mỗi liên hệ được thay thế, miễn phí trong gói $649). Tối thiểu, hãy kiểm tra email bằng validate_emails và chỉ gửi đến những địa chỉ hợp lệ.

Cách hoạt động

Bắt đầu thu thập dữ liệu → nhận runId
Thăm dò trạng thái (hoặc dùng webhook) → chờ SUCCEEDED
Tải CSV xuống → khách hàng tiềm năng cùng đầy đủ thông tin liên hệ

Các lượt thu thập dữ liệu Apollo thường mất 15-30 phút. Tất cả scraper khác mất 1-30 phút. Store Leads trả kết quả tức thì.

Xác thực

Lấy khóa API tại app.scrapercity.com/dashboard/api-docs

# Environment variable (recommended)
export SCRAPERCITY_API_KEY="your_key"

# Or save to config file
npx scrapercity login

Webhook

Với Apollo và các lượt thu thập dữ liệu chạy lâu, hãy cấu hình webhook tại app.scrapercity.com/dashboard/webhooks để nhận thông báo khi có kết quả.

Gói dịch vụ

Gói	Giá	Tín dụng
Trial	7 ngày, cần thẻ thanh toán; sau đó áp dụng gói đã chọn khi đăng ký	$5 tín dụng sử dụng
Starter	$49/tháng	$49 (cơ sở dữ liệu tính phí theo từng bản ghi bằng tín dụng)
Growth	$149/tháng	$149 + thưởng 10%, đã bao gồm cơ sở dữ liệu
Scale	$649/tháng	$649 + thưởng 30%, đã bao gồm cơ sở dữ liệu, giới hạn cao hơn

Mua thêm tín dụng bất cứ lúc nào. scrapercity.com/pricing

Liên kết

Tài liệu cho Agent - hướng dẫn thiết lập
Tài liệu tham khảo API - tài liệu đầy đủ
Hướng dẫn SDK - JavaScript và Python SDK
Python SDK trên PyPI - pip install scrapercity
Tệp Skill - dành cho Claude Code
Danh sách MCP Server - cấu hình

Giấy phép

MIT