> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evocrawl.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 技能 + CLI

> Evocrawl 技能让 AI 代理（例如 Claude Code、Antigravity 和 OpenCode）可以更简单地通过 CLI 使用 Evocrawl。

直接在终端中搜索、抓取并与网页交互。EvoCrawl CLI 既可独立运行，也可作为一项技能，供 Claude Code、Antigravity 和 OpenCode 等 AI 编码代理自动发现并使用。

<div id="installation">
  ## 安装
</div>

如果你正在使用某个 AI 代理，例如 Claude Code，你可以安装下面的 Evocrawl 技能，代理将为你完成设置。

```bash theme={null}
npx -y evocrawl-cli@latest init --all --browser
```

* `--all` 会将 Evocrawl 技能安装到所有检测到的 AI 编码代理中
* `--browser` 会自动打开浏览器以完成 Evocrawl 身份验证

<Note>
  安装该技能后，请重启你的代理，以便其发现这个新技能。
</Note>

你也可以使用 npm 手动全局安装 EvoCrawl CLI：

```bash CLI theme={null} theme={null}
# 使用 npm 全局安装
npm install -g evocrawl-cli
```

<div id="authentication">
  ## 身份验证
</div>

在使用 CLI 之前，你需要先使用 EvoCrawl API 密钥完成身份验证。

<div id="login">
  ### 登录
</div>

```bash CLI theme={null} theme={null}
# 交互式登录(打开浏览器或提示输入 API 密钥)
evocrawl login

# 使用浏览器身份验证登录(推荐用于代理)
evocrawl login --browser

# 直接使用 API 密钥登录
evocrawl login --api-key fc-YOUR-API-KEY

# 或通过环境变量设置
export EVOCRAWL_API_KEY=fc-YOUR-API-KEY
```

<div id="view-configuration">
  ### 查看配置
</div>

```bash CLI theme={null} theme={null}
# 查看当前配置和身份验证状态
evocrawl view-config
```

<div id="logout">
  ### 退出登录
</div>

```bash CLI theme={null} theme={null}
# 清除已存储的凭据
evocrawl logout
```

<div id="self-hosted-local-development">
  ### 自托管 / 本地开发
</div>

对于自托管的 Evocrawl 实例或本地开发，使用 `--api-url` 参数：

```bash CLI theme={null} theme={null}
# 使用本地 Evocrawl 实例(无需 API 密钥)
evocrawl --api-url http://localhost:3002 scrape https://example.com

# Or set via environment variable
export EVOCRAWL_API_URL=http://localhost:3002
evocrawl scrape https://example.com

# Configure and persist the custom API URL
evocrawl config --api-url http://localhost:3002
```

当使用自定义 API URL（即不是 `https://api.evocrawl.com`）时，会自动跳过 API 密钥验证，因此你在本地实例中可以在无需 API 密钥的情况下使用 Evocrawl。

<div id="check-status">
  ### 检查状态
</div>

验证安装和身份验证，并查看速率限制：

```bash CLI theme={null}
evocrawl --status
```

就绪时的输出：

```
   evocrawl cli v1.1.1

  ● Authenticated via EVOCRAWL_API_KEY
  Concurrency: 0/100 jobs (parallel scrape limit)
  Credits: 500,000 remaining
```

* **并发数（Concurrency）**：最大并行任务数。并行操作应尽量接近该上限，但不要超过。
* **额度（Credits）**：剩余 API 额度。每次抓取/爬取都会消耗额度。

<div id="commands">
  ## 命令
</div>

<div id="scrape">
  ### Scrape
</div>

抓取单个 URL，并以多种 formats 输出其内容。

<Tip>
  使用 `--only-main-content` 即可获取不含导航栏、页脚和广告的干净输出。对于大多数只需要文章或主页面内容的用例，推荐使用该选项。
</Tip>

```bash CLI theme={null} theme={null}
# 抓取 URL(默认:markdown 输出)
evocrawl https://example.com

# 或使用显式的 scrape 命令
evocrawl scrape https://example.com

# 推荐:使用 --only-main-content 获取不含导航/页脚的干净输出
evocrawl https://example.com --only-main-content
```

<div id="output-formats">
  #### 输出 formats 类型
</div>

```bash CLI theme={null} theme={null}
# 获取 HTML 输出
evocrawl https://example.com --html

# 多种格式（返回 JSON）
evocrawl https://example.com --format markdown,links

# 从页面获取图片
evocrawl https://example.com --format images

# 获取页面内容摘要
evocrawl https://example.com --format summary

# 跟踪页面变化
evocrawl https://example.com --format changeTracking

# 可用格式：markdown, html, rawHtml, links, screenshot, json, images, summary, changeTracking, attributes, branding
```

<div id="scrape-options">
  #### 抓取选项
</div>

```bash CLI theme={null} theme={null}
# 仅提取主要内容(移除导航和页脚)
evocrawl https://example.com --only-main-content

# Wait for JavaScript rendering
evocrawl https://example.com --wait-for 3000

# Take a screenshot
evocrawl https://example.com --screenshot

# Include/exclude specific HTML tags
evocrawl https://example.com --include-tags article,main
evocrawl https://example.com --exclude-tags nav,footer

# Save output to file
evocrawl https://example.com -o output.md

# Pretty print JSON output
evocrawl https://example.com --format markdown,links --pretty

# Force JSON output even with single format
evocrawl https://example.com --json

# Show request timing information
evocrawl https://example.com --timing
```

**可用选项：**

| 选项                      | 简写   | 描述                                                                                                                                             |
| ----------------------- | ---- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `--url <url>`           | `-u` | 要抓取的 URL（位置参数的替代方式）                                                                                                                            |
| `--format <formats>`    | `-f` | 输出 formats（逗号分隔）：`markdown`, `html`, `rawHtml`, `links`, `screenshot`, `json`, `images`, `summary`, `changeTracking`, `attributes`, `branding` |
| `--html`                | `-H` | `--format html` 的快捷方式                                                                                                                          |
| `--only-main-content`   |      | 仅提取主要内容                                                                                                                                        |
| `--wait-for <ms>`       |      | 等待 JS 渲染的时间（毫秒）                                                                                                                                |
| `--screenshot`          |      | 生成页面截图                                                                                                                                         |
| `--include-tags <tags>` |      | 要包含的 HTML 标签（逗号分隔）                                                                                                                             |
| `--exclude-tags <tags>` |      | 要排除的 HTML 标签（逗号分隔）                                                                                                                             |
| `--output <path>`       | `-o` | 将输出保存到文件                                                                                                                                       |
| `--json`                |      | 即使只有单一 format 也强制输出 JSON                                                                                                                       |
| `--pretty`              |      | 对 JSON 输出进行格式化打印                                                                                                                               |
| `--timing`              |      | 显示请求耗时和其他有用信息                                                                                                                                  |

***

<div id="search">
  ### 搜索
</div>

搜索网页，并按需抓取结果。

```bash CLI theme={null} theme={null}
# 搜索网络
evocrawl search "web scraping tutorials"

# 限制结果数量
evocrawl search "AI news" --limit 10

# 美化打印结果
evocrawl search "machine learning" --pretty
```

<div id="search-options">
  #### 搜索选项
</div>

```bash CLI theme={null} theme={null}
# Search specific sources
evocrawl search "AI" --sources web,news,images

# Search with category filters
evocrawl search "react hooks" --categories github
evocrawl search "machine learning" --categories research,pdf

# Time-based filtering
evocrawl search "tech news" --tbs qdr:h   # Last hour
evocrawl search "tech news" --tbs qdr:d   # Last day
evocrawl search "tech news" --tbs qdr:w   # Last week
evocrawl search "tech news" --tbs qdr:m   # 过去一个月
evocrawl search "tech news" --tbs qdr:y   # Last year

# Location-based search
evocrawl search "restaurants" --location "Berlin,Germany" --country DE

# Search and scrape results
evocrawl search "documentation" --scrape --scrape-formats markdown

# Save to file
evocrawl search "evocrawl" --pretty -o results.json
```

**可用选项：**

| 选项                           | 描述                                                           |
| ---------------------------- | ------------------------------------------------------------ |
| `--limit <number>`           | 结果数量上限（默认：5，最大：100）                                          |
| `--sources <sources>`        | 要搜索的数据源：`web`、`images`、`news`（逗号分隔）                          |
| `--categories <categories>`  | 按类别过滤：`github`、`research`、`pdf`（逗号分隔）                        |
| `--tbs <value>`              | 时间过滤：`qdr:h`（小时）、`qdr:d`（天）、`qdr:w`（周）、`qdr:m`（月）、`qdr:y`（年） |
| `--location <location>`      | 地域定向（例如："Berlin,Germany"）                                    |
| `--country <code>`           | ISO 国家代码（默认：US）                                              |
| `--timeout <ms>`             | 以毫秒为单位的超时时间（默认：60000）                                        |
| `--ignore-invalid-urls`      | 排除对其他 Evocrawl 端点无效的 URL                                     |
| `--scrape`                   | 抓取搜索结果                                                       |
| `--scrape-formats <formats>` | 抓取内容的 formats（默认：markdown）                                   |
| `--only-main-content`        | 抓取时仅包含主要内容（默认：true）                                          |
| `--json`                     | 以 JSON 格式输出                                                  |
| `--output <path>`            | 将输出保存到文件                                                     |
| `--pretty`                   | 以易读格式打印 JSON 输出                                              |

***

<div id="map">
  ### Map
</div>

快速发现站点中的所有 URL。

```bash CLI theme={null} theme={null}
# 发现网站上的所有 URL
evocrawl map https://example.com

# Output as JSON
evocrawl map https://example.com --json

# Limit number of URLs
evocrawl map https://example.com --limit 500
```

<div id="map-options">
  #### Map 命令选项
</div>

```bash CLI theme={null} theme={null}
# Filter URLs by search query
evocrawl map https://example.com --search "blog"

# Include subdomains
evocrawl map https://example.com --include-subdomains

# 控制站点地图使用方式
evocrawl map https://example.com --sitemap include   # 使用站点地图
evocrawl map https://example.com --sitemap skip      # 跳过站点地图
evocrawl map https://example.com --sitemap only      # 仅使用站点地图

# Ignore query parameters (dedupe URLs)
evocrawl map https://example.com --ignore-query-parameters

# Wait for map to complete with timeout
evocrawl map https://example.com --wait --timeout 60

# Save to file
evocrawl map https://example.com -o urls.txt
evocrawl map https://example.com --json --pretty -o urls.json
```

**可用选项：**

| 选项                          | 描述                                   |
| --------------------------- | ------------------------------------ |
| `--url <url>`               | 要映射的 URL（可替代位置参数）                    |
| `--limit <number>`          | 要发现的最大 URL 数量                        |
| `--search <query>`          | 根据搜索查询筛选 URL                         |
| `--sitemap <mode>`          | Sitemap 处理模式：`include`、`skip`、`only` |
| `--include-subdomains`      | 包含子域名                                |
| `--ignore-query-parameters` | 将带有不同参数的 URL 视为同一 URL                |
| `--wait`                    | 等待映射完成                               |
| `--timeout <seconds>`       | 超时时间（秒）                              |
| `--json`                    | 以 JSON 格式输出                          |
| `--output <path>`           | 将输出保存到文件                             |
| `--pretty`                  | 以易读格式打印 JSON 输出                      |

***

<div id="browser">
  ### 浏览器
</div>

让您的代理通过安全的浏览器沙箱与网页交互。

启动云端浏览器会话，远程执行 Python、JavaScript 或 bash 代码。每个会话都会运行一个完整的 Chromium 实例——无需在本地安装浏览器。代码在服务器端运行，并预先配置好可直接使用的 [Playwright](https://playwright.dev/) `page` 对象。

```bash CLI theme={null} theme={null}
# Launch a cloud browser session
evocrawl browser launch-session

# 执行 agent-browser 命令(默认 - 自动添加 "agent-browser" 前缀)
evocrawl browser execute "open https://example.com"
evocrawl browser execute "snapshot"
evocrawl browser execute "click @e5"
evocrawl browser execute "scrape"

# Execute Playwright Python code
evocrawl browser execute --python 'await page.goto("https://example.com")
print(await page.title())'

# Execute Playwright JavaScript code
evocrawl browser execute --node 'await page.goto("https://example.com"); console.log(await page.title());'

# List all sessions (or: list active / list destroyed)
evocrawl browser list

# Close the active session
evocrawl browser close
```

<div id="browser-options">
  #### 浏览器选项
</div>

```bash CLI theme={null} theme={null}
# Launch with custom TTL (10 minutes) and live view
evocrawl browser launch-session --ttl 600 --stream

# Launch with inactivity timeout
evocrawl browser launch-session --ttl 120 --ttl-inactivity 60

# agent-browser 命令(默认 - 自动添加 "agent-browser" 前缀)
evocrawl browser execute "open https://news.ycombinator.com"
evocrawl browser execute "snapshot"
evocrawl browser execute "click @e3"
evocrawl browser execute "scrape"

# Playwright Python - navigate, interact, extract
evocrawl browser execute --python '
await page.goto("https://news.ycombinator.com")
items = await page.query_selector_all(".titleline > a")
for item in items[:5]:
    print(await item.text_content())
'

# Playwright JavaScript - same page object
evocrawl browser execute --node '
await page.goto("https://example.com");
const title = await page.title();
console.log(title);
'

# Explicit bash mode - runs in the sandbox
evocrawl browser execute --bash "agent-browser snapshot"

# Target a specific session
evocrawl browser execute --session <id> --python 'print(await page.title())'

# Save output to file
evocrawl browser execute "scrape" -o result.txt

# Close a specific session
evocrawl browser close --session <id>

# List sessions (all / active / destroyed)
evocrawl browser list
evocrawl browser list active --json
```

**子命令：**

| 子命令              | 说明                                       |
| ---------------- | ---------------------------------------- |
| `launch-session` | 启动一个新的云端浏览器会话（返回会话 ID、CDP URL 和实时视图 URL） |
| `execute <code>` | 在会话中执行 Playwright Python/JS 代码或 bash 命令  |
| `list [status]`  | 列出浏览器会话（可按 `active` 或 `destroyed` 过滤）    |
| `close`          | 关闭浏览器会话                                  |

**执行选项：**

| 选项               | 说明                                                                                                                                                               |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--bash`         | 在沙箱中远程执行 bash 命令（默认）。已预装 [agent-browser](https://github.com/vercel-labs/agent-browser)（40+ 命令）并自动加前缀。`CDP_URL` 会自动注入，因此 agent-browser 会自动连接到你的会话。是 AI 代理的最佳使用方式。 |
| `--python`       | 以 Playwright Python 代码方式执行。会提供一个 Playwright `page` 对象——使用 `await page.goto()`、`await page.title()` 等。                                                            |
| `--node`         | 以 Playwright JavaScript 代码方式执行。同样提供 `page` 对象。                                                                                                                   |
| `--session <id>` | 指定目标会话（默认：活动会话）                                                                                                                                                  |

**启动选项：**

| 选项                           | 说明                              |
| ---------------------------- | ------------------------------- |
| `--ttl <seconds>`            | 会话总存活时间（TTL）（默认：600，范围：30–3600） |
| `--ttl-inactivity <seconds>` | 空闲达到指定时间后自动关闭（范围：10–3600）       |
| `--profile <name>`           | 配置文件名称（在会话之间保存并复用浏览器状态）         |
| `--no-save-changes`          | 仅加载已有配置文件数据，不将更改写回保存            |
| `--stream`                   | 启用实时视图流式传输                      |

**通用选项：**

| 选项                | 说明          |
| ----------------- | ----------- |
| `--output <path>` | 将输出保存到文件    |
| `--json`          | 以 JSON 格式输出 |

***

<div id="crawl">
  ### Crawl
</div>

从单个 URL 出发爬取整个网站。

```bash CLI theme={null} theme={null}
# Start a crawl (returns job ID immediately)
evocrawl crawl https://example.com

# Wait for crawl to complete
evocrawl crawl https://example.com --wait

# 等待并显示进度指示器
evocrawl crawl https://example.com --wait --progress
```

<div id="check-crawl-status">
  #### 查看抓取状态
</div>

```bash CLI theme={null} theme={null}
# 使用作业 ID 检查爬取状态
evocrawl crawl <job-id>

# 真实作业 ID 示例
evocrawl crawl 550e8400-e29b-41d4-a716-446655440000
```

<div id="crawl-options">
  #### Crawl 选项
</div>

```bash CLI theme={null} theme={null}
# Limit crawl depth and pages
evocrawl crawl https://example.com --limit 100 --max-depth 3 --wait

# Include only specific paths
evocrawl crawl https://example.com --include-paths /blog,/docs --wait

# Exclude specific paths
evocrawl crawl https://example.com --exclude-paths /admin,/login --wait

# Include subdomains
evocrawl crawl https://example.com --allow-subdomains --wait

# Crawl entire domain
evocrawl crawl https://example.com --crawl-entire-domain --wait

# Rate limiting
evocrawl crawl https://example.com --delay 1000 --max-concurrency 2 --wait

# 自定义轮询间隔和超时时间
evocrawl crawl https://example.com --wait --poll-interval 10 --timeout 300

# Save results to file
evocrawl crawl https://example.com --wait --pretty -o results.json
```

**可用选项：**

| 选项                          | 描述                                   |
| --------------------------- | ------------------------------------ |
| `--url <url>`               | 要爬取的 URL（位置参数的替代方式）                  |
| `--wait`                    | 等待爬取完成                               |
| `--progress`                | 等待期间显示进度指示器                          |
| `--poll-interval <seconds>` | 轮询间隔（默认：5 秒）                         |
| `--timeout <seconds>`       | 等待时的超时时长                             |
| `--status`                  | 检查已有爬取任务的状态                          |
| `--limit <number>`          | 最大爬取页面数                              |
| `--max-depth <number>`      | 最大爬取深度                               |
| `--include-paths <paths>`   | 要包含的路径（逗号分隔）                         |
| `--exclude-paths <paths>`   | 要排除的路径（逗号分隔）                         |
| `--sitemap <mode>`          | Sitemap 处理方式：`include`、`skip`、`only` |
| `--allow-subdomains`        | 包含子域名                                |
| `--allow-external-links`    | 跟随外部链接                               |
| `--crawl-entire-domain`     | 爬取整个域名                               |
| `--ignore-query-parameters` | 将具有不同参数的 URL 视为相同                    |
| `--delay <ms>`              | 请求之间的延迟                              |
| `--max-concurrency <n>`     | 最大并发请求数                              |
| `--output <path>`           | 将输出保存到文件                             |
| `--pretty`                  | 以更易读的格式输出 JSON                       |

***

<div id="agent">
  ### Agent
</div>

使用自然语言指令在网上搜索和获取数据。

```bash CLI theme={null} theme={null}
# Basic usage - URLs are optional
evocrawl agent "Find the top 5 AI startups and their funding amounts" --wait

# Focus on specific URLs
evocrawl agent "Compare pricing plans" --urls https://slack.com/pricing,https://teams.microsoft.com/pricing --wait

# 使用 schema 实现结构化输出
evocrawl agent "Get company information" --urls https://example.com --schema '{"name": "string", "founded": "number"}' --wait

# Use schema from a file
evocrawl agent "Get product details" --urls https://example.com --schema-file schema.json --wait
```

<div id="agent-options">
  #### Agent 选项
</div>

```bash CLI theme={null} theme={null}
# 使用 Spark 1 Pro 提高准确性
evocrawl agent "Competitive analysis across multiple domains" --model spark-1-pro --wait

# Set max credits to limit costs
evocrawl agent "Gather contact information from company websites" --max-credits 100 --wait

# Check status of an existing job
evocrawl agent <job-id> --status

# Custom polling interval and timeout
evocrawl agent "Summarize recent blog posts" --wait --poll-interval 10 --timeout 300

# Save output to file
evocrawl agent "Find pricing information" --urls https://example.com --wait -o pricing.json --pretty
```

**可用选项：**

| 选项                          | 说明                                                    |
| --------------------------- | ----------------------------------------------------- |
| `--urls <urls>`             | 可选的 URL 列表，用于限定 agent 的处理范围（用逗号分隔）                    |
| `--model <model>`           | 使用的模型：`spark-1-mini`（默认，成本低 60%）或 `spark-1-pro`（精度更高） |
| `--schema <json>`           | 用于结构化输出的 JSON schema（内联 JSON 字符串）                     |
| `--schema-file <path>`      | 用于结构化输出的 JSON schema 文件路径                             |
| `--max-credits <number>`    | 最多可消耗的 credits（达到上限时任务失败）                             |
| `--status`                  | 检查已有 agent 任务的状态                                      |
| `--wait`                    | 等待 agent 任务完成后再返回结果                                   |
| `--poll-interval <seconds>` | 等待时的轮询间隔（默认：5）                                        |
| `--timeout <seconds>`       | 等待时的超时时间（默认：无限制）                                      |
| `--output <path>`           | 将输出保存到文件                                              |
| `--json`                    | 以 JSON 格式输出                                           |

***

<div id="credit-usage">
  ### 额度使用情况
</div>

查看你团队的额度余额和使用明细。

```bash CLI theme={null}
# View credit usage
evocrawl credit-usage

# 以 JSON 格式输出
evocrawl credit-usage --json --pretty
```

***

<div id="version">
  ### Version
</div>

显示 CLI 的版本。

```bash CLI theme={null}
evocrawl version
# 或
evocrawl --version
```

<div id="global-options">
  ## 全局选项
</div>

以下选项适用于所有命令：

| 选项                | 简写   | 说明                        |
| ----------------- | ---- | ------------------------- |
| `--status`        |      | 显示版本、认证状态、并发数和额度          |
| `--api-key <key>` | `-k` | 在此命令中临时覆盖已保存的 API 密钥      |
| `--api-url <url>` |      | 使用自定义 API URL（用于自托管/本地开发） |
| `--help`          | `-h` | 显示命令帮助信息                  |
| `--version`       | `-V` | 显示 CLI 版本                 |

<div id="output-handling">
  ## 输出处理
</div>

CLI 默认将结果输出到 stdout，便于通过管道或重定向进行处理：

```bash CLI theme={null}
# 将 Markdown 通过管道传递给另一个命令
evocrawl https://example.com | head -50

# 重定向到文件
evocrawl https://example.com > output.md

# 保存格式化后的 JSON
evocrawl https://example.com --format markdown,links --pretty -o data.json
```

<div id="format-behavior">
  ### formats 的行为
</div>

* **单一 format**：输出原始内容（markdown 文本、HTML 等）
* **多个 formats**：输出包含所有请求数据的 JSON

```bash CLI theme={null}
# 原始 markdown 输出
evocrawl https://example.com --format markdown

# 使用多个 formats 的 JSON 输出
evocrawl https://example.com --format markdown,links
```

<div id="examples">
  ## 示例
</div>

<div id="quick-scrape">
  ### 快速抓取
</div>

```bash CLI theme={null}
# 从 URL 获取 Markdown 内容(使用 --only-main-content 获取简洁输出)
evocrawl https://docs.evocrawl.com --only-main-content

# Get HTML content
evocrawl https://example.com --html -o page.html
```

<div id="full-site-crawl">
  ### 整站爬取
</div>

```bash CLI theme={null}
# 爬取文档站点并设置限制
evocrawl crawl https://docs.example.com --limit 50 --max-depth 2 --wait --progress -o docs.json
```

<div id="site-discovery">
  ### 站点发现
</div>

```bash CLI theme={null}
# 查找所有博客文章
evocrawl map https://example.com --search "blog" -o blog-urls.txt
```

<div id="research-workflow">
  ### 研究工作流
</div>

```bash CLI theme={null}
# 搜索并抓取结果用于研究
evocrawl search "machine learning best practices 2024" --scrape --scrape-formats markdown --pretty
```

### 智能体

```bash CLI theme={null}
# URL 可选
evocrawl agent "Find the top 5 AI startups and their funding amounts" --wait

# 针对特定 URL
evocrawl agent "Compare pricing plans" --urls https://slack.com/pricing,https://teams.microsoft.com/pricing --wait
```

<div id="browser-automation">
  ### 浏览器自动化
</div>

```bash CLI theme={null}
# Launch a session, scrape a page, and close
evocrawl browser launch-session
evocrawl browser execute "open https://news.ycombinator.com"
evocrawl browser execute "snapshot"
evocrawl browser execute "scrape"
evocrawl browser close

# 通过 bash 模式使用 agent-browser(默认 — 推荐用于 AI 智能体)
evocrawl browser launch-session
evocrawl browser execute "open https://example.com"
evocrawl browser execute "snapshot"
# snapshot returns @ref IDs — use them to interact
evocrawl browser execute "click @e5"
evocrawl browser execute "fill @e3 'search query'"
evocrawl browser execute "scrape"
# Run --help to see all 40+ commands
evocrawl browser execute --bash "agent-browser --help"
evocrawl browser close
```

<div id="combine-with-other-tools">
  ### 与其他工具结合使用
</div>

```bash CLI theme={null}
# Extract URLs from search results
jq -r '.data.web[].url' search-results.json

# Get titles from search results
jq -r '.data.web[] | "\(.title): \(.url)"' search-results.json

# 提取链接并使用 jq 处理
evocrawl https://example.com --format links | jq '.links[].url'

# Count URLs from map
evocrawl map https://example.com | wc -l
```

<div id="telemetry">
  ## 遥测
</div>

CLI 在身份验证过程中会收集匿名使用数据，以帮助改进产品：

* CLI 版本、操作系统和 Node.js 版本
* 检测到的开发工具（例如 Cursor、VS Code、Claude Code）

**CLI 不会收集任何命令数据、URL 或文件内容。**

如需禁用遥测，请设置以下环境变量：

```bash CLI theme={null}
export EVOCRAWL_NO_TELEMETRY=1
```

<div id="open-source">
  ## 开源
</div>

EvoCrawl CLI 和技能是开源的，可在 GitHub 上获取：[evocrawl/cli](https://github.com/superaihuman/evocrawl/cli)

> 你是需要 EvoCrawl API 密钥的 AI 代理吗？请参见 [evocrawl.dev/agent-onboarding/SKILL.md](https://www.evocrawl.com/agent-onboarding/SKILL.md) 获取自动化入门说明。