Skip to content
Skills Library
Finance & accounting · Research

report-cli

/report-cli

研报查询下载工具。当用户需要查询、下载、分析行业研报、个股研报、策略报告、宏观研究、券商晨报时使用此 skill。

Repository
report-cli ↗
Licence
MIT
Last repository change
25.05.2026

Assessment and security

96/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability21 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
12
Deprecation

No signals detected. Repository changed on 25.05.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

研报查询下载工具。当用户需要查询、下载、分析行业研报、个股研报、策略报告、宏观研究、券商晨报时使用此 skill。

Original author description

研报查询下载工具。当用户需要查询、下载、分析行业研报、个股研报、策略报告、宏观研究、券商晨报时使用此 skill。

How it works

  1. 触发示例
  2. 核心原则
  3. 日期处理
  4. 一、查询研报列表 — API 端点
  5. 二、按页数筛选
  6. 三、获取摘要 — 详情页
  7. 四、下载 PDF
  8. 五、Agent 工作流
  9. 六、行业代码速查
  10. 注意事项
Original SKILL.md headings · 299 lines, 1,093 words
SKILL.md preview
---
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。**

```bash
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):
   ```bash
   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 而非拦截页面。
   ```bash
   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](https://github.com/manymore13)
- 开源地址: [github.com/manymore13/report-cli](https://github.com/manymore13/report-cli)
- 许可: MIT License

Versions

The database has no other skills named report-cli.

Database snapshot: 13.11.2026 · package version 7599f9c80535 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 96report-cli-simple
    研报查询下载工具(CLI版)。当用户需要查询、下载行业研报、个股研报、策略报告、宏观研究、券商晨报时使用此 skill。
  • 100broker-research-analyst
    券商研报分析助手,聚焦"研报获取→结构化提取→多机构观点对比→风险识别→决策辅助"。使用时机:汇总个股券商研报、追踪行业研报、对比多机构观点、识别卖方利益冲突、验证研报时效性。默认数据源为东方财富研报中心公开接口(无需 API Key)。
  • 100commodity-research-outlook
    撰写遵循卖方券商惯例的大宗商品专业研究报告与投资建议,涵盖能源、金属及农产品,输出机构级的展望报告、交易建议、主题投资演示或研究报告,支持PDF、DOCX和PPTX格式。当用户请求撰写大宗商品市场展望、构建交易建议、制作研究报告,或提及大宗商品价格预测、供需分析、宏观投资主题等关键词时触发。
  • 100consulting-report-search
    Consulting and industry report search and QA skill that prioritizes iResearch free reports. Use for consulting report search, industry report QA, iResearch report lookup, and market research report search.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.