tavily-search

tavily search

LLM 向けに最適化された、コンテンツのスニペットと関連度スコアを含むウェブ検索です。

実行前

tvly が利用可能な場合は、そのまま検索を実行してください。検索では上限付きのキー不要アクセスに対応しているため、最初のリクエストの前に API キーを探したり、認証したりしないでください。

tvly が見つからない場合は、再試行する前に tavily-cli のセットアップに従ってください。対話型セッション中にキー不要アクセスの上限に達した場合は、tvly login を実行してブラウザーで OAuth を開き、元の検索を一度再試行してください。無人環境では、対話型フローを開始せずに、上限に達したことと認証方法を報告してください。ガイドに従ったセットアップが完了した直後に、2 回目のログインを開始しないでください。

使用する場面

• あらゆるトピックについて情報を探す必要がある
• 具体的な URL がまだない
• ワークフローの最初の手順：検索 → 抽出 → マップ → クロール → 調査

クイックスタート

# Basic search
tvly search "your query" --json

# Advanced search with more results
tvly search "quantum computing" --depth advanced --max-results 10 --json

# Recent news
tvly search "AI news" --time-range week --topic news --json

# Domain-filtered
tvly search "SEC filings" --include-domains sec.gov,reuters.com --json

# Include full page content in results
tvly search "react hooks tutorial" --include-raw-content --max-results 3 --json

オプション

オプション	説明
--depth	ultra-fast、fast、basic（デフォルト）、advanced
--max-results	結果の最大数、0～20（デフォルト：5）
--topic	general（デフォルト）、news、finance
--time-range	day、week、month、year
--start-date	この日付以降の結果（YYYY-MM-DD）
--end-date	この日付以前の結果（YYYY-MM-DD）
--include-domains	含めるドメイン（カンマ区切り）
--exclude-domains	除外するドメイン（カンマ区切り）
--country	指定した国からの結果を優先
--include-answer	AI の回答を含める（basic または advanced）
--include-raw-content	ページ全体のコンテンツを含める（markdown または text）
--include-images	画像の検索結果を含める
--include-image-descriptions	AI による画像の説明を含める
--chunks-per-source	ソースごとのチャンク数（advanced／fast の深度でのみ使用可能）
-o, --output	JSON レスポンスをファイルに保存
--json	構造化された JSON 出力

検索の深度

深度	速度	関連度	最適な用途
ultra-fast	最速	低め	リアルタイムチャット、オートコンプリート
fast	高速	良好	チャンクが必要で、レイテンシーが重要な場合
basic	中程度	高い	汎用（デフォルト）
advanced	低速	最高	精度、特定の事実

ヒント

• クエリは 400 文字未満にしてください — プロンプトではなく、検索クエリとして考えてください。
• 複雑なクエリはサブクエリに分割してください。より良い結果が得られます。
• ページ全体のテキストが必要な場合は --include-raw-content を使用してください（個別の抽出呼び出しを省けます）。
• 信頼できるソースに絞り込むには --include-domains を使用してください。
• 最近の情報を探すには --time-range を使用してください。
• 身元に関わる事実は、正確な一次情報源で確認してください。 リリース、バージョン、所有権、または名前が似ているプロジェクトについては、生成された回答やパッケージ名の一致だけを信頼せず、公式リポジトリまたはドメインで確認してください。
• 標準入力から読み込む：echo "query" | tvly search - --json

関連項目

• tavily-extract — 特定の URL からコンテンツを抽出
• tavily-research — 複数のソースを用いた包括的な調査