# Stock Reports

> 查询 A 股研报列表。按 stock-code 查询个股历史，或按 type 与日期范围查询；page 和 page-size 必填。

- Skill: `ftshare-lab/stock-reports` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add ftshare-lab/stock-reports`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ftshare-lab/stock-reports/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: FTShare-Lab (https://skillmd.com/u/ftshare-lab)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ftshare-lab/stock-reports

---


# 研报列表

外部接口：`GET /api/v2/market/data/report/stock-reports`。

支持两种模式：

- 按个股查询：`--stock-code`，`--type` 可省略，传入时必须为 `StockReport`。
- 按类型和日期查询：不传 `--stock-code` 时，必须提供 `--type` 与 `--start-date`；`--end-date` 可省略，日期范围最多 3 天。

`--page` 与 `--page-size` 必填。返回 `code`、`message` 和分页 `data`，记录含研报评级、研究机构、研究员及用于下载正文的 `url_hash`。所有请求必须设置 `FTSHARE_API_KEY`，缺失凭据时不会发起请求。

```bash
python <RUN_PY> stock-reports --stock-code 600036.SH --page 1 --page-size 20
python <RUN_PY> stock-reports --type MacroReport --start-date 20260821 --page 1 --page-size 20
```