mcpField
C
china-clean-data-xls

china-clean-data-xls

github.com/jwangkun数据与数据库87572 次安装6 周前更新
代码仓库

关于 china-clean-data-xls

用于清理和规范化 A 股财务数据的技能,面向建模与分析工作。它覆盖单位统一、CAS 项目映射、异常数据处理及报表勾稽检查。

主要功能

  1. 01提取财报及附注数据
  2. 02统一单位、期间与币种
  3. 03映射 CAS 科目至建模分类
  4. 04标记重述及非经常性项目
  5. 05检查资产负债表与现金流勾稽

适用场景

  1. 01将巨潮披露数据整理为建模输入
  2. 02统一不同期间和单位的财务数据
  3. 03检查财务报表数据完整性与一致性

MCP 相关

支持通过 Wind MCP、iFind MCP 或 AkShare MCP 获取财务数据,并可配置数据源优先级。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/jwangkun/claude-for-financial-services-cn --skill china-clean-data-xls

安装后在 Claude Code 中输入/china-clean-data-xls确认已加载。

详细介绍

china-clean-data-xls

目的

清洗和标准化 A 股财务数据 — 为建模和分析准备来自巨潮公告的原始财务数据。

数据来源

Tier 0 — 万得 Wind(最全面的付费数据)
  • 覆盖范围:A 股/港美股/基金/指数/债券/宏观/研报/分析(44 个工具)
  • MCP 服务:wind-mcp(需要以 ak_ 开头的 WIND_API_KEY 密钥)
  • 优势:全市场覆盖范围最广、数据最全面,包含研报和量化分析
  • 申请密钥:https://aifinmarket.wind.com.cn/#/home
Tier 1 — 同花顺 iFind(付费精准数据)/ AkShare MCP(Tier-2 免费备选)
get_financials(ticker, "income")     → Raw income statement
get_financials(ticker, "balance")    → Raw balance sheet
get_financials(ticker, "cashflow")   → Raw cash flow statement
次要来源
  • 巨潮 — 原始公告(PDF/HTML)
  • 审计报告 — 经审计的数据

工作流

第 1 步:数据提取

从源文档中提取:

文档关键数据格式
资产负债表资产、负债、权益千元
利润表收入、费用、利润千元
现金流量表经营、投资、筹资现金流千元
报表附注详细明细文本/数字
审计报告审计意见、调整文本

提取检查清单:

  • 提取所有期间的数据(通常为 3-5 年)
  • 如有需要,提取季度数据
  • 提取上年同期比较数据
  • 记录附注和脚注
第 2 步:标准化单位

单位标准化:

问题解决方案
千元 vs 万元 vs 元统一为万元
报告日期不同对齐到同一期间末
分部数据映射到统一的分部
货币全部使用 CNY

单位换算:

From 千元: divide by 10 → 万元
From 元: divide by 10,000 → 万元
From 亿元: multiply by 10,000 → 万元
第 3 步:处理 CAS 特有项目

CAS 与 IFRS 映射:

CAS 项目对应项目备注
营业收入收入扣除增值税
营业成本销售成本包含增值税
税金及附加税费及附加城建税、教育费附加
销售费用销售及管理费用(销售)
管理费用管理费用
研发费用研发费用新 CAS 中与管理费用分列
财务费用利息及财务成本
投资收益投资收益包含联营/合营企业
公允价值变动公允价值变动
信用减值损失信用减值新 CAS 22
资产减值损失资产减值
资产处置收益资产处置
营业外收入营业外收入包含政府补助
营业外支出营业外支出
所得税费用所得税
净利润净利润
归母净利润归属于母公司的净利润关键指标
扣非净利润非 GAAP 净利润
第 4 步:修复常见数据问题

常见问题及修复方法:

问题检测方法修复方法
缺失期间数据存在缺口标记并手动补全
重述数据脚注中注明“重述”使用最新的重述数据
分部重分类附注披露映射到新的分部
一次性项目金额较大或异常的项目标记以便标准化
关联方标注关联交易识别并量化
会计变更会计政策变更说明调整可比数据
错误合计不符调查并更正
第 5 步:收入明细

按类型划分的收入:

类型CAS 项目备注
主营业务收入核心收入主营业务
其他业务收入其他收入附属业务
合计总收入

按地区划分的收入(如有披露):

地区本年度上年度增长率
国内
海外
合计
第 6 步:费用标准化

标准化非经常性项目:

项目处理方式
资产处置收益/损失从经营业务中剔除
政府补助(非经常性)剔除或单独说明
诉讼/罚款剔除
减值(一次性)剔除或标准化
并购相关费用剔除

调整后指标:

调整后营业收入 = 营业收入 - 其他业务收入
调整后营业成本 = 营业成本 (core only)
调整毛利率 = 调整后毛利 / 调整后收入
步骤 7:清理资产负债表

资产负债表映射:

CAS 项目建模类别
货币资金现金及现金等价物
交易性金融资产短期投资
应收票据应收票据
应收账款应收账款
预付款项预付款项
其他应收款其他应收款
存货存货
其他流动资产其他流动资产
长期股权投资长期投资
固定资产不动产、厂房及设备
在建工程在建工程
无形资产无形资产
商誉商誉
长期待摊费用递延费用
其他非流动资产其他非流动资产
短期借款短期债务
应付票据应付票据
应付账款应付账款
合同负债合同负债
应付职工薪酬应计薪酬
应交税费应交税费
其他应付款其他应付款
一年内到期非流动负债一年内到期的长期债务
长期借款长期债务
应付债券应付债券
预计负债预计负债
递延所得税负债递延所得税负债
其他非流动负债其他非流动负债
股本股本
资本公积资本公积
盈余公积留存收益(法定)
未分配利润留存收益
归属于母公司股东权益母公司权益
少数股东权益少数股东权益
步骤 8:质量检查

数据质量检查清单:

检查项通过标准
资产负债表平衡资产 = 负债 + 权益
现金流量勾稽现金流量 = 期末现金 - 期初现金
收入匹配与分部数据交叉核对
税费合理税费 / 税前利润约为 25%
折旧摊销一致折旧与摊销 / 不动产、厂房及设备稳定
利息匹配利息 / 债务合理

中国特有的数据问题

常见问题
问题示例修正方法
单位不一致有些以千元计,有些以元计统一单位
会计政策变更收入确认方式变更调整可比数据
报表格式变化新增报表项目映射到旧格式
追溯调整前期报表重述使用重述后的数据
外币报表子公司以美元计价折算为人民币
CAS 特定处理
项目CAS 处理
研发费用必须费用化(通常不得资本化)
政府补助总额法与净额法
股份支付在归属期内费用化
保险合同CAS 25(如适用)

质量检查

将数据传入建模流程前:

  • 所有期间数据完整
  • 单位已统一
  • 资产负债表平衡
  • 现金流量勾稽
  • CAS 项目映射正确
  • 已标记非经常性项目
  • 已应用重述调整
  • 已记录质量问题

数据源模式切换:设置环境变量 IFIND_DATA_SOURCE_MODE 以控制数据源优先级。

  • ifind-only(严格):仅使用 iFind,不可用时则报错
  • ifind-fallback(默认):优先使用 iFind,回退到 AkShare
  • akshare-only:跳过 iFind,仅使用 AkShare
  • wind-only:仅使用 Wind,不可用时则报错
  • wind-fallback:优先使用 Wind,回退到 iFind → AkShare

评论

支持 Markdown