tavily extract

1 つ以上の URL からクリーンな Markdown またはテキストコンテンツを抽出します。

コマンド実行前に

PATH に tvly が見つからない場合は、まずインストールしてください:

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

このステップをスキップしたり、他のツールにフォールバックしたりしないでください。

別のインストール方法と認証オプションについては tavily-cli を参照してください。

使用タイミング

• 特定の URL を持っていてそのコンテンツが必要な場合
• JavaScript でレンダリングされたページからテキストが必要な場合
• ワークフローのステップ 2: 検索 → 抽出 → マップ → クロール → リサーチ

クイックスタート

# 単一の URL
tvly extract "https://example.com/article" --json

# 複数の URL
tvly extract "https://example.com/page1" "https://example.com/page2" --json

# クエリフォーカス抽出 (関連チャンクのみを返す)
tvly extract "https://example.com/docs" --query "authentication API" --chunks-per-source 3 --json

# JS が多いページ
tvly extract "https://app.example.com" --extract-depth advanced --json

# ファイルに保存
tvly extract "https://example.com/article" -o article.md

オプション

オプション	説明
--query	チャンクをこのクエリとの関連性で再ランク付けします
--chunks-per-source	URL あたりのチャンク数 (1-5、--query が必須)
--extract-depth	basic (デフォルト) または advanced (JS ページ用)
--format	markdown (デフォルト) または text
--include-images	画像 URL を含める
--timeout	最大待機時間 (1-60 秒)
-o, --output	出力をファイルに保存
--json	構造化 JSON 出力

抽出の深さ

深さ	使用タイミング
basic	シンプルなページ、高速 — まずこれを試してください
advanced	JS でレンダリングされた SPA、動的コンテンツ、テーブル

ヒント

• リクエストあたり最大 20 URL — より大きなリストは複数の呼び出しにバッチ処理します。
• --query + --chunks-per-source を使用 して、ページ全体ではなく関連コンテンツのみを取得します。
• basic を最初に試し、コンテンツが不足している場合は advanced にフォールバックします。
• 遅いページは --timeout を設定 してください (最大 60 秒)。
• 検索結果にすでに必要なコンテンツが含まれている場合 (--include-raw-content 経由)、抽出ステップをスキップします。

関連項目

• tavily-search — URL がない場合にページを検索
• tavily-crawl — サイト上の多くのページからコンテンツを抽出