ScraperCity
공식B2B 리드 생성 MCP 서버 - Apollo, Google Maps, 이메일 파인더, 스킵 트레이스 및 15개 이상의 추가 도구.
ScraperCity MCP(으)로 무엇을 할 수 있나요?
- 지역 업체 스크래핑 — 검색어와 위치를 기준으로 Google Maps 목록에서 전화번호, 이메일, 리뷰를 가져온 다음, 실행 상태를 확인하고 CSV를 다운로드합니다.
- B2B 연락처 찾기 — 리드 데이터베이스를 검색하거나 Apollo를 스크래핑해 직책, 업종, 위치별 인물을 찾습니다.
- 이메일 검증 및 찾기 —
validate_emails로 이메일 전달 가능 여부를 확인하거나 이름과 회사로 업무용 이메일을 찾습니다. - 휴대전화 번호 조회 — LinkedIn 프로필이나 이메일로 전화번호를 찾거나, 이름, 이메일, 전화번호 또는 주소로 역추적합니다.
- 실행 상태 확인 및 다운로드 — 스크래핑 진행 상황을 추적하고 성공하면 완료된 결과를 CSV로 저장합니다.
문서
ScraperCity - AI 에이전트를 위한 B2B 리드 생성
AI 에이전트, CLI 또는 코드에서 리드를 가져오고, 이메일을 검증하고, 휴대폰 번호를 찾고, 비즈니스 데이터를 스크래핑하세요. 하나의 패키지에 MCP 서버, CLI, JavaScript SDK가 포함되어 있습니다. Python SDK는 pip install scrapercity입니다.
ScraperCity는 AI 에이전트에 15개 이상의 B2B 데이터 도구를 제공합니다. Apollo 스크래핑, Google Maps 추출, 이메일 찾기/검증, 휴대폰 번호 조회, 스킵 트레이싱, 이커머스 스토어 데이터, 범죄 기록 등이 포함됩니다.
여기서 시작하세요 (API 키 불필요)
npx scrapercity start "dentists in Austin"
또는 에이전트가 start_here MCP 도구나 GET https://app.scrapercity.com/api/v1/start?query=...을 호출하도록 하세요. 키가 없으면 ScraperCity가 무엇인지, 가입 방법, 요금제와 실제 약관이 적용되는 체험판, 실시간 건수가 표시되는 실제 검색을 안내합니다. 키가 있으면 계정에 맞춰 계획을 세우고 다음에 호출할 정확한 항목을 반환합니다.
체험판 안내: 체험판은 데모나 무료 요금제가 아니라 실제 사용을 위한 것입니다. 7일 동안 제공되는 $5 크레딧은 모든 도구와 데이터베이스에서 정상 가격으로 사용할 수 있으므로 첫날부터 실제 레코드를 가져와 데이터 품질을 평가할 수 있습니다. 가입 시 카드가 필요합니다. 7일이 지나면 가입 시 선택한 요금제가 시작됩니다. 그 전에 결제 페이지에서 취소하면 추가 요금이 청구되지 않습니다. 크레딧이 먼저 소진되면 데이터베이스 가져오기는 대기 상태가 되며(요금이 청구되지 않음), 크레딧을 초과하는 스크래퍼 실행은 요금제를 조기에 시작합니다. 계획 검색과 건수 확인은 무료입니다. start_here에서 최신 약관을 확인할 수 있습니다.
빠른 시작
옵션 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
옵션 2: MCP 서버 (Claude Code, Cursor, Windsurf 등)
MCP 설정에 추가하세요 (예: ~/.claude/claude_desktop_config.json):
{
"mcpServers": {
"scrapercity": {
"command": "npx",
"args": ["-y", "--package", "scrapercity", "scrapercity-mcp"],
"env": {
"SCRAPERCITY_API_KEY": "your_api_key_here"
}
}
}
}
그런 다음 AI에게 이렇게 요청하세요: "ScraperCity를 사용해 Denver에서 이메일이 있는 배관공 1000명을 찾아줘"
옵션 3: 스킬 파일 (Claude Code)
스킬 파일을 프로젝트에 복사하세요.
npx scrapercity-mcp --print-skill > SCRAPERCITY_SKILL.md
또는 다음에서 다운로드하세요: https://scrapercity.com/agents/SKILL.md
그런 다음 Claude Code에서 이렇게 요청하세요: "SCRAPERCITY_SKILL.md를 읽고 California의 SaaS 회사에서 마케팅 디렉터 2000명을 찾아 이메일을 검증한 다음 leads.csv에 저장해줘"
옵션 4: 직접 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"
옵션 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()
옵션 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
두 SDK 모두 MCP 서버와 동일한 도구 목록을 제공하며, 매 릴리스마다 최신 API 문서에서 다시 생성됩니다. 가이드: scrapercity.com/sdk. Python 패키지: pypi.org/project/scrapercity.
요금 (최신 카탈로그에서 자동 생성 — 수정하지 마세요)
| 도구 | 엔드포인트 | 가격 |
|---|---|---|
scrape_apollo | /api/v1/scrape/apollo | 리드당 $0.0039 |
scrape_website_finder | /api/v1/scrape/website-finder | 찾은 연락처당 $0.0499 |
find_people | /api/v1/scrape/skip-trace | 결과당 $0.0199 (일치 항목이 0개인 검색도 결과 1개로 청구) |
scrape_distress_list | /api/v1/scrape/distress-list | 부동산당 $0.05 |
validate_emails | /api/v1/scrape/email-validator | 이메일당 $0.0017 |
scrape_maps | /api/v1/scrape/maps | 비즈니스당 $0.0099 |
scrape_airbnb | /api/v1/scrape/airbnb-email | 결과당 $0.019 (1,000개당 $19.00) |
scrape_bizbuysell | /api/v1/scrape/bizbuysell-scraper | 매물당 $0.0099 |
scrape_crexi | /api/v1/scrape/crexi-scraper | 부동산당 $0.029 |
scrape_angi | /api/v1/scrape/angi-angies-list-scraper | 매물당 $0.0099 |
scrape_yelp | /api/v1/scrape/yelp-scraper | 결과당 $0.0099 |
scrape_zillow_agents | /api/v1/scrape/zillow-agents | 에이전트당 $0.029 |
scrape_property_lookup | /api/v1/scrape/property-lookup | 부동산당 $0.15 (+ 소유자 연락처에 $0.10) |
search_criminal_records | /api/v1/scrape/criminal-records | 검색당 $1.00 (기록이 발견된 경우에만 청구) |
scrape_store_leads | /api/v1/scrape/store-leads | 리드당 $0.0039 |
scrape_builtwith | /api/v1/scrape/techstack | 기술당 $4.99 |
scrape_signals | /api/v1/scrape/signals | 광고를 운영하는 회사당 $0.0094, 확인한 플랫폼별 웹사이트당 $0.0009, 채용 중인 회사당 $0.0043; 검색당 최소 요금 적용 |
find_emails | /api/v1/scrape/email-finder | 찾은 이메일당 $0.05 (찾지 못하면 무료) |
find_mobiles | /api/v1/scrape/mobile-finder | 찾은 번호당 $0.25 (찾지 못하면 무료) |
사용 가능한 도구
| 도구 | 기능 | 비용 |
|---|---|---|
| Apollo | 직함, 업종, 위치별 B2B 연락처 | 리드당 $0.0039 |
| Google Maps | 전화번호, 이메일, 리뷰가 포함된 지역 비즈니스 | 장소당 $0.01 |
| Email Validator | 이메일 전달 가능 여부, catch-all, MX 레코드 확인 | 이메일당 $0.0036 |
| Email Finder | 이름과 회사로 비즈니스 이메일 찾기 | 연락처당 $0.05 |
| Mobile Finder | LinkedIn 또는 이메일로 전화번호 찾기 | 입력당 $0.25 |
| People Finder | 이름, 이메일, 전화번호, 주소로 스킵 트레이싱 | 결과당 $0.02 |
| Store Leads | 연락처가 포함된 Shopify/WooCommerce 스토어 | 리드당 $0.0039 |
| BuiltWith | 특정 기술을 사용하는 모든 사이트 | 검색당 $4.99 |
| Criminal Records | 이름으로 신원 조회 | 기록이 발견되면 $1.00 |
| Lead Database | B2B 연락처, 즉시 검색 | 월 $149 이상 요금제에 포함; 그보다 낮은 요금제에서는 크레딧으로 신규 리드당 과금 |
| Local Business Database | 전화번호, 이메일, 평점이 포함된 지역 비즈니스, 즉시 검색 | 월 $149 이상 요금제에 포함; 그보다 낮은 요금제에서는 크레딧으로 신규 비즈니스당 과금 |
전송하기 전에
어떤 데이터베이스에서 가져온 리드든 아웃리치 전에 확인하세요. 모든 레코드에는 email_check_status (자체 이메일 검사 결과: valid, valid_catch_all, invalid, unknown, not_checked)가 포함됩니다. 지난 30일 이내에 확인된 valid 이메일에만 발송하고 (email_checked_on), 그 외 모든 이메일은 먼저 validate_emails에 전달하세요. 사람(Lead Database)의 경우 replaceLeftContacts: true를 query_lead_database에 전달하세요 (query_local_business_database 및 query_ecommerce_database도 각 비즈니스 또는 스토어의 담당자에 대해 이 값을 받습니다). 응답에는 replacement.run_id이 추가됩니다. 이 작업은 모든 이메일을 확인하고 퇴사한 사람을 현재 해당 직책을 맡은 사람으로 교체합니다. check_run_status로 작업이 완료될 때까지 기다린 다음, download_results에서 CSV를 전송하세요 (교체된 연락처당 $0.02, $649 요금제에서는 무료). 최소한 이메일을 validate_emails에 전달하고 유효한 이메일에만 발송하세요.
작동 방식
- 스크래핑 시작 →
runId받기 - 상태 확인 (또는 웹훅 사용) →
SUCCEEDED이 준비될 때까지 대기 - CSV 다운로드 → 전체 연락처 정보가 포함된 리드
Apollo 스크래핑은 보통 1530분이 걸립니다. 다른 모든 스크래퍼는 130분이 걸립니다. Store Leads는 즉시 처리됩니다.
인증
app.scrapercity.com/dashboard/api-docs에서 API 키를 받으세요.
# Environment variable (recommended)
export SCRAPERCITY_API_KEY="your_key"
# Or save to config file
npx scrapercity login
웹훅
Apollo 및 장시간 실행되는 스크래핑의 경우 app.scrapercity.com/dashboard/webhooks에서 웹훅을 설정해 결과가 준비되면 알림을 받으세요.
요금제
| 요금제 | 가격 | 크레딧 |
|---|---|---|
| Trial | 7일, 카드 필요, 이후 가입 시 선택한 요금제 시작 | 사용 크레딧 $5 |
| Starter | 월 $49 | $49 (데이터베이스는 레코드당 크레딧 차감) |
| Growth | 월 $149 | $149 + 10% 보너스, 데이터베이스 포함 |
| Scale | 월 $649 | $649 + 30% 보너스, 데이터베이스 포함, 더 높은 한도 |
추가 크레딧은 언제든 구매할 수 있습니다. scrapercity.com/pricing
링크
- 에이전트 문서 - 설정 가이드
- API 레퍼런스 - 전체 문서
- SDK 가이드 - JavaScript 및 Python SDK
- PyPI의 Python SDK -
pip install scrapercity - 스킬 파일 - Claude Code용
- MCP 서버 목록 - 설정
라이선스
MIT