firecrawl-alexandria

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

A direct path to structured data

通往结构化数据的直接路径

Alexandria brings ready-made website workflows, API providers, and specialized indexes into Firecrawl search and scrape. Semantic discovery finds capabilities by the data you need; domain matching connects web results to tools that may retrieve richer structured data beyond the page. Discover a tool that fits the task and get structured results directly, reducing the browsing, parsing, and repeated requests needed to assemble the data yourself.

Search to find web results and relevant tools, then inspect only the contracts needed for the task.
Scrape to execute a selected tool or read a URL. For large retained results, use its remote Bash guidance to select the data you need.

Use ordinary web results when they answer the question; use a provider tool when its coverage and inputs fit.

Alexandria 将现成的网站工作流、API 提供者和专门索引引入 Firecrawl 的搜索和抓取。语义发现根据您所需的数据查找能力；域名匹配将网页结果连接到可能检索到页面之外更丰富结构化数据的工具。发现适合任务的工具并直接获得结构化结果，减少了您自己组装数据所需的浏览、解析和重复请求。

搜索用于查找网页结果和相关工具，然后只检查任务所需的契约（contracts）。
抓取用于执行选定的工具或读取 URL。对于较大的留存结果，请使用其远程 Bash 指导来选择所需数据。

当普通网页结果能回答问题时，就使用它们；当提供者的覆盖范围和输入匹配时，就使用提供者工具。

Alexandria feedback

Alexandria 反馈

Alexandria coverage grows from what agents report. If you choose to report how the catalogue served a task, send at most one

firecrawl alexandria feedback

per website you needed data from after finishing the task. It is free: no job ID, no time window, no credit refund.

Feedback can describe any of these outcomes:

A tool answered the need, fully or partly.
A tool ran but returned wrong or incomplete data, or failed.
No provider covers the website, or a provider exists but lacks the capability you needed, and you fell back to web search, scrape, or Agent.

Opt out: if

FIRECRAWL_NO_ENDPOINT_FEEDBACK=1

(or

FIRECRAWL_DISABLE_ENDPOINT_FEEDBACK=1

) is set, the CLI silently skips the call and never sends anything. Respect that; do not try to work around it. (Team admins can also disable this server-side; the API returns

feedbackErrorCode: "TEAM_OPTED_OUT"

and the CLI exits 0 silently.)

Rules to know before you call this:

--url
is the website the user needed data from, not the provider and not a Firecrawl page.
```
--requested-functionality
```
is what they needed from it, in one sentence. These two fields are the most important: they aggregate across teams and tell us which sites and workflows to add next.
--rationale
explains the rating from observed results: which provider or capability served or failed the need, and how. Two or three sentences, no raw results pasted in.
--provider-feedback
is a JSON array of
```
{name, issue, why}
```
for providers that were missing, thin, or unavailable. Issues:
```
missing_provider
```
(no provider covers the site),
```
insufficient_coverage
```
(exists, but data was thin, stale, or partial for this market or segment),
```
provider_unavailable
```
(could not be called),
```
other
```
.
--capability-feedback
is a JSON array of
```
{name, provider, issue, why, requestedFunctionality?}
```
for capabilities that were missing, wrong, or failed. Issues:
```
new_capability_request
```
(ask the provider to add one;
```
requestedFunctionality
```
required),
```
missing_capability
```
(provider exists but lacks it),
```
insufficient_functionality
```
(exists but cannot take the input or filter you needed),
```
incorrect_result
```
,
```
execution_error
```
,
```
other
```
. Use
```
name
```
and
```
provider
```
exactly as discovery returned them; for a capability that does not exist yet, name what it should be.
Rate honestly:
```
good
```
when a tool answered the need,
```
partial
```
when it answered some of it or with gaps,
```
bad
```
when nothing available answered it or what ran was wrong or failed.
--silent &
is the right pattern: exit code 0 even on failure, so a rejected call never crashes your pipeline.

bash

undefined

Alexandria 的覆盖范围来自代理（agent）的报告。如果您选择报告目录如何服务任务，请在完成任务后，对每个您需要数据的网站发送至多一次

firecrawl alexandria feedback

。这是免费的：没有作业 ID，没有时间窗口，没有信用退款。

反馈可以描述以下任一结果：

某个工具完全或部分满足了需求。
某个工具运行了但返回了错误或不完整的数据，或者失败。
没有提供者覆盖该网站，或者提供者存在但缺乏您所需的能力，并且您回退到网页搜索、抓取或代理。

选择退出： 如果设置了

FIRECRAWL_NO_ENDPOINT_FEEDBACK=1

（或

FIRECRAWL_DISABLE_ENDPOINT_FEEDBACK=1

），CLI 会静默跳过调用并绝不发送任何内容。请尊重这一点；不要试图绕过它。（团队成员管理员也可以服务器端禁用；API 返回

feedbackErrorCode: "TEAM_OPTED_OUT"

并且 CLI 静默退出 0。）

在调用之前需要了解的规则：

--url
是用户需要数据的网站，不是提供者，也不是 Firecrawl 页面。
```
--requested-functionality
```
是用一句话说明他们需要从这个网站获得什么。这两个字段最重要：它们跨团队聚合，告诉我们接下来要添加哪些站点和工作流。
--rationale
解释评级的依据，来自观察到的结果：哪个提供者或能力满足或未满足需求，以及如何满足或未满足。两三句话，不要粘贴原始结果。
--provider-feedback
是对缺失、薄弱或不可用的提供者的
```
{name, issue, why}
```
JSON 数组。问题类型：
```
missing_provider
```
（没有提供者覆盖该网站）、
```
insufficient_coverage
```
（存在提供者，但该市场或细分的数据薄弱、过时或不完整）、
```
provider_unavailable
```
（无法调用）、
```
other
```
。
--capability-feedback
是对缺失、错误或失败的能力的
```
{name, provider, issue, why, requestedFunctionality?}
```
JSON 数组。问题类型：
```
new_capability_request
```
（请求提供者添加一项；
```
requestedFunctionality
```
必填）、
```
missing_capability
```
（提供者存在但缺少此能力）、
```
insufficient_functionality
```
（存在但无法接受您需要的输入或过滤）、
```
incorrect_result
```
、
```
execution_error
```
、
```
other
```
。
```
name
```
和
```
provider
```
必须与发现时返回的完全一致；对于尚不存在的能力，请命名它应该是什么。
诚实评级： 当工具满足了需求时评为
```
good
```
，当它部分满足或有缺口时评为
```
partial
```
，当没有可用工具满足或运行结果错误或失败时评为
```
bad
```
。
--silent &
是正确模式：即使失败也以退出码 0 结束，因此被拒绝的调用不会使您的管道崩溃。

bash

undefined

Example: send at most once per website after the task is done. 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"
--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 &


If you report a site with no provider coverage, use `--provider-feedback '[{"name":"<site or provider>","issue":"missing_provider","why":"<what was needed>"}]'` and rate `bad`; that is the signal we use to onboard new providers.

`--silent` suppresses output and `&` runs it in the background so feedback never blocks you. Run `firecrawl alexandria feedback --help` for every option.


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

`--silent` 抑制输出，`&` 使其在后台运行，因此反馈永远不会阻塞您。运行 `firecrawl alexandria feedback --help` 查看所有选项。