companiesmarketcap

CompaniesMarketCap — 金融ランキングスクレイパー

CompaniesMarketCap のスクレイパーです。金融ランキング（時価総額、利益、売上高、従業員数、P/E、利益率、資産、負債、現金）、株式の過去の時価総額、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 のみ）

---

ティッカーからスラッグへの自動解決

スクレイパーは CSV 内の会社名を基に、URL のスラッグを自動的に解決します。

ティッカー	名前 → スラッグ
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

---

スキルの構成

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

---

📖 詳細なドキュメント： 各エンドポイント、列、例、技術上の注意事項について詳しくは、references/REFERENCE.md を参照してください。