前言¶

做财务建模、回购/增发分析或者多年期股本对比时，常见的做法是去东财等第三方接口按当前口径取数，再自己翻年报核对。问题在于第三方接口往往不做历史拆股、合股折算，不同年份的股本口径也不一致，Excel 里几列对不齐就要花半天。下面介绍的这个 Skill 把「历年年末总股本」这件事一次做完：数据直接取自上市公司年报原文，历史拆股、合股自动折算到最新标准，并顺带算出每年的股本变化数与变化比例。

这是什么¶

「上市公司股本查询-逍遥投资笔记」是一个社区来源的 data-analysis 类 Skill，坐标 @user_57f2c8f6/gubenchaxun-xiaoyao，版本 1.0.1，发布者 user_57f2c8f6。它解决的问题是：给定一家上市公司和年份区间，快速拿到该公司自上市当年起至 2025 年每年年末（财年末）的总股本，并以统一口径输出结果。

该 Skill 基于通用 SKILL.md 格式编写，面向 A 股、港股、美股三类市场，其中美股部分覆盖中概股，涉及 ADS 时按 ADS 与普通股的兑换比例折算。

核心功能¶

1、历年总股本查询。批量查询 A 股、港股、美股上市公司从上市那年起至 2025 年各年年底的总股本数，A 股取年报口径，港股取 HKEX 月报表口径，美股中概取 SEC 20-F 封面数据并做 ADS 折算。

2、历史变动折算。如果历史上发生过拆股、合股等操作，Skill 会自动把这些操作折算到最新标准后再统计，避免出现某年股本突然放大或缩小的口径断层。

3、股本变化计算。在总股本序列基础上，自动计算每年的股本变化数和变化比例，方便直接看增发、回购、股权激励带来的代价本扩张或收缩。

4、出处可追溯。输出为 HTML 报告，每个数字带「？」悬浮标记，悬停可看到数据出处，便于回查年报原文或公告。

数据来源方面，官方简介明确说明所有股本数据均来自上市公司年报，称其比东财等第三方接口数据更准确。

安装与启用¶

官方资料页未给出具体的安装命令、目录位置或配置文件字段，因此这里不做推测。要安装或查看源码，直接访问下面两个地址：

https://api.skillhub.cn/user_57f2c8f6/gubenchaxun-xiaoyao
https://www.skillhub.cn/skills/user_57f2c8f6/gubenchaxun-xiaoyao

按 Skill 元数据，该 Skill 不需要 API Key（标签 requires_api_key=false），来源标记为 community，也就是说属于社区发布、不在官方维护名单内，使用时建议自己核对关键年份的年报原文。

典型用法¶

按官方简介，这个 Skill 在以下三类诉求下使用：

1、统计某公司某几年的总股本、股本变化或年末股本。例如「统计贵州茅台 2015-2024 年年末总股本」。

2、查询某公司 ADS 与普通股的兑换比例。美股中概股的 20-F 封面只披露 ADS 数，需要兑换比例才能还原成普通股口径。

3、做股本对比表，把多家公司或多个年份的年末股本排在一起比较。

实际调用方式取决于你在哪个宿主里运行该 Skill。由于官方页面抓取不到正文，SKILL.md 中的具体命令与参数未能核实，此处不写推测内容；安装后可直接按 SKILL.md 里的说明执行。

适用场景与注意¶

适合财务建模、历史股本序列研究、增发回购与股权稀释测算、跨市场（A 股/港股/美股）公司股本对比等需要「年末总股本」的场景。

需要注意的几点：

1、数据口径为年末或财年末，不提供年内时点数据，做日内或季度高频分析时用不上。

2、历史数据回溯至上市当年、截至 2025 年，之后年份的年报需要等披露后才能补充。

3、港股走 HKEX 月报表，美股走 SEC 20-F 封面，与 A 股年报口径在细节上未必完全一致，做跨市场严格对比时仍应抽查原文。

4、社区来源，评分与下载量为社区统计值（按抓取到的资料为评分 100000、下载 1328、安装 0），不代表官方背书，重要结论建议回查年报。

小结¶

这个 Skill 的价值在于把「历年年末总股本 + 拆股合股折算 + 股本变化」这三件事打包成一次查询，并附上可追溯的出处标记。对于经常要做多年期股本对比的开发者和研究人员，可以省掉翻年报和手工折算的时间。官方地址：https://api.skillhub.cn/user_57f2c8f6/gubenchaxun-xiaoyao