historical-market-cap について
Octagon MCPを使い、指定期間の株式時価総額データを取得するスキルです。企業評価の推移を追う調査担当者向けで、日次データや期間内の高値・安値などを確認できます。
主な機能
- 01期間を指定した時価総額の取得
- 02ティッカーと任意の件数上限の指定
- 03日次時価総額データの確認
- 04期間内の高値と安値の統計
活用シーン
- 01企業評価の長期推移の追跡
- 02期間内の時価総額ピークの特定
- 03ドローダウンと変動性の分析
- 04複数企業の時価総額変化の比較
MCP 対応
Octagon MCPのoctagon-agentツールで履歴データを照会します。記載されたデータソースはoctagon-stock-data-agentです。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ octagonai/ skills --skill historical-market-capインストール後、Claude Code で/historical-market-capを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
marketplace.jsonREADME.mdreferences/interpreting-results.mdmcp-setup.md詳細
過去の時価総額
Octagon MCP サーバーを使用して、指定した期間の過去の時価総額データを取得します。
前提条件
AI エージェント(Cursor、Claude Desktop、Windsurf など)で Octagon MCP が設定されていることを確認してください。インストール手順については、references/mcp-setup.md を参照してください。
ワークフロー
1. パラメーターの特定
クエリのパラメーターを決定します。
- ティッカー:株式シンボル(例:AAPL、MSFT)
- 開始日:期間の開始日
- 終了日:期間の終了日
- 上限(任意):返すレコードの最大数
2. Octagon MCP 経由でクエリを実行
自然言語のプロンプトを指定して、octagon-agent ツールを使用します。
Retrieve historical market capitalization data for <TICKER> from <START_DATE> to <END_DATE>, limited to <LIMIT> records.
MCP 呼び出し形式:
{
"server": "octagon-mcp",
"toolName": "octagon-agent",
"arguments": {
"prompt": "Retrieve historical market capitalization data for AAPL from 2025-01-01 to 2025-04-30, limited to 1000 records."
}
}
3. 予想される出力
エージェントは日次の時価総額を返します。
| 日付 | 時価総額(USD) |
|---|---|
| 2025-04-30 | $3.17 trillion |
| 2025-02-25 | $3.70 trillion (High) |
| 2025-04-08 | $2.57 trillion (Low) |
| ... | ... |
要約統計:
- 最高値:2025-02-25 の $3.70 trillion
- 最低値:2025-04-08 の $2.57 trillion
- 最新値:2025-04-30 の $3.17 trillion
データソース:octagon-stock-data-agent
4. 結果の解釈
以下の内容については、references/interpreting-results.md を参照してください。
- 時価総額のトレンド分析
- 成長率の計算
- ピークとボトムの特定
- ボラティリティの理解
クエリの例
標準的な期間:
Retrieve historical market capitalization data for AAPL from 2025-01-01 to 2025-04-30, limited to 1000 records.
通年:
Get historical market cap for MSFT for the entire year 2024.
四半期分析:
Show TSLA's market cap history for Q1 2025.
複数年のトレンド:
Retrieve market cap history for NVDA from 2020 to 2025.
ピーク分析:
When did AAPL reach its highest market cap in 2024?
時価総額の推移について
データが示す内容
| 指標 | 説明 |
|---|---|
| 日次時価総額 | 取引終了時点の値 |
| 日付系列 | 取引日のみ |
| 計算式 | 株価 × 発行済み株式数 |
| 調整 | 株式分割調整済みの株式数 |
主な統計
| 統計値 | 目的 |
|---|---|
| 最大値 | 評価額のピーク |
| 最小値 | 評価額のボトム |
| 平均値 | 標準的な評価額 |
| レンジ | ボラティリティの指標 |
トレンド分析
変化の計算
| 指標 | 計算式 |
|---|---|
| 絶対変化 | 期末時価総額 - 期首時価総額 |
| 変化率 | (期末 - 期首) / 期首 × 100% |
| CAGR | (期末/期首)^(1/年数) - 1 |
計算例
AAPL のデータの場合:
- 高値:$3.70T(2月25日)
- 安値:$2.57T(4月8日)
- レンジ:$1.13T
- ピークからボトムへの変化:-30.5%
トレンドのパターン
| パターン | 特徴 |
|---|---|
| 上昇トレンド | 高値と安値がともに切り上がる |
| 下降トレンド | 高値と安値がともに切り下がる |
| 保ち合い | 一定の範囲内で推移 |
| V字回復 | 急落後に急回復 |
| ラウンドトップ | 緩やかにピークを形成 |
期間分析
日次分析
| 用途 | 注目点 |
|---|---|
| 取引 | 短期的な値動き |
| ボラティリティ | 日々の変化 |
| イベント | 材料の影響 |
週次/月次分析
| 用途 | 注目点 |
|---|---|
| トレンド | 時間の経過に伴う方向性 |
| 比較 | 期間ごとの比較 |
| 平滑化 | ノイズの低減 |
年次分析
| 用途 | 注目点 |
|---|---|
| 成長 | 長期的な推移 |
| マイルストーン | 主な達成事項 |
| CAGR | 複利成長 |
ボラティリティ評価
ボラティリティの測定
| 指標 | 計算方法 |
|---|---|
| レンジ | 高値 - 安値 |
| レンジ率 | (高値 - 安値) / 平均値 |
| 日次変動 | 平均日次変化 |
| 標準偏差 | 価格のばらつき |
ボラティリティの解釈
| レンジ率 | ボラティリティ |
|---|---|
| <20% | 低 |
| 20-40% | 中程度 |
| 40-60% | 高 |
| >60% | 非常に高い |
例
AAPL のデータの場合:
- 高値:$3.70T
- 安値:$2.57T
- レンジ:$1.13T
- レンジ率:約35%
- 解釈:中程度から高いボラティリティ
ピークとボトムの分析
ピークの特定
| シグナル | 説明 |
|---|---|
| 史上最高値 | 過去最高値 |
| 期間最高値 | 期間内の最高値 |
| 局所ピーク | 一時的な高値 |
底値の特定
| シグナル | 説明 |
|---|---|
| 過去最低値 | これまでの最低値 |
| 期間内最低値 | 指定範囲内の最低値 |
| 局所的な底値 | 一時的な最低値 |
ピークから底値までの指標
| 指標 | 目的 |
|---|---|
| ドローダウン率 | ピークからの下落率 |
| 回復期間 | 回復までの日数 |
| ドローダウン期間 | ピークから底値までの期間 |
時系列での規模分類
カテゴリーの変化を追跡する
| 時価総額が...の場合 | 分類 |
|---|---|
| >$200B | メガキャップ |
| $10B-$200B | 大型株 |
| $2B-$10B | 中型株 |
| $300M-$2B | 小型株 |
マイルストーン分析
| マイルストーン | 意義 |
|---|---|
| 初の$1T | 歴史的な達成 |
| $2Tを突破 | エリートの仲間入り |
| $3Tを突破 | 世界で最も価値の高い企業 |
比較分析
同一企業の時系列比較
| 比較 | 目的 |
|---|---|
| YoY | 前年比成長率 |
| QoQ | 四半期ごとの勢い |
| MoM | 月ごとの傾向 |
複数企業の比較
| 比較 | 目的 |
|---|---|
| 相対的な規模 | 市場での位置づけ |
| 相対的な成長 | パフォーマンスの比較 |
| 相関 | 値動きの類似性 |
一般的なユースケース
トレンド分析
How has AAPL's market cap changed over the past year?
ピークの特定
When did TSLA reach its highest market cap?
ドローダウン分析
What was NVDA's biggest decline from peak in 2024?
マイルストーンの追跡
When did MSFT first cross $3 trillion market cap?
比較
Compare the market cap growth of AAPL and MSFT over 5 years.
分析のヒント
-
適切な期間を使用する:投資期間に合わせて分析します。
-
要因を特定する:大きな変動には、多くの場合その要因があります。
-
株式分割を考慮する:データが株式分割調整済みであることを確認します。
-
マイルストーンに注目する:端数のない数値は心理的に重要です。
-
ドローダウンを計算する:下落リスクを把握します。
-
ベンチマークと比較する:時価総額と指数のパフォーマンスを比較します。
他のスキルとの連携
| スキル | 組み合わせて使う目的 |
|---|---|
| company-market-cap | 現在と過去の比較 |
| stock-performance | 株価が時価総額の変化に与える影響 |
| income-statement | 時価総額を裏付ける収益 |
| financial-metrics-analysis | バリュエーションの推移 |