Guotai Haitong Lingxi Research Report Search

Problem Statement

In agent workflows, fetching brokerage research reports often encounters issues like scattered data sources, complex API authentication, and cross-platform execution failures (especially with Windows Shell incompatibilities). The Lingxi Research Report Search Skill from Guotai Haitong Securities encapsulates research retrieval into a standardized agent skill, addressing unstructured data fetching and multi-environment adaptation.

Core Capabilities & Mechanics

The Skill operates via the MCP gateway, featuring:
- Report Search: Retrieves macro strategy and in-depth industry reports from Guotai Haitong Institute using the search-research-report tool.
- Unified Authentication: Supports QR code or API key authorization. On first invocation, the agent checks gtht-entry.json for key status. If missing or expired, it generates a cloud authorization link or directs users to the official APP to obtain the key.
- Cross-Platform Execution: Enforces node skill-entry.js for underlying logic to bypass native Shell discrepancies. In Windows PowerShell, it strictly requires ; instead of && and disables Unix-specific commands, ensuring consistency across Linux, macOS, and Windows.

Boundaries & Caveats

• Service Limits: The Skill strictly covers Guotai Haitong's official research data. Out-of-scope queries trigger a hard block, directing users to the official channels.
• File Access Boundary: The authorization file is restricted to the Skill directory and the adjacent shared folder; reading external configurations is prohibited.
• State Synchronization: After scanning the QR code, the agent must wait for the user's explicit confirmation before executing the poll loop to prevent asynchronous state misjudgment.