Unified Research

Unified Research Skill

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

When to Use This Skill

以下の場合に使用:

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

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

統合API

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

レート制限

ベストプラクティス

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）

トラブルシューティング

関連スキル

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