Firecrawl Alexandria people API ช่วยให้ coding agent ของคุณค้นหาและเสริมข้อมูลบุคคลผ่านคีย์ Firecrawl เพียงคีย์เดียว คุณค้นพบเครื่องมือได้ฟรีด้วย v2/search แสดงรายชื่อผู้สมัครด้วย Apollo people/search ที่ 0 เครดิต เปิดเผยข้อมูลหนึ่งคนด้วย Apollo people/match ที่ 30 เครดิต หรือเสริมข้อมูลอีเมลที่รู้จักด้วย People Data Labs person/enrich ที่ 60 เครดิต ทุกการเรียกใช้จะผ่าน POST /v2/scrape
แต่ละขั้นตอนด้านล่างมีสองรูปแบบ: พรอมป์สำหรับ Claude Code (หรือ Codex) และ curl แบบดิบ เพื่อให้คุณเขียนสคริปต์ได้โดยไม่ต้องใช้เอเจนต์
Firecrawl Alexandria people API คืออะไร
Alexandria คือไลบรารีของผู้ให้บริการข้อมูลบุคคลที่สามของ Firecrawl ซึ่งเข้าถึงได้ด้วย API key ที่คุณใช้สำหรับ scraping อยู่แล้ว ตาม เอกสาร Alexandria คุณจะค้นพบเครื่องมือ ตรวจสอบอินพุตและราคา จากนั้นรันด้วย scrape การค้นพบฟรี ส่วนการเรียกใช้มีค่าใช้จ่ายเป็นเครดิตตามที่ระบุไว้บนเครื่องมือ
หมวดหมู่ People มีผู้ให้บริการ 12 ราย โดยสองรายครอบคลุมงาน prospecting ส่วนใหญ่:
| ผู้ให้บริการ | ความสามารถ | เครดิตต่อการเรียก | สิ่งที่คุณส่ง | สิ่งที่คุณได้รับ |
|---|---|---|---|---|
| Apollo | people/search |
0 | person_titles, q_keywords, q_organization_domains_list, per_page (สูงสุด 100) |
ตัวอย่างข้อมูล: ชื่อ, นามสกุลที่ถูกปิดบางส่วน, ตำแหน่ง, บริษัท, has_email, Apollo id |
| Apollo | people/match |
30 | id จากการค้นหา หรือ linkedin_url, email, หรือ name พร้อม domain |
บุคคลที่ระบุได้หนึ่งรายพร้อมตำแหน่ง ประวัติ และรายละเอียดการติดต่อ |
| People Data Labs | person/enrich |
60 | email, profile, pdl_id และอื่น ๆ; การส่งเฉพาะชื่อจะคืนค่า 400 |
ระเบียนบุคคลแบบเต็มพร้อม likelihood (1 ถึง 10) |
ราคาคือราคาที่แสดงข้างปุ่ม Run บนหน้า Apollo และหน้า People Data Labs เมื่อวันที่ 4 พฤศจิกายน 2026 หน้า Apollo ยังระบุด้วยว่า people/match ที่ไม่พบ “จะไม่คืนค่าบุคคลใด และไม่คิดค่าบริการ”
การค้นหาข้อมูลบุคคลมีค่าใช้จ่ายกี่ดอลลาร์
มูลค่าของหนึ่งเครดิตขึ้นอยู่กับแผนของคุณ ตามหน้าราคา Firecrawl Hobby อยู่ที่ $19 ต่อเดือนสำหรับ 5,000 เครดิต และ Standard อยู่ที่ $99 ต่อเดือนสำหรับ 100,000 เครดิต โดยคิดค่าบริการรายเดือนทั้งคู่
| การเรียก | เครดิต | Hobby ($0.0038/เครดิต) | Standard ($0.00099/เครดิต) |
|---|---|---|---|
| การค้นพบหรือ 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 |
การคำนวณ: $19 / 5,000 = $0.0038 ต่อเครดิต และ $99 / 100,000 = $0.00099 การค้นหา 100 ตัวอย่างและเปิดเผย 20 รายที่ดีที่สุดมีค่าใช้จ่าย 600 เครดิต ซึ่งอยู่ในโควตา 1,000 เครดิตต่อเดือนของแผน Free People Data Labs ยังจำกัดคุณที่ 50,000 การเรียก API ต่อปีต่อองค์กร โดยใช้ร่วมกันระหว่าง endpoint ของ person และ company รวมถึงการลองใหม่ด้วย

ขั้นตอนที่ 1: เชื่อมต่อ Claude Code กับ Firecrawl
วิธีที่เร็วที่สุดคือตัวติดตั้งเอเจนต์ของ Firecrawl โดยจะเพิ่มสกิล Firecrawl ให้กับ coding agent ทุกตัวที่ตรวจพบ และนำคุณเข้าสู่ระบบผ่านเบราว์เซอร์:
npx -y firecrawl-cli@latest init --all --browser
รีสตาร์ตเอเจนต์ของคุณหลังจากนั้น หากทำด้วยตนเอง จะใช้ npm install -g firecrawl-cli และ firecrawl login คู่มือ Firecrawl CLI ของเราครอบคลุมทั้งสองวิธี และบทแนะนำ Firecrawl MCP ครอบคลุม MCP server ซึ่งเปิดเผยลูปเดียวกันเป็น firecrawl_search, firecrawl_find_tools และ firecrawl_scrape
สำหรับตัวอย่าง curl ด้านล่าง ให้ export คีย์ของคุณหนึ่งครั้ง:
export FIRECRAWL_API_KEY="fc-..." # never commit this
ขั้นตอนที่ 2: ค้นพบเครื่องมือสำหรับ people ฟรี
ถามเอเจนต์ของคุณก่อน เพราะการค้นพบไม่มีค่าใช้จ่าย:
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.
เบื้องหลังแล้ว นั่นคือการค้นหาที่ตั้งค่า sources เป็น ["alexandria"] เท่านั้น การไม่ใส่ "web" จะทำให้ฟรี เพราะผลลัพธ์จากเว็บมีค่าใช้จ่าย:
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}'
คำตอบจะแสดง tools ที่จัดอันดับแล้ว แต่ละรายการมี provider, capability และคำอธิบาย หากต้องการอ่านอินพุตและราคา เอเจนต์จะรัน find-tools:
firecrawl find-tools --options '{"providers":["apollo","people-data-labs"],"level":"tools","expand":["options","response"]}' --include-costs
ขั้นตอนที่ 3: ค้นหาผู้สมัครใน Apollo ที่ 0 เครดิต
หน้า Apollo แนะนำให้เอเจนต์เริ่มที่นี่เสมอ: ฟรีและแสดงว่ามีใครอยู่บ้างก่อนที่คุณจะใช้จ่ายอะไร
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.
การเรียกแบบดิบ:
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
}
}
}'
ตัวอย่างแต่ละรายการมีนามสกุลที่ถูกปกปิดและ Apollo id ซึ่งเป็นอินพุตที่เชื่อถือได้มากที่สุดสำหรับขั้นตอนถัดไป
ขั้นตอนที่ 4: เปิดเผยข้อมูลหนึ่งคนด้วย people/match
ตอนนี้จ่ายเฉพาะคนที่คุ้มค่าที่จะติดต่อ ที่ 30 เครดิตต่อการ 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>"}}}'
ปล่อยแฟล็ก reveal ทั้งสองไว้ไม่เปิด เว้นแต่คุณจำเป็นต้องใช้ หน้า Apollo ระบุว่าอีเมลส่วนตัว “คิดค่าบริการเพิ่ม” และหมายเลขโทรศัพท์ “มีราคาแพงกว่าการ match พื้นฐานอย่างมาก”
ขั้นตอนที่ 5: เสริมข้อมูลอีเมลที่รู้จักด้วย People Data Labs
เมื่อคุณมีอีเมลอยู่แล้ว เช่นจากผู้สมัครที่เข้ามาเอง person/enrich จะคืนค่าโปรไฟล์ที่ครบถ้วนกว่า: อีเมลที่ทำงาน ตำแหน่ง บริษัท URL LinkedIn ประสบการณ์ และทักษะ
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 อยู่ในช่วง 1 ถึง 10 โดยค่าเริ่มต้นคือ 2 หน้าของผู้ให้บริการอธิบายข้อแลกเปลี่ยนไว้ตรง ๆ ว่า 404 “ฟรีที่นี่ แต่ระเบียนที่ผิดไม่ฟรี” ให้เพิ่มค่านี้ก่อนที่คุณจะวนลูปกับรายชื่อ
จัดการ THIRD_PARTY_DATA_TERMS_REQUIRED
การเรียกแบบมีค่าใช้จ่ายครั้งแรกของคุณไปยังผู้ให้บริการอาจล้มเหลวด้วย THIRD_PARTY_DATA_TERMS_REQUIRED ตามเอกสาร ข้อผิดพลาดนี้มี requiresAction.url และผู้ดูแลองค์กรต้องเปิด URL นั้นและยอมรับข้อกำหนดของผู้ให้บริการรายนั้นก่อนที่การเรียกใด ๆ จะผ่าน
อย่าให้เอเจนต์คลิกผ่านข้อกำหนดนั้น เอกสารระบุว่าเอเจนต์ต้องได้รับการอนุญาตจากผู้ใช้อย่างชัดเจนก่อนยอมรับข้อกำหนด ซึ่งควบคุมวิธีที่คุณใช้ข้อมูลส่วนบุคคลได้ เพิ่มหนึ่งบรรทัดใน CLAUDE.md ของคุณ: “ถ้าการเรียกคืนค่า THIRD_PARTY_DATA_TERMS_REQUIRED ให้หยุดและแสดง requiresAction.url ให้ฉัน”
อ่าน payload ของ alexandria[].data
ผลลัพธ์จะกลับมาในอาร์เรย์ alexandria หนึ่งรายการต่อการเรียกเครื่องมือหนึ่งครั้ง โดยมี payload ของผู้ให้บริการอยู่ภายใต้ data Raw HTTP จะห่อผลลัพธ์ SDK ทั้งหมดไว้ใน data ระดับบนสุด ดังนั้นในคำตอบจาก curl ผลลัพธ์ Apollo match จะอยู่ที่ data.alexandria[0].data.person:
curl -s https://api.firecrawl.dev/v2/scrape ... | jq '.data.alexandria[0].data.person | {name, title, email, linkedin_url}'
การตรวจสอบสองอย่างช่วยกันไม่ให้แถวข้อมูลแย่ ๆ เข้าไปใน CRM ของคุณ:
- ตรวจสอบข้อผิดพลาดในแต่ละผลลัพธ์ ก่อนที่คุณจะอ่าน
dataเอกสารระบุไว้ชัดเจนเช่นนี้ การเรียกครั้งเดียวอาจล้มเหลวในขณะที่คำขอ HTTP สำเร็จ - ถือว่าอีเมล placeholder เป็นข้อมูลที่หายไป Apollo ระบุว่าอีเมลที่ยังไม่ถูกเปิดเผยอาจกลับมาเป็นค่าแท้จริง
email_not_unlocked@domain.comแม้ว่าemail_statusจะบอกว่า verified
สำหรับ People Data Labs ข้อมูลบุคคลจะอยู่ภายใต้ data ภายในผลลัพธ์ ถัดจาก status และ likelihood ของ envelope
ส่ง feedback และรับเครดิตคืน
Alexandria จ่ายให้คุณสำหรับ feedback การส่งแต่ละครั้งจะคืนเครดิต 1 เครดิตสำหรับทุกคะแนน โดยจำกัดต่อวันตาม UTC ที่ 10 เครดิตต่อเว็บไซต์ และ 100 ต่อทีม คุณมีเวลา 20 นาทีนับจากการเรียก Alexandria ล่าสุดของทีม หลังจากนั้นคุณจะได้รับ FEEDBACK_WINDOW_EXPIRED
จาก CLI ให้รัน firecrawl alexandria feedback (ดู --help สำหรับตัวเลือก) ผ่าน MCP เอเจนต์จะเรียก firecrawl_feedback ด้วย endpoint: "alexandria" การเขียนพรอมป์หนึ่งบรรทัดได้ผลดี: “หากผลลัพธ์ดูผิดหรือว่างเปล่า ให้ส่ง feedback ถึง Alexandria โดยอธิบายสิ่งนั้น”
ให้ Claude Code เฝ้าระวังการเรียกเหล่านี้ด้วย Apidog CLI
เมื่อสคริปต์พึ่งพา people/search ที่คืนค่า id ซึ่ง people/match ยอมรับ การเปลี่ยนชื่อฟิลด์อาจทำให้พังแบบเงียบ ๆ เอเจนต์ของคุณสามารถเปลี่ยนการเรียกจากคู่มือนี้เป็น regression scenario ใน Apidog CLI และรันตามกำหนดการได้ คุณเขียนพรอมป์เพียงหนึ่งอัน
ตั้งค่า CLI และสกิลเอเจนต์ของมันหนึ่งครั้ง:
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
จากนั้นให้พรอมป์นี้กับ 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.
เอเจนต์จะอ่าน schema ของแต่ละ payload ตรวจสอบความถูกต้อง จากนั้นรันคำสั่งเช่นเหล่านี้:
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

การรันเต็มรูปแบบแต่ละครั้งมีค่าใช้จ่าย 30 เครดิตสำหรับการ match ดังนั้นควรตั้งเวลาให้รันวันละครั้งแทนที่จะรันทุก commit เอกสารอ้างอิง apidog run แสดงรายการแฟล็กสำหรับ report และ iteration และ Apidog CLI ใน Claude Code แสดงการตั้งค่าในรายละเอียดที่ลึกกว่า แผน Free ของ Apidog รองรับผู้ใช้สูงสุด 4 คน
คำถามที่พบบ่อย
Firecrawl Alexandria people API ฟรีหรือไม่? การค้นพบฟรี และ Apollo people/search แสดง 0 เครดิตเมื่อวันที่ 4 พฤศจิกายน 2026 การเปิดเผยข้อมูลบุคคลมีค่าใช้จ่ายเป็นเครดิต: 30 สำหรับ Apollo people/match และ 60 สำหรับ People Data Labs person/enrich แผน Free รวม 1,000 เครดิตต่อเดือนโดยไม่ต้องใช้บัตร
ฉันต้องมีบัญชี Apollo หรือ People Data Labs แยกต่างหากหรือไม่? ไม่ต้อง Alexandria รันทั้งสองผ่าน Firecrawl API key ของคุณและคิดค่าบริการเป็นเครดิต Firecrawl ผู้ดูแลองค์กรจำเป็นต้องยอมรับข้อกำหนดของผู้ให้บริการแต่ละรายหนึ่งครั้ง ซึ่งเป็นสิ่งที่ THIRD_PARTY_DATA_TERMS_REQUIRED เรียกร้อง
ทำไมคำตอบ people/match ของฉันจึงแสดง email_not_unlocked@domain.com? นั่นคือ placeholder ของ Apollo สำหรับอีเมลที่ยังไม่ถูกเปิดเผย ให้ถือว่าใช้ไม่ได้ แม้ว่า email_status จะบอกว่า verified
Codex หรือ Cursor รันสิ่งนี้แทน Claude Code ได้ไหม? ได้ npx -y firecrawl-cli@latest init --all ตั้งค่าเอเจนต์ทุกตัวที่ตรวจพบ และเครื่องมือ MCP ทำงานได้ใน MCP client ใดก็ได้ การเรียก curl ทำงานได้โดยไม่ต้องมีเอเจนต์เลย
ฉันจะหลีกเลี่ยงการจ่ายเงินสำหรับการ match ที่ผิดได้อย่างไร? ค้นหาก่อนที่จะ match, match ด้วย Apollo id แทนที่จะใช้ชื่อ และตั้งค่า min_likelihood เป็น 6 หรือสูงกว่าบน People Data Labs Apollo ไม่คิดค่าบริการเมื่อไม่พบ และ PDL 404 ฟรี
