研报搜索 Skill

这个 skill 面向 Claude Code 和 OpenClaw，默认使用本 skill 自带脚本。

运行脚本时，脚本路径要相对当前 SKILL.md 所在目录解析，不要假设当前工作目录正好在 skill 目录内。

何时使用

• - 用户要搜索券商研报、行业报告、公司深度、宏观策略、财报、招股书
• 用户给了关键词、作者、机构、时间范围等过滤条件
• 用户已经选中某篇研报，想看摘要、正文、结论或风险提示

运行方式

1. 搜索研报

优先运行：

bash
python3 scripts/search_reports.py 人工智能 --json

常见参数：

• - --author 张三，可重复传多次
• --org 中信证券，可重复传多次
• --time last7day|last1mon|last3mon|last1year
• --start-date 2025-01-01 --end-date 2025-03-31
• --size 10

不要把相对时间自行换算后塞进 endtime；脚本会按 fxbaogaomcp 的方式把 last1mon 这类值原样传给接口。

2. 获取研报详情

当用户指定序号或 doc_id 后，运行：

bash
python3 scripts/getreportcontent.py 5288801 --json

工作流

1. 1. 解析用户条件，只提取用户明确表达的关键词、机构、作者、时间范围。
2. 先运行 scripts/searchreports.py ... --json。
3. 向用户展示最相关的 5 到 10 条结果，必须保留 docid、机构、日期和链接。
4. 用户要求深入某篇时，再运行 scripts/getreportcontent.py DOCID --json。
5. 详情回答时优先使用 summarysections，再按需引用 content 中的正文段落。

JSON 输出字段

搜索结果

search_reports.py --json 返回：

• - total
• reports[]
• 每个 report 含 docid、title、orgname、authors、publishdate
• reporturl、detail_url
• snippets

详情结果

getreportcontent.py --json 返回：

• - docid、title、orgname、authors、publishdate
• reporturl、detailurl
• summarysections
• summary
• content
• raw_content

回复约定

• - 搜索结果先给列表，再等用户选择具体报告
• 不要伪造不存在的作者、机构、日期或摘要
• 引用详情时优先总结 summarysections，不要直接整段倾倒长正文
• 如果结果很多，先展示前几条，并告知用户可以继续筛选机构、作者或时间
• 用户如果想打开 PDF，统一引导到 https://www.fxbaogao.com/view?id=DOCID，不要返回 public.fxbaogao.com 直链
• 如果运行时出现网络或 DNS 错误，明确告诉用户当前环境需要放行外网访问 api.fxbaogao.com 和 www.fxbaogao.com
• 如果运行时出现本机 Python 证书链错误，可提示用户临时加上 FXBAOGAOSSLNO_VERIFY=1 重试，但不要默认关闭 SSL 校验

常用命令示例

bash
python3 scripts/search_reports.py 人工智能 --time last1mon --json
python3 scripts/search_reports.py 半导体 --org 中信证券 --org 华泰证券 --size 20 --json
python3 scripts/search_reports.py 新能源 --start-date 2025-01-01 --end-date 2025-03-31 --json
python3 scripts/getreportcontent.py 5288801 --json

更多示例见 examples/sample.md。