ウェブ検索 (Tavily API)

Tavily のAI最適化検索APIを使用してウェブを検索します。関連度スコア付きの高品質で構造化された結果と、オプションのAI生成サマリーを返します。

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

このスキルを使用すべき場合

以下の場合にこのスキルを使用してください:

• 学習データに含まれていない最新情報を見つける必要がある
• ユーザーが最近のイベント、ニュース、または更新について質問している
• 事実を検証または権威ある情報源を見つける必要がある
• リサーチにリアルタイムのウェブデータが必要である
• 「検索」、「調べる」、「オンラインで見つける」、「現在の」、「最新の」、「ニュース」などのキーワードが言及されている

このスキルを使用してはいけない場合:

• 情報がすでにあなたの知識ベースにあり、検証が不要である
• ユーザーが変わらない歴史的事実について質問している
• ローカルファイルまたはコードを操作している場合(他のツールを使用)
• そのタスク用のより具体的なスキルが存在する場合(例: ドキュメンテーションの検索)

前提条件

このスキルを使用する前に、以下を確認してください:

• TAVILY_API_KEY 環境変数に有効なAPIキーが設定されている
• 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	なし
--include <domains>	これらのドメインのみを含める(カンマ区切り)	なし
--exclude <domains>	これらのドメインを除外(カンマ区切り)	なし
--raw	結果に未処理のページコンテンツを含める	false
--json	JSON形式で出力(プログラム的用途向け)	false
--help	ヘルプメッセージを表示	-

検索パラメータ

トピックタイプ

• general (デフォルト): すべてのコンテンツタイプにわたるブロードなウェブ検索
• news: ニュース記事と現在のイベントを優先
• finance: 金融情報と市場データに焦点を当てる

検索深度

• basic (デフォルト): 高速検索、ほとんどのクエリに適している
• advanced: より包括的な結果による深い検索(低速、APIコスト高)

時間範囲

最近性による結果のフィルター:

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

ドメインフィルタリング

結果に表示されるサイトをコントロールします:

# ドキュメンテーションサイトのみを検索
scripts/search.ts "React hooks" --include docs.react.dev,developer.mozilla.org

# ソーシャルメディアを除外
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サマリー付き)

よくある問題と解決策

問題: 「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"
   

問題: 「Invalid Tavily API key」

症状: 401認証エラー

解決策:

1. APIキーが正確であることを確認(余分なスペースがないか)
2. APIキーの有効期限が切れていないか確認
3. Tavily アカウントがアクティブであることを確認

問題: 「Tavily API rate limit exceeded」

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

解決策:

1. しばらく待って再試行
2. リクエスト頻度を減らす
3. より高い制限のためにTavily プランのアップグレードを検討

問題: 結果が返されない

症状: 空の結果配列

解決策:

1. より広い検索用語を試す
2. 制限が厳しすぎる可能性があるドメインフィルターを削除
3. トピックがオンラインに存在するかチェック
4. 難しいクエリに対して --depth advanced を試す

制限事項

このスキルには以下の制限があります:

• アクティブなインターネット接続が必須
• Tavily プランに基づいてAPIレート制限が適用
• 結果はTavily のインデックスカバレッジに依存
• ペイウォール認証が必要なコンテンツにはアクセス不可
• リアルタイムの精度はTavily のクローリング頻度に依存
• 最大クエリ長と結果数にはAPIの制限あり

関連スキル

• research-workflow: 計画と統合を備えた複数の検索を使用する包括的なリサーチプロジェクト向け