> ## 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.

# Skill + CLI

> Evocrawl Skill は、Claude Code、Antigravity、OpenCode などの AI エージェントが CLI を通じて Evocrawl を利用するための簡単な方法です。

ターミナルから直接、Web を検索・スクレイピングし、操作できます。EvoCrawl CLI は単体でも動作し、Claude Code、Antigravity、OpenCode などの AI コーディングエージェントが自動的に検出して利用できる Skill としても機能します。

<div id="installation">
  ## インストール
</div>

Claude Code のような AI エージェントを使用している場合は、以下の Evocrawl Skill をインストールすると、エージェントがセットアップしてくれます。

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

* `--all` は検出されたすべての AI コーディングエージェントに Evocrawl Skill をインストールします
* `--browser` は Evocrawl の認証のためにブラウザを自動的に開きます

<Note>
  Skill をインストールした後、新しい Skill を認識させるためにエージェントを再起動してください。
</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

# Login with browser authentication (recommended for agents)
evocrawl login --browser

# Login with API key directly
evocrawl login --api-key fc-YOUR-API-KEY

# Or set via environment variable
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 キーなしで利用できます。

<div id="check-status">
  ### ステータスの確認
</div>

インストールと認証が正しく行われているかを確認し、レート制限も確認します。

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

準備完了時の出力:

```
   evocrawl cli v1.1.1

  ● EVOCRAWL_API_KEYで認証済み
  同時実行数: 0/100ジョブ (並列スクレイプ制限)
  クレジット: 残り500,000
```

* **同時実行数 (Concurrency)**: 並列に実行できるジョブの最大数。この上限付近まで並列処理を行ってもよいが、超えないようにする。
* **クレジット (Credits)**: 残りの API クレジット数。各 `scrape`/`crawl` はクレジットを消費する。

<div id="commands">
  ## コマンド
</div>

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

1つのURLをスクレイピングし、そのコンテンツをさまざまなフォーマットで抽出します。

<Tip>
  `--only-main-content` を使用すると、ナビゲーション、フッター、広告を除いたクリーンな出力を取得できます。記事やメインページのコンテンツのみが必要なほとんどのユースケースで推奨されます。
</Tip>

```bash CLI theme={null} theme={null}
# Scrape a URL (default: markdown output)
evocrawl https://example.com

# Or use the explicit scrape command
evocrawl scrape https://example.com

# 推奨: ナビゲーションやフッターを除いたクリーンな出力には --only-main-content を使用
evocrawl https://example.com --only-main-content
```

<div id="output-formats">
  #### 出力フォーマット
</div>

```bash CLI theme={null} theme={null}
# Get HTML output
evocrawl https://example.com --html

# Multiple formats (returns JSON)
evocrawl https://example.com --format markdown,links

# Get images from a page
evocrawl https://example.com --format images

# Get a summary of the page content
evocrawl https://example.com --format summary

# Track changes on a page
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
```

**利用可能なオプション:**

| Option                  | Short | Description                                                                                                                                    |
| ----------------------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `--url <url>`           | `-u`  | スクレイプする URL（位置引数の代わり）                                                                                                                          |
| `--format <formats>`    | `-f`  | 出力フォーマット（カンマ区切り）：`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`                |       | 単一のフォーマット指定でも JSON 出力を強制                                                                                                                       |
| `--pretty`              |       | JSON 出力を整形して表示                                                                                                                                 |
| `--timing`              |       | リクエストのタイミングやその他の有用な情報を表示                                                                                                                       |

***

<div id="search">
  ### 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   # 過去1ヶ月
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>` | スクレイピングしたコンテンツのフォーマット（デフォルト: 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

# Control sitemap usage
evocrawl map https://example.com --sitemap include   # Use sitemap
evocrawl map https://example.com --sitemap skip      # Skip sitemap
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>`          | サイトマップの処理モード: `include`, `skip`, `only` |
| `--include-subdomains`      | サブドメインを含める                              |
| `--ignore-query-parameters` | クエリパラメータが異なる URL を同一として扱う               |
| `--wait`                    | マップ処理の完了を待機                             |
| `--timeout <seconds>`       | タイムアウト時間（秒）                             |
| `--json`                    | JSON 形式で出力                              |
| `--output <path>`           | 出力をファイルに保存                              |
| `--pretty`                  | JSON 出力を整形して表示                          |

***

<div id="browser">
  ### Browser
</div>

安全なブラウザサンドボックスを使って、エージェントをWebとやり取りさせます。

クラウド上のブラウザセッションを起動し、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

# 非アクティブタイムアウトを指定して起動
evocrawl browser launch-session --ttl 120 --ttl-inactivity 60

# agent-browser commands (default - "agent-browser" is auto-prefixed)
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
```

**サブコマンド:**

| Subcommand       | Description                                               |
| ---------------- | --------------------------------------------------------- |
| `launch-session` | 新しいクラウドブラウザセッションを起動します（セッション ID、CDP URL、ライブビュー URL を返します） |
| `execute <code>` | セッション内で Playwright の Python/JS コードまたは bash コマンドを実行します     |
| `list [status]`  | ブラウザセッションを一覧表示します（`active` または `destroyed`でフィルタ可能）        |
| `close`          | ブラウザセッションを閉じます                                            |

**Execute オプション:**

| Option           | Description                                                                                                                                                                                                               |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--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>` | 対象とする特定のセッションを指定します（デフォルト: アクティブなセッション）                                                                                                                                                                                   |

**Launch オプション:**

| Option                       | Description                          |
| ---------------------------- | ------------------------------------ |
| `--ttl <seconds>`            | セッション全体の TTL（デフォルト: 600、範囲: 30–3600） |
| `--ttl-inactivity <seconds>` | 一定時間操作がない場合に自動終了します（範囲: 10–3600）     |
| `--profile <name>`           | プロファイル名（ブラウザの状態をセッション間で保存・再利用します）    |
| `--no-save-changes`          | 既存のプロファイルデータを読み込みますが、変更は保存しません       |
| `--stream`                   | ライブビューのストリーミングを有効化します                |

**共通オプション:**

| Option            | Description   |
| ----------------- | ------------- |
| `--output <path>` | 出力をファイルに保存します |
| `--json`          | JSON 形式で出力します |

***

<div id="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">
  #### クロールオプション
</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
```

**利用可能なオプション:**

| Option                      | Description                           |
| --------------------------- | ------------------------------------- |
| `--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>`          | サイトマップの処理モード: `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">
  ### エージェント
</div>

自然言語プロンプトを使用して、Web上からデータを検索・収集します。

```bash CLI theme={null} theme={null}
# 基本的な使い方 - URLは省略可能
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

# Use a schema for structured output
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">
  #### エージェントオプション
</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
```

**利用可能なオプション:**

| Option                      | Description                                                |
| --------------------------- | ---------------------------------------------------------- |
| `--urls <urls>`             | エージェントが対象とするURLの任意のリスト（カンマ区切り）                             |
| `--model <model>`           | 使用するモデル: `spark-1-mini`（デフォルト、60%安価）または `spark-1-pro`（高精度） |
| `--schema <json>`           | 構造化出力用のJSONスキーマ（インラインJSON文字列）                              |
| `--schema-file <path>`      | 構造化出力用のJSONスキーマファイルへのパス                                    |
| `--max-credits <number>`    | 消費するクレジットの上限（上限に達するとジョブは失敗）                                |
| `--status`                  | 既存のエージェントジョブのステータスを確認                                      |
| `--wait`                    | 結果を返す前にエージェントの完了を待つ                                        |
| `--poll-interval <seconds>` | 待機中のポーリング間隔（デフォルト: 5）                                      |
| `--timeout <seconds>`       | 待機時のタイムアウト（デフォルト: タイムアウトなし）                                |
| `--output <path>`           | 出力をファイルに保存                                                 |
| `--json`                    | JSON形式で出力                                                  |

***

<div id="credit-usage">
  ### クレジット使用状況
</div>

チームのクレジット残高と利用状況を確認できます。

```bash CLI theme={null}
# クレジット使用量を確認
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}
# マークダウンを別のコマンドにパイプする
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">
  ### フォーマットの挙動
</div>

* **単一フォーマット**: 生のコンテンツを出力します（markdown テキスト、HTML など）
* **複数フォーマット**: 要求されたすべてのデータを含む JSON を出力します

```bash CLI theme={null}
# Raw markdown output
evocrawl https://example.com --format markdown

# 複数フォーマットを使用した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
```

<div id="agent">
  ### エージェント
</div>

```bash CLI theme={null}
# URLs are optional
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 バージョン、OS、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 と Skill はオープンソースで、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) を参照してください。