mcpField
T
tavily-cli

tavily-cli

github.com/tavily-aiエージェントワークフロー49118.2k 回インストール8 週間前に更新
リポジトリ

tavily-cli について

Tavily CLIは、エージェント向けにウェブ検索、コンテンツ抽出、サイト内URLの発見、クロール、詳細調査を提供し、結果をJSONで出力できます。検索と抽出は回数制限付きで認証なしでも利用でき、その他の主要機能には認証が必要です。

主な機能

  1. 01ウェブ検索と情報源の発見
  2. 02URLからのコンテンツ抽出
  3. 03サイト内URLの探索
  4. 04サイトコンテンツの一括クロール
  5. 05引用付きの詳細調査
  6. 06結果のJSON出力

活用シーン

  1. 01テーマに関する情報源の検索
  2. 02指定ページの内容抽出
  3. 03サイト内ドキュメントの特定
  4. 04複数情報源の調査結果の統合

MCP 対応

入力にはMCP連携やMCPサーバー機能の説明がありません。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/tavily-ai/skills --skill tavily-cli

インストール後、Claude Code で/tavily-cliを入力して読み込まれたか確認します。

詳細

Tavily CLI

Web検索、コンテンツ抽出、サイトクロール、URL検出、詳細なリサーチに対応します。LLMでの利用に最適化されたJSONを返します。

t avily-cli が必要です。検索と抽出は上限付きで認証なしで利用できます。マップ、クロール、リサーチには認証が必要です。

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

セットアップ

tvly がインストールされていない場合：

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

または、手動でインストールします：uv tool install tavily-cli / pip install tavily-cli

エージェントのセットアップでは、ユーザーがサインインを求める場合、またはリクエストされたタスクでマップ、クロール、リサーチが必要な場合を除き、認証なしで開始してください。インストーラーでセットアップが完了していない場合は、次を実行してください：

tvly init --skip-auth

これにより、Tavilyスキルがインストールまたは更新され、認証なしでライブ検索ができることが確認されます。最初の検索または抽出リクエストの前に、APIキーを探したり認証したりしないでください。

認証が求められる場合、または必要な場合は、ガイド付きセットアップを使用してください：

tvly init

# Prefer to open the sign-in link yourself
tvly init --no-browser

tvly init は既存の認証情報を再利用し、そのCLIリリースに同梱されたTavilyスキルをインストールまたは更新して、ライブ検索を確認します。同梱スキルを更新する場合は、先に tvly update を実行してください。スキルがすでにインストールされており、認証または確認のみが必要な場合は、tvly init --skip-skills を使用してください。

検索と抽出は、認証なしですぐに実行できますが、認証なしで利用できる回数には上限があります。インタラクティブセッションでいずれかのコマンドが上限に達した場合は、tvly login を実行してブラウザーでOAuthを開き、元のコマンドを一度だけ再試行してください。無人環境では、インタラクティブなフローを開始せず、上限と認証方法を報告してください。マップ、クロール、リサーチには認証が必要です。必要な場合に限り、tvly --status --json で現在の状態を確認してください。

完全なセットアップを行わずに認証するには、tvly login、tvly login --no-browser、tvly login --api-key tvly-YOUR_KEY、または TAVILY_API_KEY を使用してください。

ブラウザーを使ったOAuthは、推奨されるインタラクティブなサインイン方法です。--no-browser はサインインリンクを自動で開かずに表示するだけです。このフローでは引き続き、tvly を実行しているマシン上のlocalhostコールバックに戻ります。リモートセッションでは、そのコールバックに到達できることを確認してください（SSHではポートフォワーディングが必要になる場合があります）。無人のエージェント環境やCI環境では、認証はユーザーに任せるか、安全に提供された TAVILY_API_KEY を使用してから、元のコマンドを再開してください。

既存のインストールを最新の状態に保つには、tvly update --check と tvly update を実行してください。

ワークフロー

次の段階的な進め方に従い、シンプルな方法から始め、必要に応じて段階を進めてください：

  1. 検索 — 特定のURLがありません。ページを検索し、質問に回答し、情報源を見つけます。
  2. 抽出 — URLがわかっています。そのコンテンツを直接取得します。
  3. マップ — 大規模なサイトで、目的のページを見つける必要があります。まずURLを検出します。
  4. クロール — サイト内のセクション全体から大量のコンテンツを取得する必要があります。
  5. リサーチ — 引用付きで、複数の情報源に基づく包括的な分析が必要です。
必要なことコマンド使用する状況
トピックに関するページを見つけるtvly searchまだ特定のURLがない
ページのコンテンツを取得するtvly extractURLがわかっている
サイト内のURLを見つけるtvly map特定の下位ページを探す必要がある
サイト内のセクションを一括抽出するtvly crawl多数のページが必要（例：すべての /docs/）
引用付きで詳細なリサーチを行うtvly research複数の情報源を統合する必要がある

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

サブコマンドを指定せずに tvly を実行すると、インタラクティブなREPLが起動します。

出力

検索、抽出、クロール、マップ、リサーチでは、構造化出力用の --json を使用できます。結果を生成するコマンドでは -o を使用してJSONレスポンスを保存できます。クロールでは、ページごとにMarkdownファイルを作成する --output-dir も使用できます。セットアップ、認証、状態確認、更新の各コマンドでは、ドキュメントに記載されている場合に --json を使用できますが、-o はサポートされていません。

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

ヒント

  • URL は必ず引用符で囲んでください — シェルは ? と & を特殊文字として解釈します。
  • エージェント型のワークフローでは --json を使用してください（選択したコマンドで利用できる場合）。
  • 標準入力から読み込むには - を使用してください — echo "query" | tvly search -
  • 終了コード：0 = 成功、1 = セットアップ／更新の失敗、2 = 入力の誤り、3 = 認証エラー、4 = API またはライブ検証エラー。

コメント

Markdown 対応