Apocdata

天启至数 ApocData — A 股数据服务

让 AI 读懂 A 股公告。 全市场公告解析为结构化数据：AI 摘要（summary）、 类型（category）、重要性（importance）、情感倾向（sentiment），条条可溯源（url）； 并覆盖行情、财务、资金流、龙虎榜、宏观等 45+ 数据接口。 免费体验额度开箱即用，注册解锁更高额度与更多能力。 支持 WorkBuddy / Codex / Hermes / DeepSeek / Kimi / 千问 / 智谱清言等所有 Agent。

安装

bashCopy code
# v2.0.5 多文件结构（推荐）
mkdir -p ~/.claude/skills/apocdata
curl -sL https://gitee.com/apocdata/ApocData-skill/repository/archive/v2.0.5.tar.gz \
  | tar xz -C ~/.claude/skills/apocdata --strip-components=1

重启 Claude Code 后自动生效。

基础用法

所有接口均为 HTTP GET，用 curl 直接调用：

bashCopy code
BASE="https://www.apocdata.com/api/blade-dataplatform/open/data"

# 查单只股票行情
curl -s "$BASE/quote?symbol=000001"

# 查股票基本信息（含 PE/PB/市值）
curl -s "$BASE/stock?symbol=000001"

OpenAPI 3 接入（GPT Actions / Coze / Dify / n8n / Zapier）

spec 的 servers.url 已内置为公网基址，导入后各接口路径直接拼接即可调用，无需再改 base。

免费体验额度，无需注册即可调用；注册解锁更高额度与更多数据能力。

场景速查（按用户意图找接口组合）

拿到自然语言意图时，优先查本表选定接口组合，再去参考文件看字段细节，避免漏调或乱调。

接口分组总览

全部 45 个活跃业务接口按使用场景分 11 组（/news 已下线）。详细参数和返回字段见对应的参考文件。

参考文件导航

根据用户需求，读取对应的参考文件获取完整接口细节：

全局规则（优先读取）

接口字典（按主题按需加载）

示例与场景

调用工作流

1. 收到用户意图 → 先查上方「场景速查表」确定接口组合
2. 首次调用前 → 读取 references/boundaries.md 了解 limit 上限和参数易错点
3. 需要具体端点参数/返回字段 → 按场景速查表指向的组别，读取对应 references/group-*.md
4. 生成分析输出前 → 读取 references/safety-rules.md 遵守强制行为规则
5. 简单查询（如「查下茅台行情」）→ 只需场景速查表 + group-a-quote.md，无需加载全部文件

关键约束速记（调任何接口前先扫一眼）

limit 上限（超限静默截断，不报错）

参数易错点

• 枚举参数优先用英文：sector-flow?type=industry/concept/region
• 中文关键字必须 URL 编码：用 curl -G --data-urlencode "q=年报"
• symbol vs tsCode：A 股 symbol=000001（6 位）；指数 tsCode=000300.SH；可转债 stkCode=688535.SH
• 日期参数按接口区分：calendar 使用 start/end；announcements 使用 startDate/endDate（可单独传入，也兼容旧版 start/end 别名）。日期格式均为 YYYYMMDD
• 错误响应：HTTP 400 + success=false + X-Tdc-Error-Code header；先检查状态再读 data
• 不存在 symbol：返回 RESOURCE_NOT_FOUND，先用 stocks 搜索确认
• 公告空结果需复核：announcements 的成功空数组可能是批次尚未完成或临时故障，不代表公告被删除；先看 X-Tdc-Freshness-*，再用日期窗口和 q 复查

完整 header 说明、错误码表、缓存策略、Freshness SLA、fields 裁剪、compact 模式等详见 references/boundaries.md。

注意事项

• 所有接口只读；免费体验额度无需注册即可调用，注册解锁更高额度与更多数据能力
• symbol 统一 6 位数字代码；指数/可转债用带后缀的 tsCode
• 单次请求超时建议 10 秒；复杂画像优先并发调用
• 收盘后 quote 价格已是最终收盘价：盘后 quote 返回 official close（与 daily 偏差 0.000%），as_of 可能显示 14:57 但价格准确，可放心使用；仅盘中（09:30-15:00）quote 为 15min 延迟快照
• 空数据需结合场景判断：success=true + 空数组可能是数据稀疏，也可能是批次尚未完成；公告和概念接口应检查 trade_date / updated_at 并适当重试
• token 紧张时：用 ?fields= 裁剪 + ?format=compact 紧凑模式，可省 60-90% token
• 小模型（<15B）：用 references/SKILL-compact.md（~3KB 精简版）代替全文注入，避免关键信息被淹没
• 输出分析必须标注数据时效（trade_date / delayed_minutes / Freshness header）
• 数据来源：天启云（ApocData Cloud），公告 T+0 08:00，北向 20:00

金融输出安全约束（摘要）

完整规则见 references/safety-rules.md。以下为 6 条强制规则摘要：

1. 数据时效透明 — 每次输出必须显示 trade_date / delayed_minutes
2. 数据来源分层 — 区分原始数据、AI 摘要、模型推断
3. 异常数据约束 — success=false 或关键字段缺失时停止确定性结论
4. 交叉验证 — 关键数据至少两个来源确认
5. 禁止买卖指令 — 严禁"买入/卖出/必涨/稳赚"等确定性表述
6. 免责声明 — 每次输出末尾注明"仅供研究参考，不构成投资建议"