File contents 查询指定日期全市场股票研报(分页)
接口说明
项目
说明
接口名称
指定日期全市场股票研报
外部接口
/data/api/v1/market/data/announcements/stock-reports(或项目实际 path)
请求方式
GET
适用场景
获取指定交易日全市场 A 股研报列表,支持分页,含研报标题、作者、发布时间、url_hash 等
请求参数
参数名
类型
是否必填
描述
取值示例
备注
start_date
string
是
查询日期,格式 YYYYMMDD,仅支持单日
20241231
-
end_date
string
是
结束日期,单日查询时与 start_date 相同
20241231
-
type
string
是
固定为 stock(或接口约定值)
stock
-
page
int
否
页码,从 1 开始
1
默认 1
page_size
int
否
每页记录数
20
默认 20
执行方式
通过根目录的 run.py 调用(推荐):
python <RUN_PY> stock-reports-all-stocks-specific-date --start-date 20241231 --page 1 --page-size 20
<RUN_PY> 为主 SKILL.md 同级的 run.py 绝对路径,参见主 SKILL.md 的「调用方式」说明。
响应结构
返回带分页的 JSON:
{
"items": [
{
"stock_code": "000001.SZ",
"stock_name": "平安银行",
"announcement_title": "研报标题示例",
"announcement_time": "2026-03-11 16:00:00",
"url_hash": "abc123..."
}
],
"total_pages": 2,
"total_items": 20
}
字段说明(items 元素)
字段名
类型
是否可为空
说明
单位
stock_code
String
否
股票代码,带市场后缀
-
stock_name
String
否
股票名称
-
announcement_title
String
否
研报标题
-
announcement_time
String
否
发布时间
-
url_hash
String
否
用于下载研报 PDF
-
注意事项
日期格式为 YYYYMMDD(如 20241231)
需要下载研报 PDF 时,使用 url_hash 调用 stock-reports-specific-url-hash
需要全量数据时,循环请求直到 page > total_pages
1 --- 2 name: stock-reports-all-stocks-specific-date 3 description: 查询指定日期全市场股票研报(分页) 4 --- 5 # 查询指定日期全市场股票研报(分页) 6 7 ## 接口说明 8 9 | 项目 | 说明 | 10 |---|---| 11 | 接口名称 | 指定日期全市场股票研报 | 12 | 外部接口 | `/data/api/v1/market/data/announcements/stock-reports`(或项目实际 path) | 13 | 请求方式 | GET | 14 | 适用场景 | 获取指定交易日全市场 A 股研报列表,支持分页,含研报标题、作者、发布时间、url_hash 等 | 15 16 ## 请求参数 17 18 | 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 | 19 |---|---|---|---|---|---| 20 | `start_date` | string | 是 | 查询日期,格式 YYYYMMDD,仅支持单日 | `20241231` | - | 21 | `end_date` | string | 是 | 结束日期,单日查询时与 start_date 相同 | `20241231` | - | 22 | `type` | string | 是 | 固定为 stock(或接口约定值) | `stock` | - | 23 | `page` | int | 否 | 页码,从 1 开始 | `1` | 默认 1 | 24 | `page_size` | int | 否 | 每页记录数 | `20` | 默认 20 | 25 26 ## 执行方式 27 28 通过根目录的 `run.py` 调用(推荐): 29 30 ```bash 31 python <RUN_PY> stock-reports-all-stocks-specific-date --start-date 20241231 --page 1 --page-size 20 32 ``` 33 34 > `<RUN_PY>` 为主 `SKILL.md` 同级的 `run.py` 绝对路径,参见主 SKILL.md 的「调用方式」说明。 35 36 ## 响应结构 37 38 返回带分页的 JSON: 39 40 ```json 41 { 42 "items": [ 43 { 44 "stock_code": "000001.SZ", 45 "stock_name": "平安银行", 46 "announcement_title": "研报标题示例", 47 "announcement_time": "2026-03-11 16:00:00", 48 "url_hash": "abc123..." 49 } 50 ], 51 "total_pages": 2, 52 "total_items": 20 53 } 54 ``` 55 56 ### 字段说明(items 元素) 57 58 | 字段名 | 类型 | 是否可为空 | 说明 | 单位 | 59 |---|---|---|---|---| 60 | `stock_code` | String | 否 | 股票代码,带市场后缀 | - | 61 | `stock_name` | String | 否 | 股票名称 | - | 62 | `announcement_title` | String | 否 | 研报标题 | - | 63 | `announcement_time` | String | 否 | 发布时间 | - | 64 | `url_hash` | String | 否 | 用于下载研报 PDF | - | 65 66 ## 注意事项 67 68 - 日期格式为 YYYYMMDD(如 20241231) 69 - 需要下载研报 PDF 时,使用 `url_hash` 调用 `stock-reports-specific-url-hash` 70 - 需要全量数据时,循环请求直到 `page > total_pages`
dvcrn/openclaw-skills-marketplace/tree/main/plugins/shawn92--ftshare-announcement-data/skills/ftshare-announcements-data/sub-skills/stock-reports-all-stocks-specific-date commit 3ca40ae837
Frequently asked questions How do I install the Stock Reports All Stocks Specific Date skill? Run npx skillmds@latest add dvcrn/stock-reports-all-stocks-specific-date in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the Stock Reports All Stocks Specific Date skill do? 查询指定日期全市场股票研报(分页) It is listed under Coding & Dev Tools on SkillMD.
Is Stock Reports All Stocks Specific Date safe to use? This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with Stock Reports All Stocks Specific Date? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is Stock Reports All Stocks Specific Date free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published Stock Reports All Stocks Specific Date? dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.