Back to Details

companiesmarketcap

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

CompaniesMarketCap — Financial Rankings Scraper

CompaniesMarketCap — 金融排名数据采集工具

Scraper de CompaniesMarketCap que extrae rankings financieros (market cap, earnings, revenue, employees, P/E, márgenes, activos, deuda, cash), marketcap histórico de stocks y ETF holdings.
Usa el sistema de CSV download nativo del sitio (
?download=csv
) — no requiere API key y es más mantenible que scrapear HTML.
这是一款针对CompaniesMarketCap的数据采集工具，可提取金融排名数据（market cap、earnings、revenue、employees、P/E、利润率、资产、负债、cash）、股票历史市值数据以及ETF holdings。
该工具使用网站原生的CSV download系统（
?download=csv
）——无需API key，相比抓取HTML更易维护。

⚠️ Aviso Legal

⚠️ 法律声明

  • CompaniesMarketCap no tiene API pública oficial. Usa el endpoint CSV que está públicamente disponible.
  • Respetá los términos de servicio del sitio.
  • Implementá rate limiting (mín 2 segundos entre requests).
  • CompaniesMarketCap 无官方公开API，本工具使用公开可用的CSV端点。
  • 请遵守网站的服务条款。
  • 请实现请求频率限制（请求间隔至少2秒）。

Instalación

安装

bash
pip install requests beautifulsoup4
bash
pip install requests beautifulsoup4

Scripts

脚本

ScriptDescripción
fetch_cmc.pyScript principal: rankings, stock history, ETF holdings
脚本描述
fetch_cmc.py主脚本：获取排名、股票历史数据、ETF持仓

Uso rápido

快速使用

bash
undefined
bash
undefined

Ranking de market cap (default)

获取市值排名（默认）

python scripts/fetch_cmc.py --rankings
python scripts/fetch_cmc.py --rankings

Ranking de earnings

获取盈利排名

python scripts/fetch_cmc.py --rankings --metric earnings
python scripts/fetch_cmc.py --rankings --metric earnings

Ranking de revenue (top 10)

获取营收排名（前10）

python scripts/fetch_cmc.py --rankings --metric revenue --limit 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
python scripts/fetch_cmc.py --stock NVDA python scripts/fetch_cmc.py --stock GGAL

ETF holdings

获取ETF持仓

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

Todo junto + output a JSON

同时获取多项数据并输出为JSON

python scripts/fetch_cmc.py --stock AAPL --rankings --output aapl_full.json
python scripts/fetch_cmc.py --stock AAPL --rankings --output aapl_full.json

Modo silencioso (solo JSON)

静默模式（仅输出JSON）

python scripts/fetch_cmc.py --rankings --metric earnings --limit 5 --quiet

---
python scripts/fetch_cmc.py --rankings --metric earnings --limit 5 --quiet

---

Endpoints

端点说明

FlagDataMétodoDetalle
--rankings
Ranking listCSV download12 métricas + ETFs, ~10,852 empresas
--stock TICKER
Marketcap históricoHTML28-31 años por stock
--etf TICKER --holdings
ETF holdingsHTML~505 posiciones (SPY)
--etf TICKER
ETF summaryHTMLInformación del ETF
参数数据类型获取方式详情
--rankings
排名列表CSV下载包含12类指标及ETF数据，覆盖约10852家企业
--stock TICKER
历史市值数据HTML抓取单支股票可获取28-31年数据
--etf TICKER --holdings
ETF持仓数据HTML抓取单支ETF约包含505个持仓标的（如SPY）
--etf TICKER
ETF概要信息HTML抓取ETF基础信息

Rankings disponibles (
--metric
)

可用排名指标（
--metric
）

MétricaDescripción
marketcap
(default)		Market Capitalization
earnings
Earnings (TTM)
revenue
Revenue (TTM)
employees
Employee count
pe_ratio
Price/Earnings ratio
operating_margin
Operating margin (TTM)
total_assets
Total assets
net_assets
Net assets
liabilities
Total liabilities
debt
Total debt
cash
Cash on hand
pb_ratio
Price/Book ratio
etfs
ETF market caps
指标描述
marketcap
（默认）		市值
earnings
盈利（TTM）
revenue
营收（TTM）
employees
员工数量
pe_ratio
市盈率
operating_margin
营业利润率（TTM）
total_assets
总资产
net_assets
净资产
liabilities
总负债
debt
总债务
cash
现金储备
pb_ratio
市净率
etfs
ETF市值排名

Flags adicionales

额外参数

FlagDescripción
--limit N
Limitar a N filas en rankings
--output archivo.json
Guardar output a archivo
--delay N
Delay entre requests (default: 2.0s)
--quiet
Modo silencioso (solo JSON)
参数描述
--limit N
限制排名数据的行数为N
--output archivo.json
将结果保存至指定文件
--delay N
请求间隔时间（默认：2.0秒）
--quiet
静默模式（仅输出JSON）

Resolución automática ticker → slug

Ticker 自动转换为URL Slug

El scraper resuelve automáticamente el slug de la URL a partir del nombre de la compañía en el CSV:
TickerNombre → Slug
NVDANVIDIA → 
nvidia
AAPLApple → 
apple
GGALGalicia Financial Group → 
galicia-financial-group
SPYSPDR S&P 500 ETF → 
spdr-sp-500-etf
BRK-BBerkshire Hathaway → 
berkshire-hathaway
采集工具可通过CSV中的公司名称自动解析URL的slug：
Ticker名称 → Slug
NVDANVIDIA → 
nvidia
AAPLApple → 
apple
GGALGalicia Financial Group → 
galicia-financial-group
SPYSPDR S&P 500 ETF → 
spdr-sp-500-etf
BRK-BBerkshire Hathaway → 
berkshire-hathaway

Estructura del skill

工具结构

skills/companiesmarketcap/
├── SKILL.md                              # Este archivo
├── references/
│   └── REFERENCE.md                      # Documentación completa
└── scripts/
    └── fetch_cmc.py                      # Script principal
📖 Documentación detallada: Consultá references/REFERENCE.md para la documentación exhaustiva de cada endpoint, columnas, ejemplos y consideraciones técnicas.
skills/companiesmarketcap/
├── SKILL.md                              # 本文档
├── references/
│   └── REFERENCE.md                      # 完整文档
└── scripts/
    └── fetch_cmc.py                      # 主脚本
📖 详细文档： 请查阅references/REFERENCE.md获取各端点、字段、示例及技术注意事项的完整说明。