Chinese Stock Announcements (SZSE & SSE)
这个技能用于查询中国A股上市公司（上交所、深交所）的官方信息披露与公告。它可以作为独立脚本供人类或大模型使用，也可以作为 OpenClaw 插件直接集成在 Python 代码中。
使用场景
- 用户需要查询某只特定股票（如平安银行 000001、浦发银行 600000）的最新公告时。
- 用户想批量追踪多只股票的动向时。
- 用户想通过关键词（如"年报"、"重组"、"分红"）来搜索两市所有相关的公告时。
- 用户需要限定特定的时间范围（精确到时分秒）来过滤公告时。
工作流程
当用户请求查询股票公告时，大模型应该直接调用本项目提供的 stock_plugin.py 脚本来获取数据，并格式化输出给用户。
方式一：命令行/脚本直接调用 (CLI)
你可以直接执行 Python 代码来调用该模块：
# 例子：查询包含关键词且在指定时间内的公告
python3 -c "
import json
from stock_plugin import StockAnnouncementPlugin
plugin = StockAnnouncementPlugin()
res = plugin.query_announcements(
keyword='年报',
start_date='2024-03-15 00:00:01',
end_date='2024-03-16 00:00:01',
limit=5
)
print(json.dumps(res, indent=2, ensure_ascii=False))
"
方式二：在 OpenClaw 工作流中调用 (Python 代码编写)
如果用户要求你编写一段使用该功能的 OpenClaw 代码，你可以按照以下方式组织代码：
from openclaw2 import OpenClaw
from stock_plugin import StockAnnouncementPlugin
# 初始化 OpenClaw 客户端
client = OpenClaw.remote(api_key="your_api_key")
# 安装股票公告查询插件
client.use(StockAnnouncementPlugin())
# 让大模型 Agent 调用插件获取数据
results = client.pipeline([
"请帮我查询 000001 和 600000 从 2024-03-15 00:00:01 到 2024-03-16 00:00:01 发布关于「年报」的公告"
])
print(results[-1])
参数说明
StockAnnouncementPlugin.query_announcements 支持以下参数：
| 参数 | 类型 | 说明 | 示例 |
|---|---|---|---|
stock_codes | List[str] | 股票代码列表（可选） | ["000001", "600000"] |
keyword | str | 搜索关键词（可选） | "年报" |
start_date | str | 起始时间（精确到秒或天） | "2024-03-15 00:00:01" 或 "2024-03-15" |
end_date | str | 结束时间（精确到秒或天） | "2024-03-16 00:00:01" 或 "2024-03-16" |
limit | int | 单个交易所返回的最大结果数 | 10 (默认) |
⚠️ 时间过滤规则注意：
- 深交所 (SZSE)：原生 API 请求体支持传入日期(
YYYY-MM-DD)获取粗略范围，随后通过脚本在本地自动进行精确到时分秒的二次过滤筛选。 - 上交所 (SSE)：原生 API 仅支持日期级别(
YYYY-MM-DD)的检索和返回，所以插件会自动截取传入时间的日期部分进行检索。上交所数据由于没有时分秒属性，不支持秒级精确过滤。
技能资源
stock_plugin.py：核心逻辑文件，包含StockAnnouncementPlugin类及沪深两市的抓取和过滤逻辑。使用标准 requests 库实现，无需复杂环境。
前置条件
需要安装 requests 库：
pip install requests