| name | announcement-subscription |
| version | 1.0.0 |
| description | 深交所公告订阅推送服务，支持按公司、类别订阅上市公司公告，并通过邮件/钉钉/飞书实时推送结构化提取结果 |
| homepage | http://39.104.68.74:8452 |
| metadata | {"api_base":"http://39.104.68.74:8452","api_key":"mk_6b06aedefda608f513dd02599ff04c56"} |
announcement-subscription
深交所公告订阅推送服务，支持按公司、类别订阅上市公司公告，并通过邮件/钉钉/飞书实时推送结构化提取结果。
Base URL: http://39.104.68.74:8452
API Key: mk_6b06aedefda608f513dd02599ff04c56
当前订阅配额： 免费版（最多 3 个类别订阅）
快速开始
查看我的订阅列表
curl "http://39.104.68.74:8452/api/v1/subscriptions?page=1&page_size=20" \
-H "X-API-Key: mk_6b06aedefda608f513dd02599ff04c56"
查看可订阅的类别
curl "http://39.104.68.74:8452/api/v1/subscriptions/available-categories" \
-H "X-API-Key: mk_6b06aedefda608f513dd02599ff04c56"
创建新订阅
curl -X POST "http://39.104.68.74:8452/api/v1/subscriptions" \
-H "X-API-Key: mk_6b06aedefda608f513dd02599ff04c56" \
-H "Content-Type: application/json" \
-d '{
"sub_type": "category",
"notify_method": "email",
"notify_target": "lihanghang@memect.co",
"category_code": "人事变动",
"category_name": "人事变动"
}'
删除订阅
curl -X DELETE "http://39.104.68.74:8452/api/v1/subscriptions/{subscription_id}" \
-H "X-API-Key: mk_6b06aedefda608f513dd02599ff04c56"
订阅类型 (sub_type)
| 类型 | 说明 | 配额消耗 |
|---|
company | 订阅某公司所有已开放类别 | 1 |
category | 订阅所有公司的某类别 | 1 |
company_category | 精准订阅某公司某类别 | 1 |
daily_digest | 每日聚合推送 | 不消耗配额 |
通知方式 (notify_method)
| 方式 | 说明 | 参数格式 |
|---|
email | 邮件推送 | 邮箱地址 |
dingtalk | 钉钉机器人 | Webhook URL |
feishu | 飞书机器人 | Webhook URL |
常用操作
1. 订阅某类别的所有公告
订阅所有公司的"董事会决议"公告，推送到飞书：
curl -X POST "http://39.104.68.74:8452/api/v1/subscriptions" \
-H "X-API-Key: mk_6b06aedefda608f513dd02599ff04c56" \
-H "Content-Type: application/json" \
-d '{
"sub_type": "category",
"notify_method": "feishu",
"notify_target": "https://open.feishu.cn/open-apis/bot/v2/hook/YOUR_WEBHOOK_URL",
"category_code": "ctb_company_0081",
"category_name": "董事会决议"
}'
2. 订阅某公司的所有公告
订阅"平安银行"的所有公告，推送到邮件：
curl -X POST "http://39.104.68.74:8452/api/v1/subscriptions" \
-H "X-API-Key: mk_6b06aedefda608f513dd02599ff04c56" \
-H "Content-Type: application/json" \
-d '{
"sub_type": "company",
"notify_method": "email",
"notify_target": "lihanghang@memect.co",
"company_code": "000001",
"company_name": "平安银行"
}'
3. 每日聚合推送
每天早上 9:00 收取昨日公告汇总：
curl -X POST "http://39.104.68.74:8452/api/v1/subscriptions" \
-H "X-API-Key: mk_6b06aedefda608f513dd02599ff04c56" \
-H "Content-Type: application/json" \
-d '{
"sub_type": "daily_digest",
"notify_method": "email",
"notify_target": "lihanghang@memect.co",
"digest_time": "09:00"
}'
4. 查看可订阅公司
curl "http://39.104.68.74:8452/api/v1/subscriptions/available-companies?keyword=平安&page=1&page_size=20" \
-H "X-API-Key: mk_6b06aedefda608f513dd02599ff04c56"
可订阅类别
当前支持以下 14 个类别：
| 类别代码 | 类别名称 | 准确率 |
|---|
| 人事变动 | 人事变动 | 97.73% |
| 业绩预告 | 业绩预告 | 98.66% |
| O_临时公告_股票交易异常波动 | 股票交易异常波动 | 100% |
| O_临时公告_变更证券简称 | 变更证券简称 | 100% |
| O_临时公告_召开业绩说明会 | 召开业绩说明会 | 97% |
| 核心技术人员离职 | 核心技术人员离职 | 100% |
| 业务资格获批 | 业务资格获批 | 100% |
| O_临时公告_用募集资金置换预先投入的自筹资金 | 用募集资金置换预先投入的自筹资金 | 95.3% |
| O_临时公告_变更会计师事务所 | 变更会计师事务所 | 100% |
| O_临时公告_中标候选人公示 | 中标候选人公示 | 96.88% |
| O_临时公告_取消重大资产重组并复牌 | 取消重大资产重组并复牌 | 100% |
| O_临时公告_重大资产重组终止 | 重大资产重组终止 | 95% |
| O_临时公告_应当披露交易的提示 | 应当披露交易的提示 | 98.03% |
| O_临时公告_股票交易风险提示 | 股票交易风险提示 | 97.29% |
当前订阅状态
我的订阅（2026-03-05）
配额使用情况
- 免费版配额： 3 个类别订阅
- 当前使用： 3 个（订阅 #6, #4, #3）
- 每日聚合： 不消耗配额（订阅 #8）
- 风险提示订阅： 需要释放配额或升级
响应格式
成功响应
{
"code": 200,
"message": "查询成功",
"data": {
"total": 6,
"page": 1,
"page_size": 20,
"items": [...]
}
}
错误响应
{
"detail": "关键词订阅配额已用完 (5/3)，当前等级: free"
}
注意事项
⚠️ 重要提示：
- 配额限制： 免费版最多 3 个类别订阅
- 删除机制： 订阅删除为软删除（is_active = false），可能不立即释放配额
- 重复订阅： 重复订阅会返回错误
- 推送重试： 推送失败会自动重试（最多 3 次）
- 更新限制： 某些字段（如 notify_method）可能无法通过 API 更新
💡 最佳实践：
- 建议先查询可订阅类别和公司列表
- 测试时可使用邮件方式，生产环境推荐使用机器人
- 钉钉/飞书机器人需要配置加签密钥以提高安全性
- 使用
daily_digest 汇总推送，避免过于频繁的通知
对接建议
1. 集成到 OpenClaw
创建 Python 包装脚本，方便通过自然语言调用：
import requests
import json
import sys
API_BASE = "http://39.104.68.74:8452"
API_KEY = "mk_6b06aedefda608f513dd02599ff04c56"
def get_headers():
return {"X-API-Key": API_KEY, "Content-Type": "application/json"}
def list_subscriptions():
"""查看所有订阅"""
response = requests.get(
f"{API_BASE}/api/v1/subscriptions?page=1&page_size=20",
headers=get_headers()
)
return response.json()
def create_subscription(sub_type, notify_method, notify_target, category_code=None, category_name=None, company_code=None, company_name=None, digest_time=None):
"""创建订阅"""
data = {
"sub_type": sub_type,
"notify_method": notify_method,
"notify_target": notify_target
}
if category_code:
data["category_code"] = category_code
data["category_name"] = category_name
if company_code:
data["company_code"] = company_code
data["company_name"] = company_name
if digest_time:
data["digest_time"] = digest_time
response = requests.post(
f"{API_BASE}/api/v1/subscriptions",
headers=get_headers(),
json=data
)
response.json()
():
response = requests.delete(
,
headers=get_headers()
)
response.json()
():
response = requests.get(
,
headers=get_headers()
)
response.json()
():
params = {: page, : page_size}
keyword:
params[] = keyword
response = requests.get(
,
headers=get_headers(),
params=params
)
response.json()
__name__ == :
result = list_subscriptions()
(json.dumps(result, indent=, ensure_ascii=))
2. 日常使用场景
用户可以直接说：
- "帮我查看订阅列表"
- "订阅人事变动公告到邮件"
- "删除订阅 #7"
- "看看有哪些类别可以订阅"
- "搜索平安银行"
3. Webhook 集成
飞书机器人：
- 在飞书群设置 → 添加群机器人
- 获取 Webhook URL
- 使用订阅 API 创建订阅
钉钉机器人：
- 在钉钉群设置 → 智能群助手 → 添加机器人
- 获取 Webhook URL
- 配置加签密钥（推荐）
- 使用订阅 API 创建订阅
故障排查
配额已用完
问题： detail: "关键词订阅配额已用完 (5/3)，当前等级: free"
解决方案：
- 删除不需要的订阅
- 使用
daily_digest 汇总推送（不消耗配额）
- 联系服务方升级套餐
订阅删除后配额未释放
问题： 删除订阅后仍提示配额已用完
可能原因： 软删除机制，配额未立即释放
解决方案：
- 等待一段时间后重试
- 联系服务方手动清理
- 尝试更新订阅而不是删除
无法更新 notify_method
问题： 更新订阅时 notify_method 字段无变化
解决方案：
- 删除订阅后重新创建
- 联系服务方确认 API 限制
技术支持
更新记录
- 2026-03-05: 初始版本，集成公告订阅推送 API
