CLI | Evocrawl

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

インストール

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

npx -y evocrawl-cli@latest init --all --browser

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

Skill をインストールした後、新しい Skill を認識させるためにエージェントを再起動してください。

npm を使って EvoCrawl CLI をグローバルに手動でインストールすることもできます。

CLI

# npm でグローバルにインストール
npm install -g evocrawl-cli

認証

CLI を使用する前に、EvoCrawl API キーを使って認証する必要があります。

CLI

# 対話型ログイン(ブラウザを開くか、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

設定の表示

CLI

# 現在の設定と認証ステータスを表示
evocrawl view-config

ログアウト

CLI

# 保存された認証情報をクリア
evocrawl logout

セルフホスト / ローカル開発

セルフホスト環境の Evocrawl インスタンスやローカル開発では、--api-url オプションを使用してください:

CLI

# ローカルの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 キーなしで利用できます。

ステータスの確認

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

CLI

evocrawl --status

準備完了時の出力:

   evocrawl cli v1.1.1

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

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

コマンド

Scrape

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

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

CLI

# 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

出力フォーマット

CLI

# 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

スクレイプのオプション

CLI

# メインコンテンツのみを抽出(ナビゲーションとフッターを削除)
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`		リクエストのタイミングやその他の有用な情報を表示

Search

ウェブ検索を行い、必要に応じて結果をスクレイピングします。

CLI

# ウェブを検索する
evocrawl search "web scraping tutorials"

# 結果数を制限する
evocrawl search "AI news" --limit 10

# 結果を整形して表示する
evocrawl search "machine learning" --pretty

検索オプション

CLI

# 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 出力を見やすく整形して表示

Map

ウェブサイト内のすべてのURLを迅速に検出します。

CLI

# ウェブサイト上のすべての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

Map オプション

CLI

# 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 出力を整形して表示

Browser

安全なブラウザサンドボックスを使って、エージェントをWebとやり取りさせます。クラウド上のブラウザセッションを起動し、Python、JavaScript、または bash のコードをリモートで実行します。各セッションでは完全な Chromium インスタンスが動作しており、ローカルにブラウザをインストールする必要はありません。コードはサーバー側で実行され、あらかじめ設定された Playwright の page オブジェクトをすぐに利用できます。

CLI

# 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

ブラウザオプション

CLI

# 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（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 形式で出力します

クロール

指定した URL を起点に、ウェブサイト全体をクロールします。

CLI

# 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

クロールのステータスを確認する

CLI

# ジョブIDを使用してクロールステータスを確認
evocrawl crawl <job-id>

# 実際のジョブIDの例
evocrawl crawl 550e8400-e29b-41d4-a716-446655440000

クロールオプション

CLI

# 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出力を整形して表示

エージェント

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

CLI

# 基本的な使い方 - 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

エージェントオプション

CLI

# より高精度な結果を得るには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形式で出力

クレジット使用状況

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

CLI

# クレジット使用量を確認
evocrawl credit-usage

# JSON形式で出力
evocrawl credit-usage --json --pretty

Version

CLIのバージョンを表示します。

CLI

evocrawl version
# または
evocrawl --version

グローバルオプション

これらのオプションはすべてのコマンドで利用できます。

オプション	短縮形	説明
`--status`		バージョン、認証情報、同時実行数、クレジット残高を表示する
`--api-key <key>`	`-k`	このコマンドで使用する API キーを、保存されているキーより優先して指定する
`--api-url <url>`		カスタム API URL を使用する（セルフホスト環境／ローカル開発向け）
`--help`	`-h`	コマンドのヘルプを表示する
`--version`	`-V`	CLI のバージョン情報を表示する

出力の処理

CLI はデフォルトで標準出力 (stdout) に出力するため、パイプやリダイレクトが容易です。

CLI

# マークダウンを別のコマンドにパイプする
evocrawl https://example.com | head -50

# ファイルにリダイレクトする
evocrawl https://example.com > output.md

# 整形されたJSON形式で保存する
evocrawl https://example.com --format markdown,links --pretty -o data.json

フォーマットの挙動

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

CLI

# Raw markdown output
evocrawl https://example.com --format markdown

# 複数フォーマットを使用したJSON出力
evocrawl https://example.com --format markdown,links

使用例

クイックスクレイプ

CLI

# URLからMarkdownコンテンツを取得(クリーンな出力には --only-main-content を使用)
evocrawl https://docs.evocrawl.com --only-main-content

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

サイト全体クロール

CLI

# 制限付きでドキュメントサイトをクロールする
evocrawl crawl https://docs.example.com --limit 50 --max-depth 2 --wait --progress -o docs.json

サイトの発見

CLI

# すべてのブログ投稿を検索
evocrawl map https://example.com --search "blog" -o blog-urls.txt

調査ワークフロー

CLI

# リサーチ用の検索とスクレイピング結果
evocrawl search "machine learning best practices 2024" --scrape --scrape-formats markdown --pretty

エージェント

CLI

# 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

ブラウザ自動化

CLI

# 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

他のツールとの連携

CLI

# 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

テレメトリー

CLI は、製品の改善のために認証時に匿名の利用状況データを収集します：

CLI バージョン、OS、Node.js バージョン
開発ツールの検出（例：Cursor、VS Code、Claude Code）

CLI を通じてコマンド内容、URL、ファイル内容が収集されることは一切ありません。 テレメトリーを無効にするには、次の環境変数を設定します：

CLI

export EVOCRAWL_NO_TELEMETRY=1

オープンソース

EvoCrawl CLI と Skill はオープンソースで、GitHub で公開されています: evocrawl/cli

EvoCrawl API キーが必要な AI エージェントですか？自動オンボーディング手順については、evocrawl.dev/agent-onboarding/SKILL.md を参照してください。

​インストール

​認証

​ログイン

​設定の表示

​ログアウト

​セルフホスト / ローカル開発

​ステータスの確認

​コマンド

​Scrape

​出力フォーマット

​スクレイプのオプション

​Search

​検索オプション

​Map

​Map オプション

​Browser

​ブラウザオプション

​クロール

​クロールのステータスを確認する

​クロールオプション

​エージェント

​エージェントオプション

​クレジット使用状況

​Version

​グローバルオプション

​出力の処理

​フォーマットの挙動

​使用例

​クイックスクレイプ

​サイト全体クロール

​サイトの発見

​調査ワークフロー

​エージェント

​ブラウザ自動化

​他のツールとの連携

​テレメトリー

​オープンソース

インストール

認証

ログイン

設定の表示

ログアウト

セルフホスト / ローカル開発

ステータスの確認

コマンド

Scrape

出力フォーマット

スクレイプのオプション

Search

検索オプション

Map

Map オプション

Browser

ブラウザオプション

クロール

クロールのステータスを確認する

クロールオプション

エージェント

エージェントオプション

クレジット使用状況

Version

グローバルオプション

出力の処理

フォーマットの挙動

使用例

クイックスクレイプ

サイト全体クロール

サイトの発見

調査ワークフロー

エージェント

ブラウザ自動化

他のツールとの連携

テレメトリー

オープンソース