marketwatch

MarketWatch — 金融データスクレイパー

MarketWatch のスクレイパーです。米国株および世界各国の ADR について、リアルタイムの株価情報、財務諸表（損益計算書、貸借対照表、キャッシュフロー計算書）、SEC 提出書類、アナリスト予想、オプションチェーン、過去の株価を取得します。

API キーは不要です。公開ページの HTML からデータを取得します。

---

⚠️ 法的注意事項

• MarketWatch には公式の公開 API がありません。このスクレイパーは、ウェブ上で一般公開されているデータにアクセスします。
• MarketWatch はボット対策に Datadome を使用しています。スクレイパーは、回避のためにブラウザーの完全なヘッダーを使用します。
• MarketWatch の利用規約を遵守してください。
• レート制限を実装してください（リクエスト間隔は最低 3 秒、推奨 5 秒）。
• サイトの HTML 構造が変更されると、スクレイパーが動作しなくなる場合があります。

---

インストール

pip install requests beautifulsoup4

---

スクリプト

スクリプト	説明
fetch_marketwatch.py	メインスクリプト：すべてのエンドポイント

---

クイックスタート

# Quote + perfil de compañía
python scripts/fetch_marketwatch.py --ticker AAPL --quote --profile

# Income statement anual (por defecto)
python scripts/fetch_marketwatch.py --ticker MSFT --income

# Income statement trimestral
python scripts/fetch_marketwatch.py --ticker AAPL --income --quarterly

# Balance sheet + cash flow trimestral
python scripts/fetch_marketwatch.py --ticker NVDA --balance --cashflow --quarterly

# Todos los financials (income + balance + cashflow)
python scripts/fetch_marketwatch.py --ticker AAPL --financials

# SEC filings (10-K, 10-Q, 8-K)
python scripts/fetch_marketwatch.py --ticker AAPL --sec-filings

# Analyst estimates + target price
python scripts/fetch_marketwatch.py --ticker AAPL --analyst

# Options chain
python scripts/fetch_marketwatch.py --ticker AAPL --options

# Historical OHLCV
python scripts/fetch_marketwatch.py --ticker AAPL --historical

# Todo lo disponible
python scripts/fetch_marketwatch.py --ticker GGAL --all

# A JSON
python scripts/fetch_marketwatch.py --ticker AAPL --all --output aapl.json

# Control de rate limiting
python scripts/fetch_marketwatch.py --ticker AAPL --quote --delay 5

---

利用可能なエンドポイント

フラグ	データ	頻度	期間
--quote	価格、変動、パフォーマンス（5 日、1 か月、年初来）	リアルタイム	1 スナップショット
--profile	主要な比率、セクター、業種、従業員数	現在	1 スナップショット
--income	損益計算書	年次／四半期	約 5 年
--balance	貸借対照表	年次／四半期	約 5 年
--cashflow	キャッシュフロー計算書	年次／四半期	約 5 年
--financials	損益計算書＋貸借対照表＋キャッシュフロー計算書（ショートカット）	--quarterly に応じて	約 5 年
--sec-filings	SEC 提出書類（10-K、10-Q、8-K）	過去分	約 20 件以上
--analyst	予想、目標株価、推奨	四半期／年次	約 15 項目以上
--options	オプションチェーン（権利行使価格別のコール／プット）	満期日別	利用可能なすべて
--historical	日次の過去 OHLCV	日次	約 1～3 か月
--all	上記すべて	--quarterly に応じて	-

---

エンドポイントごとに利用できるデータ

株価情報

現在の価格、変動額（$）、変動率（%）、前日終値、およびパフォーマンス表（5 日、1 か月、3 か月、年初来、1 年）。

企業プロフィール

以下を含む、最大 29 項目の財務比率： 現在の P/E、P/E 比率、EPS、時価総額、発行済み株式数、従業員 1 人あたりの売上高、従業員数、配当利回り、ベータなど。

財務諸表

各財務諸表には約 40～60 項目が含まれます（損益計算書では売上高、売上原価、売上総利益、営業利益、純利益、EBITDA、EPS など、貸借対照表では現金、売掛金、総資産、負債、資本など、キャッシュフロー計算書では営業キャッシュフロー、フリーキャッシュフロー、設備投資など）。

SEC 提出書類

提出書類の一覧には、提出日、書類日付、種類（10-K、10-Q、8-K）、カテゴリが含まれます。

アナリスト予想

平均推奨、平均目標株価、評価件数、目標株価の高値／中央値／安値、当年／翌年の予想、および企業別の格付け変更表。

オプション

満期日ごとに整理されたオプションチェーンで、コールとプット、権利行使価格、価格、出来高、未決済建玉が含まれます。

過去データ

日次 OHLCV。日付、始値、高値、安値、終値、出来高（直近約 60 日分）が含まれます。

---

ボット対策（Datadome）

MarketWatch は、自動スクレイピング対策に Datadome を使用しています。

状況	症状	解決策
短時間にリクエストを連続して送信	401 Unauthorized	--delay を増やす（最低 3 秒、理想は 5 秒）
IP が一時的にブロックされている	delay を設定しても 401	5～10 分待つ
ヘッダーが正しくない	即座に 401	ブラウザーのヘッダーを使用する（すでに含まれています）
セッション Cookie がない	401	スクレイパーが Cookie を自動的に処理します

推奨事項： 1 回の実行につき、1 ティッカーあたり 4～5 エンドポイント以内にしてください。

---

スキルの構成

skills/marketwatch/
├── SKILL.md                              # Este archivo
├── references/
│   └── REFERENCE.md                      # Documentación completa de todos los endpoints
└── scripts/
    └── fetch_marketwatch.py              # Script principal

---

📖 完全なリファレンス： 各エンドポイント、options の列、financials のフィールド、historical data の構造などの詳細については、references/REFERENCE.md を参照してください。