report-cli

name	report-cli
description	研报查询下载工具。当用户需要查询、下载、分析行业研报、个股研报、策略报告、宏观研究、券商晨报时使用此 skill。
author	manymore13
license	MIT
repository	https://github.com/manymore13/report-cli

研报工具

触发示例

以下说法会触发此 skill：

行业研报：

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

个股研报：

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

策略 / 宏观 / 晨报：

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

下载：

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

核心原则

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

操作	方式
行业 / 策略 / 宏观 / 晨报查询	WebFetch → GET 请求 API（返回 JSON）
个股研报查询	bash curl → POST 请求 API（WebFetch 不支持 POST）
看摘要 / 页数	WebFetch → 详情页（提取正文）
下载 PDF	WebFetch 拿 PDF 链接 → curl 下载

---

日期处理

• 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=*

参数	说明	示例
pageSize	每页条数，默认 20	20
pageNo	页码，从 1 开始	1
beginTime	开始日期，固定 2025-01-01	2025-01-01
endTime	结束日期，系统当前日期	动态计算
qType	固定 1	1
industryCode	行业代码	1046

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"}'

body 字段	说明	示例
code	6 位股票代码	600519
pageSize	每页条数，默认 20	20
pageNo	页码，从 1 开始	1

股票代码格式：

沪市 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}

类型	qType
策略报告	2
宏观研究	3
券商晨报	4

响应关键字段

字段	含义	接口
data	研报数组	全部
hits	总条数	全部
TotalPage	分页总页数	全部
title	标题	全部
orgSName	券商简称	全部
publishDate	发布日期	全部
emRatingName	评级	全部
encodeUrl	详情页标识（重要）	全部
infoCode	研报编码	list / list2
attachPages	研报页数	list / list2
attachSize	文件大小(KB)	list / list2
stockName	股票名称	list2
industryName	行业名称	list

评级对照

emRatingName	含义
买入	强烈看好
增持	看好
中性	观望
减持	看空
卖出	强烈看空
不评级	仅供参考，无评级

---

二、按页数筛选

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

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

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

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

---

三、获取摘要 — 详情页

URL 拼接

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

研报类型	详情页 URL
行业	https://data.eastmoney.com/report/zw_industry.jshtml?encodeUrl={encodeUrl}
个股	https://data.eastmoney.com/report/zw_stock.jshtml?encodeUrl={encodeUrl}
策略 / 宏观 / 晨报	https://data.eastmoney.com/report/zw_macresearch.jshtml?encodeUrl={encodeUrl}

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

页面提取规则

用 WebFetch 访问详情页后：

目标	提取方式	用途
正文摘要	提取 <p> 标签文本内容，取前 800 字	判断内容质量、呈现核心观点
PDF 下载链接	优先用 a.pdf-link 的 href	下载完整 PDF
PDF 链接（备用）	正则 https://pdf\.dfcfw\.com/pdf/[^\s"'<>]+\.pdf	当 CSS 选择器在 WebFetch 中失效时使用
标题	h1 或页面 title	确认页面正确
页数（策略 / 宏观 / 晨报）	正文字数 < 500 → 推断 1-2 页	补 API 无 attachPages 的缺口

---

四、下载 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. 输出摘要 → 按需下载

---

六、行业代码速查

代码	行业	代码	行业
422	物流	1033	电池
428	电力	1036	半导体
448	通信设备	1037	消费电子
451	房地产开发	1038	光学光电子
457	电网设备	1040	中药Ⅱ
459	元件	1042	医药商业
465	化学制药	1044	生物制品
473	证券Ⅱ	1045	房地产服务
474	保险Ⅱ	1046	游戏Ⅱ
475	银行Ⅱ	1225	服装家纺
481	汽车零部件	1231	航空装备Ⅱ
482	一般零售	1232	航天装备Ⅱ
538	化学制品	1238	IT服务Ⅱ
545	通用设备	1239	白色家电
727	医疗服务	1241	黑色家电
736	通信服务	1250	煤炭开采
737	软件开发	1252	化妆品
738	多元金融	1253	医疗美容
910	专用设备	1257	农业综合Ⅱ
1031	光伏设备	1258	饲料
1032	风电设备	1259	养殖业
1263	摩托车及其他	1277	白酒Ⅱ
1267	造纸	1280	食品加工
1271	酒店餐饮	1281	休闲食品
1282	饮料乳品	1287	工业金属

---

注意事项

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

---

作者 & 开源

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