mcpField
T
tavily-search-and-fetch

tavily-search-and-fetch

github.com/rioiart生産性038 回インストール37 週間前に更新
リポジトリ

tavily-search-and-fetch について

Tavily APIでウェブ調査を行うコマンドラインスキルです。検索、ページ内容の抽出、サイトURLの発見、引用付きレポートの作成が必要な利用者向けで、タスク別スクリプトにドメインや期間の絞り込み、構造化出力などのオプションがあります。

主な機能

  1. 01条件を指定したウェブ検索
  2. 02最大20件のURLから内容を抽出
  3. 03サイトマップによるURL発見
  4. 04引用付き調査レポートの生成
  5. 05構造化データをファイルに保存

活用シーン

  1. 01最近のニューストピックを調査
  2. 02指定記事の内容を収集
  3. 03ドキュメントサイトのページを把握
  4. 04引用付きの比較レポートを作成

インストール

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

$npx skills add https://github.com/rioiart/tavily-skill --skill tavily-search-and-fetch

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

LICENSE
references/
api_reference.md
scripts/
tavily_crawl.sh
tavily_extract.sh
tavily_research.sh
tavily_search.sh
tavily_sitemap.sh

詳細

Tavily リサーチャー

Tavily の LLM 最適化 API を利用したウェブ調査:検索、抽出、サイトマップ、リサーチ。

セットアップ

TAVILY_API_KEY 環境変数が必要です。無料キー(月 1000 クレジット)は https://app.tavily.com で取得できます。

適切なツールの選び方

必要なものスクリプト
ウェブ検索結果tavily_search.sh
特定の URL のコンテンツtavily_extract.sh
サイト上の URL を検出(高速)tavily_sitemap.sh
引用付きの AI 生成レポートtavily_research.sh

クイックスタート

検索
scripts/tavily_search.sh "What is retrieval augmented generation?" --include-answer
ニュース検索
scripts/tavily_search.sh "AI regulation updates" --topic news --time-range week
URL からコンテンツを抽出
scripts/tavily_extract.sh https://example.com/article1 https://example.com/article2
サイト上の URL を検出
scripts/tavily_sitemap.sh https://docs.example.com --max-depth 2 --limit 100
AI リサーチレポート
scripts/tavily_research.sh "Compare LangGraph vs CrewAI for multi-agent systems" --model pro

スクリプト

tavily_search.sh

標準的なウェブ検索です。タイトル、URL、スニペット、オプションの AI 回答を返します。

主なオプション:

  • --depth ultra-fast|fast|basic|advanced — 速度と関連性のバランスを調整します
  • --topic general|news|finance — コンテンツの種類に合わせて最適化します
  • --include-answer — AI が生成した要約を取得します
  • --include-raw-content — ページ全体のコンテンツを取得します
  • --time-range day|week|month|year — 新しさで絞り込みます
  • --chunks-per-source N — ソースごとのチャンク数(1~5、advanced/fast)
  • --include-domains / --exclude-domains — ソースを絞り込みます
tavily_extract.sh

特定の URL から全コンテンツを抽出します(一度に最大 20 件)。

主なオプション:

  • --depth basic|advanced — JavaScript を多用するページには advanced を使用します
  • --query TEXT — 関連性に基づいてチャンクを再ランク付けします
  • --chunks-per-source N — 関連性の高いチャンクのみを返します(1~5、--query が必要)
  • --format markdown|text — 出力形式
tavily_sitemap.sh

コンテンツを抽出せずにウェブサイト上の URL を検出します。クロールより高速です。まずサイト構造を把握するために使用します。

主なオプション:

  • --max-depth N — クロールの深さ(1~5、1 から始めてください)
  • --limit N — URL の合計上限(デフォルト:50)
  • --instructions TEXT — 特定の種類のページに絞り込みます
tavily_research.sh

引用付きの AI 生成リサーチです。所要時間は 30~120 秒です。

主なオプション:

  • --model mini|pro|auto — 焦点を絞った質問には mini、包括的な分析には pro を使用します
  • --citation-format numbered|mla|apa|chicago
  • --output-schema JSON — 構造化された JSON 出力を取得します
  • --output-file PATH — 結果をファイルに保存します

コストの最適化

タスク推奨される方法クレジット
簡単な事実確認tavily_search.sh --include-answer1
詳細な検索tavily_search.sh --depth advanced2
記事全体のコンテンツtavily_extract.sh <urls>URL 5 件ごとに 1
サイト URL の検出tavily_sitemap.sh1
AI リサーチレポートtavily_research.sh変動

ドメイン固有の検索

# Only search specific sites
scripts/tavily_search.sh "async python" --include-domains docs.python.org,realpython.com

# Exclude unreliable sources
scripts/tavily_search.sh "health advice" --exclude-domains reddit.com,quora.com

API リファレンス

すべてのパラメーターの説明は references/api_reference.md を参照してください。

コメント