Firecrawl Alexandria 是什么:一把 key 调用 430 家数据供应商

Firecrawl Alexandria 把 430 家供应商收进 Firecrawl API key 背后。本文拆解 People 分类 12 家供应商、search/find-tools/scrape 调用循环、credit 计价规则与免费额度,并给出 agent 回归测试方案。

用 Apifox,节省研发团队的每一分钟

Firecrawl Alexandria 是什么:一把 key 调用 430 家数据供应商

免费使用 Apifox

相关推荐

最新文章

API

一体化协作平台

API 设计

API 文档

API 调试

自动化测试

API Mock

API Hub

立即体验 Apifox
目录

Firecrawl Alexandria 是一个收录 430 家数据供应商、2,461 项能力的资源库,你的 AI agent 用它做搜索和抓取时已经在用的那把 Firecrawl API key 就能直接访问。其 People 分类有 12 家供应商,包括 Apollo、People Data Labs 和 FullEnrich。发现免费;执行供应商工具按其标注的 credit 计费。

本指南覆盖 People 分类里有什么、search / find-tools / scrape 这套循环怎么运作、调用成本几何,以及编码 agent 如何用 Apifox CLI 回归测试守住这些调用。

Firecrawl Alexandria 是什么?

Firecrawl Alexandria 是一个位于 Firecrawl API 背后的目录,收录官方数据供应商、自定义连接器和 Firecrawl 自有索引。agent 描述需求,在网页结果旁拿到排序后的工具,查看工具的入参和价格,再通过 scrape 端点执行。一把 key 同时覆盖实时网页和全部供应商。

Firecrawl Alexandria 的 People 数据试用界面,可输入自然语言问题或选择示例查询

Firecrawl 于 2026 年 9 月 22 日发布 Alexandria,与其 $75M B 轮融资同一公告——由 Smash Capital 领投,Altos Ventures、Nexus Venture Partners、Y Combinator、Freestyle 和 Offline Ventures 跟投。Firecrawl 表示部分供应商的费用已由其支付,包括 Wikimedia Enterprise。

Alexandria 页面截至 2026 年 11 月 3 日的数字:

指标 数值
供应商 430
能力 2,461
分类 20
已索引来源 113M+ 论文、README、issue 和文档
People 供应商 12

Alexandria 还包含三个 Firecrawl 自营索引:Developer Index 搜索文档、代码仓库、issue 和 agent skill;Research Index 查找科研论文并跟踪引用;Government & Legal Index 覆盖法律、法规和条例。如果你此前只用 Firecrawl“把网页转成 markdown”,那 Alexandria 能触达爬虫从页面上拿不到的数据。

People 分类里有什么

People 分类把销售级数据补全和公共记录收进一把 key,共 12 家供应商:

Firecrawl Alexandria People 分类 12 家供应商概览:商业补全(Apollo、FullEnrich、People Data Labs、Data Legion)、媒体(Particle)与公共记录(OpenSanctions、英国制裁名单、NPI Registry、US Senate eFD、U.S. House Clerk、新泽西 DCA 执照、西雅图市)

商业补全(4 家):

  • Apollo:按职位和公司找人,解析出经过验证的工作邮箱,按域名补全公司信息。10 项能力。
  • People Data Labs:个人与公司身份解析,支持按档案、邮箱、域名、股票代码或姓名做补全和搜索。
  • FullEnrich:人员与公司搜索、档案查询、公司画像和经验证的联系方式。
  • Data Legion:人员与公司补全。

媒体(1 家):

  • Particle:播客情报,包括节目里出现的人物。

公共记录(7 家):

  • OpenSanctions:制裁、PEP 和关注人物搜索。
  • UK Sanctions List (FCDO):31 个制度下约 6,400 个制裁对象。
  • NPI Registry:CMS 医疗从业者身份与执业地点。
  • US Senate financial disclosures (eFD):每次调用需确认法定使用限制。
  • U.S. House Clerk:唱名表决和现任议员名册。
  • New Jersey license verification (DCA):持证人搜索和执照记录。
  • City of Seattle:市议员名册和选区查询。

接入 agent 之前有两个细节要留意。People Data Labs 对每个客户组织有每年 50,000 次 API 调用的配额,person 和 company 端点共享、重试也计数、每年 UTC 1 月 1 日重置。Apollo 则自带 27 个现成 skill,例如“Search-first prospect list”——先免费搜索,只为值得联系的人付费揭示。

Firecrawl Alexandria 怎么运作:search、find-tools、scrape

按 Alexandria 文档,每次调用都走同样的三步:

  1. 发现。带 sources: ["alexandria"] 和一句自然语言查询调用 search,返回排序后的工具,各带供应商、能力和描述。
  2. 查看。调用 find-tools 读取工具的入参、响应契约和价格。
  3. 执行。调用 scrape,带一个 alexandria 对象指定供应商、能力和选项。不需要页面 URL。
Firecrawl Alexandria 调用流程:编码 agent 持 FIRECRAWL_API_KEY 先做免费发现搜索,再用免费的 find-tools 查看,最后通过付费 scrape 调用 Apollo、People Data Labs 等供应商

发现调用的原始 HTTP 版本:

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

同时想要网页结果就用 ["web", "alexandria"],但注意网页结果是收费的;纯工具发现免费。

执行环节,以 Apollo 的 people/search 能力为例:

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 把结果放在 alexandria[] 里,payload 在 data 下;原始 HTTP 会把整个结果再多包一层 data。使用前检查每条结果的 error。Node 里同样的调用是 firecrawl.scrape({ alexandria: {...} }),Python 里是 firecrawl.scrape(alexandria={...})。

在终端里,Firecrawl CLI 完成同样的循环:

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

走 MCP 的话,同样的循环对应 firecrawl_search、firecrawl_find_tools 和 firecrawl_scrape。Firecrawl 文档里的 CLI 指南和 MCP 说明覆盖这两种配置。

第一次跑会碰到一道门槛:部分供应商返回 THIRD_PARTY_DATA_TERMS_REQUIRED 和一个 requiresAction.url,需要组织管理员先接受该供应商的条款,调用才会成功。

Firecrawl Alexandria 的 credit 计价

Alexandria 与 Firecrawl 其余功能共用同一个 credit 余额。文档规则如下:

  • 发现免费。带 sources: ["alexandria"] 的搜索和 find-tools 不扣 credit。
  • 执行按工具标注价格计费,显示在每个供应商页面的 Run 按钮旁。
  • Government 和 Research 索引免费,有方案设定的每日调用上限;Scale 和 Enterprise 不限。
  • 反馈返还 1 个 credit。须在团队最后一次 Alexandria 调用后 20 分钟内提交,否则报 FEEDBACK_WINDOW_EXPIRED。返还上限为每网站 10 credit、每团队每 UTC 日 100 credit。

2026 年 11 月 3 日,供应商页面显示两个价格:Apollo people/search 为 0 credit,People Data Labs person/enrich 每次 60 credit。Apollo 的付费步骤在揭示邮箱,所以遍历列表前先用 find-tools --include-costs 查清相关能力的价格。

一个 credit 折合多少美元?按 Firecrawl 定价页、月付计算:

方案 价格 Credit/月 每 credit 成本 一次 PDL 补全(60 credit)
Free $0,无需信用卡 1,000 $0 月度赠送额度够 16 次
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

付费方案可用 $5 步长加购 credit(Hobby 1,000、Standard 2,000)。通过 PDL 补全 500 位联系人是 30,000 credit,基本要上 Standard。

PDL 的 min_likelihood 输入(1 到 10,默认 2)会拒绝弱匹配;按供应商页面的说法,404“在这里免费,错误记录不免费”。调高它能省 credit 也省脏数据。

Alexandria 不是什么

先排除几个误解:

  • 不是爬虫。Alexandria 工具调用的是官方 API、登记库和连接器。爬取仍由 Firecrawl 的 scrape 端点负责;需要横向选型时可另行对比各家网页抓取 API。
  • 不是 CRM。它返回数据;存储、去重和同步联系人是你或你的 CRM 的事。
  • 不是独立基准。Firecrawl 报告称 845 个任务上、同模型同提示词、AI 盲评下,用 Alexandria 的 agent 答案质量比内置 web 工具高 21%。这是 Firecrawl 自测,当作需要在你自己工作负载上验证的说法即可。
  • 不是合规工具。英国制裁名单本身就写明:命中或未命中都不是合规结论。

让编码 agent 用 Apifox CLI 测试 Alexandria

工作流一旦依赖 apollo/people/search,你会想知道入参何时被改名、结果何时开始报错。你的 agent 可以用 Apifox CLI 的回归测试抓住这些;你只需要写一句提示词。

一次性配好 CLI 和它的 agent skill:

npm install -g apifox-cli@latest
apifox login --with-token <YOUR_APIFOX_TOKEN>
npx -y skills add https://apifox.com   # pick Claude Code, Codex or Cursor when prompted

然后给 agent 这样一句提示词:

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 Apifox 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 读取每个 payload 数据模型、校验 JSON,然后运行类似命令:

apifox import --project <projectId> --format openapi --file ./firecrawl-alexandria.json
apifox environment create Firecrawl --project <projectId> --base-url https://api.firecrawl.dev
apifox cli-schema get test-case-create
apifox cli-schema validate test-case-create --file ./apollo-search-case.json
apifox test-case create --project <projectId> --file ./apollo-search-case.json
apifox run --test-case <caseId> --project <projectId> -e <envId> \
  --env-var "FIRECRAWL_API_KEY=$FIRECRAWL_API_KEY" -r cli,junit

用例的选择让测试集很便宜:纯工具发现免费,Apollo 搜索 11 月 3 日标价 0 credit。把 PDL 补全这类 60 credit 的付费能力排除在定时运行之外,或改用已知测试输入每周跑一次。同一行 apifox run ... -r junit 可直接进流水线;Apifox CLI CI/CD 指南有 GitHub Actions 和 GitLab 示例,《Apifox CLI in Claude Code》覆盖 agent 配置。

总结

Firecrawl Alexandria 把一把 key 变成 430 家供应商的入口,Apollo、People Data Labs 等 12 个 People 数据源都藏在同样的三次调用背后。发现免费、执行明码标价,免费方案的 1,000 credit 足够验证适配度。先读供应商条款,把 min_likelihood 调高,再让 agent 用 Apifox CLI 守住这些调用。

FAQ

Firecrawl Alexandria 免费吗?发现免费:带 sources: ["alexandria"] 的搜索和 find-tools 不扣 credit,Government 和 Research 索引在每日限额内免费。供应商工具按标注 credit 从方案余额扣除;方案每月赠 1,000 免费 credit,无需绑卡。

需要单独的 Apollo 或 People Data Labs 账户吗?不需要。Firecrawl 表示所有 People 供应商都能用同一把 Firecrawl API key 调用。部分供应商要求组织管理员先接受条款,信号是 THIRD_PARTY_DATA_TERMS_REQUIRED 错误。

走 Alexandria 调一次 People Data Labs 多少钱?person/enrich 能力在 2026 年 11 月 3 日标价每次 60 credit——按月付价格,Hobby 约 $0.23,Standard 约 $0.06。PDL 对每个组织另有每年 50,000 次的调用配额。

Claude Code 或 Codex 能用 Alexandria 吗?可以。安装 Firecrawl CLI 或接入 Firecrawl MCP server,agent 就获得 search、find-tools 和 scrape。

21% 的答案质量提升是独立测试吗?不是。它是 Firecrawl 自测:845 个任务、同模型同提示词、AI 盲评。依赖它之前先自己对比一遍。