Tavily CLI

ウェブ検索、コンテンツ抽出、サイトクローリング、URL 発見、および深い調査。LLM 消費向けに最適化された JSON を返します。

詳細なオプション情報については、tvly --help または tvly <command> --help を実行してください。

前提条件

インストール済みで認証されている必要があります。tvly --status で確認してください。

tavily v0.1.0

> Authenticated via OAuth (tvly login)

準備ができていない場合:

curl -fsSL https://cli.tavily.com/install.sh | bash

または手動で: uv tool install tavily-cli / pip install tavily-cli

その後、認証します:

tvly login --api-key tvly-YOUR_KEY
# または: export TAVILY_API_KEY=tvly-YOUR_KEY
# または: tvly login  (ブラウザで OAuth を開く)

ワークフロー

このエスカレーション パターンに従ってください — シンプルに始めて、必要に応じてエスカレートします:

1. 検索 — 特定の URL なし。ページを見つけ、質問に答え、ソースを発見します。
2. 抽出 — URL がある。そのコンテンツを直接引き出します。
3. マップ — 大規模サイト、正しいページを見つける必要がある。まず URL を発見します。
4. クローリング — サイト全体セクションから大量のコンテンツが必要。
5. 調査 — 引用付きで包括的なマルチソース分析が必要。

必要な機能	コマンド	使用時期
トピック内のページを検索	tvly search	特定の URL がまだない場合
ページのコンテンツを取得	tvly extract	URL がある場合
サイト内の URL を検索	tvly map	特定のサブページを見つける必要がある場合
サイトセクションを一括抽出	tvly crawl	多くのページが必要な場合 (例: すべての /docs/)
引用付き深い調査	tvly research	マルチソース合成が必要な場合

詳細なコマンド リファレンスについては、各コマンドの個別スキルを使用するか (例: tavily-search、tavily-crawl)、tvly <command> --help を実行してください。

出力

すべてのコマンドは構造化されたマシン可読出力用の --json と、ファイルに保存するための -o をサポートしています。

tvly search "react hooks" --json -o results.json
tvly extract "https://example.com/docs" -o docs.md
tvly crawl "https://docs.example.com" --output-dir ./docs/

ヒント

• 常に URL をクォートします — シェルは ? と & を特殊文字として解釈します。
• エージェント ワークフローに --json を使用します — すべてのコマンドがこれをサポートしています。
• stdin から読み込む場合は - を使用します — echo "query" | tvly search -
• 終了コード: 0 = 成功、2 = 不正な入力、3 = 認証エラー、4 = API エラー。