Özet: Claude Code'daki yapay zekâ ajanlarıyla bir potansiyel müşteri listesi oluşturmak için işi dört pano görevine bölün: Firecrawl Alexandria üzerinden ücretsiz Apollo kişi araması, bu aramanın zaten getirdiği alanlar üzerinde bir ön eleme adımı, yalnızca kriterleri karşılayanlar için ücretli People Data Labs veri zenginleştirmesi ve herhangi bir iletişime geçmeden önce insan incelemesi. Tek bir Firecrawl anahtarı tüm sağlayıcıları kapsar ve her görev ne kadar harcadığını raporlar.
Ajanlarla potansiyel müşteri listesini tek bir uzun Claude Code oturumunda da oluşturabilirsiniz. “Bu on şirketteki Mühendislikten Sorumlu Başkan Yardımcılarını iş e-postalarıyla birlikte bul” dersiniz; ajan arar, verileri zenginleştirir ve size bir CSV teslim eder. Ancak asıl sorun faturada başlar: Ajan, sırf unvanına bakarak bile eleyeceğiniz kişilerin verilerini zenginleştirmek için ücret ödemiştir.
Firecrawl Alexandria, "önce ucuz olanı yap" yaklaşımını uygulamayı kolaylaştırıyor. Yüzlerce veri sağlayıcısını tek bir Firecrawl API anahtarının arkasında topluyor; kendi kuralı ise keşfin ücretsiz olması, çalıştırmanın ise her araçta belirtilen kredi miktarı kadar maliyet getirmesidir. Bu yazıda, Claude Code veya Codex'i çalışma zamanı olarak kullanarak bu hattı Sharkly üzerindeki görevler halinde nasıl yapılandıracağınızı ve her aşamanın kredi maliyetini ele alıyoruz.
Firecrawl Alexandria bir potansiyel müşteri bulma ajanına neler sağlar?
Firecrawl Alexandria, bir ajanın tek bir Firecrawl anahtarı üzerinden çağırabileceği bir veri sağlayıcı kütüphanesidir. Alexandria sayfasında 430 sağlayıcı ve 2.461 yetenek listelenmektedir. Ajan bir aracı ücretsiz olarak keşfeder, girdilerini ve fiyatını okur, ardından web sayfaları için kullandığı aynı scrape uç noktası üzerinden çalıştırır.
Potansiyel müşteri listeleri için asıl önemli olan People kategorisidir. Bu kategori; zenginleştirme için Apollo, People Data Labs, FullEnrich ve Data Legion'ın yanı sıra yaptırım listeleri ve NPI Registry gibi kamuya açık kaynaklar dahil olmak üzere 12 sağlayıcı içerir. Bu yazıda bunlardan ikisi kullanılmaktadır:
| Sağlayıcı | Yetenek | Liste fiyatı | İş akışındaki görevi |
|---|---|---|---|
| Apollo | people/search |
0 kredi | Hedef alan adlarınızdaki kişileri unvana göre bulma |
| People Data Labs | person/enrich |
Çağrı başına 60 kredi | Yalnızca kriterleri karşılayan kişilerin profil alanlarını doldurma |
Apollo’nun Alexandria üzerindeki kendi sayfasında, “Search-first prospect list” (Önce ara potansiyel müşteri listesi) adlı yerleşik bir yetenek yer alıyor. Açıklaması tüm stratejiyi tek bir satırda özetliyor: Önce ücretsiz arama yapın, yalnızca ödeme yapmaya değer kişileri açığa çıkarın, ardından maliyet sırasına göre doğrulanmış iş e-postalarını bulun. Aşağıdaki pano, bu stratejiyi sorumluları atanmış dört göreve dönüştürüyor.
Potansiyel müşteri listesi neden tek bir isteme değil de aşamalara ihtiyaç duyar?
Tek bir oturum, maliyeti belirleyen en kritik kararı gözden kaçırır: Ücretli çağrı yapılmadan önce kimlerin eleneceği. Firecrawl fiyatlandırması bu farkı somut biçimde ortaya koyuyor.
Diyelim ki Apollo, belirlediğiniz on alan adında toplam 40 kişi buldu. Bunların hepsini kişi başı 60 krediden zenginleştirmek 2.400 krediye mâl olur; bu da Ücretsiz planın aylık 1.000 kredisinin iki katından fazladır. Eğer unvanlar üzerinden yapılacak bir ön eleme ile bu sayı 12'ye indirilirse, zenginleştirme işlemi 720 krediye mâl olur ve Ücretsiz plan sınırları içinde kalır.
Bu eleme kuralı tamamen iş kararına bağlıdır. “Platform Lideri” unvanının bir alıcı sayılıp sayılmayacağına birinin karar vermesi gerekir. Bu kural bir istemin içine gömüldüğünde kimse incelemez. Ancak Atananı olan bir görev haline geldiğinde bir sorumlusu, bir durumu ve neyin değiştiğine dair bir kaydı olur.
Ajanlarla potansiyel müşteri listesi nasıl oluşturulur: Dört görev
İşte pano görevleri olarak iş akışı. Her aşamanın bir öncekini beklemesi için görevleri blocks / is blocked by ilişkisiyle birbirine bağlayın.
| Görev | Atanan | Firecrawl maliyeti | Tamamlanma kriteri |
|---|---|---|---|
| 1. ICP'den Apollo filtrelerine + kişi araması | Ajan | 0 kredi | Kişi listesi kaydedildi, satır sayısı paylaşıldı |
| 2. Dönen alanlar üzerinden ön eleme | Ajan | 0 kredi | Kalan kişiler ve eleme nedenleri paylaşıldı |
| 3. Kalan kişileri People Data Labs ile zenginleştirme | Ajan | Çağrı başına 60 kredi | Zenginleştirilmiş satırlar paylaşıldı, harcanan kredi raporlandı |
| 4. İletişime geçmeden önce inceleme | İnsan | 0 kredi | Liste onaylandı, düzenlendi veya geri gönderildi |
1. Adım: İdeal Müşteri Profilini (ICP) ücretsiz bir Apollo aramasına dönüştürün
İlk görev, ideal müşteri profilinizi Apollo’nun arama girdilerine dönüştürür. Bu yetenek; sayfa başına en fazla 100 sonuç olmak üzere person_titles, q_keywords, q_organization_domains_list, page ve per_page parametrelerini kabul eder. Apollo’nun test panelinde bu çağrı 0 kredi olarak görünmektedir.
Keşif aşaması da ücretsizdir. Ajan hangi aracı kullanacağını bilmiyorsa, sources: ["alexandria"] parametresiyle Alexandria’ya danışır. Firecrawl dokümantasyonu, kaynaklara "web" eklemenin ücretli web sonuçları da döndüreceğini belirtmektedir; bu nedenle keşfi yalnızca araçlarla sınırlı tutun.
# Free tool discovery: tools only, no paid web results
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 at a company", "sources": ["alexandria"], "limit": 3}'
# Apollo people search at the target domains (listed at 0 credits)
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 Engineering", "Head of Platform"],
"q_organization_domains_list": ["example-one.com", "example-two.com"],
"page": 1,
"per_page": 100
}
}
}'
Sonuç alexandria[0].data altında yer alır. Firecrawl dokümantasyonu, kullanmadan önce her araç sonucunda hata olup olmadığının kontrol edilmesini önerir; bu yüzden bunu kabul kriterlerinin bir parçası yapın: Ajan satır sayısını ve karşılaştığı herhangi bir hatayı bildirmeden görev tamamlanmış sayılmaz.
2. Adım: Arama sonucunda zaten dönen alanlar üzerinden ön eleme yapın
Ön eleme görevinin hiçbir maliyeti yoktur. Arama çıktısını okur ve hâlihazırda eldeki verilere dayanarak satırları eler: Yanlış unvan, yanlış şirket, mükerrer kişi. Yeni bir API çağrısı yapılmaz.
Eleme kurallarını her ajanın okuyabileceği bir yere koyun. Bir Sharkly Skill özelliği, Ajan çalışmaları için yeniden kullanılabilir talimatları paketler; böylece Skills in Sharkly yazısında açıklandığı gibi, bu kurallar her potansiyel müşteri ajanıyla ilişkilendirilmiş tek bir Yetenek haline gelir.
# lead-rules.md (owner: the person who approves the send)
keep_titles: ["VP of Engineering", "Head of Platform", "Director of Engineering"]
drop_if: [title_not_in_keep_titles, company_domain_not_in_list, duplicate_person]
max_enrich_calls_per_run: 15
pdl_min_likelihood: 6
every_task_reports: [rows_in, rows_out, credits_spent, errors]
3. Adım: Yalnızca kriterleri karşılayan kişileri zenginleştirin
Burası ücretli aşamadır. People Data Labs person/enrich yeteneği çağrı başına 60 kredi olarak listelenmiştir. Yeterli girdi olarak bir pdl_id, bir email veya bir email_hash ile birlikte 18 isteğe bağlı alanı daha kabul eder. Arama alanlarını zenginleştirme girdileriyle eşleştirmeden önce ajanın findTools ile girdi sözleşmesinin tamamını okumasını sağlayın.
Maliyeti düşüren en önemli ayar min_likelihood değeridir. Bu değer 1 ile 10 arasında değişir ve varsayılan olarak 2'dir; Firecrawl'a göre bu seviyede bir eşleşmenin doğru kişi olma olasılığı yalnızca %10 ila %30 arasındadır. Bu değeri yükseltmek zayıf bir eşleşmenin 404 dönmesini sağlar ve sağlayıcı sayfası bunun neden faydalı olduğunu açıkça belirtir: “Burada 404 hatası ücretsizdir, yanlış bir kayıt ise ücrete tabidir.”
// One enrich call per qualified person; client set up with $FIRECRAWL_API_KEY
const result = await firecrawl.scrape({
alexandria: {
provider: "people-data-labs",
capability: "person/enrich",
options: {
email: person.email, // or pdl_id / email_hash
min_likelihood: 6, // weak matches 404 instead of billing a wrong record
titlecase: true,
},
},
});
const record = result.alexandria[0];
if (record.error) report.errors.push(record.error);
People Data Labs ayrıca Alexandria üzerinden bir kotalandırmaya tabidir: Müşteri organizasyonu başına yılda 50.000 API çağrısı; bu kota kişi ve şirket uç noktaları arasında paylaşılır. Yeniden denemeler de hesaba katılır ve kota 1 Ocak UTC tarihinde sıfırlanır. Kurallar dosyasında çalışma başına zenginleştirme çağrılarına üst sınır koymak için bir neden daha.
Bir çağrı THIRD_PARTY_DATA_TERMS_REQUIRED hatasıyla başarısız olursa, yanıtta bir requiresAction.url bulunur. Bir organizasyon yöneticisinin sağlayıcının şartlarını buradan kabul etmesi gerekir ve Firecrawl dokümantasyonu, ajanların şartları kabul etmeden önce açık kullanıcı onayına ihtiyaç duyduğunu belirtir. Bunu bir devir teslim olarak değerlendirin: Ajan görevi bir insanın yanıt vermesini bekleyecek şekilde bırakır.
4. Adım: İletişime geçmeden önce bir insan inceler
Son görev bir insana aittir. Ajan zenginleştirilmiş listeyi ekler ve görevi waiting for human review durumunda bırakır. İnceleyen kişi, kamuya açık profillerle karşılaştırarak bir örneklemi kontrol eder, iletişime geçilmemesi gereken kişileri listeden çıkarır ve onaylar.
Bu, human-in-the-loop coding agents yazımızda anlattığımız kontrol noktasının aynısıdır. Liste yalnızca veridir; biriyle iletişime geçmek ise bir insanın altına imza atacağı bir karardır.
Aşama başına kredi faturası
10 hedef alan adı, bulunan 40 kişi ve ön elemeyi geçen 12 kişi ile liste fiyatlarına göre ortaya çıkan harcama tablosu şöyledir:
| Aşama | Çağrı Sayısı | Kredi |
|---|---|---|
| Araç keşfi | 1 | 0 |
Apollo people/search |
1 | 0 |
| Ön eleme | 0 | 0 |
People Data Labs person/enrich |
12 | 720 |
| Toplam | 14 | 720 |
Kredileri dolara dönüştürmek kullanılan plana bağlıdır, bu yüzden yuvarlamak yerine hesabı tam yapalım. Aylık faturalandırılan Firecrawl pricing sayfasına göre; Hobby planı 5.000 kredi için 19$'dır (kredi başına 0,0038$), dolayısıyla 720 kredi yaklaşık 2,74$'lık plan kredisine denk gelir. Standard planı 100.000 kredi için 99$'dır (kredi başına 0,00099$), dolayısıyla aynı işlem yaklaşık 0,71$'dır. Ücretsiz planın sunduğu aylık 1.000 kredi ise bu işlemi 0$ maliyetle karşılar.
Ön eleme görevi olmadan aynı işlem 2.400 krediye mâl olur: Hobby planında yaklaşık 9,12$ tutar ve Ücretsiz planın kotasını aşar. Ön eleme görevi, faturadaki en ucuz satırdır ve en çok tasarrufu sağlar.
Sharkly iş akışının şeffaf ve denetlenebilir kalmasını nasıl sağlar?
Çağrıları Claude Code veya Codex yapar; Sharkly ise sürecin yönetimini üstlenir.
- Atananı olan görevler. İster bir Ajan, ister bir Ekip (Crew), ister bir insan olsun; her aşamanın bir durumu ve bir sorumlusu vardır.
- Anahtar görev metninin dışında kalır.
FIRECRAWL_API_KEYdeğerini Computer & Runtime altındaki Agent Environment Variables alanına tanımladığınızda, bu değer ajan süreci başladığında sisteme aktarılır. Sharkly bu değerleri gizli anahtar deposu olarak değil, Ajan yöneticileri tarafından görülebilen düz metin ayarlar olarak etiketler; bu nedenle yalnızca bu işe özgü sınırlandırılmış bir anahtar kullanın. - İnceleme durumları. Bir Ajan, bir görevi bir insanın yanıt vermesini veya incelemesini bekleyecek şekilde bırakabilir ve bu durum ilgili kişinin Gelen Kutusu'na düşer.
- Çalıştırma kaydı. Her çalıştırma; başlangıç ve bitiş zamanlarını, araç çağrılarını ve hata ayrıntılarını gösterir, böylece kredi raporunun arkasında denetlenebilir bir iz bulunur.
Dört görevi elle oluşturmak istemiyorsanız, Sharkly Crews bölümünde anlatıldığı gibi, bir Ekip lideri ana görevi bu aşamalara bölebilir. Sharkly'ye başlamak ücretsizdir ve model kullanımı Runtime'ınıza bağlı Claude Code veya Codex planı üzerinden yürütülür.
Zamanlanmış olarak çalıştırın, incelemeyi manuel tutun
Bu dört görev bir hafta boyunca sorunsuz çalıştıktan sonra, yeni bir alan adı listesinin ücretsiz aramayı ve sınırlandırılmış zenginleştirmeyi tetiklemesi için 1 ila 3 arasındaki görevleri bir Otomasyona (Automation) bağlayın. 4. Görev manuel kalmaya devam eder. Bu türden birden fazla çalıştırmayı aynı anda izlemek için how to monitor coding agents running in parallel yazısına göz atın.
Ücretsiz aşamalarla başlayın
Ajanlarla potansiyel müşteri listesini, Apollo yeteneğinin tarif ettiği şekilde oluşturun: Ücretsiz arayın, elinizdekilerle ön eleme yapın, yalnızca kriterleri karşılayanlar için ödeme yapın ve kimseyle iletişime geçilmeden önce listeyi bir insanın kontrolüne bırakın. Sharkly üzerinde 1. ve 2. görevlerle başlayın. Bunların maliyeti 0 kredidir ve ücretli aşamanın ne kadar harcayacağını size önceden gösterir.
Sıkça Sorulan Sorular
What is Firecrawl Alexandria?
Ajanların tek bir Firecrawl API anahtarı üzerinden çağırabildiği bir veri sağlayıcı kütüphanesidir. Keşif ücretsizdir ve her araç çalıştırma için kendi kredi ücretini listeler. Firecrawl bunu 22 Eylül 2026'da kullanıma sunmuştur.
Is Apollo people search free through Firecrawl?
Apollo’nun people/search yeteneği Firecrawl test panelinde 0 kredi olarak görünmektedir. İletişim bilgilerini açığa çıkarmak ayrı ve ücretli bir adımdır, bu nedenle çalıştırmadan önce o yeteneğin liste fiyatını kontrol edin.
How much does People Data Labs enrichment cost on Firecrawl?
person/enrich çağrı başına 60 kredi olarak listelenmiştir. Bu tutar, aylık faturalandırmada Hobby planında yaklaşık 0,23$, Standard planında ise 0,06$'dır. Yükseltilmiş bir min_likelihood değerinden kaynaklanan 404 yanıtının hiçbir maliyeti yoktur.
Does this work with Codex instead of Claude Code?
Evet. Firecrawl; bir CLI, SDK'lar ve firecrawl_search, firecrawl_find_tools ile firecrawl_scrape içeren bir MCP sunucusu sunar ve bir Sharkly Ajanı her iki Runtime üzerinde de çalışabilir. Genel kurulum adımları AI task manager: assign, track, and review agent work yazısında yer almaktadır.
Should an agent send outreach from the list on its own?
Hayır. Gönderim adımını mutlaka bir insan incelemesi görevinin arkasında tutun. Ajanın görevi, doğrulanmış bir liste ve bir kredi raporu teslim edildiğinde sona erer.
