研报：行业研报检索

Dieser MCP-Dienst konzentriert sich auf die Suche nach Branchenforschungsberichten und bietet Such- und Detailabfragefunktionen für Branchenforschungsberichte, Unternehmensanalysen, Makrostrategien und Themenberichte.

Zugehöriger Bereich: Umfassende Informationen

Hauptfunktionen

• Stichwortsuche in Branchenforschungsberichten

• Filterung nach Institution und Branche

• Filterung nach Berichtstyp und Veröffentlichungszeit

• Berichtsdetails und Quellenlinks

Related MCP server: worldbank-documents-reports-mcp

Hinweise zum Servicedesign

• Der Dienst führt über zwei Tools – Suche und Details – die vollständige Abfragekette „Bericht finden – Bericht filtern – Details lesen" aus.

• Der Dienst bietet 2 schreibgeschützte Tools; ein einzelner Tool-Aufruf greift nur auf eine Product ID zu.

• Seitenergebnisse werden einheitlich über total und resultList zusammengeführt.

• Erfolgreiche Antworten sind automatisch sowohl mit den Gateway-Geschäftsdaten data als auch mit der internen Form stat/data kompatibel.

• Das Anforderungs-Timeout kann über HANDAAS_REQUEST_TIMEOUT konfiguriert werden, Standardwert 30 Sekunden.

Umgebungsanforderungen

• Python 3.10+

• Abhängigkeiten: mcp, python-dotenv, requests

Lokaler Schnellstart

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

Standardadresse des Dienstes: http://127.0.0.1:8000/mcp. Unterstützt stdio, sse und streamable-http.

Umgebungsvariablen

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

Echte Anmeldedaten dürfen nur in der lokalen .env-Datei oder in Bereitstellungsschlüsseln gespeichert werden.

Cursor / Cherry Studio-Konfiguration

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

Verfügbare Tools und Product IDs

Empfohlener Aufrufablauf

1. Rufen Sie research_report_search auf, um Berichte zu suchen und den Kandidatenkreis einzugrenzen.

2. Bestätigen Sie den Zielbericht anhand von Titel, Institution, Branche, Typ und Veröffentlichungsdatum.

3. Verwenden Sie die reportId aus dem Ergebnis, um research_report_detail aufzurufen und vollständige Metadaten sowie Quellenlinks zu erhalten.

Detaillierte Tool-Beschreibung

1. research_report_search

Wann verwenden: Wenn der Benutzer Berichte zu einer bestimmten Branche, einem Unternehmen, einem Thema, einer Institution oder innerhalb eines Zeitraums suchen möchte.

Wichtige Parameter: rpKeyword durchsucht Berichtstitel; rpOrgName durchsucht den vollständigen Namen oder die Kurzbezeichnung der Institution; rpCalIndustryList und rpType dienen der präzisen Filterung; das Datumsformat ist YYYY-MM-DD; pageSize maximal 50.

Rückgabebeschreibung: Gibt Berichtstitel, Institution, Veröffentlichungsdatum, Branche, Typ und reportId zurück; der Berichtstext als Datei wird nicht zurückgegeben.

2. research_report_detail

Wann verwenden: Wenn der Zielbericht bereits bestätigt wurde und Institution, Branche, Typ, Veröffentlichungsdatum und Quellenlink benötigt werden.

Wichtige Parameter: reportId muss aus dem Ergebnis von research_report_search stammen.

Rückgabebeschreibung: Gibt Berichtsmetadaten sowie das Quellenlink-Feld zurück; das Tool kauft, lädt, öffnet oder analysiert keine PDF-Dateien.

Verwendungsbeispiele

Beispiel 1: Suche nach Branchenforschungsberichten

Suchen Sie nach Branchenforschungsberichten zum Thema künstliche Intelligenz, die 2026 veröffentlicht wurden, und geben Sie zunächst 10 Ergebnisse zurück.

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

Beispiel 2: Abfrage von Berichtsdetails

Zeigen Sie die veröffentlichende Institution, Branchenklassifizierung, das Veröffentlichungsdatum und den Quellenlink des zuvor ausgewählten Berichts an.

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

Hinweise zur Verwendung

1. Für Details muss die reportId aus den Suchergebnissen verwendet werden.

2. Das Startdatum darf nicht später als das Enddatum sein.

3. Das Tool gibt nur Quellenlink-Metadaten zurück; es öffnet, kauft, lädt oder analysiert keine Berichtsdateien.

4. Die Standpunkte in den Berichten gehören der ursprünglich veröffentlichenden Institution und repräsentieren nicht die Position des MCP-Dienstes.

Test und Validierung

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

Unit-Tests verwenden Mock-Antworten; die echte Validierung erfolgt über den Aufruf des HandaaS Integrator Gateway über die lokale .env-Datei.