About companiesmarketcap
A scraper for CompaniesMarketCap data, for users who need financial rankings, stock market-cap histories or ETF holdings. It uses the site's downloadable CSV for rankings and does not require an API key.
Key features
- 01Rankings across 12 financial metrics and ETFs
- 02Historical stock market capitalization
- 03ETF summaries and holdings
- 04Ticker-to-URL slug resolution
- 05JSON output, row limits and request delays
Use cases
- 01Comparing companies by revenue, earnings or market cap
- 02Retrieving a stock’s market-cap history
- 03Reviewing an ETF’s summary and holdings
- 04Saving limited ranking results as JSON
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/companiesmarketcapin Claude Code to confirm it loaded.
Bundled filesreferences/REFERENCE.mdscripts/fetch_cmc.py
Details
From the project READMECompaniesMarketCap — Financial Rankings Scraper
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.
⚠️ 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).
Instalación
pip install requests beautifulsoup4
Scripts
| Script | Descripción |
|---|---|
| fetch_cmc.py | Script principal: rankings, stock history, ETF holdings |
Uso rápido
# 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
Endpoints
| Flag | Data | Método | Detalle |
|---|---|---|---|
--rankings | Ranking list | CSV download | 12 métricas + ETFs, ~10,852 empresas |
--stock TICKER | Marketcap histórico | HTML | 28-31 años por stock |
--etf TICKER --holdings | ETF holdings | HTML | ~505 posiciones (SPY) |
--etf TICKER | ETF summary | HTML | Información del ETF |
Rankings disponibles (--metric)
| Métrica | Descripció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 |
Flags adicionales
| Flag | Descripció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) |
Resolución automática ticker → slug
El scraper resuelve automáticamente el slug de la URL a partir del nombre de la compañía en el CSV:
| Ticker | Nombre → 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 |
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.