ScraperCity

ScraperCity - AI Ajanları için B2B Potansiyel Müşteri Oluşturma

Potansiyel müşterileri bulun, e-postaları doğrulayın, cep telefonu numaralarını bulun ve işletme verilerini kazıyın — tümünü AI ajanınızdan, CLI’dan veya kodunuzdan yapın. Tek paket: MCP sunucusu, CLI ve JavaScript SDK. Python SDK: pip install scrapercity.

ScraperCity, AI ajanlarına 15’ten fazla B2B veri aracına erişim sağlar: Apollo kazıma, Google Maps veri çıkarma, e-posta bulma/doğrulama, cep telefonu numarası arama, kişi izleme, e-ticaret mağazası verileri, sabıka kayıtları ve daha fazlası.

Buradan Başlayın (API anahtarı gerekmez)

npx scrapercity start "dentists in Austin"

Ya da ajanınızdan start_here MCP aracını veya GET https://app.scrapercity.com/api/v1/start?query=... çağırmasını isteyin. Anahtar olmadan yönlendirmeli bir tanıtım alırsınız: ScraperCity’nin ne olduğu, nasıl kaydolacağınız, planlar ve güncel koşullarıyla deneme süresi ve canlı sayımlarla gerçek aramalar. Anahtarınız varsa hesabınıza göre plan yapar ve sıradaki tam çağrıyı döndürür.

Deneme süresi, açıkça: Deneme süresi bir demo veya ücretsiz katman değil, gerçek kullanımdır: 7 gün boyunca geçerli 5 $ kredi; tüm araçlarda ve veritabanlarında normal fiyatlarla kullanılabilir, böylece ilk günden gerçek kayıtları çekip verileri değerlendirebilirsiniz. Kayıt sırasında kart gerekir. 7 günün sonunda, kayıt sırasında seçtiğiniz plan başlar; bu tarihten önce faturalandırma bölümünden iptal ederseniz başka ücret alınmaz. Kredi daha önce tükenirse veritabanı çekimleri bekler (bunlar için ücret alınmaz); krediyi aşan bir kazıma işlemi planı erken başlatır. Planlama aramaları ve sayımları kontrol etmek ücretsizdir. start_here güncel koşulları döndürür.

Hızlı Başlangıç

Seçenek 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

Seçenek 2: MCP Sunucusu (Claude Code, Cursor, Windsurf vb.)

MCP yapılandırmanıza ekleyin (ör. ~/.claude/claude_desktop_config.json):

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

Ardından AI’nıza şunu söyleyin: "ScraperCity kullanarak Denver’da e-posta adresleriyle birlikte 1000 tesisatçı bul"

Seçenek 3: Skill Dosyası (Claude Code)

Skill dosyasını projenize kopyalayın:

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

Ya da şuradan indirin: https://scrapercity.com/agents/SKILL.md

Ardından Claude Code’da şunu söyleyin: "SCRAPERCITY_SKILL.md dosyasını oku ve California’daki SaaS şirketlerinde çalışan 2000 pazarlama direktörü bul, e-postalarını doğrula ve leads.csv dosyasına kaydet"

Seçenek 4: Doğrudan 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"

Seçenek 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()

Seçenek 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

Her iki SDK da MCP sunucusuyla aynı araç listesini içerir ve her sürümde canlı API belgelerinden yeniden oluşturulur. Kılavuz: scrapercity.com/sdk. Python paketi: pypi.org/project/scrapercity.

Fiyatlandırma (canlı katalogdan otomatik oluşturulur — düzenlemeyin)

Araç	Uç nokta	Fiyat
scrape_apollo	/api/v1/scrape/apollo	Potansiyel müşteri başına $0.0039
scrape_website_finder	/api/v1/scrape/website-finder	Bulunan kişi başına $0.0499
find_people	/api/v1/scrape/skip-trace	Sonuç başına $0.0199 (0 eşleşmeli aramalar 1 sonuç olarak ücretlendirilir)
scrape_distress_list	/api/v1/scrape/distress-list	Mülk başına $0.05
validate_emails	/api/v1/scrape/email-validator	E-posta başına $0.0017
scrape_maps	/api/v1/scrape/maps	İşletme başına $0.0099
scrape_airbnb	/api/v1/scrape/airbnb-email	Sonuç başına $0.019 (1.000 sonuç başına $19.00)
scrape_bizbuysell	/api/v1/scrape/bizbuysell-scraper	İlan başına $0.0099
scrape_crexi	/api/v1/scrape/crexi-scraper	Mülk başına $0.029
scrape_angi	/api/v1/scrape/angi-angies-list-scraper	İlan başına $0.0099
scrape_yelp	/api/v1/scrape/yelp-scraper	Sonuç başına $0.0099
scrape_zillow_agents	/api/v1/scrape/zillow-agents	Temsilci başına $0.029
scrape_property_lookup	/api/v1/scrape/property-lookup	Mülk başına $0.15 (+sahip iletişim bilgisi için $0.10)
search_criminal_records	/api/v1/scrape/criminal-records	Arama başına $1.00 (yalnızca kayıt bulunursa ücret alınır)
scrape_store_leads	/api/v1/scrape/store-leads	Potansiyel müşteri başına $0.0039
scrape_builtwith	/api/v1/scrape/techstack	Teknoloji başına $4.99
scrape_signals	/api/v1/scrape/signals	Reklam yayınlayan şirket başına $0.0094, kontrol edilen platform başına web sitesi başına $0.0009, işe alım yapan şirket başına $0.0043; arama başına minimum ücret
find_emails	/api/v1/scrape/email-finder	Bulunan e-posta başına $0.05 (bulunamazsa ÜCRETSİZ)
find_mobiles	/api/v1/scrape/mobile-finder	Bulunan numara başına $0.25 (bulunamazsa ÜCRETSİZ)

Kullanılabilir Araçlar

Araç	Ne işe yarar	Ücret
Apollo	İş unvanı, sektör ve konuma göre B2B kişileri	Potansiyel müşteri başına $0.0039
Google Maps	Telefon, e-posta ve yorum bilgileriyle yerel işletmeler	Yer başına $0.01
Email Validator	E-posta teslim edilebilirliğini, catch-all durumunu ve MX kayıtlarını doğrular	E-posta başına $0.0036
Email Finder	İsim ve şirket bilgisiyle iş e-postası bulur	Kişi başına $0.05
Mobile Finder	LinkedIn veya e-posta üzerinden telefon numaraları bulur	Girdi başına $0.25
People Finder	İsim, e-posta, telefon veya adresle kişi izleme	Sonuç başına $0.02
Store Leads	İletişim bilgileriyle Shopify/WooCommerce mağazaları	Potansiyel müşteri başına $0.0039
BuiltWith	Belirli bir teknolojiyi kullanan tüm siteler	Arama başına $4.99
Criminal Records	İsimle geçmiş kontrolü	Kayıt bulunursa $1.00
Lead Database	B2B kişiler, anında sorgulama	Aylık $149 ve üzeri planlara dahil; bu tutarın altındaki planlarda yeni potansiyel müşteri başına kredi kullanılır
Local Business Database	Telefon, e-posta ve puan bilgileriyle yerel işletmeler, anında sorgulama	Aylık $149 ve üzeri planlara dahil; bu tutarın altındaki planlarda yeni işletme başına kredi kullanılır

Göndermeden Önce

Herhangi bir veritabanından alınan potansiyel müşteriler: iletişime geçmeden önce kontrol edin. Her kayıtta email_check_status bulunur (kendi e-posta denetleyicimiz: valid, valid_catch_all, invalid, unknown, not_checked): YALNIZCA son 30 gün içinde kontrol edilmiş valid e-posta adreslerine gönderim yapın (email_checked_on); diğer tüm e-posta adreslerini önce validate_emails aracından geçirin. Kişiler için (Lead Database), replaceLeftContacts: true değerini query_lead_database aracına iletin (query_local_business_database ve query_ecommerce_database da her işletmenin veya mağazanın iletişim kişisi için bu değeri kabul eder); yanıt, her e-postayı kontrol eden ve ayrılmış kişilerin yerine o roldeki mevcut kişiyi koyan bir işlem olan replacement.run_id değerini ekler. check_run_status ile işlemin tamamlanmasını bekleyin, ardından download_results konumundaki CSV’yi gönderin (değiştirilen kişi başına $0.02; $649 planında ücretsiz). En azından e-postaları validate_emails aracından geçirin ve yalnızca geçerli olanlara gönderim yapın.

Nasıl Çalışır

1. Kazımayı başlatın → bir runId alın
2. Durumu sorgulayın (veya webhook kullanın) → SUCCEEDED için bekleyin
3. CSV’yi indirin → tüm iletişim bilgilerini içeren potansiyel müşteriler

Apollo kazımaları genellikle 15-30 dakika sürer. Diğer tüm kazıyıcılar: 1-30 dakika. Mağaza potansiyel müşterileri anında gelir.

Kimlik Doğrulama

API anahtarınızı app.scrapercity.com/dashboard/api-docs adresinden alın.

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

# Or save to config file
npx scrapercity login

Webhook’lar

Apollo ve uzun süren kazıma işlemleri için sonuçlar hazır olduğunda bildirim almak üzere app.scrapercity.com/dashboard/webhooks adresinden bir webhook yapılandırın.

Planlar

Plan	Fiyat	Krediler
Deneme	7 gün, kart gerekir; ardından kayıt sırasında seçilen plan başlar	5 $ kullanım kredisi
Starter	$49/ay	$49 (veritabanlarında kayıt başına kredi kullanılır)
Growth	$149/ay	$149 + %10 bonus, veritabanları dahil
Scale	$649/ay	$649 + %30 bonus, veritabanları dahil, daha yüksek limitler

İstediğiniz zaman ek kredi satın alın. scrapercity.com/pricing

Bağlantılar

• Ajan Belgeleri - kurulum kılavuzu
• API Referansı - tüm belgeler
• SDK kılavuzu - JavaScript ve Python SDK’ları
• PyPI’da Python SDK - pip install scrapercity
• Skill Dosyası - Claude Code için
• MCP Sunucusu Listesi - yapılandırma

Lisans

MIT