レポート：業界レポート検索

このMCPサービスは業界レポート検索を中核とし、業界レポート、企業研究、マクロ戦略、テーマレポートの検索・詳細照会機能を提供します。

所属カテゴリ：総合情報

主な機能

• 業界レポートのキーワード検索

• 機関・業界の絞り込み

• レポート種別・公開日時の絞り込み

• レポート詳細とソースリンク

Related MCP server: worldbank-documents-reports-mcp

サービス設計の説明

• 本サービスは検索と詳細の2つのToolにより、「レポート発見→レポート絞り込み→詳細閲覧」の完全な照会フローを実現します。

• 本サービスは2つの読み取り専用Toolを提供し、1回のTool呼び出しで1つのProduct IDのみにアクセスします。

• ページング結果は一律に total と resultList に集約されます。

• 成功レスポンスはGateway業務のdataと内部の stat/data の両方の形式に自動対応します。

• リクエストのタイムアウトは HANDAAS_REQUEST_TIMEOUT で設定可能で、デフォルトは30秒です。

環境要件

• Python 3.10+

• 依存関係：mcp、python-dotenv、requests

ローカルでのクイックスタート

cd research-report-mcp-server
python3 -m venv mcp_env
source mcp_env/bin/activate
pip install -r requirements.txt
cp .env.example .env
python server/mcp_server.py streamable-http

サービスデフォルトアドレス：http://127.0.0.1:8000/mcp。stdio、sse、streamable-http に対応しています。

環境変数

INTEGRATOR_ID=your_integrator_id
SECRET_ID=your_secret_id
SECRET_KEY=your_secret_key
HANDAAS_REQUEST_TIMEOUT=30

実際の認証情報はローカルの .env またはデプロイ用シークレットにのみ保存できます。

Cursor / Cherry Studio設定

{
  "mcpServers": {
    "research-report-mcp-server": {
      "type": "streamableHttp",
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

利用可能なToolとProduct ID

推奨呼び出しフロー

1. research_report_search を呼び出してレポートを検索し、候補範囲を絞り込みます。

2. タイトル、機関、業界、種別、公開日時に基づいて対象レポートを確認します。

3. 結果の reportId を使用して research_report_detail を呼び出し、完全なメタデータとソースリンクを取得します。

Tool詳細説明

1. research_report_search

使用タイミング：ユーザーが特定の業界、企業、テーマ、機関、または期間内のレポートを検索する必要がある場合に使用します。

主要パラメータ：rpKeyword はレポートタイトルの検索、rpOrgName は機関の正式名称または略称の検索、rpCalIndustryList と rpType は精密な絞り込みに使用します。日付形式は YYYY-MM-DD、pageSize は最大50です。

戻り値の説明：レポートタイトル、機関、公開日時、業界、種別、reportId を返します。レポート本文ファイルは返しません。

2. research_report_detail

使用タイミング：対象レポートが確定し、機関、業界、種別、公開日時、ソースリンクを取得する必要がある場合に使用します。

主要パラメータ：reportId は research_report_search の結果から取得する必要があります。

戻り値の説明：レポートのメタデータとソースリンクフィールドを返します。ToolはPDFファイルの購入、ダウンロード、オープン、解析は行いません。

使用例

例1：業界レポートの検索

2026年に公開された人工知能業界レポートを検索し、最初に10件返してください。

{
  "tool": "research_report_search",
  "arguments": {
    "rpKeyword": "人工智能",
    "rpCalIndustryList": "人工智能",
    "rpPublishDateStart": "2026-01-01",
    "rpPublishDateEnd": "2026-12-31",
    "pageIndex": 1,
    "pageSize": 10
  }
}

例2：レポート詳細の照会

先ほど選択したレポートの公開機関、業界分類、公開日時、ソースリンクを確認してください。

{
  "tool": "research_report_detail",
  "arguments": {
    "reportId": "从研报检索结果取得"
  }
}

使用上の注意事項

1. 詳細は検索結果の reportId を使用する必要があります。

2. 開始日は終了日より後であってはなりません。

3. Toolはソースリンクのメタデータのみを返し、レポートファイルのオープン、購入、ダウンロード、解析は行いません。

4. レポートの見解は元の公開機関に帰属し、MCPサービスの立場を代表するものではありません。

テスト検証

python -m py_compile server/mcp_server.py
python -m unittest discover -s tests -v

単体テストはMockレスポンスを使用します。実環境での検証はローカルの .env を通じてHandaaS Integrator Gatewayを呼び出して行います。