Claude Code'dan Potansiyel Müşteri Leadleri Nasıl Bulunur ve Zenginleştirilir?

Claude Code'dan Potansiyel Müşteri Leadleri Nasıl Bulunur ve Zenginleştirilir?

Claude Code'dan Potansiyel Müşteri Leadleri Nasıl Bulunur ve Zenginleştirilir?Tobias Hoffmann

Claude Code'dan Potansiyel Müşteri Leadleri Nasıl Bulunur ve Zenginleştirilir? Firecrawl...

Claude Code'dan Potansiyel Müşteri Leadleri Nasıl Bulunur ve Zenginleştirilir?

Firecrawl Alexandria people API, kodlama ajanınızın tek bir Firecrawl anahtarı üzerinden kişileri bulmasını ve zenginleştirmesini sağlar. Araçları v2/search ile ücretsiz keşfedersiniz, adayları Apollo people/search ile 0 kredi karşılığında listelersiniz, birini Apollo people/match ile 30 kredi karşılığında açığa çıkarırsınız veya bilinen bir e-postayı People Data Labs person/enrich ile 60 kredi karşılığında zenginleştirirsiniz. Her çağrı POST /v2/scrape üzerinden gider.

Bugün Apidog'u deneyin

Aşağıdaki her adım iki kez geliyor: Claude Code (veya Codex) için bir istem ve ham curl, böylece ajan olmadan da betikleyebilirsiniz.

Firecrawl Alexandria people API nedir

Alexandria, Firecrawl'ın üçüncü taraf veri sağlayıcıları kütüphanesidir ve kazıma için zaten kullandığınız API anahtarıyla erişilebilir. Alexandria belgelerine göre, bir aracı keşfeder, girdilerini ve fiyatını inceler, ardından scrape ile çalıştırırsınız. Keşif ücretsizdir; çalıştırma, araçta listelenen kredilere mal olur.

People kategorisinde 12 sağlayıcı bulunur. Bunlardan ikisi potansiyel müşteri çalışmalarının çoğunu kapsar:

Sağlayıcı Yetenek Çağrı başına kredi Ne gönderirsiniz Ne alırsınız
Apollo people/search 0 person_titles, q_keywords, q_organization_domains_list, per_page (maks 100) Önizlemeler: ad, maskelenmiş soyad, unvan, şirket, has_email, Apollo id
Apollo people/match 30 Aramadan gelen id veya linkedin_url, email, ya da name artı domain Unvanı, geçmişi ve iletişim bilgileriyle çözümlenmiş tek bir kişi
People Data Labs person/enrich 60 email, profile, pdl_id ve diğerleri; yalnızca ad 400 döndürür Tam bir kişi kaydı artı likelihood (1 ile 10 arası)

Fiyatlar, 4 Kasım 2026 tarihinde Apollo sayfasındaki ve People Data Labs sayfasındaki Çalıştır düğmesinin yanında gösterilen fiyatlardır. Apollo'nun sayfası ayrıca bir people/match isabetsizliğinin "kişi döndürmediğini ve faturalandırılmadığını" belirtir.

Bir kişi aramasının dolar cinsinden maliyeti nedir

Bir kredinin değeri planınıza bağlıdır. Firecrawl fiyatlandırma sayfasına göre Hobby, 5.000 kredi için ayda 19 $ ve Standard, 100.000 kredi için ayda 99 $ olup her ikisi de aylık faturalandırılır.

Çağrı Kredi Hobby (0,0038 $/kredi) Standard (0,00099 $/kredi)
Keşif araması veya find-tools 0 0 $ 0 $
Apollo people/search 0 0 $ 0 $
Apollo people/match 30 0,114 $ 0,0297 $
PDL person/enrich 60 0,228 $ 0,0594 $

Hesap şöyle: 19 $ / 5.000 = kredi başına 0,0038 $ ve 99 $ / 100.000 = 0,00099 $. 100 önizleme aramak ve en iyi 20'yi açığa çıkarmak 600 krediye mal olur; bu da Free planının aylık 1.000 kredisinin içine sığar. People Data Labs ayrıca kuruluş başına yılda 50.000 API çağrısıyla sınırlar; bu sınır person ve company uç noktaları arasında paylaşılır ve yeniden denemeler dahildir.

Flow of a people lookup on Firecrawl Alexandria: free discovery search, Apollo people/search at 0 credits, Apollo people/match at 30 credits, People Data Labs person/enrich at 60 credits, and feedback refunding 1 credit

Adım 1: Claude Code'u Firecrawl'a bağlayın

En hızlı yol Firecrawl'ın ajan yükleyicisidir. Algıladığı her kodlama ajanına Firecrawl becerilerini ekler ve sizi tarayıcı üzerinden oturum açtırır:

npx -y firecrawl-cli@latest init --all --browser
Enter fullscreen mode Exit fullscreen mode

Ardından ajanınızı yeniden başlatın. Elle yapmak için npm install -g firecrawl-cli ve firecrawl login komutlarını kullanın. Firecrawl CLI kılavuzumuz her ikisini de kapsar ve Firecrawl MCP anlatımı aynı döngüyü firecrawl_search, firecrawl_find_tools ve firecrawl_scrape olarak sunan MCP sunucusunu kapsar.

Aşağıdaki curl örnekleri için anahtarınızı bir kez dışa aktarın:

export FIRECRAWL_API_KEY="fc-..."   # never commit this
Enter fullscreen mode Exit fullscreen mode

Adım 2: Kişi araçlarını ücretsiz keşfedin

Keşif hiçbir şeye mal olmadığı için önce ajanınıza sorun:

Use Firecrawl Alexandria to find tools that search people by job title and
company, and tools that enrich a person from an email. Inspect Apollo and
People Data Labs with find-tools and show me each capability's inputs and
credit price before you run anything.
Enter fullscreen mode Exit fullscreen mode

Arka planda bu, sources yalnızca ["alexandria"] olarak ayarlanmış bir aramadır. "web" ifadesini dışarıda bırakmak aramayı ücretsiz tutar, çünkü web sonuçları faturalandırılır:

curl https://api.firecrawl.dev/v2/search \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "find people by job title and company", "sources": ["alexandria"], "limit": 5}'
Enter fullscreen mode Exit fullscreen mode

Yanıt, her biri bir sağlayıcı, yetenek ve açıklama içeren sıralanmış tools listeler. Girdileri ve fiyatları okumak için ajan find-tools çalıştırır:

firecrawl find-tools --options '{"providers":["apollo","people-data-labs"],"level":"tools","expand":["options","response"]}' --include-costs
Enter fullscreen mode Exit fullscreen mode

Adım 3: Adaylar için Apollo'da 0 krediyle arama yapın

Apollo'nun sayfası ajanlara her zaman buradan başlamalarını söyler: ücretsizdir ve hiçbir şey harcamadan önce kimin var olduğunu gösterir.

Run Apollo people/search through Firecrawl Alexandria for "VP of Sales" and
"Head of Revenue" at stripe.com and linear.app, 25 per page. Show name,
title, company and has_email. Don't reveal anyone yet.
Enter fullscreen mode Exit fullscreen mode

Ham çağrı:

curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "alexandria": {
      "provider": "apollo",
      "capability": "people/search",
      "options": {
        "person_titles": ["VP of Sales", "Head of Revenue"],
        "q_organization_domains_list": ["stripe.com", "linear.app"],
        "page": 1,
        "per_page": 25
      }
    }
  }'
Enter fullscreen mode Exit fullscreen mode

Her önizleme, maskelenmiş bir soyad ve bir Apollo id taşır; bu, sonraki adım için en güvenilir girdidir.

Adım 4: people/match ile bir kişiyi açığa çıkarın

Şimdi yalnızca iletişime değer kişiler için, eşleşme başına 30 kredi ödeyin:

For the 3 previews with has_email true, run Apollo people/match with their
id. Don't set reveal_personal_emails or reveal_phone_number.
Enter fullscreen mode Exit fullscreen mode 
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"alexandria": {"provider": "apollo", "capability": "people/match", "options": {"id": "<apollo_id>"}}}'
Enter fullscreen mode Exit fullscreen mode

İhtiyacınız yoksa iki açığa çıkarma bayrağını kapalı bırakın. Apollo sayfası, kişisel bir e-postanın "ekstra faturalandığını" ve bir telefon numarasının "temel eşleşmeden önemli ölçüde daha pahalı" olduğunu belirtir.

Adım 5: Bilinen bir e-postayı People Data Labs ile zenginleştirin

Elinde zaten bir e-posta olduğunda, örneğin gelen bir kayıttan, person/enrich daha dolgun bir profil döndürür: iş e-postası, unvan, şirket, LinkedIn URL'si, deneyim ve beceriler.

Enrich jane@example.com with People Data Labs person/enrich through
Firecrawl Alexandria. Set min_likelihood to 6 so a weak match comes back
as a 404 instead of a wrong record.
Enter fullscreen mode Exit fullscreen mode 
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"alexandria": {"provider": "people-data-labs", "capability": "person/enrich", "options": {"email": "jane@example.com", "min_likelihood": 6}}}'
Enter fullscreen mode Exit fullscreen mode

min_likelihood 1 ile 10 arasında çalışır ve varsayılan değeri 2'dir. Sağlayıcı sayfası ödünleşimi açıkça ortaya koyar: 404 "burada ücretsizdir, yanlış bir kayıt ise değildir." Bir liste üzerinde döngü kurmadan önce bunu yükseltin.

THIRD_PARTY_DATA_TERMS_REQUIRED ile başa çıkın

Bir sağlayıcıya yaptığınız ilk ücretli çağrı THIRD_PARTY_DATA_TERMS_REQUIRED hatasıyla başarısız olabilir. Belgeler, hatanın bir requiresAction.url taşıdığını ve herhangi bir çağrının geçebilmesi için bir kuruluş yöneticisinin bu adresi açıp o sağlayıcının koşullarını kabul etmesi gerektiğini belirtir.

Ajanın bunu tıklayıp geçmesine izin vermeyin. Belgeler, ajanların, kişisel verileri nasıl kullanabileceğinizi yöneten koşulları kabul etmeden önce açık kullanıcı yetkilendirmesine ihtiyaç duyduğunu söyler. CLAUDE.md dosyanıza bir satır ekleyin: "Bir çağrı THIRD_PARTY_DATA_TERMS_REQUIRED döndürürse dur ve bana requiresAction.url göster."

alexandria[].data yükünü okuyun

Sonuçlar, her araç çağrısı için bir girdi içeren bir alexandria dizisinde ve sağlayıcının yükü data altında gelecektir. Ham HTTP, tüm SDK sonucunu üst düzey bir data içine sarar; bu nedenle bir curl yanıtında Apollo eşleşmesi data.alexandria[0].data.person konumundadır:

curl -s https://api.firecrawl.dev/v2/scrape ... | jq '.data.alexandria[0].data.person | {name, title, email, linkedin_url}'
Enter fullscreen mode Exit fullscreen mode

İki kontrol, kötü satırları CRM'inizden uzak tutar:

  1. data okumadan önce her sonucu hatalara karşı kontrol edin. Belgeler bunu açıkça söyler; HTTP isteği başarılı olurken tek bir çağrı başarısız olabilir.
  2. Yer tutucu e-postaları eksik olarak değerlendirin. Apollo, açığa çıkarılmamış bir e-postanın, email_status doğrulandı dese bile gerçek anlamda email_not_unlocked@domain.com olarak dönebileceğini belirtir.

People Data Labs için kişi, sonucun içindeki data altında, zarfın status ve likelihood alanlarının yanında yer alır.

Geri bildirim gönderin ve bir kredi geri alın

Alexandria size geri bildirim için ödeme yapar. Her gönderim, herhangi bir derecelendirme için 1 kredi iade eder; UTC günü başına web sitesi başına 10 kredi ve ekip başına 100 kredi ile sınırlıdır. Ekibinizin en son Alexandria çağrısından itibaren 20 dakikanız vardır; sonrasında FEEDBACK_WINDOW_EXPIRED alırsınız.

CLI'dan firecrawl alexandria feedback komutunu çalıştırın (seçenekler için --help komutuna bakın). MCP üzerinden ajan, endpoint: "alexandria" ile firecrawl_feedback çağırır. Bir istem satırı iyi çalışır: "Bir sonuç yanlış veya boş görünüyorsa, onu açıklayan Alexandria geri bildirimi gönder."

Claude Code'un bu çağrıları Apidog CLI ile korumasını sağlayın

Bir betik, people/match tarafından kabul edilen bir id döndüren people/search işlevine bağımlı hale geldiğinde, yeniden adlandırılan bir alan onu sessizce bozar. Ajanınız bu kılavuzdaki çağrıları Apidog CLI içinde bir regresyon senaryosuna dönüştürebilir ve bunu bir programa göre çalıştırabilir. Tek bir istem yazarsınız.

CLI'ı ve ajan becerisini bir kez kurun:

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_APIDOG_TOKEN>
npx -y skills add https://apidog.com   # pick Claude Code or Codex when prompted
Enter fullscreen mode Exit fullscreen mode

Ardından Claude Code'a şu istemi verin:

Write an OpenAPI 3 file for three Firecrawl calls from this guide:
POST /v2/search with sources ["alexandria"], POST /v2/scrape for apollo
people/search (per_page 1), and POST /v2/scrape for apollo people/match.
All send Authorization: Bearer {{FIRECRAWL_API_KEY}}. Import it into Apidog
project <projectId> and create a "Firecrawl" environment for
https://api.firecrawl.dev. Build a test scenario that runs the three in
order, saves data.alexandria[0].data.people[0].id as personId and passes it
to people/match, and asserts status 200, no result error, and a person
object on the match. Run it and summarize failures.
Enter fullscreen mode Exit fullscreen mode

Ajan her yük şemasını okur, doğrular ve ardından şu gibi komutları çalıştırır:

apidog import --project <projectId> --format openapi --file ./firecrawl-people.json
apidog environment create Firecrawl --project <projectId> --base-url https://api.firecrawl.dev
apidog test-scenario create --project <projectId> --name "Alexandria people" --folder-id <folderId> --priority <priority>
apidog cli-schema get test-scenario-update
apidog cli-schema validate test-scenario-update --file ./people-scenario.json
apidog test-scenario update <scenarioId> --project <projectId> --file ./people-scenario.json
apidog run -t <scenarioId> --project <projectId> -e <envId> \
  --env-var "FIRECRAWL_API_KEY=$FIRECRAWL_API_KEY" -r cli,junit
Enter fullscreen mode Exit fullscreen mode

Diagram of an Apidog test scenario chaining Firecrawl v2/search, Apollo people/search and Apollo people/match, run by a coding agent with apidog run and producing a test report

Her tam çalıştırma eşleşme için 30 krediye mal olur; bu nedenle bunu her commit yerine günlük olarak planlayın. apidog run referansı rapor ve yineleme bayraklarını listeler ve Claude Code'da Apidog CLI kurulumu daha derinlemesine gösterir. Apidog'un Free planı 4 kullanıcıya kadar kapsar.

SSS

Firecrawl Alexandria people API ücretsiz mi? Keşif ücretsizdir ve Apollo people/search 4 Kasım 2026'da 0 kredi gösterdi. Bir kişiyi açığa çıkarmak krediye mal olur: Apollo people/match için 30 ve People Data Labs person/enrich için 60. Free planı, kart olmadan ayda 1.000 kredi içerir.

Ayrı Apollo veya People Data Labs hesaplarına ihtiyacım var mı? Hayır. Alexandria her ikisini de Firecrawl API anahtarınız üzerinden çalıştırır ve Firecrawl kredileriyle faturalandırır. Bir kuruluş yöneticisinin her sağlayıcının koşullarını bir kez kabul etmesi gerekir; THIRD_PARTY_DATA_TERMS_REQUIRED tam olarak bunu ister.

people/match yanıtım neden email_not_unlocked@domain.com gösteriyor? Bu, açığa çıkarılmamış bir e-posta için Apollo'nun yer tutucusudur. email_status doğrulandı dese bile bunu kullanılamaz olarak değerlendirin.

Bunu Claude Code yerine Codex veya Cursor çalıştırabilir mi? Evet. npx -y firecrawl-cli@latest init --all algılanan her ajanı kurar ve MCP araçları herhangi bir MCP istemcisinde çalışır. curl çağrıları hiç ajan olmadan da çalışır.

Yanlış eşleşmeler için ödeme yapmaktan nasıl kaçınırım? Eşleştirmeden önce arama yapın, ad yerine Apollo id ile eşleştirin ve People Data Labs'te min_likelihood değerini 6 veya daha yükseğe ayarlayın. Apollo bir isabetsizliği faturalandırmaz ve bir PDL 404 ücretsizdir.