mcpField
T
tavily-map

tavily-map

github.com/tavily-ai生産性49117.4k 回インストール8 週間前に更新
リポジトリ

tavily-map について

tavily-mapは、ページ内容を取得せずにサイト内のURLを見つけるコマンドラインスキルです。抽出やクロールの前に対象ページを探す用途に適しています。

主な機能

  1. 01サイト内URLの検出
  2. 02自然言語による絞り込み
  3. 03パスとドメインの包含・除外
  4. 04深さ、幅、URL数の制限
  5. 05JSONの出力と保存

活用シーン

  1. 01大規模サイトから特定ページを探す
  2. 02抽出対象を決める前にURLを一覧化
  3. 03意味による絞り込みでドキュメントを探す

MCP 対応

このスキルは `tvly` コマンドラインを使用します。入力にはMCPへの直接接続についての記載はありません。

インストール

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

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

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

詳細

tavily map

コンテンツを抽出せずに、ウェブサイト上の URL を見つけます。クロールより高速です。

実行する前に

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

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

使用する場面

  • 大規模なサイトで特定のサブページを見つける必要がある場合
  • 抽出またはクロールする内容を決める前に、すべての URL の一覧が必要な場合
  • ワークフローのステップ 3：search → extract → map → crawl → research

クイックスタート

# Discover all URLs
tvly map "https://docs.example.com" --json

# With natural language filtering
tvly map "https://docs.example.com" --instructions "Find API docs and guides" --json

# Filter by path
tvly map "https://example.com" --select-paths "/blog/.*" --limit 500 --json

# Deep map
tvly map "https://example.com" --max-depth 3 --limit 200 --json

オプション

オプション説明
--max-depth深さのレベル（1～5、デフォルト：1）
--max-breadthページごとのリンク数（デフォルト：20）
--limit検出する URL の最大数（デフォルト：50）
--instructionsURL を絞り込むための自然言語による指示
--select-paths含めるパスの正規表現パターンをカンマ区切りで指定
--exclude-paths除外するパスの正規表現パターンをカンマ区切りで指定
--select-domains含めるドメインの正規表現をカンマ区切りで指定
--exclude-domains除外するドメインの正規表現をカンマ区切りで指定
--allow-external / --no-external外部リンクを含める
--timeout最大待機時間（10～150 秒）
-o, --outputJSON レスポンスをファイルに保存
--json構造化された JSON 出力

Map + Extract パターン

map で適切なページを見つけてから、extract で抽出します。サイト全体をクロールするより効率的なことがよくあります。

# Step 1: Find the authentication docs
tvly map "https://docs.example.com" --instructions "authentication" --json

# Step 2: Extract the specific page you found
tvly extract "https://docs.example.com/api/authentication" --json

ヒント

  • Map は URL の検出のみを行います — コンテンツは抽出しません。コンテンツには extract または crawl を使用してください。
  • 大規模なサイトから特定のページを数件だけ取得する場合は、Map + extract のほうが crawl より効果的です。
  • パスパターンだけでは不十分な場合は、--instructions を使用して意味に基づいて絞り込んでください。

関連項目

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

コメント

Markdown 対応