技能介绍

要解决什么问题

在写研报、盯盘或核对公告时，你往往需要在南方财经侧查股票相关报道与公司披露，而不是在通用网页里碰运气。手工翻站点、拼搜索词，还容易把「按代码查资讯」和「按关键词搜全文」混成一条链路，结果漏公告或命中无关新闻。

sfc-news 是南财数据技能族里的资讯子技能，把资讯搜索、最新文章、股票资讯、公司公告（含公告详情）收敛到一组 REST 接口，并约定鉴权、分页与输出目录，方便在 Agent 或 OpenClaw 工作流里稳定调用。

核心能力与调用逻辑

技能按场景划分接口优先级，文档明确要求：查某只股票的消息时，优先走 stock_articles（/rest/theme/stock/articles），而不是泛化的 search。

| 场景 | 要点 |
|------|------|
| 股票资讯 | 关键词为股票代码；stockCode 需带市场后缀（如 300274.SZ） |
| 公司公告 | secuCode 为证券代码，不带 .SZ/.SH 后缀 |
| 公告详情 | 用公告列表返回的 id 调详情接口 |
| 资讯搜索 | 关键词必填，适合行业或公司名等模糊检索 |
| 最新文章 | 无需关键词，请求头为 Authorization: Bearer |

Token 统一从 skills/sfc-news/config.json 读取，请求头格式为 {"token": "YOUR_TOKEN"}，也可用环境变量 SFC_TOKEN。401 或未登录类错误统一提示检查 config.json 中的 token。实现侧还包含 HTML 清理、中文关键词 URL 编码、30 秒超时，以及文本/JSON 双格式输出；生成文件默认落在 ~/.openclaw/workspace/nancai/，命名形如 {类型}_{主题}_{日期}.md。

边界与注意点

代码格式别混用：stock_articles 要后缀，company_notice 不要后缀；技能会对代码做去后缀等处理，但入参仍应按文档区分。
分页：列表量大时用 pageNo/pageSize，避免一次拉满。
模块配合：行情可结合 sfc-quote，主题资讯可结合 sfc-theme，与 sfc-data 系列共用同一 token。
搜索降级：只有在你确实需要关键词全文检索时才用 search；个股动态仍以 stock_articles 为准。