tavily map

コンテンツを抽出せずにウェブサイトのURLを検出します。クローリングより高速です。

コマンドを実行する前に

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

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

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

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

使う場面

• 大規模サイト上の特定のサブページを見つける必要がある
• 何を抽出またはクローリングするか決める前に、すべてのURLのリストが必要
• ワークフローのステップ3: 検索 → 抽出 → マップ → クローリング → リサーチ

クイックスタート

# すべてのURLを検出
tvly map "https://docs.example.com" --json

# 自然言語フィルタリング付き
tvly map "https://docs.example.com" --instructions "Find API docs and guides" --json

# パスでフィルタ
tvly map "https://example.com" --select-paths "/blog/.*" --limit 500 --json

# ディープマップ
tvly map "https://example.com" --max-depth 3 --limit 200 --json

オプション

オプション	説明
--max-depth	深さレベル (1-5、デフォルト: 1)
--max-breadth	ページあたりのリンク数 (デフォルト: 20)
--limit	検出するURL数の上限 (デフォルト: 50)
--instructions	URL フィルタリング用の自然言語ガイダンス
--select-paths	カンマ区切りの正規表現パターン (含める)
--exclude-paths	カンマ区切りの正規表現パターン (除外)
--select-domains	ドメイン用カンマ区切り正規表現 (含める)
--exclude-domains	ドメイン用カンマ区切り正規表現 (除外)
--allow-external / --no-external	外部リンクを含める
--timeout	最大待機時間 (10-150 秒)
-o, --output	出力をファイルに保存
--json	構造化 JSON 出力

Map + Extract パターン

map で適切なページを見つけてから extract で抽出します。これはサイト全体をクローリングするより効率的なことが多いです:

# ステップ1: 認証ドキュメントを検出
tvly map "https://docs.example.com" --instructions "authentication" --json

# ステップ2: 見つけたページを抽出
tvly extract "https://docs.example.com/api/authentication" --json

ヒント

• Map は URL 検出のみ — コンテンツ抽出はしません。コンテンツには extract または crawl を使用してください。
• 大規模サイトから数ページだけ必要な場合、Map + Extract が crawl より優れています。
• パスパターンでは不十分な場合、--instructions を使用してセマンティックフィルタリングを行ってください。

関連項目

• tavily-extract — 検出したURL からコンテンツを抽出
• tavily-crawl — 多くのページが必要な場合の一括抽出