南财金融搜索

要解决的问题

金融数据检索往往分散在多个系统里——股票、债券、基金、研报、舆情、宏观指标各有各的查询入口。做投研或数据聚合时，为每个数据源写一套调用逻辑既重复又难以维护。这个技能把南财金融搜索引擎的 14 个搜索类别统一到一个接口后面，让 Agent 用关键词就能跨类别检索。

核心能力

• 14 个搜索类别：覆盖主题、股票、债券、资讯、快讯、舆情、综合、公司、基金、产品、研报、研报图片、EDB 指标、指数，通过 category 参数切换。
• 统一的请求格式：GET 请求到 https://terminal.sfccn.com/terminal/rest/esSearch/searchkey/page，认证走 Token Header，核心参数只有 keyword 和 category 两个必填项。
• 灵活的分页：多数类别用 pageNo 和 pageSize 翻页，pageSize 建议不超过 50；主题库（Category 1）则用 lastId 参数，传入上一页最后一个 id 继续翻页。
• 结构化返回：每个类别有明确的字段文档，高亮文本带 <em> 标签，时间戳为秒级 Unix 格式，需要后续处理。

使用注意点

• 返回文本中的高亮标签需要手动去除或替换，否则拼接到 Markdown 或对话里会有多余的 <em> 标签残留。
• 资讯和快讯的 date_updated 是秒级时间戳，直接展示需要先转换为可读日期。
• Category 7 综合搜索返回的是 dict，每个子类别有独立的 total 和 list，不能当成单一列表处理。
• Token 配置有优先级：环境变量 SFC_TOKEN → ~/.openclaw/identity/sfc_token → skills/sfc-search/config.json 中的 api_key，配置错误会直接返回认证失败。