台股 ETF 分红总表生成器

为什么需要这一包

想比较月派 ETF，打开查询网站，一次只能看一只。

想看“每投入 10 万一年大概能领多少”，还得自己拿计算器一只一只算。

你可能卡在这几件事

“我想一次看全部，自己排序。” 网站的排行榜用的是它自己的算法，字段也不能自己筛选。你想要的是一张属于自己的表。

“每次都要重新查一遍。” 派息每个月都在变，手动整理的表格过两周就过时了。

“股息率到底怎么算的？” 有的用最近一次派息乘以次数推估，有的用去年全年。看到很高的数字，也不知道是不是特别派息。

这包要解决的事

把“查资料”变成“点一下”。 程序直接读取证交所、柜买中心的官方 ETF 清单与收盘价，加上 Yahoo Finance 的派息记录，用固定、公开的算法整理成 Excel。想更新就再运行一次，每一栏怎么算都写在表里。

---

内容清单

1️⃣ 主程序 etf_dividend_table.py

• 涵盖全部上市＋上柜 ETF：清单直接抓取官方 OpenAPI，新上市的 ETF 会自动出现（默认排除杠杆与反向型，加一个参数就能列入）
• 约 30 秒跑完：同时查询多只；测试时全部 319 只约 30 秒
• 不需要任何账号或密钥
• 可以只查指定的几只、指定输出文件夹

2️⃣ 输出的 Excel（三个工作表）

总表：每只一行

• 代码、名称、上市／上柜、收盘价
• 派息频率（月派、季派、半年派、年派）
• 最近除息日、最近一次派息
• 近 12 个月派息合计、近 12 月股息率
• 每投入 10 万一年约能领多少
• 备注：股息率特别高或近一年没有除息时自动提醒

已设好筛选与冻结窗格，默认按股息率从高到低排序。

派息明细：每只近 3 年的每一次除息日与金额。

说明：每一栏的算法与数据来源。

另附同样内容的 CSV，可以直接导入 Google 电子表格。

3️⃣ 双击运行文件 产生派息总表.bat

Windows 双击就能运行，运行完自动打开输出文件夹。

4️⃣ 使用说明.md

安装 Python 与包、两种运行方式、参数说明、每个字段怎么算、Excel 筛选技巧、用 Windows 任务计划程序每周自动更新，以及 10 条故障排除。

5️⃣ 数据质量处理

• Yahoo 偶尔会把同一次派息记成相隔一两天的两笔，程序会自动合并
• 股息率 12% 以上会在备注中提醒“请以基金公司公告为准核对”
• 股息率用“过去 12 个月实际派了多少”计算，不用次数推算

---

适合谁／不适合谁

✅ 这包适合你，如果……

• 你在比较台股 ETF 的派息，想要一张可以自己筛选排序的总表
• 你常用 Excel 或 Google 电子表格整理数据
• 你想定期更新，不想每次手动查
• 你愿意按照说明安装一次 Python（之后双击就能用）

❌ 这包不适合你，如果……

• 你想要有人告诉你买哪一只。 这个包只整理过去的派息数据
• 你需要“预估下次派息”或“即将除息”提醒。程序只整理已经发生的派息
• 你只用手机、没有电脑
• 你需要海外 ETF 的数据。目前只涵盖台湾上市、上柜 ETF

---

常见问题

相关免费教程

• Grok 是什么？最新版本 Grok 4.7、功能与方案价格整理
• 100 个“最终版(2)”文件名：用 Claude Code 批量改名，而且改错可以救回来
• Gemini 4 是什么？Hydrogen、Carbon、Argon 差在哪、怎么选