unified-research

name	unified-research
description	複数のリサーチAPI（Tavily/SerpAPI/Brave/NewsAPI/Perplexity）を統合した情報収集。 Use when: (1) user says「リサーチして」「調べて」「情報を集めて」「深掘りして」, (2) user wants multi-source research, (3) user mentions「ファクトチェック」「情報収集」. Do NOT use for: APIキー不要の簡易調査（research-freeを使用）、 最強の徹底調査（mega-researchを使用）。

Unified Research Skill

複数のリサーチAPIを統合した高品質な情報収集スキル。

When to Use This Skill

以下の場合に使用:

• トピックについて深くリサーチしたい時
• 信頼性の高い情報源から情報を集めたい時
• ファクトベースのコンテンツを作成したい時
• 複数の検索エンジンの結果を比較したい時

トリガーワード: 「リサーチして」「調べて」「情報を集めて」「深掘りして」

統合API

API	特徴	用途
Tavily	AI検索特化	高品質なセマンティック検索
SerpAPI	Google検索	構造化された検索結果
Brave Search	プライバシー重視	広範なWeb検索
NewsAPI	ニュース集約	最新ニュース取得
Perplexity	AI検索+引用	サマリー生成と引用付き回答

Quick Start

cd /Users/matsumototoshihiko/Desktop/dev/\ kindlenote0201/kindle-content-empire

# 単一クエリでリサーチ
npx ts-node packages/worker/src/research/run-unified-research.ts single "新NISA 2024"

# 新NISA専用リサーチ（7クエリ自動実行）
npx ts-node packages/worker/src/research/run-unified-research.ts nisa

# トピックリサーチ（5クエリ自動実行）
npx ts-node packages/worker/src/research/run-unified-research.ts topic "投資信託"

API使用例

TypeScriptから使用

import { unifiedSearch, researchTopic } from './unified-research';

// 単一クエリ
const result = await unifiedSearch('新NISA 2024', {
  tavily: true,
  serpapi: true,
  brave: true,
  newsapi: false,  // ニュースは必要時のみ
  perplexity: true,
});

console.log(`ソース数: ${result.sources.length}`);
console.log(`ファクト数: ${result.facts.length}`);
console.log(`AIサマリー: ${result.summary}`);

// トピックリサーチ（複数クエリ）
const results = await researchTopic('仮想通貨', true);

出力形式

ResearchResult

interface ResearchResult {
  query: string;           // 検索クエリ
  sources: ResearchSource[]; // 情報ソース一覧
  summary?: string;        // AIサマリー（Perplexity）
  facts: string[];         // 抽出されたファクト
  timestamp: Date;         // 実行日時
  apiUsed: string[];       // 使用したAPI一覧
}

ResearchSource

interface ResearchSource {
  title: string;           // タイトル
  url: string;             // URL
  snippet: string;         // スニペット/要約
  source: string;          // ソースAPI名
  publishedAt?: string;    // 公開日（ニュースの場合）
  score?: number;          // 関連度スコア（Tavilyの場合）
}

環境変数

.envファイルに以下のAPIキーを設定:

# Research APIs
TAVILY_API_KEY=your_tavily_key
SERPAPI_KEY=your_serpapi_key
BRAVE_SEARCH_API_KEY=your_brave_key
NEWSAPI_KEY=your_newsapi_key
PERPLEXITY_API_KEY=your_perplexity_key

レート制限

API	制限	対策
Tavily	1000 req/month (Free)	重要クエリのみ使用
SerpAPI	100 req/month (Free)	キャッシュ活用
Brave	2000 req/month (Free)	並列実行制限
NewsAPI	100 req/day (Free)	ニュース時のみ
Perplexity	課金制	サマリー必要時のみ

ベストプラクティス

1. 適切なAPI選択: 目的に応じてAPIを選択

   • 一般検索: Tavily + Brave
   • Google結果: SerpAPI
   • ニュース: NewsAPI
   • AIサマリー: Perplexity

2. レート制限対策:

   • 並列リクエストは5つまで
   • リクエスト間に1秒のディレイ

3. 結果の検証:

   • 複数ソースで情報をクロスチェック
   • 公式情報源を優先

ファイル構成

packages/worker/src/research/
├── unified-research.ts      # メインモジュール
├── run-unified-research.ts  # CLI実行スクリプト
├── enhanced-research.ts     # WebSearch統合版
├── keyword-research.ts      # キーワードリサーチ
└── deep-research.ts         # 従来版（DuckDuckGo）

トラブルシューティング

問題	解決策
APIキーエラー	.envファイルを確認
レート制限	待機時間を増やす
タイムアウト	タイムアウト値を増加
空の結果	クエリを調整、別APIを試す

関連スキル

• research-cited-report: 出典付きレポート生成
• gpt-researcher: 自律型深層リサーチ
• context7-docs: 最新ドキュメント取得