DEV Community

Cover image for Cara Menemukan dan Memperkaya Lead dari Claude Code
Walse
Walse

Posted on Originally published at apidog.com

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.

Coba Apidog hari ini

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:

Penyedia Kemampuan Kredit per panggilan Yang Anda kirim Yang Anda dapat
Apollo people/search 0 person_titles, q_keywords, q_organization_domains_list, per_page (maks 100) Pratinjau: nama depan, nama belakang tersamarkan, jabatan, perusahaan, has_email, id Apollo
Apollo people/match 30 id dari pencarian, atau linkedin_url, email, atau name plus domain Satu orang yang berhasil diidentifikasi lengkap dengan jabatan, riwayat, dan detail kontak
People Data Labs person/enrich 60 email, profile, pdl_id, dan lainnya; nama tanpa data lain akan menghasilkan 400 Rekaman lengkap seseorang plus likelihood (1 hingga 10)

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.

Panggilan Kredit Hobby ($0.0038/kredit) Standard ($0.00099/kredit)
Pencarian discovery atau 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

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.

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

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
Enter fullscreen mode Exit fullscreen mode

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
Enter fullscreen mode Exit fullscreen mode

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.
Enter fullscreen mode Exit fullscreen mode

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}'
Enter fullscreen mode Exit fullscreen mode

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
Enter fullscreen mode Exit fullscreen mode

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.
Enter fullscreen mode Exit fullscreen mode

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
      }
    }
  }'
Enter fullscreen mode Exit fullscreen mode

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.
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

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.
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 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}'
Enter fullscreen mode Exit fullscreen mode

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
Enter fullscreen mode Exit fullscreen mode

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.
Enter fullscreen mode Exit fullscreen mode

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

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.

Top comments (0)