Tobias Hoffmann

Posted on Nov 3 Originally published at apidog.com

Firecrawl Alexandria Nedir? Apollo, People Data Labs ve 430 Sağlayıcı için Tek API Anahtarı

#ai #api #automation #tools

Firecrawl Alexandria, 430 veri sağlayıcısı ve 2.461 yetenekten oluşan bir kütüphanedir; yapay zekâ ajanınız bu kütüphaneye, arama ve kazıma için hâlihazırda kullandığı aynı Firecrawl API anahtarıyla erişir. Kişiler kategorisinde Apollo, People Data Labs ve FullEnrich dahil 12 sağlayıcı bulunur. Keşif ücretsizdir; bir sağlayıcı aracını çalıştırmak ise üzerinde listelenen kredilere mal olur.

Bugün Apidog'u deneyin

Bu kılavuz, Kişiler kategorisinde neler olduğunu, arama, araç bulma ve kazıma döngüsünün nasıl işlediğini, çağrıların ne kadara mal olduğunu ve kodlama ajanınızın bunları bir Apidog CLI regresyon paketiyle nasıl koruyabileceğini ele alır.

Firecrawl Alexandria nedir?

Firecrawl Alexandria, Firecrawl API'sinin arkasında yer alan resmi veri sağlayıcıları, özel bağlayıcılar ve Firecrawl'ın kendi dizinlerinden oluşan bir katalogdur. Bir ajan neye ihtiyacı olduğunu tanımlar, web sonuçlarının yanında sıralanmış araçları geri alır, bir aracın girdilerini ve fiyatını inceler, ardından onu kazıma (scrape) uç noktası üzerinden çalıştırır. Tek bir anahtar hem canlı web'i hem de her sağlayıcıyı kapsar.

Firecrawl bunu 22 Eylül 2026'da, Smash Capital liderliğinde Altos Ventures, Nexus Venture Partners, Y Combinator, Freestyle ve Offline Ventures'ın katıldığı 75 milyon dolarlık Seri B duyurusuyla aynı anda başlattı. Firecrawl, aralarında Wikimedia Enterprise'ın da bulunduğu bazı sağlayıcılara hâlihazırda ödeme yaptığını söylüyor.

3 Kasım 2026 itibarıyla Alexandria sayfasındaki sayılar şöyle:

Metrik	Değer
Sağlayıcılar	430
Yetenekler	2.461
Kategoriler	20
Dizinlenmiş kaynaklar	113M+ makale, README, issue ve doküman
Kişiler sağlayıcıları	12

Alexandria ayrıca Firecrawl tarafından işletilen üç dizin içerir. Developer Index; dokümantasyon, depo, issue ve ajan becerilerini arar. Research Index; bilimsel makaleleri bulur ve atıfları takip eder. Government & Legal Index ise yasaları, düzenlemeleri ve yönetmelikleri kapsar. Firecrawl'ı yalnızca sayfaları markdown'a dönüştürmek için kullandıysanız, Alexandria bir kazıyıcının sayfadan elde edemeyeceği verilere ulaşır.

Kişiler kategorisinde neler var

Kişiler kategorisi, satış düzeyinde zenginleştirmeyi ve kamu kayıtlarını tek bir anahtarın arkasına koyar. 12 sağlayıcı listeler:

Ticari zenginleştirme (4):

Apollo: unvan ve şirkete göre kişi bulma, bunları doğrulanmış iş e-postalarına çözümleme, bir alan adından şirketleri zenginleştirme. 10 yetenek.
People Data Labs: bir profil, e-posta, alan adı, borsa kodu veya isimden kişi ve şirket kimliği çözümleme, zenginleştirme ve arama.
FullEnrich: kişi ve şirket araması, profil aramaları, firma bilgileri ve doğrulanmış iletişim verileri.
Data Legion: kişi ve şirket zenginleştirme.

Medya (1):

Particle: programlarda yer alan kişiler dahil olmak üzere podcast istihbaratı.

Kamu kayıtları (7):

OpenSanctions: yaptırım, PEP ve ilgi kişisi araması.
UK Sanctions List (FCDO): 31 rejim genelinde yaklaşık 6.400 yaptırım listesi kaydı.
NPI Registry: CMS sağlık hizmeti sağlayıcısı kimlikleri ve muayenehane konumları.
US Senate financial disclosures (eFD): her çağrı, yasal kullanım kısıtlamalarının kabul edilmesini gerektirir.
U.S. House Clerk: oylama sonuçları ve güncel üye listesi.
New Jersey license verification (DCA): lisans sahibi araması ve lisans kayıtları.
City of Seattle: konsey üye listesi ve bölge sorgulaması.

Bunları bir ajana bağlamadan önce iki ayrıntı önemlidir. People Data Labs, müşteri kuruluş başına yıllık 50.000 API çağrısı kotası taşır; kişi ve şirket uç noktaları arasında paylaşılır, yeniden denemeleri sayar ve 1 Ocak UTC'de sıfırlanır. Apollo ise beraberinde 27 hazır beceriyle gelir; örneğin "Search-first prospect list", önce ücretsiz arama yapar ve yalnızca iletişime geçilmeye değer kişileri açığa çıkarmak için ödeme yapar.

Firecrawl Alexandria nasıl çalışır: arama, araç bulma, kazıma

Her Alexandria çağrısı, Alexandria dokümanlarına göre aynı üç adımı izler:

Keşfet. sources: ["alexandria"] ve sade bir dille yazılmış bir sorguyla search'ü çağırın. Her biri bir sağlayıcı, yetenek ve açıklamayla birlikte sıralanmış araçlar geri alırsınız.
İncele. Bir aracın girdilerini, yanıt sözleşmesini ve fiyatını okumak için find-tools'u çağırın.
Yürüt. Sağlayıcıyı, yeteneği ve seçenekleri adlandıran bir alexandria nesnesiyle scrape'i çağırın. Sayfa URL'si gerekmez.

İşte ham HTTP üzerinden keşif çağrısı:

curl -s https://api.firecrawl.dev/v2/search \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "find VP of Sales at a SaaS company", "sources": ["alexandria"], "limit": 5}'

Sayfaları da istediğinizde ["web", "alexandria"] kullanın, ancak web sonuçlarının ücretli olduğunu unutmayın; yalnızca araç keşfi ücretsizdir.

Ve işte Apollo'nun people/search yeteneğini kullanan yürütme:

curl -s 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"],
        "q_organization_domains_list": ["stripe.com"],
        "page": 1,
        "per_page": 25
      }
    }
  }'

SDK sonuçları alexandria[] içinde döndürür; yük data altındadır; ham HTTP ise tüm bu sonucu bir data alanı daha içine sarar. Kullanmadan önce her sonuçta hata olup olmadığını kontrol edin. Node'da aynı çağrı firecrawl.scrape({ alexandria: {...} }), Python'da ise firecrawl.scrape(alexandria={...}) şeklindedir.

Bir terminalden Firecrawl CLI aynı döngüyü yapar:

npm install -g firecrawl-cli
firecrawl login
firecrawl search "work email for a VP of Sales" --sources web,alexandria --domain-tools --limit 2
firecrawl find-tools --options '{"providers":["apollo"],"level":"tools","expand":["options","response"]}' --include-costs
firecrawl scrape apollo/people/search --options '{"person_titles":["VP of Sales"],"per_page":10}'

MCP üzerinden aynı döngü firecrawl_search, firecrawl_find_tools ve firecrawl_scrape'tir. Firecrawl CLI kılavuzumuz ve Firecrawl MCP anlatımımız her iki kurulumu da ele alır.

İlk çalıştırmalarda bir kapıya takılırsınız: bazı sağlayıcılar requiresAction.url içeren THIRD_PARTY_DATA_TERMS_REQUIRED döndürür ve çağrının çalışması için bir kuruluş yöneticisinin o sağlayıcının şartlarını kabul etmesi gerekir.

Firecrawl Alexandria'nın kredi cinsinden fiyatlandırması

Alexandria, Firecrawl'ın geri kalanıyla aynı kredi bakiyesini kullanır. Dokümanlardaki kurallar:

Keşif ücretsizdir. sources: ["alexandria"] ile arama ve find-tools hiçbir şeye mal olmaz.
Yürütme, aracın listelenen fiyatına mal olur. Bu, her sağlayıcı sayfasında Çalıştır düğmesinin yanında gösterilir.
Government ve Research dizinleri ücretsizdir; planınızın belirlediği günlük çağrı limitiyle. Scale ve Enterprise sınırsızdır.
Geri bildirim 1 kredi iade eder. Ekibinizin son Alexandria çağrısından sonraki 20 dakika içinde gönderin, aksi halde FEEDBACK_WINDOW_EXPIRED ile başarısız olur. İadeler web sitesi başına 10 kredi ve UTC günü başına ekip başına 100 kredi ile sınırlıdır.

3 Kasım 2026'da sağlayıcı sayfaları iki fiyat gösteriyordu: Apollo people/search 0 kredi, People Data Labs person/enrich ise çağrı başına 60 kredi. Apollo için ücretli adım e-postaları açığa çıkarmaktır; bu yüzden bir liste üzerinde döngü kurmadan önce bu yetenekleri find-tools --include-costs ile kontrol edin.

Bir kredi dolar cinsinden ne kadara mal olur? İşte Firecrawl fiyatlandırma sayfasından, aylık faturalandırmayla hesaplama:

Plan	Fiyat	Kredi/ay	Kredi başına maliyet	Bir PDL zenginleştirmesi (60 kredi)
Free	$0, kart yok	1.000	$0	Aylık hibe içinde 16 çağrı sığar
Hobby	$19	5.000	$0,0038	$0,228
Standard	$99	100.000	$0,00099	$0,0594
Growth	$399	500.000	$0,000798	$0,0479
Scale	$749	1.000.000	$0,000749	$0,0449

Ücretli planlar 5 dolarlık artışlarla kredi ekler (Hobby'de 1.000, Standard'da 2.000). PDL aracılığıyla 500 kişiyi zenginleştirmek 30.000 kredidir ve bu sizi Standard'a taşır.

PDL'nin min_likelihood girdisi (1 ile 10 arası, varsayılan 2) zayıf eşleşmeleri reddeder ve sağlayıcı sayfasına göre bir 404 "burada ücretsizdir, yanlış bir kayıt ise değildir". Kredi ve hatalı satırlardan tasarruf etmek için bunu yükseltin.

Alexandria ne değildir

Bazı şeyleri dışlamakta fayda var:

Bir kazıyıcı değildir. Alexandria araçları resmi API'leri, kayıt sistemlerini ve bağlayıcıları çağırır. Kazıma hâlâ Firecrawl'ın scrape uç noktasıdır; web kazıma API'leri derlememiz bunu diğer seçeneklerle karşılaştırır.
Bir CRM değildir. Veri döndürür; kişileri depolamak, tekilleştirmek ve senkronize etmek sizin ya da CRM'inizin işidir.
Bağımsız bir kıyaslama değildir. Firecrawl, Alexandria kullanan ajanların 845 görevde yerleşik web araçlarına kıyasla yanıt kalitesinde %21 daha yüksek puan aldığını bildiriyor; aynı model ve istemlerle, bir yapay zekâ tarafından kör değerlendirmeyle. Bu Firecrawl'ın kendi testidir, dolayısıyla kendi iş yükünüzde kontrol edilecek bir iddia olarak ele alın.
Bir uyumluluk aracı değildir. UK yaptırım listesi bile bir eşleşmenin veya yokluğun bir uyumluluk tespiti olmadığını söyler.

Kodlama ajanınızın Alexandria'yı Apidog CLI ile test etmesine izin verin

Bir iş akışı apollo/people/search'e bağımlı hale geldiğinde, bir girdinin adı değiştiğinde veya bir sonuç hata döndürmeye başladığında bunu bilmek istersiniz. Ajanınız bunu Apidog CLI'daki bir regresyon paketiyle yakalayabilir; siz tek bir istem yazarsınız.

CLI'yi 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, Codex or Cursor when prompted

Ardından ajanınıza şu istemi verin:

Write an OpenAPI 3 file for two Firecrawl calls: POST /v2/search with
sources ["alexandria"], and POST /v2/scrape with an alexandria object for
provider "apollo", capability "people/search", per_page 5. Both send
Authorization: Bearer {{FIRECRAWL_API_KEY}}. Import it into Apidog project
<projectId>, create a "Firecrawl" environment with base URL
https://api.firecrawl.dev, and create a test case per endpoint that asserts
status 200, at least one returned tool on search, and on scrape that
data.alexandria[0].data exists with no error. Run both and summarize failures.

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

apidog import --project <projectId> --format openapi --file ./firecrawl-alexandria.json
apidog environment create Firecrawl --project <projectId> --base-url https://api.firecrawl.dev
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file ./apollo-search-case.json
apidog test-case create --project <projectId> --file ./apollo-search-case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> \
  --env-var "FIRECRAWL_API_KEY=$FIRECRAWL_API_KEY" -r cli,junit

Çağrıların seçimi paketi ucuz tutar: yalnızca araç keşfi ücretsizdir ve Apollo search 3 Kasım'da 0 kredi gösteriyordu. 60 kredilik PDL zenginleştirmesi gibi ücretli yetenekleri zamanlanmış çalıştırmadan uzak tutun ya da bilinen bir test girdisiyle haftalık olarak çalıştırın. Aynı apidog run ... -r junit satırı bir işlem hattına bırakılabilir; Apidog CLI CI/CD kılavuzunda GitHub Actions ve GitLab örnekleri vardır ve Claude Code'da Apidog CLI ajan kurulumunu ele alır. Apidog'un ücretsiz planı 4 kullanıcıya kadar kapsar.

Sonuç

Firecrawl Alexandria tek bir anahtarı 430 sağlayıcıya erişime dönüştürür; Apollo, People Data Labs ve on kişi kaynağı daha aynı üç çağrının arkasındadır. Keşif ücretsizdir, yürütmenin listelenmiş bir fiyatı vardır ve ücretsiz planın 1.000 kredisi uygunluğu test etmeye yeter. Önce sağlayıcı şartlarını kontrol edin, min_likelihood'ı yüksek tutun ve çağrıları ajanınızın Apidog CLI ile korumasına izin verin.

SSS

Firecrawl Alexandria ücretsiz mi? Keşif ücretsizdir. sources: ["alexandria"] ile arama ve find-tools hiçbir krediye mal olmaz ve Government ile Research dizinleri günlük bir limite kadar ücretsizdir. Sağlayıcı araçları, planınızdan düşülen listelenen kredilerine mal olur; planınız ayda 1.000 ücretsiz krediyle ve kartsız başlar.

Ayrı Apollo veya People Data Labs hesaplarına ihtiyacım var mı? Hayır. Firecrawl, her Kişiler sağlayıcısının aynı Firecrawl API anahtarıyla çağrılabileceğini söylüyor. Bazı sağlayıcılar yine de önce bir kuruluş yöneticisinin şartlarını kabul etmesini gerektirir; bu, bir THIRD_PARTY_DATA_TERMS_REQUIRED hatasıyla bildirilir.

Alexandria üzerinden bir People Data Labs araması ne kadara mal olur? person/enrich yeteneği 3 Kasım 2026'da çağrı başına 60 kredi gösteriyordu. Bu, aylık fiyatlarla Hobby'de yaklaşık 0,23 dolar ve Standard'da 0,06 dolardır. PDL'nin ayrıca kuruluş başına yıllık 50.000 çağrı kotası vardır.

Claude Code veya Codex Alexandria'yı kullanabilir mi? Evet. Firecrawl CLI'yi kurun veya Firecrawl MCP sunucusuna bağlanın; ajan arama, find-tools ve scrape yeteneklerine kavuşur.

%21'lik yanıt kalitesi kazancı bağımsız mı? Hayır. Bu Firecrawl'ın kendi testidir: 845 görev, aynı model ve istemler, kör yapay zekâ değerlendirmesi. Ona güvenmeden önce kendi karşılaştırmanızı yapın.

DEV Community