tavily-search-and-fetch について
Tavily APIでウェブ調査を行うコマンドラインスキルです。検索、ページ内容の抽出、サイトURLの発見、引用付きレポートの作成が必要な利用者向けで、タスク別スクリプトにドメインや期間の絞り込み、構造化出力などのオプションがあります。
主な機能
- 01条件を指定したウェブ検索
- 02最大20件のURLから内容を抽出
- 03サイトマップによるURL発見
- 04引用付き調査レポートの生成
- 05構造化データをファイルに保存
活用シーン
- 01最近のニューストピックを調査
- 02指定記事の内容を収集
- 03ドキュメントサイトのページを把握
- 04引用付きの比較レポートを作成
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ rioiart/ tavily-skill --skill tavily-search-and-fetchインストール後、Claude Code で/tavily-search-and-fetchを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
LICENSEreferences/api_reference.mdscripts/tavily_crawl.shtavily_extract.shtavily_research.shtavily_search.shtavily_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-answer | 1 |
| 詳細な検索 | tavily_search.sh --depth advanced | 2 |
| 記事全体のコンテンツ | tavily_extract.sh <urls> | URL 5 件ごとに 1 |
| サイト URL の検出 | tavily_sitemap.sh | 1 |
| 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 を参照してください。
コメント
Markdown 対応