wwcai-audit-data

#wwcai-audit-data · 财审数据 Skill

一站式查询 A 股上市公司三张财务报表、审计信息、市场统计、人民币汇率、敏感词检测。共 8 个 API。昵称「娃娃菜」（取自 wwcai 谐音）。

#何时使用本 Skill

查某公司财报（资产/负债/利润/现金流）、对比多家公司财务数据、查审计信息或市场统计、查人民币汇率、检测文本敏感词。

#运行时规则

API Key 获取：优先读环境变量 WWCAI_API_KEY；若取不到，按匿名调用（限 50 次/天，按 IP）。所有需要认证的端点通过 HTTP Header 携带 Authorization: Bearer <key>。Key 的获取与保存方法见下方「API Key：申请、配置与配额」节。

Base URL：https://wwcai.cn

公司名 → 股票代码：用户常用公司名（如"贵州茅台"），需先映射为 6 位代码（茅台=600519、五粮液=000858、宁德时代=300750 等）。若不确定代码，向用户确认或要求提供 6 位代码。

fields 参数：三张报表返回字段很多（资产负债表约 148 项、利润表约 75 项、现金流约 66 项）。主动用 fields 指定用户关心的字段以减少返回量和 token 消耗，不要默认拉全量。完整字段表见 references/api-balance-sheets.md 等。

typrep 报表类型：A=合并报表（默认），B=母公司报表。不传 typrep 时同时返回合并与母公司两组数据（结构为 {consolidated, parent}），通常不需要这行为，建议显式传 typrep=A 只取合并报表以精简返回。

对比类请求：查多家公司同一指标时，分别发请求并各带 fields，然后聚合对比，不要一次性拉全字段。

配额与错误处理：429（超额）→ 告知用户次日 0 点重置；提示免费注册 https://wwcai.cn/register 申请 Key 可提升配额（具体额度以 /api/quota 实时返回为准）。401 → 提示 Key 未配置或无效。400 → 检查 stkcd/accper 等必填参数。404 → 该公司/报告期数据不存在。

结果呈现：返回中文 JSON，默认以表格或要点方式呈现关键字段，避免直接倾倒原始 JSON。报告期数据仅含半年报（06-30）和年报（12-31）。

敏感词检测：开放接口无需 Key，按 IP 限流 60 次/分钟。

#端点速查（决策树 + 字段提示）

按用户意图路由到端点。每个端点的完整参数表、返回字段表、curl/Python/Node.js 示例、响应示例在对应 references/api-*.md 里，需要时再读取，避免一次性占用上下文。API 总览（接口表/配额/通用错误码）见 references/README.md。

#各端点要点与关键字段

1. 资产负债表 balance-sheets — 必填 stkcd（6 位）、accper（YYYY-MM-DD）；可选 typrep（A 合并默认 / B 母公司）、fields（中文字段名逗号分隔）。常用字段：资产总计、负债合计、所有者权益合计、货币资金、存货净额、应收账款净额。 示例意图：查贵州茅台 2024 年报的资产总计和负债合计。

2. 利润表 income-statements — 必填 stkcd、accper；可选 typrep、fields。常用字段：营业收入、营业成本、营业利润、利润总额、净利润。 示例意图：五粮液 2024 年的净利润和营业收入。

3. 现金流量表 cash-flow-statements — 必填 stkcd、accper；可选 typrep、fields。常用字段：经营活动产生的现金流量净额、投资活动产生的现金流量净额、筹资活动产生的现金流量净额、现金及现金等价物净增加额。 示例意图：宁德时代 2024 年经营活动现金流。

4. 审计信息 audit-info — 必填 code（6 位）；可选 year、page、limit（≤20）。返回 { data:[...], pagination:{page,limit,total,totalPages} }。判断审计风险优先看 is_clean（布尔，是否标准无保留意见）与 severity（0-4，0 最干净）；另有 opinion_code（如 AO_UNQUALIFIED）、audit_firm（事务所）、signing_cpas（签字 CPA）、ic_opinion/ic_firm（内控审计）、audit_fee（元）、report_date。注意 stock_code 带交易所后缀（如 600519.SH）。 示例意图：600519 近 5 年审计意见，有没有换过事务所。

5. 审计数据统计 audit-stats — 可选 dimension（overview 默认 / opinions / firms / fees / cpas / ic_opinions / switches）、year、top。返回 { dimension, data:[...] }，data 结构随维度变化（预聚合物化视图，毫秒级响应）。 示例意图：2024 年事务所市占率 Top 10。

6. 人民币汇率 fx-rates — 用 latest=1 取最新交易日全部币种；或用 filter[date][_eq] / filter[pair][_eq] / filter[currency][_eq]（仅这 3 种 filter 有效，其他透传参数会被忽略）；另有 sort（默认 -date）、limit（默认 30，上限 500）、fields。返回 data[]，字段 rate_mid（1 外币兑人民币，已统一换算）、official_rate（外管局公告原值）、currency、pair、date。覆盖 25 种货币、1994 年至今，来源中国外汇交易中心。 示例意图：今天美元和欧元兑人民币汇率分别是多少。

7. 配额查询 quota — 无参数。返回 tier（public / basic / advanced / pro / admin）、limit、used、remaining、resetAt（每日 00

8. 敏感词检测 sensitive-check — 必填 text（≤10000 字符）。开放接口无需 Key，按 IP 限流 60 次/分钟。返回 contains（布尔，是否包含敏感词）、count（数量）、categories（分类数组，如广告/色情/政治）、matches（命中详情，每项含 word 与 categories）。 示例意图：检测这段文本是否包含敏感词。

#错误码

#安装与更新

安装：对话中输入「请帮我安装 https://wwcai.cn/skills/wwcai-audit-data.zip 这个skill」，安装后重启 AI 工具。

更新：对话中输入「请帮我更新 wwcai-audit-data skill」。

在线调试：https://wwcai.cn/api

#API Key：申请、配置与配额

#申请

注册 https://wwcai.cn/register → 登录后 https://wwcai.cn/me → 「API Key」生成。

#配置（保存 Token）

拿到 Key 后，存为用户级环境变量 WWCAI_API_KEY：所有终端与 AI 工具（opencode 等）均可读取，重启后持久。skill 运行时会优先读该变量；读不到则按匿名调用（限 50 次/天）。

主推：Windows 用户级环境变量（持久、跨终端、跨工具）。

PowerShell（推荐）：

[Environment]::SetEnvironmentVariable("WWCAI_API_KEY","你的Key","User")

cmd：

setx WWCAI_API_KEY "你的Key"

生效：关闭并重开所有终端 / 重启 AI 工具；已在运行的终端不会自动刷新。

验证（任选其一）：

echo $env:WWCAI_API_KEY                                       # 当前终端能读到
[Environment]::GetEnvironmentVariable("WWCAI_API_KEY","User") # 用户级持久值

或调用 /api/quota：返回 tier != public 即说明 Key 已生效。

安全提示：

• 切勿将 Key 写入 git 仓库、截图或转发他人；若用 .env 等文件保存，务必加入 .gitignore。
• Key 一旦泄露，可在 https://wwcai.cn/me 重新生成，旧 Key 立即失效。

常见排错：

• 401、或配额仍是 50/天 → 多为终端未重开 / 变量名拼错（必须全大写 WWCAI_API_KEY）/ 误用会话级 set 而非持久 setx。
• 跨平台备注：macOS / Linux 可写入 ~/.zshrc 或 ~/.bashrc：export WWCAI_API_KEY="你的Key"，随后 source 对应文件使其生效。

#配额

等级（按自然日 00

#版本

v1.5 · 2026-07 · 按 skill-creator 标准重构：入口标准化为 SKILL.md，新增 references/ 渐进披露层（直接复用官方 9 份 API 文档，含完整字段表与多语言示例）；SKILL.md 精简为决策树 + 运行规则 + references 指针。对齐官方 API 文档修正：补 404 错误码、管理员「无限制」配额、敏感词 contains 字段、audit-info 的 opinion_code/stock_code 交易所后缀/pagination 结构、fx-rates 的 limit 上限 500 与 sort 默认值。

v1.4 · 2026-07 · skill 更名为 wwcai-audit-data、分发改为 zip、新增「API Key 配置（保存 Token）」节、安装/更新命令与自指全部对齐新名。

v1.3 · 2026-07 · 对齐实际配额（50/200/400/800，以 /api/quota 实时为准）、补 typrep 默认行为、fx-rates filter 语法与字段、audit-info 推理字段、413/503 错误码、429 Retry-After。