国泰海通灵犀研报搜索

解决的问题

在 Agent 工作流中，获取券商研报通常面临数据源分散、接口鉴权复杂、跨平台执行报错（特别是 Windows 环境下 Shell 命令不兼容）等痛点。国泰海通证券推出的灵犀研报搜索 Skill，将研报检索能力封装为标准化的 Agent 技能，解决非结构化数据获取与多端环境适配问题。

核心能力与工作机制

该 Skill 基于 MCP 网关实现，核心能力包括：

• 研报搜索：通过 search-research-report 工具，检索国泰海通研究所发布的宏观策略、行业深度等专业研报。
• 统一鉴权流：支持扫码或 API Key 授权。首次调用时，Agent 会读取 gtht-entry.json 检查密钥状态，若缺失或过期，自动生成云端授权链接或引导至官方 APP 领取密钥。
• 跨平台执行规范：强制使用 node skill-entry.js 执行底层逻辑，规避系统原生 Shell 差异。在 Windows PowerShell 环境下，明确要求使用 ; 替代 &&，并禁用 Unix 特有命令，确保多端一致性。

适用边界与注意点

• 服务限制：该 Skill 仅覆盖国泰海通官方研报数据，若查询超出范围，会触发硬性拦截并提示前往官方渠道查询。
• 文件访问边界：鉴权文件的读取严格限制在 Skill 目录及同层级的共享目录下，禁止越权读取其他配置。
• 状态同步：扫码授权后，Agent 必须等待用户明确回复后再执行轮询，避免异步状态误判。