tavily-research

tavily research

AI を活用した詳細な調査を行い、情報源を収集・分析して、出典付きのレポートを作成します。所要時間は 30〜120 秒です。

実行前

調査には認証が必要です。tvly がすでに認証済みの場合は、要求されたコマンドを直接実行してください。実行のたびにステータスを確認する必要はありません。

tvly が見つからない場合は、tavily-cli のセットアップに従ってください。 インストール済みの CLI で認証エラーが発生した場合は、認証のみを行うには tvly login を使用してください。ガイド付きの確認も役立つ場合は、tvly init --skip-skills を使用してください。ユーザーが対話操作を完了できる場合は、ブラウザーを使った OAuth を推奨します。--no-browser を指定すると、サインインリンクを開かずに表示しますが、引き続き localhost へのコールバックを待ちます。無人のエージェント環境や CI 環境では、認証はユーザーに任せるか、安全に提供された TAVILY_API_KEY を使用してください。ガイド付きセットアップの完了直後に、続けて別のログインを開始しないでください。

使用する場面

• 複数の情報源を網羅的に分析する必要がある場合
• 比較、市場レポート、文献レビューをユーザーが求めている場合
• 簡単な検索では不十分で、出典付きの統合分析が必要な場合
• ワークフローのステップ 5：search → extract → map → crawl → research

クイックスタート

# Basic research (waits for completion)
tvly research "competitive landscape of AI code assistants"

# Pro model for comprehensive analysis
tvly research "electric vehicle market analysis" --model pro

# Stream results in real-time
tvly research "AI agent frameworks comparison" --stream

# Save report to file
tvly research "fintech trends 2025" --model pro -o fintech-report.json

# JSON output for agents
tvly research "quantum computing breakthroughs" --json

オプション

オプション	説明
--model	mini、pro、または auto（デフォルト）
--stream	結果をリアルタイムでストリーミングします
--no-wait	request_id をすぐに返します（非同期）
--output-schema	構造化出力用の JSON スキーマへのパス
--citation-format	numbered、mla、apa、chicago
--poll-interval	確認間隔（秒、デフォルト：10）
--timeout	最大待機時間（秒、デフォルト：600）
-o, --output	JSON レスポンスをファイルに保存します
--json	構造化 JSON 出力

モデルの選択

モデル	用途	速度
mini	単一トピックに絞った調査	約30秒
pro	複数の観点からの網羅的な分析	約60〜120秒
auto	複雑さに応じて API が選択します	変動

目安：「X は何をするの？」なら mini。「X と Y と Z の比較」や「最善の方法は…」なら pro を使います。

非同期ワークフロー

時間のかかる調査では、開始と結果の確認を別々に行えます。

# Start without waiting
tvly research "topic" --no-wait --json    # returns request_id

# Check status
tvly research status <request_id> --json

# Wait for completion
tvly research poll <request_id> --json -o result.json

ヒント

• 調査には 30〜120 秒かかります。進捗をリアルタイムで確認するには、--stream を使用してください。
• 複雑な比較や多面的なトピックには --model pro を使用してください。
• カスタムスキーマに合った構造化 JSON 出力を取得するには、--output-schema を使用してください。
• 簡単な情報を調べる場合は、代わりに tvly search を使用してください。research は詳細な統合分析に使用します。
• 標準入力から読み込むには、echo "query" | tvly research - --json を使用します。

関連項目

• tavily-search — 簡単な情報を調べるためのウェブ検索
• tavily-crawl — 独自に分析するために、サイトから一括で情報を抽出