Отчет: Поиск отраслевых отчетов

Этот MCP-сервис специализируется на поиске отраслевых отчетов и предоставляет возможности поиска и просмотра деталей отраслевых отчетов, корпоративных исследований, макростратегий и тематических отчетов.

Раздел: Общая информация

Основные функции

• Поиск отраслевых отчетов по ключевым словам

• Фильтрация по организациям и отраслям

• Фильтрация по типу отчета и дате публикации

• Детали отчета и ссылка на источник

Related MCP server: worldbank-documents-reports-mcp

Описание дизайна сервиса

• Сервис реализует полный цикл поиска «поиск отчета — фильтрация отчета — просмотр деталей» с помощью двух Tool.

• Сервис предоставляет 2 read-only Tool, один вызов Tool обращается только к одному Product ID.

• Результаты постранично унифицированы в формате total и resultList.

• Успешный ответ автоматически совместим с двумя форматами: бизнес-данные Gateway и внутренние 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.