mcpField
F
financial-data

financial-data

github.com/xbtlinデータ・データベース16.9k223 回インストール1 日前に更新
リポジトリ

financial-data について

財務調査のデータ収集、照合、報告を標準化する Codex スキルです。市場別の情報源に加え、台湾株の取得コマンドや株価調整の規則を示します。

主な機能

  1. 01市場別の財務データソース
  2. 02重要指標の二重照合
  3. 03誤差に応じた差異表示
  4. 04台湾株データ取得コマンド
  5. 05過去株価の調整基準

活用シーン

  1. 01企業の財務情報の調査
  2. 02情報源間の指標の照合
  3. 03台湾株データの取得

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/xbtlin/ai-berkshire --skill financial-data

インストール後、Claude Code で/financial-dataを入力して読み込まれたか確認します。

詳細

Codex アダプターに関する注記

このスキルは skills/financial-data.md から生成されており、Claude Code と Codex のユーザーが同じ正式なワークフローを共有できるようにしています。

  • $ARGUMENTS は、現在の Codex スレッドにおけるユーザーのリクエストとして扱ってください。
  • ソースに Task、Agent、WebSearch、Bash、Read、Write など Claude 専用の機能が記載されている場合は、このセッションで利用できる最も近い Codex の機能を使用してください。利用可能であればサブエージェントを使い、必要に応じてウェブ検索を行い、ローカルツールにはシェルコマンドを使い、ワークスペースのファイルは通常のファイル編集で変更してください。
  • このリポジトリの tools/ にある共通プロジェクトツールを使用してください。リポジトリのルートから python3 tools/financial_rigor.py ... のようなパスを指定してコマンドを実行することを推奨します。現在のスレッドがリポジトリ外から始まった場合は、固定のホームディレクトリパスを想定せず、まず実際のチェックアウト先を特定してください。
  • 調査を始める前に date コマンドを実行して今日の日付を確認し、「最新」データの基準として扱い、レポートのヘッダーにデータの基準日を記載してください。トレーニングデータから現在の日付を推測してはいけません。
  • AGENTS.md に記載された調査品質ルールを守ってください。財務データを相互検証し、評価や計算には正確な演算ツールを使用し、不確実性や情報源の不足を明確に示してください。

财务数据获取与交叉验证规范

本规范适用于所有涉及企业财务数据的研究。每个关键数据必须来自两个独立来源，误差>1%须标记。

データソースの優先順位

米国株（PDD、腾讯ADR、网易ADR等）
优先级来源URL获取方式
1（主）macrotrendsmacrotrends.net/stocks/charts/{ticker}直接访问，无需注册
2（副）stockanalysisstockanalysis.com/stocks/{ticker}/financials直接访问，无需注册
原始一手SEC EDGARsec.gov/cgi-bin/browse-edgar10-K / 10-Q 原文
港股（腾讯0700、网易9999、美团3690等）
优先级来源URL获取方式
1（主）aastocksaastocks.com/tc/stocks/analysis/company-fundamental直接访问
2（副）macrotrends（ADR代码）腾讯用TCEHY，网易用NTES直接访问
原始一手HKEX披露易hkexnews.hk年报PDF
A股（三七互娱、吉比特等）
优先级来源URL获取方式
1（主）东方财富eastmoney.com → 搜股票代码 → 财务报表直接访问
2（副）巨潮资讯cninfo.com.cn原始年报/季报PDF
台股（台积电2330、联发科2454、大立光3008等）
优先级来源URL获取方式
1（主）FinMind APIapi.finmindtrade.comtools/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 台積        # 搜索股票代码（注意台股名称为繁体）

台湾株に関する特記事項：

  1. **通貨単位はニュー台湾ドル（TWD）**です。香港ドル／人民元／米ドルと混在させる場合は必ず明示し、市場をまたいで比較する前に通貨を統一してください
  2. 月次売上高は台湾株独自の強みです：上場企業は毎月10日までに前月の売上高を開示する義務があり、ファンダメンタルズの転換点を追ううえで、最も速く利用できる公開シグナルです。earnings-review/thesis-tracker 系の分析では優先的に活用してください（revenue サブコマンド）
  3. FinMind の損益計算書は単四半期の値です。ツールは自動的に年間の値を合計します。4四半期に満たない年には「前N四半期分のみの累計」と表示されます
  4. FinMind は登録なしで直接使用できます（時間単位の制限があります）。登録後の API token はローカルマシンにのみ保存し、git へのコミットは厳禁です。ツールは次の優先順位で自動的に読み込みます：①環境変数 FINMIND_TOKEN、②ローカルファイル local/finmind_token.txt（local/ は .gitignore で恒久的に除外されています。このファイルに token を1行で記入してください）。token をレポート、skill、commit に記載してはいけません
  5. 相互検証：FinMind の数値を Goodinfo（または TSM などの macrotrends 上の ADR）と照合し、誤差のルールは以下に従ってください。台積電など 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月结束）
合并口径是否含少数股东权益
数据更新滞后某平台尚未更新最新一期财报

特別ルール

  1. 未上市公司（米哈游、莉莉丝等）：一次情報のデータしかない場合は、データの前に [估计] と記載し、相互検証は行わないでください
  2. 四半期データと年度データ：相互検証には年度データを優先してください。四半期データは情報源によって更新が遅れている場合があります
  3. 原始財報を優先：2つの情報源がいずれも原始財報（10-K／年報PDF）と一致しない場合は、原始財報を正として、情報源の誤りを記載してください

股价与复权（历史序列必读）

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

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

规则：

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

快速索引

场景主要来源备用来源
PDD / 拼多多macrotrends.net/stocks/charts/PDDstockanalysis.com/stocks/pdd
腾讯macrotrends.net/stocks/charts/TCEHYaastocks（0700.HK）
网易macrotrends.net/stocks/charts/NTESaastocks（9999.HK）
三七互娱eastmoney.com（002555）cninfo.com.cn
吉比特eastmoney.com（603444）cninfo.com.cn
Nintendomacrotrends.net/stocks/charts/NTDOYstockanalysis.com/stocks/ntdoy
Capcommacrotrends（CCOEY）stockanalysis（CCOEY）
台积电tools/twstock_data.py（2330）goodinfo.tw / macrotrends（TSM，注意1 ADR=5股）
联发科tools/twstock_data.py（2454）goodinfo.tw

コメント

Markdown 対応