Back to Details

market-research

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

深掘りリサーチスキル

In-Depth Research Skill

$ARGUMENTS を解析してリサーチタイプと対象を判定し、以下のコマンドを実行してください。
Parse $ARGUMENTS to determine the research type and target, then execute the following command.

実行コマンド

Execution Command

bash
python3 /Users/kikuchihiroyuki/stock-skills/.claude/skills/market-research/scripts/run_research.py <command> <target>
bash
python3 /Users/kikuchihiroyuki/stock-skills/.claude/skills/market-research/scripts/run_research.py <command> <target>

自然言語ルーティング

Natural Language Routing

自然言語→スキル判定は .claude/rules/intent-routing.md を参照。
For natural language → skill determination, refer to .claude/rules/intent-routing.md.

リサーチタイプ別の出力

Output by Research Type

stock（銘柄リサーチ）

stock (Stock Research)

  • 基本情報 + バリュエーション（yfinance）
  • 最新ニュース（yfinance）
  • Xセンチメント（Grok API）
  • 深掘り分析: ニュース・業績材料・アナリスト見解・競合比較（Grok API）
  • Basic Information + Valuation (yfinance)
  • Latest News (yfinance)
  • X Sentiment (Grok API)
  • In-Depth Analysis: News, Earnings Materials, Analyst Opinions, Competitor Comparisons (Grok API)

industry（業界リサーチ）

industry (Industry Research)

  • トレンド・主要プレイヤー・成長ドライバー・リスク・規制動向（Grok API）
  • Trends, Key Players, Growth Drivers, Risks, Regulatory Trends (Grok API)

market（マーケット概況）

market (Market Overview)

  • 値動き・マクロ要因・センチメント・注目イベント・セクターローテーション（Grok API）
  • Price Movements, Macro Factors, Sentiment, Notable Events, Sector Rotation (Grok API)

business（ビジネスモデル分析）

business (Business Model Analysis)

  • 事業概要（何で稼いでいるか）
  • 事業セグメント構成（セグメント名・売上比率・概要）
  • 収益モデル（ストック型/フロー型/サブスク等）
  • 競争優位性（参入障壁・ブランド・技術・moat）
  • 重要KPI（投資家が注目すべき指標）
  • 成長戦略（中期経営計画・M&A・新規事業）
  • ビジネスリスク（構造的リスク・依存度）
  • Business Overview (Revenue sources)
  • Business Segment Structure (Segment names, revenue ratios, overviews)
  • Revenue Model (Stock/Flow/Subscription, etc.)
  • Competitive Advantages (Barriers to entry, brand, technology, moat)
  • Key KPIs (Indicators investors should focus on)
  • Growth Strategy (Medium-term management plan, M&A, new businesses)
  • Business Risks (Structural risks, dependencies)

API について

About APIs

Grok API

Grok API

  • XAI_API_KEY 環境変数が設定されている場合のみ Grok API を利用
  • 未設定時は yfinance データのみでレポート生成（stock の場合）
  • Grok API is only available if the XAI_API_KEY environment variable is set
  • If not set, reports are generated using only yfinance data (for stock research)

2層構成

Two-Tier Structure

  1. Layer 1 (yfinance): 常に利用可能（ファンダメンタルズ・株価データ）
  2. Layer 2 (Grok API): XAI_API_KEY 設定時（X投稿・Web検索による深掘り分析）
  • industry / market / business は Layer 2 が必要。未設定時はその旨を表示
  1. Layer 1 (yfinance): Always available (fundamentals, stock price data)
  2. Layer 2 (Grok API): Available when XAI_API_KEY is set (in-depth analysis via X posts and web search)
  • industry / market / business research require Layer 2. If not set, display a message to that effect

APIステータスサマリー（KIK-431）

API Status Summary (KIK-431)

各レポートの末尾に Grok API の状態を表示する:
状態表示
正常✅ 正常
未設定🔑 未設定 — XAI_API_KEY を設定すると利用可能
認証エラー❌ 認証エラー (401) — XAI_API_KEY を確認してください
レート制限⚠️ レート制限 (429) — しばらく待ってから再試行
タイムアウト⏱️ タイムアウト — ネットワーク接続を確認
その他のエラー❌ エラー — 詳細は stderr を確認
Display the Grok API status at the end of each report:
StatusDisplay
Normal✅ Normal
Not Set🔑 Not Set — Available when XAI_API_KEY is configured
Authentication Error❌ Authentication Error (401) — Please check your XAI_API_KEY
Rate Limited⚠️ Rate Limited (429) — Please try again after some time
Timeout⏱️ Timeout — Check your network connection
Other Errors❌ Error — Check stderr for details

出力の補足

Output Supplements

スクリプトの出力をそのまま表示した後、Claudeが以下を補足してください:
After displaying the script output as-is, Claude should supplement the following:

stock の場合

For stock research

  • ファンダメンタルズデータと Grok リサーチの整合性を確認
  • バリュースコアと市場センチメントの乖離があれば指摘
  • 投資判断に影響する追加コンテキストがあれば補足
  • Verify consistency between fundamentals data and Grok research
  • Point out discrepancies between value scores and market sentiment
  • Add additional context that may impact investment decisions

industry の場合

For industry research

  • 日本市場固有の事情を補足（規制環境、参入障壁等）
  • 関連する銘柄スクリーニングの提案（/screen-stocks との連携）
  • Supplement Japan-specific market conditions (regulatory environment, entry barriers, etc.)
  • Propose related stock screening (integration with /screen-stocks)

market の場合

For market research

  • ポートフォリオへの影響を推定（/stock-portfolio との連携）
  • 類似過去事例があれば言及
  • Estimate impact on portfolios (integration with /stock-portfolio)
  • Mention similar past cases if applicable

business の場合

For business research

  • セグメント構成と株価バリュエーションの関係を考察
  • 収益モデルの持続性（ストック型は安定、フロー型は景気感応度高い等）
  • 競争優位性が実際の財務指標（ROE、利益率等）に表れているか確認
  • /stock-report
    の結果と合わせてファンダメンタルズとの整合性を補足
  • Analyze the relationship between segment structure and stock price valuation
  • Evaluate the sustainability of the revenue model (e.g., stock-type models are stable, flow-type models are highly cyclical)
  • Verify whether competitive advantages are reflected in actual financial metrics (ROE, profit margins, etc.)
  • Supplement consistency with fundamentals by combining with /stock-report results

実行例

Execution Examples

bash
undefined
bash
undefined

銘柄リサーチ

Stock Research

python3 .../run_research.py stock 7203.T python3 .../run_research.py stock AAPL
python3 .../run_research.py stock 7203.T python3 .../run_research.py stock AAPL

業界リサーチ

Industry Research

python3 .../run_research.py industry 半導体 python3 .../run_research.py industry "Electric Vehicles"
python3 .../run_research.py industry Semiconductors python3 .../run_research.py industry "Electric Vehicles"

マーケットリサーチ

Market Research

python3 .../run_research.py market 日経平均 python3 .../run_research.py market "S&P500"
python3 .../run_research.py market Nikkei Average python3 .../run_research.py market "S&P500"

ビジネスモデル分析

Business Model Analysis

python3 .../run_research.py business 7751.T python3 .../run_research.py business AAPL
undefined
python3 .../run_research.py business 7751.T python3 .../run_research.py business AAPL
undefined

前提知識統合ルール (KIK-466)

Context Integration Rules (KIK-466)

get_context.py の出力に以下がある場合、リサーチ結果と統合して回答する:
  • 保有銘柄との関連: リサーチ対象セクターにPF保有銘柄がある場合、「保有中の7203.Tに影響あり → ヘルスチェック推奨」
  • 過去リサーチ（SUPERSEDES）: 同一対象の前回リサーチと比較。「前回（2週間前）: センチメント中立 → 今回: やや強気」
  • 投資メモ: 対象銘柄の懸念・テーゼがあれば、リサーチ結果と照合して更新の示唆
  • ウォッチリスト: リサーチ対象がウォッチ中なら「監視中銘柄 → 買い時判断材料」と文脈を付加
If the following are present in the output of get_context.py, integrate them with the research results in the response:
  • Relevance to Held Stocks: If there are portfolio holdings in the research target sector, add: "Affects held stock 7203.T → Health check recommended"
  • Past Research (SUPERSEDES): Compare with previous research on the same target. E.g., "Previous (2 weeks ago): Neutral sentiment → Current: Slightly bullish"
  • Investment Notes: If there are concerns/theses about the target stock, cross-reference with research results and suggest updates
  • Watchlist: If the research target is on the watchlist, add context: "Monitored stock → Material for entry timing judgment"

分析結論の記録促し

Prompt to Record Analysis Conclusions

stock/business/industry リサーチで銘柄への見解・テーゼ性のある結論を含む回答をした場合:
💡 この分析はまだ投資メモとして記録されていません。テーゼ/懸念として記録しますか？
When providing responses containing opinions or thesis-driven conclusions for stock/business/industry research:
💡 This analysis has not yet been recorded as an investment note. Would you like to record it as a thesis/concern?