Firecrawl Alexandria là một thư viện gồm 430 nhà cung cấp dữ liệu và 2.461 khả năng mà AI agent của bạn truy cập được bằng chính API key Firecrawl mà nó đã dùng cho tìm kiếm và scraping. Danh mục People của nó chứa 12 nhà cung cấp, bao gồm Apollo, People Data Labs và FullEnrich. Việc khám phá là miễn phí; chạy một công cụ của nhà cung cấp sẽ tốn số credit được liệt kê trên đó.
Hướng dẫn này bao quát những gì có trong danh mục People, cách vòng lặp search, find-tools và scrape hoạt động, các lệnh gọi tốn bao nhiêu, và cách coding agent của bạn có thể bảo vệ chúng bằng một bộ kiểm thử hồi quy trên Apidog CLI.
Firecrawl Alexandria là gì?
Firecrawl Alexandria là một danh mục gồm các nhà cung cấp dữ liệu chính thức, connector tùy chỉnh và các chỉ mục của chính Firecrawl, nằm phía sau Firecrawl API. Một agent mô tả thứ nó cần, nhận lại danh sách công cụ đã được xếp hạng bên cạnh kết quả web, xem xét đầu vào và giá của một công cụ, rồi chạy nó thông qua endpoint scrape. Một key duy nhất bao quát cả web trực tiếp lẫn mọi nhà cung cấp.
Firecrawl ra mắt nó vào ngày 22 tháng 9 năm 2026, trong cùng thông báo về vòng gọi vốn Series B trị giá 75 triệu USD, do Smash Capital dẫn dắt cùng với Altos Ventures, Nexus Venture Partners, Y Combinator, Freestyle và Offline Ventures. Firecrawl cho biết họ đã trả tiền cho một số nhà cung cấp, trong đó có Wikimedia Enterprise.
Các con số trên trang Alexandria tính đến ngày 3 tháng 11 năm 2026:
| Chỉ số | Giá trị |
|---|---|
| Nhà cung cấp | 430 |
| Khả năng | 2.461 |
| Danh mục | 20 |
| Nguồn được lập chỉ mục | 113 triệu+ bài báo, README, issue và tài liệu |
| Nhà cung cấp People | 12 |
Alexandria cũng bao gồm ba chỉ mục do Firecrawl vận hành. Developer Index tìm kiếm tài liệu, repository, issue và agent skill. Research Index tìm các bài báo khoa học và lần theo các trích dẫn. Government & Legal Index bao quát luật, quy định và pháp lệnh. Nếu bạn từng chỉ dùng Firecrawl để biến các trang thành markdown, thì Alexandria với tới được dữ liệu mà một scraper không thể lấy từ một trang web.
Danh mục People chứa những gì
Danh mục People đưa dữ liệu làm giàu (enrichment) chuẩn cho sales và hồ sơ công khai về sau một key duy nhất. Nó liệt kê 12 nhà cung cấp:
Làm giàu dữ liệu thương mại (4):
- Apollo: tìm người theo chức danh và công ty, xác minh họ thành email công việc đã được xác thực, làm giàu thông tin công ty từ một tên miền. 10 khả năng.
- People Data Labs: phân giải danh tính người và công ty, làm giàu và tìm kiếm từ hồ sơ, email, tên miền, mã cổ phiếu hoặc tên.
- FullEnrich: tìm kiếm người và công ty, tra cứu hồ sơ, firmographics và dữ liệu liên hệ đã được xác thực.
- Data Legion: làm giàu dữ liệu người và công ty.
Truyền thông (1):
- Particle: thông tin chuyên sâu về podcast, bao gồm cả những người xuất hiện trong các chương trình.
Hồ sơ công khai (7):
- OpenSanctions: tìm kiếm lệnh trừng phạt, PEP và những người đáng quan tâm.
- UK Sanctions List (FCDO): khoảng 6.400 chỉ định trên 31 chế độ trừng phạt.
- NPI Registry: danh tính nhà cung cấp dịch vụ y tế CMS và địa điểm hành nghề.
- Công bố tài chính Thượng viện Hoa Kỳ (eFD): mỗi lệnh gọi yêu cầu xác nhận các hạn chế sử dụng theo luật định.
- U.S. House Clerk: các cuộc bỏ phiếu điểm danh và danh sách thành viên hiện tại.
- Xác minh giấy phép New Jersey (DCA): tìm kiếm người được cấp phép và hồ sơ giấy phép.
- City of Seattle: danh sách hội đồng và tra cứu khu vực bầu cử.
Có hai chi tiết cần lưu ý trước khi bạn đưa những thứ này vào một agent. People Data Labs có hạn mức 50.000 lệnh gọi API mỗi năm cho mỗi tổ chức khách hàng, dùng chung cho cả endpoint người và công ty, tính cả các lần thử lại, và được đặt lại vào ngày 1 tháng 1 theo giờ UTC. Và Apollo đi kèm 27 skill dựng sẵn, chẳng hạn "Search-first prospect list", vốn tìm kiếm miễn phí trước và chỉ trả tiền để tiết lộ những người đáng liên hệ.
Firecrawl Alexandria hoạt động thế nào: search, find-tools, scrape
Mọi lệnh gọi Alexandria đều tuân theo ba bước giống nhau, theo tài liệu Alexandria:
- Khám phá. Gọi search với
sources: ["alexandria"]và một truy vấn bằng ngôn ngữ tự nhiên. Bạn nhận lại các công cụ đã được xếp hạng, mỗi công cụ kèm nhà cung cấp, khả năng và mô tả. - Xem xét. Gọi find-tools để đọc đầu vào, hợp đồng phản hồi và giá của một công cụ.
- Thực thi. Gọi scrape với một đối tượng
alexandrianêu tên nhà cung cấp, khả năng và các tùy chọn. Không cần URL trang.
Đây là lệnh gọi khám phá qua HTTP thuần:
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}'
Dùng ["web", "alexandria"] khi bạn cũng muốn có các trang web, nhưng lưu ý rằng kết quả web là có tính phí; khám phá chỉ riêng công cụ là miễn phí.
Và đây là phần thực thi, dùng khả năng people/search của Apollo:
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 trả kết quả trong alexandria[], với payload nằm dưới data; HTTP thuần bọc toàn bộ kết quả đó trong thêm một trường data nữa. Hãy kiểm tra lỗi ở mọi kết quả trước khi dùng. Trong Node, lệnh gọi tương tự là firecrawl.scrape({ alexandria: {...} }), và trong Python là firecrawl.scrape(alexandria={...}).
Từ terminal, Firecrawl CLI thực hiện đúng vòng lặp đó:
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}'
Qua MCP, vòng lặp tương tự là firecrawl_search, firecrawl_find_tools và firecrawl_scrape. Hướng dẫn Firecrawl CLI và bài hướng dẫn Firecrawl MCP của chúng tôi bao quát cả hai cách thiết lập.
Có một rào cản chặn ngay lần chạy đầu tiên: một số nhà cung cấp trả về THIRD_PARTY_DATA_TERMS_REQUIRED kèm một requiresAction.url, và quản trị viên tổ chức phải chấp nhận điều khoản của nhà cung cấp đó trước khi lệnh gọi hoạt động.
Giá Firecrawl Alexandria tính bằng credit
Alexandria dùng chung số dư credit với phần còn lại của Firecrawl. Các quy tắc từ tài liệu:
- Khám phá là miễn phí. Search với
sources: ["alexandria"]và find-tools không tốn gì. - Thực thi tốn mức giá được niêm yết của công cụ. Nó được hiển thị trên mỗi trang nhà cung cấp, cạnh nút Run.
- Các chỉ mục Government và Research là miễn phí với giới hạn số lệnh gọi mỗi ngày theo gói của bạn; gói Scale và Enterprise là không giới hạn.
- Phản hồi (feedback) hoàn lại 1 credit. Hãy gửi trong vòng 20 phút kể từ lệnh gọi Alexandria cuối cùng của nhóm bạn, nếu không nó sẽ thất bại với
FEEDBACK_WINDOW_EXPIRED. Số hoàn tối đa là 10 credit mỗi website và 100 mỗi nhóm mỗi ngày theo UTC.
Vào ngày 3 tháng 11 năm 2026, các trang nhà cung cấp hiển thị hai mức giá: Apollo people/search hiển thị 0 credit, và People Data Labs person/enrich hiển thị 60 credit mỗi lệnh gọi. Với Apollo, bước tốn phí là tiết lộ email, nên hãy kiểm tra những khả năng đó bằng find-tools --include-costs trước khi bạn lặp qua một danh sách.
Một credit đáng giá bao nhiêu đô-la? Đây là phép tính từ trang giá Firecrawl, thanh toán theo tháng:
| Gói | Giá | Credit/tháng | Chi phí mỗi credit | Một lần PDL enrich (60 credit) |
|---|---|---|---|---|
| Free | $0, không cần thẻ | 1.000 | $0 | 16 lệnh gọi vừa với hạn mức hàng tháng |
| 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 |
Các gói trả phí thêm credit theo bước $5 (1.000 ở Hobby, 2.000 ở Standard). Làm giàu 500 liên hệ qua PDL là 30.000 credit, đưa bạn lên gói Standard.
Đầu vào min_likelihood của PDL (từ 1 đến 10, mặc định 2) từ chối các kết quả khớp yếu, và theo trang nhà cung cấp thì một lỗi 404 "là miễn phí ở đây còn một bản ghi sai thì không". Hãy nâng nó lên để tiết kiệm credit và tránh các dòng dữ liệu tồi.
Alexandria không phải là gì
Sẽ hữu ích khi loại trừ một số thứ:
- Không phải một scraper. Các công cụ Alexandria gọi API, sổ đăng ký và connector chính thức. Scraping vẫn là endpoint scrape của Firecrawl, mà bài tổng hợp các web scraping API của chúng tôi so sánh với các lựa chọn khác.
- Không phải một CRM. Nó trả về dữ liệu; việc lưu trữ, loại bỏ trùng lặp và đồng bộ liên hệ là việc của bạn hoặc của CRM bạn dùng.
- Không phải một phép đo độc lập. Firecrawl báo cáo rằng các agent dùng Alexandria đạt điểm cao hơn 21% về chất lượng câu trả lời so với các công cụ web tích hợp sẵn trên 845 tác vụ, cùng model và prompt, được một AI đánh giá mù. Đó là bài kiểm tra của chính Firecrawl, nên hãy coi nó như một tuyên bố cần tự kiểm chứng trên khối lượng công việc của bạn.
- Không phải một công cụ tuân thủ. Bản thân danh sách trừng phạt của Anh nói rằng một kết quả khớp hay việc không có kết quả khớp không phải là một phán quyết về tuân thủ.
Để coding agent của bạn kiểm thử Alexandria bằng Apidog CLI
Một khi một quy trình phụ thuộc vào apollo/people/search, bạn sẽ muốn biết khi nào một đầu vào bị đổi tên hoặc một kết quả bắt đầu trả về lỗi. Agent của bạn có thể bắt được điều đó bằng một bộ kiểm thử hồi quy trong Apidog CLI; bạn chỉ cần viết một prompt.
Thiết lập CLI và agent skill của nó một lần:
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
Sau đó đưa cho agent của bạn prompt này:
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.
Agent đọc schema payload của từng cái, xác thực JSON của nó, rồi chạy các lệnh như sau:
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
Việc chọn các lệnh gọi này giữ cho bộ kiểm thử rẻ: khám phá chỉ riêng công cụ là miễn phí, và Apollo search hiển thị 0 credit vào ngày 3 tháng 11. Hãy giữ các khả năng tốn phí như PDL enrich 60 credit ra khỏi lần chạy theo lịch, hoặc chạy chúng hàng tuần với một đầu vào kiểm thử đã biết. Dòng apidog run ... -r junit tương tự cũng thả vào được một pipeline; hướng dẫn Apidog CLI CI/CD có các ví dụ GitHub Actions và GitLab, còn Apidog CLI trong Claude Code bao quát việc thiết lập agent. Gói miễn phí của Apidog hỗ trợ tối đa 4 người dùng.
Tổng kết
Firecrawl Alexandria biến một key duy nhất thành quyền truy cập vào 430 nhà cung cấp, với Apollo, People Data Labs và mười nguồn People nữa nằm sau cùng ba lệnh gọi. Khám phá là miễn phí, thực thi có mức giá niêm yết, và 1.000 credit của gói miễn phí là đủ để thử xem có phù hợp không. Hãy kiểm tra điều khoản nhà cung cấp trước, giữ min_likelihood ở mức cao, và để agent của bạn bảo vệ các lệnh gọi bằng Apidog CLI.
Câu hỏi thường gặp
Firecrawl Alexandria có miễn phí không? Việc khám phá thì có. Search với sources: ["alexandria"] và find-tools không tốn credit, và các chỉ mục Government và Research miễn phí tới một giới hạn hàng ngày. Các công cụ của nhà cung cấp tốn số credit được niêm yết, trừ vào gói của bạn, vốn bắt đầu với 1.000 credit miễn phí mỗi tháng và không cần thẻ.
Tôi có cần tài khoản Apollo hay People Data Labs riêng không? Không. Firecrawl cho biết mọi nhà cung cấp People đều có thể gọi được qua cùng API key Firecrawl. Một số nhà cung cấp yêu cầu quản trị viên tổ chức chấp nhận điều khoản của họ trước, được báo hiệu bằng lỗi THIRD_PARTY_DATA_TERMS_REQUIRED.
Một lần tra cứu People Data Labs qua Alexandria tốn bao nhiêu? Khả năng person/enrich hiển thị 60 credit mỗi lệnh gọi vào ngày 3 tháng 11 năm 2026. Đó là khoảng $0.23 ở gói Hobby và $0.06 ở gói Standard theo giá hàng tháng. PDL cũng có hạn mức 50.000 lệnh gọi mỗi năm cho mỗi tổ chức.
Claude Code hay Codex có dùng được Alexandria không? Có. Hãy cài Firecrawl CLI hoặc kết nối máy chủ Firecrawl MCP, và agent sẽ có search, find-tools và scrape.
Mức tăng 21% về chất lượng câu trả lời có độc lập không? Không. Đó là bài kiểm tra của chính Firecrawl: 845 tác vụ, cùng model và prompt, do AI đánh giá mù. Hãy tự chạy so sánh của bạn trước khi dựa vào nó.