web-search-tavily

Web Search（Tavily API）

Tavily の AI 最適化検索 API を使用してウェブを検索します。関連性スコアと、オプションの AI 生成要約を含む、高品質で構造化された結果を返します。

注: このスキルには Tavily API キーが必要です。エージェントに組み込まれた機能で基本的なウェブ検索を行うには、web-search を参照してください。

このスキルを使用するタイミング

次の場合にこのスキルを使用します：

• トレーニングデータに含まれていない最新情報を探す必要がある
• ユーザーが最近の出来事、ニュース、更新について尋ねている
• 事実を確認したり、信頼できる情報源を探したりする必要がある
• 調査にリアルタイムのウェブデータが必要である
• 次のキーワードが含まれている：検索、調べる、オンラインで探す、現在、最新、ニュース

次の場合はこのスキルを使用しないでください：

• 情報がすでにナレッジベースにあり、検証する必要がない
• ユーザーが変化しない歴史的事実について尋ねている
• ローカルファイルやコードを扱っている（他のツールを使用してください）
• タスクにより適したスキルがある（例：ドキュメント検索）

前提条件

このスキルを使用する前に、次のことを確認してください：

• 有効な API キーを設定した TAVILY_API_KEY 環境変数がある
• 検索スクリプトを実行するための Deno がインストールされている
• インターネットアクセスが利用可能である

Tavily API キーはこちらから取得してください：https://tavily.com

クイックスタート

簡単な検索を実行します：

deno run --allow-env --allow-net=api.tavily.com scripts/search.ts "your search query"

AI 生成の回答を含む例：

deno run --allow-env --allow-net=api.tavily.com scripts/search.ts "React 19 new features" --answer

スクリプトの使用方法

deno run --allow-env --allow-net=api.tavily.com scripts/search.ts [options] "query"

オプション

オプション	説明	デフォルト
--answer	AI 生成の回答要約を含めます	false
--depth <level>	検索の深さ：basic または advanced	basic
--results <n>	返す結果の数	5
--topic <type>	トピックの種類：general、news、または finance	general
--time <range>	期間フィルター：day、week、month、または year	none
--include <domains>	これらのドメインのみを含めます（カンマ区切り）	none
--exclude <domains>	これらのドメインを除外します（カンマ区切り）	none
--raw	結果にページの生コンテンツを含めます	false
--json	JSON 形式で出力します（プログラムからの利用向け）	false
--help	ヘルプメッセージを表示します	-

検索パラメーター

トピックの種類

• general（デフォルト）：あらゆる種類のコンテンツを対象とした幅広いウェブ検索
• news：ニュース記事や最近の出来事を優先します
• finance：金融情報や市場データに焦点を当てます

検索の深さ

• basic（デフォルト）：高速な検索で、ほとんどのクエリに適しています
• advanced：より包括的な結果を得るための、より詳細な検索です（時間がかかり、API コストも高くなります）

期間

結果を新しさで絞り込みます：

• day：過去 24 時間
• week：過去 7 日間
• month：過去 30 日間
• year：過去 365 日間

ドメインのフィルタリング

結果に表示するサイトを指定します：

# Only search documentation sites
scripts/search.ts "React hooks" --include docs.react.dev,developer.mozilla.org

# Exclude social media
scripts/search.ts "AI news" --exclude twitter.com,reddit.com

出力形式

人間が読みやすい出力（デフォルト）

🔍 Search: "React 19 new features"

Found 5 results in 234ms

📝 AI Answer:
────────────────────────────────────────────────────────────
React 19 introduces several new features including...
────────────────────────────────────────────────────────────

1. React 19 Release Notes
   https://react.dev/blog/2024/04/25/react-19
   React 19 is now available on npm! This release includes...
   Score: 0.987

2. What's New in React 19
   https://example.com/react-19-features
   A comprehensive overview of React 19's new features...
   Score: 0.945

JSON 出力（--json）

{
  "query": "React 19 new features",
  "results": [
    {
      "title": "React 19 Release Notes",
      "url": "https://react.dev/blog/2024/04/25/react-19",
      "content": "React 19 is now available on npm...",
      "score": 0.987,
      "published_date": "2024-04-25"
    }
  ],
  "answer": "React 19 introduces several new features...",
  "response_time": 234
}

結果フィールド

フィールド	型	説明
title	string	ページタイトル
url	string	ソース URL
content	string	ページからの関連する抜粋
score	number	関連性スコア（0～1。高いほど良好）
published_date	string	公開日（利用可能な場合）
raw_content	string	ページ全体のコンテンツ（--raw を指定した場合のみ）

例

例 1：最近の出来事の検索

シナリオ：技術トピックに関する最近のニュースを探す

scripts/search.ts "OpenAI GPT-5 announcement" --topic news --time week --answer

想定される出力：GPT-5 に関する最近のニュース記事と AI 生成の要約

例 2：ドキュメントの検索

シナリオ：特定の技術ドキュメントを探す

scripts/search.ts "Deno deploy edge functions tutorial" --depth advanced --results 10

想定される出力：ドキュメントサイトやチュートリアルサイトからの包括的な結果

例 3：事実の検証

シナリオ：特定の主張や統計を検証する

scripts/search.ts "world population 2024" --include un.org,worldbank.org,census.gov --json

想定される出力：プログラムによる検証向けに、信頼できる情報源から取得した JSON 形式の結果

例 4：金融調査

シナリオ：市場情報を調査する

scripts/search.ts "NVIDIA stock analysis 2024" --topic finance --answer

想定される出力：AI 要約を含む金融分析と市場データ

よくある問題と解決方法

Issue: 「TAVILY_API_KEY environment variable is not set」

症状：API キーエラーが発生し、スクリプトが直ちに終了します

解決方法：

1. https://tavily.com から API キーを取得します
2. 環境変数を設定します：

   export TAVILY_API_KEY="your-api-key-here"
   

3. または、変数をインラインで指定して実行します：

   TAVILY_API_KEY="your-key" deno run --allow-env --allow-net=api.tavily.com scripts/search.ts "query"
   

Issue: 「Invalid Tavily API key」

症状：401 認証エラー

解決方法：

1. API キーが正しいこと（余分なスペースがないこと）を確認します
2. API キーの有効期限が切れていないか確認します
3. Tavily アカウントが有効であることを確認します

Issue: 「Tavily API rate limit exceeded」

症状：429 エラーレスポンス

解決方法：

1. 少し待ってから再試行します
2. リクエストの頻度を減らします
3. 上限を引き上げるには、Tavily プランのアップグレードを検討します

Issue: 結果が返されない

症状：結果配列が空です

解決方法：

1. より広範な検索語句を試します
2. 制限が厳しすぎる可能性のあるドメインフィルターを削除します
3. そのトピックがオンラインに存在するか確認します
4. 難しいクエリには --depth advanced を試します

制限事項

このスキルには、以下の制限事項があります：

• インターネットへの接続が必要です
• Tavily プランに応じて API レート制限が適用されます
• 結果は Tavily のインデックス範囲に依存します
• 有料コンテンツやログインが必要なコンテンツにはアクセスできません
• リアルタイムの正確性は Tavily のクロール頻度に依存します
• クエリの最大長と結果数には API による制限があります

関連スキル

• research-workflow：計画と統合を行いながら複数の検索を活用する包括的な調査プロジェクト向け