File contents 查询单只股票所有公告(分页)
接口说明
项目
说明
接口名称
单只股票公告历史
外部接口
/data/api/v1/market/data/announcements/stock-announcements
请求方式
GET
适用场景
获取单只 A 股股票的公告历史列表,支持分页,含公告标题、发布时间、url_hash 等
请求参数
参数名
类型
是否必填
描述
取值示例
备注
stock_code
string
是
股票代码,含市场后缀
000001.SZ
6 位数字 + .SZ/.SH/.BJ
page
int
否
页码,从 1 开始
1
默认 1
page_size
int
否
每页记录数
20
默认 20
执行方式
通过根目录的 run.py 调用(推荐):
python <RUN_PY> stock-announcements-single-stock-all-periods --stock-code 000001.SZ --page 1 --page-size 20
<RUN_PY> 为主 SKILL.md 同级的 run.py 绝对路径,参见主 SKILL.md 的「调用方式」说明。
响应结构
返回带分页的 JSON,结构同「指定日期全市场公告」:
{
"items": [
{
"stock_code": "000001.SZ",
"stock_name": "平安银行",
"announcement_id": "1225004736",
"announcement_title": "公告标题示例",
"announcement_time": "2026-03-11 16:54:28",
"column_type": "stock",
"url_hash": "169f21a0b04aa7291c3a963a8c80542641ea6cd5..."
}
],
"total_pages": 2,
"total_items": 31
}
字段说明(items 元素)
字段名
类型
是否可为空
说明
单位
stock_code
String
否
股票代码,带市场后缀
-
stock_name
String
否
股票名称
-
announcement_id
String
否
公告 ID
-
announcement_title
String
否
公告标题
-
announcement_time
String
否
发布时间
-
column_type
String
否
类型,如 stock
-
url_hash
String
否
用于下载公告 PDF
-
注意事项
股票代码格式:6 位数字 + 市场后缀(SH/SZ/BJ)
需要下载公告 PDF 时,使用 url_hash 调用 stock-announcements-specific-url-hash
1 --- 2 name: stock-announcements-single-stock-all-periods 3 description: 查询单只股票所有公告(分页) 4 --- 5 # 查询单只股票所有公告(分页) 6 7 ## 接口说明 8 9 | 项目 | 说明 | 10 |---|---| 11 | 接口名称 | 单只股票公告历史 | 12 | 外部接口 | `/data/api/v1/market/data/announcements/stock-announcements` | 13 | 请求方式 | GET | 14 | 适用场景 | 获取单只 A 股股票的公告历史列表,支持分页,含公告标题、发布时间、url_hash 等 | 15 16 ## 请求参数 17 18 | 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 | 19 |---|---|---|---|---|---| 20 | `stock_code` | string | 是 | 股票代码,含市场后缀 | `000001.SZ` | 6 位数字 + .SZ/.SH/.BJ | 21 | `page` | int | 否 | 页码,从 1 开始 | `1` | 默认 1 | 22 | `page_size` | int | 否 | 每页记录数 | `20` | 默认 20 | 23 24 ## 执行方式 25 26 通过根目录的 `run.py` 调用(推荐): 27 28 ```bash 29 python <RUN_PY> stock-announcements-single-stock-all-periods --stock-code 000001.SZ --page 1 --page-size 20 30 ``` 31 32 > `<RUN_PY>` 为主 `SKILL.md` 同级的 `run.py` 绝对路径,参见主 SKILL.md 的「调用方式」说明。 33 34 ## 响应结构 35 36 返回带分页的 JSON,结构同「指定日期全市场公告」: 37 38 ```json 39 { 40 "items": [ 41 { 42 "stock_code": "000001.SZ", 43 "stock_name": "平安银行", 44 "announcement_id": "1225004736", 45 "announcement_title": "公告标题示例", 46 "announcement_time": "2026-03-11 16:54:28", 47 "column_type": "stock", 48 "url_hash": "169f21a0b04aa7291c3a963a8c80542641ea6cd5..." 49 } 50 ], 51 "total_pages": 2, 52 "total_items": 31 53 } 54 ``` 55 56 ### 字段说明(items 元素) 57 58 | 字段名 | 类型 | 是否可为空 | 说明 | 单位 | 59 |---|---|---|---|---| 60 | `stock_code` | String | 否 | 股票代码,带市场后缀 | - | 61 | `stock_name` | String | 否 | 股票名称 | - | 62 | `announcement_id` | String | 否 | 公告 ID | - | 63 | `announcement_title` | String | 否 | 公告标题 | - | 64 | `announcement_time` | String | 否 | 发布时间 | - | 65 | `column_type` | String | 否 | 类型,如 stock | - | 66 | `url_hash` | String | 否 | 用于下载公告 PDF | - | 67 68 ## 注意事项 69 70 - 股票代码格式:6 位数字 + 市场后缀(SH/SZ/BJ) 71 - 需要下载公告 PDF 时,使用 `url_hash` 调用 `stock-announcements-specific-url-hash`
dvcrn/openclaw-skills-marketplace/tree/main/plugins/shawn92--ftshare-announcement-data/skills/ftshare-announcements-data/sub-skills/stock-announcements-single-stock-all-periods commit 550b6477a6
Frequently asked questions How do I install the Stock Announcements Single Stock All Periods skill? Run npx skillmds@latest add dvcrn/stock-announcements-single-stock-all-periods 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 Announcements Single Stock All Periods skill do? 查询单只股票所有公告(分页) It is listed under Coding & Dev Tools on SkillMD.
Is Stock Announcements Single Stock All Periods 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 Announcements Single Stock All Periods? 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 Announcements Single Stock All Periods free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published Stock Announcements Single Stock All Periods? dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.