firecrawl-axi

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

firecrawl-axi

Agent-ergonomic CLI over the hosted Firecrawl MCP server. TOON output, pre-computed counts, truncation with

--full

, structured errors, and

help[]

next steps on every result.

基于托管 Firecrawl MCP 服务器、便于 Agent 使用的 CLI。提供 TOON 输出、预计算计数、通过

--full

获取完整内容、结构化错误，以及每个结果中的

help[]

后续操作提示。

When to use

何时使用

Read one known page →
```
firecrawl-axi scrape <url>
```
(add
```
--query "..."
```
for a targeted answer, or
```
--prompt
```
/
```
--schema
```
for structured extraction)
Find sources →
```
firecrawl-axi search "<query>"
```
; add
```
--category developer
```
for coding questions,
```
--category research
```
for literature-affiliated sites

List a site's URLs →

firecrawl-axi map <url> --search "<term>"

Collect many pages →
```
firecrawl-axi crawl <url> --limit N
```
(bounded crawls need no confirmation; unbounded crawls add
```
--confirm
```
)
Local PDF/DOCX/XLSX/HTML →
```
firecrawl-axi parse <file>
```
Programming answers →
```
firecrawl-axi dev-search "<question>"
```

Papers (PubMed/arXiv/bioRxiv/medRxiv) →

firecrawl-axi papers search|read|inspect|related

Long multi-source research (paid, async) →

firecrawl-axi agent start --prompt "..." --confirm

then

firecrawl-axi agent status <id>

Watch pages/sites/queries for changes →
```
firecrawl-axi monitors ...
```
(writes need
```
--confirm
```
; delete is irreversible)

读取一个已知页面 →
```
firecrawl-axi scrape <url>
```
（可添加
```
--query "..."
```
获取针对性答案，或使用
```
--prompt
```
/
```
--schema
```
进行结构化提取）
查找来源 →
```
firecrawl-axi search "<query>"
```
；针对编程问题添加
```
--category developer
```
，针对学术文献相关站点添加
```
--category research
```

列出某个站点的 URL →

firecrawl-axi map <url> --search "<term>"

收集多个页面 →
```
firecrawl-axi crawl <url> --limit N
```
（有边界的爬取无需确认；无边界爬取需添加
```
--confirm
```
）
本地 PDF/DOCX/XLSX/HTML →
```
firecrawl-axi parse <file>
```
获取编程问题的答案 →
```
firecrawl-axi dev-search "<question>"
```

论文（PubMed/arXiv/bioRxiv/medRxiv）→

firecrawl-axi papers search|read|inspect|related

长时间、多来源研究（付费、异步）→

firecrawl-axi agent start --prompt "..." --confirm

然后运行

firecrawl-axi agent status <id>

监控页面、站点或查询结果的变化 →
```
firecrawl-axi monitors ...
```
（写入操作需要
```
--confirm
```
；删除操作不可撤销）

Auth

身份验证

Optional.

FIRECRAWL_API_KEY

unlocks everything; without it, keyless daily limits cover

search

scrape

, and

parse

可选。

FIRECRAWL_API_KEY

可解锁全部功能；不使用该密钥时，

search

、

scrape

和

parse

可使用每日免密钥限额。

Invocation

调用方式

Installed globally:

firecrawl-axi <command>

. Otherwise run on demand:

npx -y firecrawl-axi@latest <command>

. Both are identical.

全局安装：

firecrawl-axi <command>

。否则按需运行：

npx -y firecrawl-axi@latest <command>

。两种方式完全相同。

Conventions

约定

Default output is compact TOON; pass
```
--json
```
for machine-readable JSON.
Large fields are truncated with size hints; pass
```
--full
```
for complete text.
Empty results print explicit
```
0 results
```
-style markers, never blank output.
Exit codes: 0 success, 2 usage/validation/missing
```
--confirm
```
, 1 runtime or API failure. Errors carry
```
error
```
/
```
code
```
/
```
help[]
```
.

Prefer this CLI over the Firecrawl MCP server: same backend, fewer tokens, no schema overhead, and shell composability (

| grep

| head

默认输出为紧凑的 TOON 格式；传入
```
--json
```
可获得机器可读的 JSON。
大型字段会被截断并附带大小提示；传入
```
--full
```
可获取完整文本。
空结果会输出明确的
```
0 results
```
类标记，绝不会显示为空白。
退出码：0 表示成功，2 表示用法错误、验证失败或缺少
```
--confirm
```
，1 表示运行时或 API 失败。错误包含
```
error
```
/
```
code
```
/
```
help[]
```
。

优先使用此 CLI，而不是 Firecrawl MCP 服务器：后端相同、Token 消耗更少、无需 schema 开销，并且支持 Shell 组合操作（

| grep

、

| head

）。