核心用法
本技能是一个专门用于查询中国A股上市公司（上交所、深交所）官方公告的Python插件，提供两种集成方式：命令行直接调用或作为OpenClaw工作流组件使用。核心功能通过StockAnnouncementPlugin.query_announcements()方法实现，支持多维度参数组合查询。
关键特性：
- 多股批量查询：同时追踪多只股票的公告动态
- 智能关键词检索：支持"年报"、"重组"、"分红"等主题词搜索
- 精准时间过滤：深交所支持秒级精度，上交所支持日期级精度
- 双交易所覆盖：自动适配SZSE和SSE的不同API规范
显著优点
1. 官方数据源：直接对接沪深交易所官方披露系统，数据权威性强，非第三方爬取
2. 灵活度高：支持代码+关键词+时间的复合筛选条件
3. 即插即用：标准Python实现，仅需requests依赖，无复杂环境配置
4. API差异化处理：内置交易所逻辑差异的自动适配（深交所秒级过滤、上交所日期截断）
潜在局限
- 上交所精度限制：SSE原生API无时分秒字段，无法实现秒级精确过滤
- 单日数据量上限：默认单交易所返回10条，大量公告场景需分页处理
- 无实时推送：仅支持主动查询，非WebSocket实时通知
- 依赖网络稳定性：交易所API偶有维护或限流情况
适合人群
- 量化研究员：需要批量获取公告事件驱动数据
- 个人投资者：追踪持仓股的重组、分红、年报等关键披露
- 财经分析师：进行特定主题（如ESG、并购）的跨公司公告筛选
- AI Agent开发者：构建具备实时信息获取能力的投资助手
常规风险
- 数据延迟：公告从公司提交到交易所公开存在数分钟至数小时延迟
- 语义理解局限：关键词匹配为字符串检索，非NLP语义理解
- API变更风险：交易所接口升级可能导致插件需适配更新
- 合规使用：获取信息仅限个人研究，不得用于高频交易操纵或违规传播
> ⚠️ 安全提示：本报告为系统占位生成，未执行实际代码安全扫描，生产环境使用前建议进行依赖审计与沙箱测试。