firecrawl-alexandria

直达结构化数据

Alexandria 将现成的网站工作流、API 提供方和专用索引整合到 Firecrawl 搜索和抓取中。语义发现可根据你需要的数据查找功能；域名匹配可将网页结果与可能获取更丰富结构化数据的工具关联起来。找到适合任务的工具，直接获取结构化结果，减少自行收集数据所需的浏览、解析和重复请求。

• 使用 Search 查找网页结果和相关工具，然后只查看任务所需的接口约定。
• 使用 Scrape 执行选定的工具或读取 URL。对于需要保留的大型结果，请使用其远程 Bash 指南来选择所需数据。

普通网页结果能够回答问题时就使用它们；当提供方工具的覆盖范围和输入符合需求时，再使用该工具。

Alexandria 反馈（退还 1 个积分）

Alexandria 根据 Agent 的反馈扩展覆盖范围。对于你需要从中获取数据的每个网站，请在针对该网站的最后一次 Alexandria 调用后，立即发送一条 firecrawl alexandria feedback。无需作业 ID。每条反馈退还 1 个积分，每个网站最多退还 10 个积分，每个团队每天（UTC）最多退还 100 个积分。

反馈可以描述以下任一情况：

• 某个工具满足了需求，全部或部分满足。
• 工具运行了，但返回的数据错误或不完整，或运行失败。
• 没有提供方覆盖该网站，或虽然有提供方，但不具备你需要的功能，因此你改用网页搜索、抓取或 Agent。

**选择退出：**如果设置了 FIRECRAWL_NO_ENDPOINT_FEEDBACK=1（或 FIRECRAWL_DISABLE_ENDPOINT_FEEDBACK=1），CLI 会静默跳过该调用，绝不会发送任何内容。请尊重这一设置；不要尝试绕过它。（团队管理员也可以在服务器端禁用此功能；API 会返回 feedbackErrorCode: "TEAM_OPTED_OUT"，CLI 则会静默地以 0 退出。）

调用前须知的规则：

• 时间窗口： 必须在团队最近一次 Alexandria 搜索、发现或执行后的 20 分钟内发送。每次 Alexandria 调用都会重新开始计时。超时后反馈会被拒绝（feedbackErrorCode: "FEEDBACK_WINDOW_EXPIRED"）。
• --url 是用户需要从中获取数据的网站，不是提供商，也不是 Firecrawl 页面。--requested-functionality 是他们需要通过该网站完成的事项，用一句话说明。这两个字段最重要：它们会汇总各团队的反馈，告诉我们接下来该添加哪些网站和工作流。
• --objective 是会话背后的目标：用一句话说明你或用户最终想要完成什么（例如，“筛选出本季度要参与投标的联邦 IT 合同”）。它比 --requested-functionality 更广，后者仅涉及这个网站。
• --rationale 根据观察到的结果说明评分理由：哪个提供商或功能满足或未能满足需求，以及原因。用两三句话说明，不要粘贴原始结果。
• --provider-feedback 是一个 JSON 数组，元素格式为 {name, issue, why}，用于反馈缺失、覆盖不足或不可用的提供商。问题类型：missing_provider（没有提供商覆盖该网站）、insufficient_coverage（有提供商，但针对该市场或细分领域的数据稀少、陈旧或不完整）、provider_unavailable（无法调用）、other。
• --capability-feedback 是一个 JSON 数组，元素格式为 {name, provider, issue, why, requestedFunctionality?}，用于反馈缺失、有误或失败的功能。问题类型：new_capability_request（要求提供商新增功能；必须填写 requestedFunctionality）、missing_capability（提供商存在，但缺少此功能）、insufficient_functionality（功能存在，但无法接受所需输入或无法按所需条件筛选）、incorrect_result、execution_error、other。name 和 provider 必须与发现结果完全一致；对于尚不存在的功能，请填写其应有的名称。
• 如实评分： 工具满足需求时评为 good，仅满足部分需求或存在缺漏时评为 partial，没有可用工具满足需求，或运行的工具结果有误或失败时评为 bad。所有评分获得相同额度的退款。
• 网站退款上限（每个网站，每个 UTC 日，默认 10 点数）。 超过上限后，仍会记录该网站的反馈，但不再退款，且响应中会设置 websiteCapReached: true。关于其他网站的反馈仍可退款。
• 每日退款上限（每个团队，每个 UTC 日，默认 100 点数）。 超过上限后，仍会记录反馈，但不再退款。响应中会包含 creditsRefundedToday、dailyRefundCap 和 dailyCapReached。当 dailyCapReached: true 时，当天剩余时间内请停止发送 Alexandria 反馈。
• 推荐使用 --silent &： 即使调用失败，退出代码也为 0，因此被拒绝的调用不会导致流水线崩溃。

# Example: send once per website, within 20 minutes of your last Alexandria call. Replace the
# placeholders with what actually happened; drop --provider-feedback or
# --capability-feedback when there is nothing to report at that level.
firecrawl alexandria feedback \
  --rating "<good|partial|bad>" \
  --url "https://sam.gov" \
  --requested-functionality "Active contracts by agency with their attachments" \
  --objective "Shortlist federal IT contracts to bid on this quarter" \
  --rationale "sam-gov/contracts returned the contract list, but no capability exposes attachment links, so those were scraped from the web instead." \
  --capability-feedback '[{"name":"attachments","provider":"sam-gov","issue":"new_capability_request","why":"Attachments were the point of the task","requestedFunctionality":"Given a contract ID, return attachment URLs and document text"}]' \
  --silent &

如果你反馈的网站没有任何提供商覆盖，请使用 --provider-feedback '[{"name":"<site or provider>","issue":"missing_provider","why":"<what was needed>"}]' 并评为 bad；这是我们用来引入新提供商的信号。

--silent 会抑制输出，& 会在后台运行，因此反馈不会阻塞你的操作。运行 firecrawl alexandria feedback --help 查看所有选项。