南方财经研报检索

要解决什么问题

在 Agent 或自动化流程里查券商研报时，常见痛点是：各家终端接口不统一、返回里文件名带空格或全角空格导致下载链接失效，以及终端直接吐 URL 不利于在对话里阅读。本技能面向南方财经终端的研报检索接口，把「多条件查询 + 可点击的 Markdown 结果」收敛成固定流程。

技能如何工作

技能调用 https://terminal.sfccn.com/terminal/sfc-search/api/v1/sprite/searchReport，支持按 report_title、report_source、report_author、report_type 以及 startDate / endDate 分页检索。鉴权与主技能共用 config.json。

统一输出流程大致是：

• 对 filename 去掉普通空格与全角空格后再做 quote(..., safe='/') 编码
• 与 COS 基址拼接成下载地址，并把残留空格替换为 %20
• 以 Markdown 渲染：【序号】标题、引用行里的机构/分析师/日期/类型/页数，以及「点击下载研报」超链接（不裸露纯文本 URL）

本地落盘规则：生成文件写入 ~/.openclaw/workspace/nancai/，命名形如 {类型}_{主题}_{日期}.md 或 .png。命令行侧还支持 --brief、--json、--top N 等输出形态。

对话里出现「研报」「研究报告」「券商报告」等词，或「公司名 + 研报」「机构名 + 研报」等模式时，会按规则映射到标题/机构搜索；带日期表述时会尝试解析时间范围。

适用边界与注意点

• 依赖南方财经终端 API 可用性与账号配置，网络超时、JSON 解析错误会走技能内错误处理，但不能替代终端侧的权限与配额。
• 输出刻意避免 HTML 标签与裸 URL，若你的下游只接受纯链接文本，需改用 --json 或自行解析 Markdown。
• 分页从 pageNo=0 起算，默认列表规模与排序由 pageSize、sort 参数决定，大批量抓取应自行控制频率与页数。