mcpField
A
a-stock-financial

a-stock-financial

github.com/nigo81データ・データベース13748 回インストール9 週間前に更新
リポジトリ

a-stock-financial について

a-stock-financialは、中国A株上場企業の財務諸表を照会し、Excelに出力するスキルです。AkShare経由で同花顺のデータを取得し、複数の帳票と期間区分に対応します。

主な機能

  1. 01貸借対照表・損益計算書・キャッシュフロー計算書の照会
  2. 02財務サマリー指標の取得
  3. 03報告期間・年度・単四半期での絞り込み
  4. 04帳票のExcelブックへの出力

活用シーン

  1. 01企業の直近数年の財務諸表を確認
  2. 02報告期間ごとの財務指標を比較
  3. 03分析用に指定帳票を出力

インストール

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

$npx skills add https://github.com/nigo81/nigo-skills --skill a-stock-financial

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

同梱ファイルscripts/export_excel.pyscripts/fetch_reports.py

詳細

プロジェクトの README より

A股上市公司财务报表查询

基于 AkShare(同花顺数据源)获取A股上市公司财务报表,支持查询和导出 Excel。

依赖

pip install akshare openpyxl

股票代码查询

不要用 stock_zh_a_spot_em() 拉全市场行情(极慢,需1分钟+)。

用户说公司名称而非代码时,用 WebSearch 搜索"XX 股票代码"即可。

可用数据

报表列数内容
资产负债表80列流动/非流动资产、流动/非流动负债、权益各明细
利润表46列营收→成本各项→营业利润→净利润→每股收益→综合收益
现金流量表73列直接法三大活动现金流 + 间接法补充资料
财务摘要20+指标净利率、毛利率、ROE、存货周转率、流动比率等

每个报表支持3个时间维度:按报告期(最全)、按年度(多年对比)、按单季度

工作流

1. 确认参数
  • 股票代码:用户给出代码直接用;说公司名则 WebSearch 搜索
  • 报表类型:默认查全部,用户指定则只查对应报表(balance/income/cashflow/abstract)
  • 时间维度:默认 按报告期,年报对比用 按年度,看季度用 按单季度
  • 用户说"近N年/近N期"的映射:
    • "近3年" = --indicator 按年度 --last 3(取最近3个年度)
    • "近4期" = --indicator 按报告期 --last 4(取最近4个报告期,含季报/半年报/年报)
    • "2025年报" = --period 2025-12-31
    • "2025三季报" = --period 2025-09-30
2. 查询报表
SCRIPT=~/.claude/skills/a-stock-financial/scripts/fetch_reports.py

# 查所有报表,按报告期,最近4期
python3 $SCRIPT <股票代码>

# 只查利润表,按年度,最近5年
python3 $SCRIPT <股票代码> --type income --indicator 按年度 --last 5

# 查资产负债表,指定报告期(只返回1期数据)
python3 $SCRIPT <股票代码> --type balance --period 2025-12-31

# 查财务摘要
python3 $SCRIPT <股票代码> --type abstract

# 输出为 JSON
python3 $SCRIPT <股票代码> --output json

--type 可选:balance、income、cashflow、abstract、all(默认) --indicator 可选:按报告期(默认)、按年度、按单季度

3. 展示结果

以表格形式展示关键指标,并提供简要财务分析:

  • 营收趋势、利润率变化
  • 资产负债结构、偿债能力
  • 现金流健康度
  • 与往年数据的同比变化
4. 导出 Excel(用户要求时)
EXPORT=~/.claude/skills/a-stock-financial/scripts/export_excel.py

# 导出所有报告期(默认最近20期)
python3 $EXPORT <股票代码> <公司名称>

# 只导出2025年报(1期数据)
python3 $EXPORT 600326 西藏天路 --period 2025-12-31

# 导出最近3期
python3 $EXPORT 600326 西藏天路 --last 3

# 按年度导出,最近5年
python3 $EXPORT 600326 西藏天路 --indicator 按年度 --last 5

# 指定输出路径
python3 $EXPORT 600326 西藏天路 --output /tmp/财报.xlsx

导出文件包含4个 Sheet:资产负债表、利润表、现金流量表、财务摘要。

注意事项

  • symbol 为 6 位股票代码(如 "600326"),不含交易所后缀
  • 数据源为同花顺,完全免费无需 token
  • 数据单位通常为"亿",带 * 的是核心指标列
  • 如果东财接口报错,同花顺接口(_ths 后缀)是稳定的备选

作者:nigo 微信公众号:逆行的狗

コメント