data-acquisition

name	data-acquisition
description	A股市场数据采集、清洗和交叉验证服务。 负责获取个股行情、财务报表、宏观指标，并进行多源交叉验证和置信度标注。 当需要以下操作时触发： - 获取A股个股的实时行情、历史K线 - 拉取上市公司财务报表（利润表/资产负债表/现金流量表） - 获取宏观经济指标数据 - 验证数据的准确性和可信度 由 financial-analysis-cn、equity-research-cn、macro-analysis-cn 等 Skill 调用。 通常不直接由用户触发，由其他 Skill 在数据采集阶段调用。

数据采集 Skill

A股市场数据采集基础设施，提供多源数据获取、交叉验证和置信度评级。

---

数据源层次

🥇 AkShare（东方财富/新浪）  — 主力：行情+财报+宏观，覆盖最广，完全免费
    ↓ 失败
🥈 Baostock（证券宝）        — 备用：历史行情稳定可靠
    ↓ 失败
🥉 Tushare Free（社区）      — 第三备选：日限200次
    ↓ 全部失败
📦 缓存 + ⚠️ 降级警告

🔍 yfinance（Yahoo Finance）  — 仅用于交叉验证关键指标，不作数据源
   注意：A股数据不稳定，偏差>5%以AkShare为准

---

采集能力

个股数据

运行 scripts/fetch_stock.py {代码} 获取：

• 实时行情快照（价格、PE、PB、市值、行业）
• 历史K线（支持日/周/月，前/后复权）
• 返回 JSON 含 data + metadata（source、confidence、timestamp）

财报数据

运行 scripts/fetch_financial.py {代码} 获取：

• 利润表 / 资产负债表 / 现金流量表（近5年）
• 自动计算衍生指标（毛利率、净利率、ROE、ROA、资产负债率等）
• 3年营收/净利润 CAGR

宏观数据

运行 scripts/fetch_macro.py 获取：

• GDP、CPI、PPI、M2、PMI、LPR
• 北向资金、国债收益率

交叉验证

运行 scripts/data_validator.py {代码} --fields close,pe,pb 验证：

• 偏差 ≤5% → confidence: high
• 偏差 >5% → confidence: medium（以AkShare为准，标注偏差）
• yfinance无数据 → confidence: acceptable（单源，可使用）

---

数据输出格式

每条数据必须包含：

{
  "value": 1735.5,
  "source": "akshare:stock_zh_a_spot_em",
  "source_origin": "东方财富",
  "timestamp": "2026-03-22T15:00:00+08:00",
  "cross_validated": true,
  "validation_source": "yfinance",
  "deviation": 0.018,
  "confidence": "high"
}

---

接口参考

详见 references/api-catalog.md