market-research

Original：🇨🇳 Chinese

Translated

1 scripts

In-depth research on stocks, industries, markets, and business models. Integrates Grok API (X/Web Search) and yfinance to generate comprehensive analytical reports.

2installs

Sourceokikusan-public/stock_skills

Added on2026-03-12

NPX Install

npx skill4agent add okikusan-public/stock_skills market-research

SKILL.md Content (Chinese)

View Translation Comparison →

In-Depth Research Skill

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>

Natural Language Routing

For natural language → skill determination, refer to .claude/rules/intent-routing.md.

Output by Research Type

stock (Stock Research)

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 Research)

Trends, Key Players, Growth Drivers, Risks, Regulatory Trends (Grok API)

market (Market Overview)

Price Movements, Macro Factors, Sentiment, Notable Events, Sector Rotation (Grok API)

business (Business Model Analysis)

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)

About APIs

Grok API

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)

Two-Tier Structure

Layer 1 (yfinance): Always available (fundamentals, stock price data)
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 Status Summary (KIK-431)

Display the Grok API status at the end of each report:

Status	Display
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

After displaying the script output as-is, Claude should supplement the following:

For stock research

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

For industry research

Supplement Japan-specific market conditions (regulatory environment, entry barriers, etc.)
Propose related stock screening (integration with /screen-stocks)

For market research

Estimate impact on portfolios (integration with /stock-portfolio)
Mention similar past cases if applicable

For business research

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