Cara Menemukan dan Memperkaya Lead dari Claude Code

API people Firecrawl Alexandria memungkinkan coding agent Anda menemukan dan memperkaya data orang melalui satu kunci Firecrawl. Anda menemukan tool secara gratis dengan v2/search, mendaftar kandidat dengan Apollo people/search pada 0 kredit, mengungkap satu orang dengan Apollo people/match pada 30 kredit, atau memperkaya email yang sudah diketahui dengan People Data Labs person/enrich pada 60 kredit. Setiap panggilan melewati POST /v2/scrape.

Setiap langkah di bawah ini hadir dua kali: sebuah prompt untuk Claude Code (atau Codex) dan curl mentah, sehingga Anda dapat membuat skripnya tanpa agent.

Apa itu API people Firecrawl Alexandria

Alexandria adalah pustaka penyedia data pihak ketiga milik Firecrawl, yang dapat diakses dengan kunci API yang sudah Anda gunakan untuk scraping. Menurut dokumentasi Alexandria, Anda menemukan sebuah tool, memeriksa input dan harganya, lalu menjalankannya dengan scrape. Discovery gratis; eksekusi memakan kredit yang tertera pada tool tersebut.

Kategori People berisi 12 penyedia. Dua di antaranya mencakup sebagian besar pekerjaan prospecting:

Harga adalah yang ditampilkan di samping tombol Run pada halaman Apollo dan halaman People Data Labs pada 4 November 2026. Halaman Apollo juga menyebutkan bahwa kegagalan people/match "tidak mengembalikan orang dan tidak ditagih."

Berapa biaya pencarian people dalam dolar

Nilai satu kredit bergantung pada paket Anda. Menurut halaman harga Firecrawl, Hobby adalah $19 per bulan untuk 5.000 kredit dan Standard adalah $99 per bulan untuk 100.000 kredit, keduanya ditagih bulanan.

Perhitungannya: $19 / 5.000 = $0.0038 per kredit, dan $99 / 100.000 = $0.00099. Mencari 100 pratinjau dan mengungkap 20 terbaik memakan 600 kredit, yang masih masuk dalam 1.000 kredit bulanan paket Free. People Data Labs juga membatasi Anda pada 50.000 panggilan API per tahun per organisasi, dibagi bersama untuk endpoint person dan company, termasuk retry.

Langkah 1: Hubungkan Claude Code ke Firecrawl

Rute tercepat adalah installer agent dari Firecrawl. Ia menambahkan skill Firecrawl ke setiap coding agent yang terdeteksi dan membuat Anda masuk melalui browser:

npx -y firecrawl-cli@latest init --all --browser

Mulai ulang agent Anda setelahnya. Secara manual, caranya adalah npm install -g firecrawl-cli dan firecrawl login. Panduan Firecrawl CLI kami membahas keduanya, dan panduan Firecrawl MCP membahas server MCP, yang mengekspos alur yang sama sebagai firecrawl_search, firecrawl_find_tools, dan firecrawl_scrape.

Untuk contoh curl di bawah ini, ekspor kunci Anda satu kali:

export FIRECRAWL_API_KEY="fc-..."   # never commit this

Langkah 2: Temukan tool people secara gratis

Tanyakan pada agent Anda dulu, karena discovery tidak memakan biaya:

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.

Di balik layar, itu adalah pencarian dengan sources diatur hanya ke ["alexandria"]. Menghilangkan "web" membuatnya gratis, karena hasil web ditagih:

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}'

Responsnya mencantumkan tools yang diperingkat, masing-masing dengan penyedia, kemampuan, dan deskripsi. Untuk membaca input dan harga, agent menjalankan find-tools:

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

Langkah 3: Cari kandidat di Apollo dengan 0 kredit

Halaman Apollo memberi tahu agent untuk selalu memulai dari sini: gratis dan menunjukkan siapa yang ada sebelum Anda membelanjakan apa pun.

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.

Panggilan mentahnya:

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
      }
    }
  }'

Setiap pratinjau membawa nama belakang yang tersamarkan dan id Apollo, input paling andal untuk langkah berikutnya.

Langkah 4: Ungkap satu orang dengan people/match

Sekarang bayar hanya untuk orang yang layak dihubungi, dengan 30 kredit per match:

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.

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>"}}}'

Biarkan dua flag reveal tetap nonaktif kecuali Anda membutuhkannya. Halaman Apollo menyebutkan bahwa email pribadi "ditagih ekstra" dan nomor telepon "jauh lebih mahal daripada match dasar."

Langkah 5: Perkaya email yang sudah diketahui dengan People Data Labs

Ketika Anda sudah memiliki email, misalnya dari pendaftaran masuk, person/enrich mengembalikan profil yang lebih lengkap: email kerja, jabatan, perusahaan, URL LinkedIn, pengalaman, dan keahlian.

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.

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}}}'

min_likelihood berkisar dari 1 hingga 10 dengan default 2. Halaman penyedia menjelaskan tradeoff-nya secara gamblang: 404 "gratis di sini dan rekaman yang salah tidak." Naikkan sebelum Anda melakukan looping atas sebuah daftar.

Menangani THIRD_PARTY_DATA_TERMS_REQUIRED

Panggilan berbayar pertama Anda ke sebuah penyedia mungkin gagal dengan THIRD_PARTY_DATA_TERMS_REQUIRED. Menurut dokumentasi, error tersebut membawa requiresAction.url, dan admin organisasi harus membukanya dan menyetujui ketentuan penyedia tersebut sebelum panggilan apa pun bisa berhasil.

Jangan biarkan agent mengkliknya begitu saja. Dokumentasi menyebutkan bahwa agent memerlukan otorisasi pengguna yang eksplisit sebelum menyetujui ketentuan, yang mengatur bagaimana Anda boleh menggunakan data pribadi. Tambahkan satu baris ke CLAUDE.md Anda: "Jika sebuah panggilan mengembalikan THIRD_PARTY_DATA_TERMS_REQUIRED, berhenti dan tunjukkan requiresAction.url kepada saya."

Membaca payload alexandria[].data

Hasil dikembalikan dalam array alexandria, satu entri per panggilan tool, dengan payload penyedia di bawah data. HTTP mentah membungkus seluruh hasil SDK dalam data tingkat atas, jadi dalam respons curl, match Apollo berada di data.alexandria[0].data.person:

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

Dua pemeriksaan menjaga baris buruk keluar dari CRM Anda:

1. Periksa setiap hasil untuk error sebelum Anda membaca data. Dokumentasi menyatakan ini secara eksplisit; satu panggilan bisa gagal meskipun permintaan HTTP berhasil.
2. Perlakukan email placeholder sebagai tidak ada. Apollo mencatat bahwa email yang tidak diungkap dapat dikembalikan sebagai literal email_not_unlocked@domain.com, bahkan ketika email_status menyatakan verified.

Untuk People Data Labs, person berada di bawah data di dalam hasil, bersebelahan dengan status dan likelihood pada envelope-nya.

Kirim feedback dan dapatkan kredit kembali

Alexandria membayar Anda untuk feedback. Setiap pengiriman mengembalikan 1 kredit untuk rating apa pun, dibatasi per hari UTC pada 10 kredit per website dan 100 per tim. Anda memiliki 20 menit sejak panggilan Alexandria terakhir tim Anda; setelah itu Anda akan mendapat FEEDBACK_WINDOW_EXPIRED.

Dari CLI, jalankan firecrawl alexandria feedback (lihat --help untuk opsinya). Melalui MCP, agent memanggil firecrawl_feedback dengan endpoint: "alexandria". Satu baris prompt berfungsi baik: "Jika sebuah hasil terlihat salah atau kosong, kirim feedback Alexandria yang mendeskripsikannya."

Biarkan Claude Code menjaga panggilan ini dengan Apidog CLI

Begitu sebuah skrip bergantung pada people/search yang mengembalikan id yang diterima people/match, field yang diganti namanya akan merusaknya secara diam-diam. Agent Anda dapat mengubah panggilan dari panduan ini menjadi skenario regresi di Apidog CLI dan menjalankannya sesuai jadwal. Anda cukup menulis satu prompt.

Setel CLI dan skill agent-nya satu kali:

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

Lalu berikan prompt ini ke Claude Code:

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.

Agent membaca setiap skema payload, memvalidasinya, lalu menjalankan perintah seperti ini:

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

Setiap menjalankan penuh memakan 30 kredit untuk match-nya, jadi jadwalkan harian alih-alih pada setiap commit. Referensi apidog run mencantumkan flag report dan iteration, dan Apidog CLI di Claude Code menunjukkan penyiapannya lebih mendalam. Paket Free Apidog mencakup hingga 4 pengguna.

FAQ

Apakah API people Firecrawl Alexandria gratis? Discovery gratis, dan Apollo people/search menunjukkan 0 kredit pada 4 November 2026. Mengungkap seseorang memakan kredit: 30 untuk Apollo people/match dan 60 untuk People Data Labs person/enrich. Paket Free mencakup 1.000 kredit per bulan tanpa kartu.

Apakah saya perlu akun Apollo atau People Data Labs terpisah? Tidak. Alexandria menjalankan keduanya melalui kunci API Firecrawl Anda dan menagih dalam kredit Firecrawl. Admin organisasi memang perlu menyetujui ketentuan setiap penyedia satu kali, yang itulah yang diminta THIRD_PARTY_DATA_TERMS_REQUIRED.

Mengapa respons people/match saya menampilkan email_not_unlocked@domain.com? Itu adalah placeholder Apollo untuk email yang tidak diungkap. Perlakukan sebagai tidak tersedia, bahkan jika email_status menyatakan verified.

Bisakah Codex atau Cursor menjalankan ini alih-alih Claude Code? Ya. npx -y firecrawl-cli@latest init --all menyiapkan setiap agent yang terdeteksi, dan tool MCP berfungsi di klien MCP apa pun. Panggilan curl berfungsi tanpa agent sama sekali.

Bagaimana cara menghindari membayar untuk match yang salah? Cari sebelum Anda melakukan match, match berdasarkan id Apollo bukan berdasarkan nama, dan setel min_likelihood ke 6 atau lebih tinggi pada People Data Labs. Apollo tidak menagih untuk yang tidak ditemukan, dan 404 PDL gratis.