Informe de investigación: Búsqueda de informes de investigación del sector

Este servicio MCP se centra en la búsqueda de informes de investigación del sector, y ofrece capacidades de búsqueda y consulta de detalles para informes de investigación del sector, investigación de empresas, estrategia macro y informes temáticos.

Categoría: Información integral

Funciones principales

• Búsqueda por palabras clave de informes de investigación del sector

• Filtrado por institución y sector

• Filtrado por tipo de informe y fecha de publicación

• Detalles del informe y enlace de origen

Related MCP server: worldbank-documents-reports-mcp

Descripción del diseño del servicio

• El servicio completa el flujo completo de consulta de "descubrir informes—filtrar informes—leer detalles" mediante dos herramientas: búsqueda y detalles.

• El servicio ofrece 2 herramientas de solo lectura; una sola llamada a una herramienta accede únicamente a un ID de producto.

• Los resultados paginados se consolidan uniformemente en total y resultList.

• Las respuestas exitosas son automáticamente compatibles con el formato de datos de negocio de Gateway y el formato interno stat/data.

• El tiempo de espera de las solicitudes se puede configurar mediante HANDAAS_REQUEST_TIMEOUT; el valor predeterminado es de 30 segundos.

Requisitos del entorno

• Python 3.10+

• Dependencias: mcp, python-dotenv, requests

Inicio rápido local

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

Dirección predeterminada del servicio: http://127.0.0.1:8000/mcp. Compatible con stdio, sse y streamable-http.

Variables de entorno

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

Las credenciales reales solo deben guardarse en el archivo .env local o en secretos de implementación.

Configuración de Cursor / Cherry Studio

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

Herramientas disponibles e ID de producto

Flujo de llamada recomendado

1. Llame a research_report_search para buscar informes y reducir el conjunto de candidatos.

2. Confirme el informe objetivo según el título, la institución, el sector, el tipo y la fecha de publicación.

3. Use el reportId del resultado para llamar a research_report_detail y obtener los metadatos completos y el enlace de origen.

Descripción detallada de las herramientas

1. research_report_search

Cuándo usarla: cuando el usuario necesita buscar informes de un sector, empresa, tema, institución o rango de fechas específico.

Parámetros clave: rpKeyword busca por título del informe; rpOrgName busca por nombre completo o abreviado de la institución; rpCalIndustryList y rpType se usan para un filtrado preciso; el formato de fecha es YYYY-MM-DD; pageSize máximo 50.

Descripción de la respuesta: devuelve el título del informe, la institución, la fecha de publicación, el sector, el tipo y el reportId; no devuelve el archivo del contenido del informe.

2. research_report_detail

Cuándo usarla: cuando ya se ha confirmado el informe objetivo y se necesita obtener la institución, el sector, el tipo, la fecha de publicación y el enlace de origen.

Parámetros clave: reportId debe provenir de los resultados de research_report_search.

Descripción de la respuesta: devuelve los metadatos del informe y el campo de enlace de origen; la herramienta no compra, descarga, abre ni analiza archivos PDF.

Ejemplos de uso

Ejemplo uno: búsqueda de informes de investigación del sector

Busque informes de investigación del sector de inteligencia artificial publicados en 2026 y devuelva primero 10 resultados.

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

Ejemplo dos: consulta de detalles del informe

Consulte la institución publicadora, la clasificación del sector, la fecha de publicación y el enlace de origen del informe seleccionado anteriormente.

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

Notas de uso

1. Los detalles deben usar el reportId de los resultados de búsqueda.

2. La fecha de inicio no puede ser posterior a la fecha de finalización.

3. La herramienta solo devuelve metadatos del enlace de origen; no abre, compra, descarga ni analiza archivos de informes.

4. Las opiniones del informe pertenecen a la institución publicadora original y no representan la postura del servicio MCP.

Pruebas y verificación

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

Las pruebas unitarias utilizan respuestas simuladas (Mock); la verificación real se realiza mediante la llamada a HandaaS Integrator Gateway a través del archivo .env local.