Report CLI

研报工具

触发示例

以下说法会触发此 skill：

行业研报：

• "帮我查一下近一个月的半导体行业研报，只看 10 页以上的"
• "游戏行业研报有哪些，按页数排个序"
• "光伏设备最近有什么新研报"
• "医药商业和生物制品行业对比一下"
• "帮我看看有哪些行业可以查"

个股研报：

• "下载茅台最新的 3 份个股研报"
• "宁德时代最近有什么研报，只看买入评级的"
• "000858 最近一年的研报"
• "比亚迪和特斯拉的研报对比"

策略 / 宏观 / 晨报：

• "最近有没有看好新能源车的策略报告，给我看摘要"
• "宏观研究最近有什么新观点"
• "今天的券商晨报说了什么"
• "去年下半年的策略报告，只看买入评级的"

下载：

• "把这 3 篇下载到 ./reports 目录"
• "下载第 1、3、5 篇的 PDF"
• "下载今天所有的券商晨报"

核心原则

全部操作通过 HTTP 完成，无需安装任何 CLI。

日期处理

• beginTime = 固定 2025-01-01（覆盖足够长的时间范围）
• endTime = 系统当前日期（从系统上下文获取，动态计算），格式 YYYY-MM-DD
• 用户明示日期范围时，以用户指定的为准

一、查询研报列表 — API 端点

行业研报（GET，用 WebFetch）

https://reportapi.eastmoney.com/report/list?pageSize=20&pageNo=1&beginTime=2025-01-01&endTime={今天}&qType=1&industryCode=1046&industry=*&rating=*

industry=* 和 rating=* 为可选参数。若返回结果为空，尝试去掉这两个参数重试。

个股研报（POST，必须用 bash curl）

WebFetch 不支持 POST 请求，个股研报查询必须用 bash curl。

curl -s -X POST https://reportapi.eastmoney.com/report/list2 \
  -H "Content-Type: application/json" \
  -d '{"pageSize":20,"pageNo":1,"beginTime":"2025-01-01","endTime":"{今天}","code":"600519"}'

股票代码格式：

沪市 6 开头（600519 贵州茅台），深市主板 0 开头（000858 五粮液），创业板 3 开头（300750 宁德时代）。输入时传 6 位纯数字，不加交易所前缀。

若用户输入的是股票名称而非代码（如"帮我查茅台"），Claude 应凭常识转换为代码；不确定时向用户确认。

策略 / 宏观 / 晨报（GET，用 WebFetch）

https://reportapi.eastmoney.com/report/jg?pageSize=20&pageNo=1&beginTime=2025-01-01&endTime={今天}&qType={qType}

响应关键字段

评级对照

二、按页数筛选

API 返回的 attachPages 字段即研报页数。

• 行业和个股研报: attachPages 直接在 JSON 里，直接筛选
• 策略 / 宏观 / 晨报: API 不返回 attachPages，需访问详情页后根据正文长度判断

默认跳过 ≤ 2 页的研报（通常无实质内容）。用户可指定阈值，如"只看 10 页以上的"。

attachPages 为 null 或缺失时，视为未知页数。默认暂不跳过，标记为"页数未知"供用户自行判断。

三、获取摘要 — 详情页

URL 拼接

用 API 返回的 encodeUrl 字段，拼到对应 URL 模板：

若详情页返回 404，对 encodeUrl 值做 URL 百分号编码后再拼接。不同工具对应：JS encodeURIComponent()、Python urllib.parse.quote()、bash 可调 python3 -c "import urllib.parse; print(urllib.parse.quote('VALUE'))"。

页面提取规则

用 WebFetch 访问详情页后：

四、下载 PDF

步骤

1. 拿 PDF 链接：从详情页提取。URL 格式：

   https://pdf.dfcfw.com/pdf/H3_AP202505251678987843_1.pdf?1748207582000.pdf
   

2. 下载到本地（跨平台 curl）：

   curl -L -o "研报标题.pdf" \
     -A "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36" \
     "https://pdf.dfcfw.com/pdf/H3_XXX.pdf"
   

   • -L: 跟随重定向
   • -o: 指定保存路径
   • -A: 设置 User-Agent 绕过反爬
   • macOS / Linux 自带 curl，Windows 10+ 内置 curl

3. 校验文件：确保下载的是真 PDF 而非拦截页面。

   head -c 4 "研报标题.pdf"    # 应输出: %PDF
   

4. 文件命名：用研报标题做文件名，去除 \/:*?"<>| 等非法字符，最长 100 字符。

频率控制

• API 查询间隔 ≥ 1 秒
• PDF 下载间隔 ≥ 2 秒
• 单次会话下载不超过 10 份，避免 IP 被临时封禁

五、Agent 工作流

查研报列表 + 页数过滤

1. 行业/策略/宏观/晨报 → WebFetch 调 GET API；个股 → bash curl POST API
2. 拿 JSON，过滤 attachPages > 2（或用户指定阈值）
3. 列出：序号 + 标题 + 券商 + 日期 + 页数 + 评级
4. 评级含义参考评级对照表，向用户解释
5. 问用户想看哪篇的摘要

看摘要

1. 用 encodeUrl 拼详情页 URL
2. WebFetch 访问，提取正文前 800 字
3. 总结核心观点呈现给用户
4. 问是否需要下载完整 PDF

下载 PDF

1. 从详情页提取 PDF 链接（优先 CSS 选择器，备用正则匹配）
2. curl -L -o 下载到用户指定目录
3. 校验文件是否为真 PDF

策略 / 宏观 / 晨报筛选（无 attachPages）

1. WebFetch /jg API → JSON
2. 取前 5 条的 encodeUrl（避免请求过多），逐篇 WebFetch 详情页
3. 按正文长度过滤（< 500 字 → 1-2 页，跳过）
4. 输出摘要 → 按需下载

六、行业代码速查

注意事项

• 不支持港股研报
• 频率控制详见第四节
• 数据仅供学习研究使用

作者 & 开源

• 作者: manymore13
• 开源地址: github.com/manymore13/report-cli
• 许可: MIT License