TL;DR: Untuk menyusun daftar prospek (lead list) dengan agen di Claude Code, bagi pekerjaan menjadi empat tugas di papan kerja (board tasks): pencarian orang gratis via Apollo melalui Firecrawl Alexandria, tahap kualifikasi berdasarkan kolom data yang sudah dihasilkan dari pencarian tersebut, pengayaan data (enrichment) berbayar via People Data Labs hanya untuk prospek yang lolos kualifikasi, serta peninjauan manual oleh manusia sebelum outreach dimulai. Satu API key Firecrawl mencakup semua penyedia data, dan setiap tugas melaporkan kredit yang digunakannya.
Anda bisa saja menyusun daftar prospek menggunakan agen dalam satu sesi Claude Code yang panjang. Anda meminta "VP of Engineering di sepuluh perusahaan ini beserta email kantornya", lalu agen akan mencari, memperkaya data, dan memberikan file CSV. Masalahnya baru terasa saat tagihan keluar: agen membayar biaya pengayaan data untuk orang-orang yang sebenarnya akan langsung Anda eliminasi hanya dari jabatan mereka.
Firecrawl Alexandria mempermudah penerapan alur kerja hemat-biaya sejak awal. Fitur ini menyatukan ratusan penyedia data di balik satu API key Firecrawl, dengan aturan bawaan bahwa pencarian tools (discovery) bersifat gratis, sementara eksekusinya memerlukan kredit sesuai ketentuan tiap tool. Artikel ini merinci alur (pipeline) tersebut menjadi beberapa tugas di Sharkly, menggunakan Claude Code atau Codex sebagai runtime, serta menampilkan rincian biaya kredit di setiap tahapnya.
Manfaat Firecrawl Alexandria bagi agen pembuat daftar prospek
Firecrawl Alexandria adalah pustaka penyedia data yang dapat dipanggil agen melalui satu API key Firecrawl. Halaman Alexandria mencantumkan 430 penyedia dan 2.461 kapabilitas. Agen dapat menemukan tool secara gratis, membaca parameter input dan biayanya, lalu menjalankannya melalui endpoint scrape yang sama seperti saat scraping halaman web.
Untuk urusan daftar prospek, kategori People adalah yang paling penting. Kategori ini mencakup 12 penyedia, termasuk Apollo, People Data Labs, FullEnrich, dan Data Legion untuk pengayaan data, ditambah sumber publik seperti daftar sanksi dan NPI Registry. Artikel ini menggunakan dua di antaranya:
| Penyedia | Kapabilitas | Harga tercantum | Peran dalam pipeline |
|---|---|---|---|
| Apollo | people/search |
0 kredit | Mencari orang berdasarkan jabatan di domain target Anda |
| People Data Labs | person/enrich |
60 kredit per panggilan | Melengkapi data profil hanya untuk kandidat yang memenuhi kualifikasi |
Halaman Apollo di Alexandria mencantumkan skill bawaan bernama "Search-first prospect list." Deskripsinya merangkum seluruh strategi dalam satu kalimat: cari secara gratis terlebih dahulu, buka data hanya untuk orang yang layak dibayar, lalu cari email kerja terverifikasi berdasarkan urutan biaya termurah. Papan kerja di bawah ini mengubah strategi tersebut menjadi empat tugas dengan penanggung jawab masing-masing.
Mengapa pembuatan daftar prospek butuh tahapan, bukan satu prompt saja
Menggunakan satu sesi langsung menyamarkan keputusan krusial yang menentukan biaya: siapa yang harus dieliminasi sebelum pemanggilan API berbayar dilakukan. Skema harga Firecrawl memperjelas perbedaan biaya ini.
Katakanlah Apollo menemukan 40 orang di sepuluh domain target Anda. Memperkaya data semuanya dengan tarif 60 kredit per panggilan akan menghabiskan 2.400 kredit—lebih dari dua kali lipat kuota paket Free yang sebesar 1.000 kredit per bulan. Namun, jika tahap kualifikasi berdasarkan jabatan menyaringnya menjadi 12 orang, biaya enrichment hanya 720 kredit dan tetap aman dalam kuota paket Free.
Aturan eliminasi tersebut adalah keputusan bisnis. Seseorang harus menentukan apakah posisi "Head of Platform" tergolong sebagai calon pembeli. Ketika aturan ini terkubur dalam sebuah prompt, tidak ada yang meninjaunya. Namun saat dijadikan tugas dengan Penerima Tugas (Assignee), ada penanggung jawab, status yang jelas, serta riwayat perubahan yang tercatat.
Cara menyusun daftar prospek dengan agen: empat tugas utama
Berikut alur pipeline yang disusun sebagai tugas di papan kerja. Hubungkan tugas-tugas ini dengan dependensi blocks / is blocked by agar setiap tahap menunggu penyelesaian tahap sebelumnya.
| Tugas | Penerima Tugas | Biaya Firecrawl | Selesai jika |
|---|---|---|---|
| 1. Konversi ICP ke filter Apollo + pencarian orang | Agen | 0 kredit | Daftar orang tersimpan, jumlah baris dilaporkan |
| 2. Kualifikasi berdasarkan data hasil pencarian | Agen | 0 kredit | Kandidat yang lolos dan alasan eliminasi dilaporkan |
| 3. Pengayaan data kandidat yang lolos di People Data Labs | Agen | 60 kredit per panggilan | Baris yang diperkaya ditampilkan, kredit terpakai dilaporkan |
| 4. Peninjauan sebelum outreach | Manusia | 0 kredit | Daftar disetujui, diedit, atau dikembalikan |
Langkah 1: Ubah ICP menjadi pencarian Apollo gratis
Tugas pertama mengubah profil pelanggan ideal (ICP) Anda menjadi parameter pencarian Apollo. Kapabilitas ini menerima person_titles, q_keywords, q_organization_domains_list, page, dan per_page, dengan batas maksimal 100 hasil per halaman. Playground Apollo menampilkan panggilan ini seharga 0 kredit.
Pencarian tool (discovery) juga gratis. Jika agen belum tahu tool mana yang harus digunakan, agen dapat meminta informasi ke Alexandria menggunakan sources: ["alexandria"]. Dokumentasi Firecrawl mencatat bahwa menambahkan "web" ke dalam sources juga akan mengembalikan hasil pencarian web berbayar, jadi batasi discovery hanya untuk tools.
# 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
}
}
}'
Hasilnya akan berada di bawah alexandria[0].data. Dokumentasi Firecrawl menyarankan untuk memeriksa error pada setiap hasil pemanggilan tool sebelum menggunakannya. Jadikan hal ini sebagai kriteria penerimaan (acceptance criteria): tugas belum dianggap selesai sebelum agen melaporkan jumlah baris yang didapat beserta error apa pun yang ditemui.
Langkah 2: Kualifikasi berdasarkan data yang sudah diperoleh dari pencarian
Tugas kualifikasi tidak memakan biaya apa pun. Tahap ini membaca output pencarian dan mengeliminasi baris berdasarkan data yang sudah ada: jabatan tidak sesuai, perusahaan salah, atau profil duplikat. Tidak ada panggilan API baru.
Letakkan aturan eliminasi di tempat yang bisa dibaca oleh setiap agen. Fitur Skill di Sharkly mengemas instruksi yang dapat digunakan kembali untuk pekerjaan Agen, sehingga aturan tersebut menjadi satu Skill yang terhubung ke setiap agen pembuat daftar prospek, seperti yang dijelaskan dalam Skills di Sharkly.
# 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]
Langkah 3: Perkayaan data khusus untuk kandidat yang lolos
Inilah tahap yang berbayar. Kapabilitas person/enrich dari People Data Labs tercantum seharga 60 kredit per panggilan. Kapabilitas ini memerlukan pdl_id, email, atau email_hash sebagai input wajib, ditambah 18 kolom opsional lainnya. Mintalah agen untuk membaca ketentuan input lengkap menggunakan findTools sebelum memetakan kolom hasil pencarian ke input pengayaan data.
Pengaturan paling hemat biaya adalah min_likelihood. Nilainya berkisar antara 1 hingga 10 dengan default 2, di mana menurut Firecrawl tingkat kecocokan data hanya 10 hingga 30% kemungkinan orang yang tepat. Menaikkan nilainya akan membuat kecocokan yang lemah menghasilkan error 404, dan halaman penyedia secara gamblang menjelaskan keuntungannya: “respons 404 di sini gratis, sedangkan data yang salah tetap berbayar.”
// 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 juga menetapkan kuota melalui Alexandria: 50.000 panggilan API per tahun untuk setiap organisasi pelanggan, yang dibagi bersama antara endpoint profil orang dan perusahaan. Percobaan ulang (retry) tetap dihitung, dan kuota direset setiap 1 Januari UTC. Inilah alasan lain untuk membatasi jumlah panggilan pengayaan data per eksekusi dalam file aturan.
Jika panggilan gagal dengan pesan THIRD_PARTY_DATA_TERMS_REQUIRED, respons akan menyertakan requiresAction.url. Admin organisasi harus menyetujui ketentuan penyedia di tautan tersebut, dan dokumentasi Firecrawl menegaskan bahwa agen memerlukan otorisasi eksplisit dari pengguna sebelum menyetujui ketentuan apa pun. Perlakukan ini sebagai penyerahan tugas (hand-off): agen membiarkan tugas dalam status menunggu tanggapan manusia.
Langkah 4: Peninjauan oleh manusia sebelum outreach
Tugas terakhir menjadi tanggung jawab manusia. Agen melampirkan daftar yang telah diperkaya dan membiarkan tugas dalam status waiting for human review. Peninjau akan memeriksa sampel data dengan mencocokkannya ke profil publik, menghapus siapa pun yang tidak seharusnya dihubungi, lalu memberikan persetujuan.
Ini adalah gerbang pengawasan yang sama seperti yang kami jelaskan dalam agen pengodean human-in-the-loop. Daftar tersebut barulah sekadar data; keputusan untuk menghubungi seseorang adalah langkah yang harus disetujui oleh manusia.
Rincian biaya kredit per tahap
Dengan 10 domain target, 40 orang ditemukan, dan 12 orang memenuhi kualifikasi, rincian biaya berdasarkan harga tercantum adalah sebagai berikut.
| Tahap | Panggilan | Kredit |
|---|---|---|
| Penemuan tool | 1 | 0 |
Apollo people/search |
1 | 0 |
| Kualifikasi | 0 | 0 |
People Data Labs person/enrich |
12 | 720 |
| Total | 14 | 720 |
Konversi kredit ke dolar bergantung pada paket langganan Anda, jadi hitung secara akurat alih-alih sekadar membulatkannya. Berdasarkan harga Firecrawl dengan tagihan bulanan, paket Hobby berharga $19 untuk 5.000 kredit ($0,0038 per kredit), sehingga 720 kredit setara sekitar $2,74 dari jatah kredit paket. Paket Standard berharga $99 untuk 100.000 kredit ($0,00099 per kredit), sehingga proses yang sama hanya memakan sekitar $0,71. Sementara pada paket Free, kuota 1.000 kredit per bulan dapat menutupinya dengan biaya $0.
Tanpa tahap kualifikasi, proses yang sama akan menghabiskan 2.400 kredit: sekitar $9,12 pada paket Hobby, dan melebihi batas kuota paket Free. Tahap kualifikasi adalah baris paling murah dalam rincian biaya ini, namun menghasilkan penghematan paling besar.
Cara Sharkly menjaga alur kerja tetap akuntabel dan terkendali
Claude Code atau Codex bertugas melakukan pemanggilan, sementara Sharkly mengelola seluruh alur kerja di sekitarnya.
- Tugas dengan Assignee (Penerima Tugas). Setiap tahap memiliki status dan penanggung jawab yang jelas, baik itu Agen, Crew, maupun manusia.
- API key tidak masuk ke dalam teks tugas. Tetapkan
FIRECRAWL_API_KEYdi bagian Environment Variables milik Agen, di bawah menu Computer & Runtime, dan nilai tersebut akan disuntikkan saat proses agen dimulai. Sharkly menandai nilai-nilai ini sebagai pengaturan teks biasa (plaintext) yang dapat dilihat oleh pengelola Agen, bukan brankas rahasia (secret storage), jadi gunakan key yang cakupannya dibatasi khusus untuk pekerjaan ini. - Status peninjauan (Review states). Agen dapat menetapkan tugas ke status menunggu tanggapan manusia (waiting for a human reply) atau menunggu peninjauan manusia (human review), yang akan langsung masuk ke Kotak Masuk (Inbox) orang yang bertanggung jawab.
- Catatan eksekusi (Run record). Setiap eksekusi menampilkan waktu mulai dan selesai, pemanggilan tool, serta rincian kegagalan, sehingga laporan penggunaan kredit memiliki jejak audit yang jelas.
Jika Anda tidak ingin membuat empat tugas secara manual, seorang Crew leader dapat memecah tugas utama menjadi beberapa tahapan, seperti yang diulas dalam Sharkly Crews. Sharkly gratis untuk mulai digunakan, dan penggunaan model AI berjalan menggunakan kuota paket Claude Code atau Codex yang terhubung ke Runtime Anda.
Jalankan secara terjadwal, pertahankan peninjauan manual
Setelah keempat tugas berjalan lancar tanpa kendala selama seminggu, masukkan tugas 1 hingga 3 ke dalam Otomatisasi (Automation) agar daftar domain baru dapat langsung memicu pencarian gratis dan pengayaan data yang telah dibatasi. Tugas 4 tetap dijalankan secara manual. Untuk memantau beberapa proses eksekusi ini sekaligus, lihat panduan cara memantau coding agent yang berjalan secara paralel.
Mulai dari tahap gratis
Susunlah daftar prospek dengan agen seperti yang dijelaskan dalam skill Apollo: cari secara gratis, lakukan kualifikasi dari data yang sudah ada, bayar hanya untuk kandidat yang lolos, dan libatkan manusia untuk memeriksa daftar sebelum outreach dilakukan. Mulailah dengan tugas 1 dan 2 di Sharkly. Keduanya membutuhkan 0 kredit dan memberi Anda gambaran berapa biaya yang akan dihabiskan pada tahap berbayar.
FAQ
Apa itu Firecrawl Alexandria?
Pustaka penyedia data yang dapat dipanggil agen melalui satu API key Firecrawl. Penemuan tool (discovery) bersifat gratis, dan setiap tool mencantumkan harga kreditnya masing-masing untuk eksekusi. Firecrawl meluncurkannya pada 22 September 2026.
Apakah pencarian orang Apollo gratis melalui Firecrawl?
Kapabilitas people/search milik Apollo berbiaya 0 kredit di playground Firecrawl. Pembukaan detail kontak merupakan langkah terpisah yang berbayar, jadi periksa harga yang tercantum untuk kapabilitas tersebut sebelum Anda menjalankannya.
Berapa biaya pengayaan data People Data Labs di Firecrawl?
person/enrich tercantum seharga 60 kredit per panggilan. Itu sekitar $0,23 pada paket Hobby dan $0,06 pada paket Standard, dengan tagihan bulanan. Respons 404 akibat dinaikkannya min_likelihood tidak dikenakan biaya apa pun.
Apakah cara ini bisa digunakan dengan Codex alih-alih Claude Code?
Ya. Firecrawl menyediakan CLI, SDK, dan MCP server dengan firecrawl_search, firecrawl_find_tools, serta firecrawl_scrape, dan Agen Sharkly dapat berjalan di kedua Runtime tersebut. Panduan penyiapan umumnya dapat dibaca di AI task manager: menugaskan, melacak, dan meninjau pekerjaan agen.
Bolehkah agen mengirim pesan outreach dari daftar tersebut secara mandiri?
Tidak disarankan. Pastikan pengiriman pesan tetap berada di balik tugas peninjauan oleh manusia. Tugas agen cukup berakhir sampai tahap daftar terverifikasi dan laporan penggunaan kredit.
