SuperAPI AI 工具集

financial-data

数据与分析

查看项目

更新于 10-15 09:28

技能介绍

用途

本规范适用于所有涉及企业财务数据的研究。其核心目标是保证财务数据的可靠性:每个关键数据必须来自两个独立来源,误差超过 1% 须标记。

数据源优先级

美股(PDD、腾讯ADR、网易ADR等)

  • 优先级1(主):macrotrends,URL 为 macrotrends.net/stocks/charts/{ticker},直接访问,无需注册。
  • 优先级2(副):stockanalysis,URL 为 stockanalysis.com/stocks/{ticker}/financials,直接访问,无需注册。
  • 原始一手:SEC EDGAR,URL 为 sec.gov/cgi-bin/browse-edgar,10-K / 10-Q 原文。

港股(腾讯0700、网易9999、美团3690等)

  • 优先级1(主):aastocks,URL 为 aastocks.com/tc/stocks/analysis/company-fundamental,直接访问。
  • 优先级2(副):macrotrends(ADR代码),腾讯用 TCEHY,网易用 NTES,直接访问。
  • 原始一手:HKEX披露易,URL 为 hkexnews.hk,年报PDF。

A股(三七互娱、吉比特等)

  • 优先级1(主):东方财富,eastmoney.com → 搜股票代码 → 财务报表,直接访问。
  • 优先级2(副):巨潮资讯,cninfo.com.cn,原始年报/季报PDF。

台股(台积电2330、联发科2454、大立光3008等)

  • 优先级1(主):FinMind API,api.finmindtrade.com,使用 tools/twstock_data.py(零依赖脚本)。
  • 优先级2(副):Goodinfo台湾股市资讯网,goodinfo.tw/tw/StockDetail.asp?STOCK_ID={代码},直接访问。
  • 原始一手:公开资讯观测站(MOPS),mops.twse.com.tw,财报原文/月营收公告。

FinMind 取数工具(分析台股时优先调用,输出自带市值验算):

python3 tools/twstock_data.py quote 2330        # 最新行情 + PER/PBR/殖利率 + 市值验算
python3 tools/twstock_data.py valuation 2330    # 估值指标 + PER一年区间 + 52周高低
python3 tools/twstock_data.py financials 2330   # 近5年年度核心财务(营收/毛利率/归母净利/EPS/ROE)
python3 tools/twstock_data.py revenue 2330      # 近13个月月营收及同比
python3 tools/twstock_data.py dividend 2330     # 近年股利政策(现金/股票股利、除息日)
python3 tools/twstock_data.py search 台積        # 搜索股票代码(注意台股名称为繁体)

台股特别注意:

  • 货币单位是新台币(TWD),与港币/人民币/美元混排时必须显式标注,跨市场对比先统一换算。
  • 月营收是台股独有优势:上市柜公司每月10日前强制披露上月营收,是跟踪基本面拐点最快的公开信号,earnings-review/thesis-tracker 类分析应优先利用(revenue 子命令)。
  • FinMind 损益表为单季值,工具已自动加总为年度值;不足4季的年份会标注"仅前N季累计"。
  • FinMind 未注册可直接用(有小时级限额)。注册后的 API token 只存本机、严禁提交到 git,工具按优先级自动读取:①环境变量 FINMIND_TOKEN;②本地文件 local/finmind_token.txt(local/ 已被 .gitignore 永久排除,把 token 单独一行写入该文件即可)。token 不得出现在报告、skill、commit 中。
  • 交叉验证:FinMind 数值与 Goodinfo(或 macrotrends 上的 ADR,如 TSM)对照,误差规则同下;台积电等有 ADR 的公司注意 ADR 与台股原股的汇率/存托比率差异(1 TSM ADR = 5 股 2330)。

执行规范

第一步:获取数据

对每个财务指标(收入、净利润、毛利率、经营现金流、资产负债率等),分别从来源1和来源2取数。

第二步:误差计算与标记

误差率 = |来源1数值 - 来源2数值| / 来源1数值 × 100%

  • ≤ 1%:一致,取来源1数值,标注两个来源。
  • 1% ~ 5%:标记"数据存在差异",注明两个数值,说明可能原因(汇率/会计口径)。
  • 5%:标记"数据存在重大差异",必须查原始财报核实,不得直接使用。

第三步:数据呈现格式

每个关键数据必须按以下格式标注:

收入:1,239亿元 ✅
  - macrotrends: 1,241亿元
  - stockanalysis: 1,237亿元
  - 误差: 0.3%

差异示例:

净利润:245亿元 ⚠️ 数据存在差异
  - macrotrends: 245亿元(GAAP)
  - stockanalysis: 278亿元(Non-GAAP)
  - 误差: 13.5% — 原因:会计口径不同(GAAP vs Non-GAAP)

常见差异原因(不一定是数据错误)

  • GAAP vs Non-GAAP:最常见,尤其是利润类数据。
  • 汇率换算:港币/人民币/美元换算时间点不同。
  • 财年定义:自然年 vs 财年(如苹果财年10月结束)。
  • 合并口径:是否含少数股东权益。
  • 数据更新滞后:某平台尚未更新最新一期财报。

特别规则

  • 未上市公司(米哈游、莉莉丝等):只有一手数据来源时,数据前标记 [估计],不执行交叉验证。
  • 季度数据 vs 年度数据:优先使用年度数据做交叉验证,季度数据部分来源可能有滞后。
  • 原始财报优先:若两个来源均与原始财报(10-K/年报PDF)不符,以原始财报为准,标记来源错误。

股价与复权(历史序列必读)

价格有三种口径,混用会让历史股价位置、长期涨幅、历史估值分位全部失真:

  • 不复权:实际成交价,除权除息日跳空;仅用于"当前时点"快照。
  • 前复权:以最新价为基准回调历史价;历史股价对比、N年涨幅、历史PE band 一律用它。
  • 后复权:以上市首日为基准前推;计算历史总回报/年化收益。

规则:

  • 涉及历史价格的分析统一用前复权,且同一分析内不得混用复权与不复权来源。
  • 当前市值/当前PE 用当前实际股价 × 当前总股本即可,与复权无关——复权只影响历史序列。
  • 跨越拆股/大比例送转的每股指标(历史EPS、历史股价),必须复权还原后再同比。
  • 总回报/年化收益需计入分红(后复权已含),只看价格涨幅会低估。
  • 增发/回购后市值验算以最新总股本为准(financial_rigor.py verify-market-cap 偏差>5% 会提示核对)。

快速索引

  • PDD / 拼多多:主要来源 macrotrends.net/stocks/charts/PDD,备用 stockanalysis.com/stocks/pdd。
  • 腾讯:主要来源 macrotrends.net/stocks/charts/TCEHY,备用 aastocks(0700.HK)。
  • 网易:主要来源 macrotrends.net/stocks/charts/NTES,备用 aastocks(9999.HK)。
  • 三七互娱:主要来源 eastmoney.com(002555),备用 cninfo.com.cn。
  • 吉比特:主要来源 eastmoney.com(603444),备用 cninfo.com.cn。
  • Nintendo:主要来源 macrotrends.net/stocks/charts/NTDOY,备用 stockanalysis.com/stocks/ntdoy。
  • Capcom:主要来源 macrotrends(CCOEY),备用 stockanalysis(CCOEY)。
  • 台积电:主要来源 tools/twstock_data.py(2330),备用 goodinfo.tw / macrotrends(TSM,注意1 ADR=5股)。
  • 联发科:主要来源 tools/twstock_data.py(2454),备用 goodinfo.tw。

使用方式与限制

该技能以规范文档形式提供,配合仓库中的 tools/ 工具使用。执行前需运行 date 命令确认当天日期,作为"最新"数据的基准,并在报告头部说明数据截止日期,不得依据训练数据假设当前日期。研究质量规则要求交叉核对财务数据、使用精确算术工具进行估值/数学计算,并清楚标注不确定性与来源缺口。关于该技能的收费、价格、平台支持范围等,资料暂未提供。