核心用法
该技能提供中国A股上市公司公告查询能力,覆盖深交所(SZSE)与上交所(SSE)两大官方信息披露平台。核心功能包括:
- 单股/批量查询:支持传入股票代码列表(如
["000001", "600000"])获取指定公司公告 - 关键词搜索:可通过
keyword参数筛选特定主题公告(如"年报"、"重组"、"分红") - 时间范围过滤:支持精确到秒的时间区间查询(
YYYY-MM-DD HH:MM:SS格式),便于追踪特定时段的披露事件
技术实现上,技能封装为StockAnnouncementPlugin类,既可作为独立CLI脚本直接调用,也可集成至OpenClaw工作流中供Agent自动调用。输出为标准JSON格式,便于下游处理。
显著优点
1. 官方数据源:直接对接沪深交易所信息披露平台,数据权威性高,非第三方聚合或爬虫转存
2. 灵活的时间精度:深交所支持秒级二次过滤,满足对披露时效敏感的场景(如追踪收盘后紧急公告)
3. 低依赖部署:仅依赖标准requests库,无复杂环境配置要求
4. 双模式调用:兼顾开发者CLI调试需求与Agent自动化集成场景
潜在局限与风险
| 维度 | 说明 |
|------|------|
| **交易所差异** | 上交所原生API仅支持日期级别检索,无时分秒字段,秒级过滤对SSE数据无效 |
| **结果数量限制** | `limit`参数控制单交易所返回上限,批量查询需注意分页逻辑 |
| **API稳定性** | 依赖交易所官方接口,存在因对方服务调整导致临时不可用的风险 |
| **数据覆盖** | 仅限A股主板市场,不含北交所、新三板等其他板块 |
适合人群
- 量化研究员/基金经理:需要程序化获取公告事件驱动数据
- 财经媒体/投研分析师:批量追踪特定主题(如并购重组)的市场动态
- 个人投资者:快速检索持仓股票的最新披露信息
风险提示
- T+0延迟:公告从公司提交到交易所审核发布存在时间差,非实时推送
- 信息解读风险:原始公告文本需专业金融知识解读,技能仅提供数据获取能力
- 合规使用:查询结果仅限个人研究使用,禁止用于未经授权的自动化交易或数据再分发