mcpField
S
stock-analysis

stock-analysis

github.com/gracefullightその他4912.1k 回インストール1 日前に更新
リポジトリ

stock-analysis について

Yahoo Financeのデータを使って米国株と暗号資産を分析するコマンドラインスキルです。株式と暗号資産を組み合わせたポートフォリオにも対応し、市場・リスク要因を踏まえたシグナルやJSONを出力します。

主な機能

  1. 01株式と対応する暗号資産の分析
  2. 02複数ティッカーの比較
  3. 03株式・暗号資産を含むポートフォリオ管理
  4. 04ファンダメンタルズ・モメンタム・センチメントの評価
  5. 05タイミング・市場・セクターリスクの検出
  6. 06テキスト要約またはJSON出力

活用シーン

  1. 01投資判断の前にティッカーを確認
  2. 02複数の株式や暗号資産を比較
  3. 03ポートフォリオ価値・損益・期間リターンを追跡

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/gracefullight/stock-checker --skill stock-analysis

インストール後、Claude Code で/stock-analysisを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

_meta.json
App-Plan.md
README.md
TODO.md
scripts/
analyze_stock.py
portfolio.py

詳細

株式分析（v5.0）

Yahoo Finance のデータを使用して、米国株と暗号資産を分析します。ポートフォリオ管理、暗号資産への対応、定期分析が含まれます。

クイックスタート

重要： 引数として渡すのは株式のティッカーシンボルのみです。コマンドに余分なテキスト、ヘッダー、書式を追加しないでください。

単一のティッカーを分析します：

uv run {baseDir}/scripts/analyze_stock.py AAPL
uv run {baseDir}/scripts/analyze_stock.py MSFT --output json

複数のティッカーを比較します：

uv run {baseDir}/scripts/analyze_stock.py AAPL MSFT GOOGL

暗号資産の分析（v5.0）

時価総額上位20銘柄の暗号資産を分析します：

uv run {baseDir}/scripts/analyze_stock.py BTC-USD
uv run {baseDir}/scripts/analyze_stock.py ETH-USD SOL-USD

対応している暗号資産： BTC-USD、ETH-USD、BNB-USD、SOL-USD、XRP-USD、ADA-USD、DOGE-USD、AVAX-USD、DOT-USD、MATIC-USD、LINK-USD、ATOM-USD、UNI-USD、LTC-USD、BCH-USD、XLM-USD、ALGO-USD、VET-USD、FIL-USD、NEAR-USD

暗号資産の分析項目：

  • 時価総額（大型／中型／小型の分類）
  • カテゴリー（スマートコントラクト L1、DeFi、決済など）
  • BTC との相関（30日間）
  • モメンタム（RSI、価格レンジ）
  • 市場の状況（VIX、市場全体のレジーム）

ポートフォリオ管理（v5.0）

株式と暗号資産を組み合わせたポートフォリオを作成・管理します：

# Create portfolio
uv run {baseDir}/scripts/portfolio.py create "My Portfolio"

# Add assets
uv run {baseDir}/scripts/portfolio.py add AAPL --quantity 100 --cost 150.00
uv run {baseDir}/scripts/portfolio.py add BTC-USD --quantity 0.5 --cost 40000 --portfolio "My Portfolio"

# View holdings with current P&L
uv run {baseDir}/scripts/portfolio.py show

# Update/remove assets
uv run {baseDir}/scripts/portfolio.py update AAPL --quantity 150
uv run {baseDir}/scripts/portfolio.py remove BTC-USD

# List/delete portfolios
uv run {baseDir}/scripts/portfolio.py list
uv run {baseDir}/scripts/portfolio.py delete "My Portfolio"

ポートフォリオの保存先： ~/.clawdbot/skills/stock-analysis/portfolios.json

ポートフォリオ分析（v5.0）

期間リターンを任意で指定して、ポートフォリオ内のすべての資産を分析します：

# Analyze portfolio
uv run {baseDir}/scripts/analyze_stock.py --portfolio "My Portfolio"

# With period returns (daily/weekly/monthly/quarterly/yearly)
uv run {baseDir}/scripts/analyze_stock.py --portfolio "My Portfolio" --period weekly
uv run {baseDir}/scripts/analyze_stock.py -p "My Portfolio" --period monthly

ポートフォリオの概要には、以下が含まれます：

  • 総取得コスト、現在価値、損益
  • 期間リターン（指定した場合）
  • 集中度に関する警告（単一資産が30%超）
  • 推奨の概要（BUY／HOLD／SELL の件数）

例：

  • ✅ 正しい例：uv run {baseDir}/scripts/analyze_stock.py BAC
  • ✅ 正しい例：uv run {baseDir}/scripts/analyze_stock.py BTC-USD
  • ❌ 誤った例：uv run {baseDir}/scripts/analyze_stock.py === BANK OF AMERICA (BAC) - Q4 2025 EARNINGS ===
  • ❌ 誤った例：uv run {baseDir}/scripts/analyze_stock.py "Bank of America"

ティッカーシンボルのみを使用してください（例：「Bank of America」ではなく BAC）。暗号資産には -USD の接尾辞を使用してください（例：BTC-USD）。

分析項目

このスクリプトは、次の8つの主要な項目を評価します：

  1. 決算サプライズ（重み30%）：予想 EPS と実績の比較、売上高の予想超過／未達
  2. ファンダメンタルズ（重み20%）：P/E レシオ、利益率、売上高の成長、負債水準
  3. アナリストのセンチメント（重み20%）：コンセンサス評価、目標株価と現在株価の比較
  4. 過去のパターン（重み10%）：過去の決算発表時の反応、ボラティリティ
  5. 市場の状況（重み10%）：VIX、SPY／QQQ のトレンド、市場レジーム
  6. セクターのパフォーマンス（重み15%）：株式とセクターの比較、セクターのトレンド
  7. モメンタム（重み15%）：RSI、52週レンジ、出来高、相対的な強さ
  8. センチメント分析（重み10%）：恐怖・強欲指数、空売り残高、VIX のタームストラクチャー、インサイダー取引、プット／コールレシオ

センチメントのサブ指標：

  • 恐怖・強欲指数（CNN）：逆張りのシグナル（極度の恐怖は買いの機会、極度の強欲は警戒）
  • 空売り残高：空売りが多く、踏み上げの可能性がある場合は強気、根拠のある空売りは弱気
  • VIX のタームストラクチャー：コンタンゴは市場の安心感／強気、バックワーデーションは市場の緊張／弱気
  • インサイダーの動向：SEC Form 4 の提出書類に基づく純買い／純売り（直近90日間）
  • プット／コールレシオ：比率が高い場合は過度な恐怖／強気、低い場合は安心感／弱気

一部の項目を利用できない場合、重みは自動的に正規化されます。

タイミングに関する特別なチェック：

  • 決算前の警告（14日未満）：BUY ではなく HOLD を推奨します
  • 決算後の急騰の検出（5日間で15%超）：利益がすでに株価に織り込まれている可能性を示します
  • 買われすぎの状況（RSI > 70 かつ52週高値に近い）：信頼度を下げます

タイミングに関する警告とリスクフラグ

このスクリプトは、高リスクの状況を検出します：

決算のタイミング
  • 決算前の期間：決算まで14日未満の場合、BUY シグナルは HOLD になります
  • 決算後の急騰：決算後5日間で株価が15%超上昇した場合、利益が「すでに織り込まれている可能性がある」と警告します
テクニカルリスク
  • 買われすぎの状況：RSI > 70 かつ52週高値に近い場合は、高リスクのエントリーとなります
市場リスク
  • VIX 高水準：市場の恐怖感（VIX > 30）により、BUY シグナルの信頼度が低下します
  • リスクオフモード（v4.0.0）：安全資産（GLD、TLT、UUP）がそろって上昇すると、BUY の信頼度を 30%低下させます
    • 金、米国債、米ドルへの逃避を検出します
    • GLD ≥ +2%、TLT ≥ +1%、UUP ≥ +1%（5 日間の変化率）で発動します
セクターリスク
  • セクターの低迷：銘柄の見通しはよく見えても、セクターから資金が流出している場合があります
地政学リスク（v4.0.0）

このスクリプトは、直近 24 時間の速報ニュースを危機関連キーワードでスキャンし、影響を受ける銘柄に自動でフラグを付けます。

  • 台湾情勢：半導体（NVDA、AMD、TSM、INTC など）→ 信頼度を 30%低下
  • 中国との緊張：テクノロジー／一般消費財（AAPL、QCOM、NKE、SBUX など）→ 信頼度を 30%低下
  • ロシア・ウクライナ情勢：エネルギー／素材（XOM、CVX、MOS、CF など）→ 信頼度を 30%低下
  • 中東情勢：石油／防衛（XOM、LMT、RTX など）→ 信頼度を 30%低下
  • 銀行危機：金融（JPM、BAC、WFC、C など）→ 信頼度を 30%低下

ティッカーが影響対象リストに含まれていなくても、そのセクターが影響を受ける場合は、信頼度を 15%低下させます。

アラートの例：

⚠️ SECTOR RISK: Tech supply chain and consumer market exposure (detected: china, tariff)
速報ニュースアラート（v4.0.0）
  • Google News RSS を危機関連キーワード（戦争、景気後退、制裁、災害など）でスキャンします
  • 注意事項に最大 2 件の速報ニュースアラート（直近 24 時間）を表示します
  • API 呼び出しの過剰を避けるため、1 時間のキャッシュを使用します

出力形式

デフォルト（テキスト）：3～5 個の箇条書きと注意事項を含む、簡潔な買い／保有／売りシグナル

JSON：スコア、指標、生データを含む構造化データで、さらなる分析に使用できます

制限事項

  • データの鮮度：Yahoo Finance のデータには 15～20 分の遅延が生じる場合があります
  • センチメントデータの古さ：
    • 空売り残高データには約 2 週間の遅延があります（FINRA の報告スケジュールによる）
    • インサイダー取引データには、届出から 2～3 日の遅延が生じる場合があります
    • VIX のターム構造は、先物取引時間中のみ更新されます
  • 速報ニュースの制限事項（v4.0.0）：
    • Google News RSS には 15～60 分の遅延が生じる場合があります
    • キーワード照合では誤検出や見落としが生じる場合があります
    • センチメント分析は行わず、キーワードのみを検出します
    • 1 時間のキャッシュにより、アラートの情報が多少古くなる場合があります
  • データの欠落：すべての銘柄で、アナリストのカバレッジ、オプションチェーン、または完全なファンダメンタルズデータがそろっているわけではありません
  • 実行時間：非同期の並列取得とキャッシュを使用した場合、銘柄ごとに 3～5 秒です（共通指標は 1 時間キャッシュされます）
  • 免責事項：すべての出力に、目立つ「投資助言ではありません」という警告が含まれます
  • 米国市場のみ：米国以外のティッカーでは、データが不完全な場合があります

エラー処理

スクリプトは次の状況を適切に処理します。

  • 無効なティッカー → 明確なエラーメッセージ
  • アナリストデータの欠落 → 利用可能な指標のみに基づくシグナル
  • API の障害 → 指数バックオフで再試行し、3 回失敗すると終了

コメント

Markdown 対応