companiesmarketcap

CompaniesMarketCap — 财务排名抓取工具

用于抓取 CompaniesMarketCap 的工具，可提取财务排名（市值、收益、营收、员工人数、市盈率、利润率、资产、债务、现金）、股票历史市值和 ETF 持仓。

使用网站原生的 CSV 下载功能（?download=csv）——无需 API 密钥，且比抓取 HTML 更易维护。

---

⚠️ 法律声明

• CompaniesMarketCap 没有官方公共 API。本工具使用公开提供的 CSV 端点。
• 请遵守该网站的服务条款。
• 请实施速率限制（请求间隔至少 2 秒）。

---

安装

pip install requests beautifulsoup4

---

脚本

脚本	说明
fetch_cmc.py	主脚本：排名、股票历史数据、ETF 持仓

---

快速使用

# Ranking de market cap (default)
python scripts/fetch_cmc.py --rankings

# Ranking de earnings
python scripts/fetch_cmc.py --rankings --metric earnings

# Ranking de revenue (top 10)
python scripts/fetch_cmc.py --rankings --metric revenue --limit 10

# Stock marketcap histórico
python scripts/fetch_cmc.py --stock NVDA
python scripts/fetch_cmc.py --stock GGAL

# ETF holdings
python scripts/fetch_cmc.py --etf SPY --holdings

# Todo junto + output a JSON
python scripts/fetch_cmc.py --stock AAPL --rankings --output aapl_full.json

# Modo silencioso (solo JSON)
python scripts/fetch_cmc.py --rankings --metric earnings --limit 5 --quiet

---

端点

标志	数据	方法	详情
--rankings	排名列表	CSV 下载	12 项指标 + ETF，约 10,852 家公司
--stock TICKER	历史市值	HTML	每只股票可追溯 28–31 年
--etf TICKER --holdings	ETF 持仓	HTML	约 505 个持仓（SPY）
--etf TICKER	ETF 摘要	HTML	ETF 信息

可用排名指标（--metric）

指标	说明
marketcap (default)	市值
earnings	收益（TTM）
revenue	营收（TTM）
employees	员工人数
pe_ratio	市盈率
operating_margin	营业利润率（TTM）
total_assets	总资产
net_assets	净资产
liabilities	总负债
debt	总债务
cash	持有现金
pb_ratio	市净率
etfs	ETF 市值

---

其他标志

标志	说明
--limit N	将排名结果限制为 N 行
--output archivo.json	将输出保存到文件
--delay N	请求间隔（默认：2.0 秒）
--quiet	静默模式（仅输出 JSON）

---

自动将 ticker 解析为 slug

抓取工具会根据 CSV 中的公司名称自动解析 URL slug：

Ticker	名称 → Slug
NVDA	NVIDIA → nvidia
AAPL	Apple → apple
GGAL	Galicia Financial Group → galicia-financial-group
SPY	SPDR S&P 500 ETF → spdr-sp-500-etf
BRK-B	Berkshire Hathaway → berkshire-hathaway

---

Skill 结构

skills/companiesmarketcap/
├── SKILL.md                              # Este archivo
├── references/
│   └── REFERENCE.md                      # Documentación completa
└── scripts/
    └── fetch_cmc.py                      # Script principal

---

📖 详细文档： 请参阅 references/REFERENCE.md，了解每个端点、列、示例和技术注意事项的完整文档。