Stock Analysis Skill: 8-Dimension Scoring, Hot Scanner, and Rumor Detection

24,000+ downloads and 130 stars — stock-analysis by @udiedrichsen is the most comprehensive market data skill on ClawHub. Now at v6.2, it has grown from a basic stock analyzer into a multi-module system covering portfolio tracking, dividend income analysis, viral trend detection, and early market signal scanning.

The underlying data source is Yahoo Finance, which means no API key required for basic use. The skill wraps around Python scripts that Claude runs to pull live data.

What's Available

The skill exposes several distinct command sets:

The 8-Dimension Scoring System

Core stock analysis evaluates each ticker across 8 dimensions, producing a composite score and investment signal (BUY/HOLD/SELL):

uv run scripts/analyze_stock.py AAPL

Fast mode (skips insider trading and breaking news for speed):

uv run scripts/analyze_stock.py AAPL --fast

Multiple tickers in one run:

uv run scripts/analyze_stock.py AAPL MSFT GOOGL --fast

Crypto:

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

Dividend Analysis

For income investors, the dividend module is the standout feature:

# Full dividend analysis
uv run scripts/dividends.py JNJ
 
# Compare dividend stocks
uv run scripts/dividends.py JNJ PG KO MCD --output json

Metrics computed:

• Dividend Yield and Annual Payout
• Payout Ratio with classification (safe / moderate / high / unsustainable)
• 5-Year Dividend Growth (CAGR)
• Consecutive Years of Increases
• Safety Score (0–100)
• Income Rating (excellent / good / moderate / poor)

This is more useful than raw Yahoo Finance yield data because it contextualizes the numbers. A 7% yield with a 95% payout ratio and declining streak is very different from a 4% yield with 50% payout and 20 consecutive years of growth.

Watchlist + Alerts

# Add to watchlist
uv run scripts/watchlist.py add AAPL
 
# Add with price target alert
uv run scripts/watchlist.py add AAPL --target 200
 
# Add with stop loss
uv run scripts/watchlist.py add AAPL --stop 150
 
# Alert when BUY/SELL signal changes
uv run scripts/watchlist.py add AAPL --alert-on signal
 
# View current watchlist
uv run scripts/watchlist.py list
 
# Check for triggered alerts
uv run scripts/watchlist.py check
 
# Telegram-formatted output
uv run scripts/watchlist.py check --notify

The watchlist persists between sessions. Running /stock_alerts in Claude will trigger the check command and report any triggered conditions.

Hot Scanner (v6.1)

The Hot Scanner finds viral stocks and crypto before the crowd by aggregating multiple sources:

uv run scripts/hot_scanner.py

Sources: CoinGecko trending, Google News trending, Yahoo Finance trending, Twitter/X mentions (via bird CLI if available).

Output includes why each ticker is trending — news catalyst, social mention spike, volume anomaly — not just the name.

Rumor Scanner (v6.2)

New in v6.2, the Rumor Scanner is designed for early signal detection:

uv run scripts/rumor_scanner.py

What it looks for:

• M&A rumors and takeover bids
• Insider buying/selling activity
• Analyst upgrades/downgrades before announcement
• Twitter/X patterns: "hearing that...", "sources say...", "expecting news on..."

Each signal is impact-scored — ranked by potential market effect. Useful for research analysts and active traders who want to catch catalysts before they hit mainstream financial media.

Portfolio Management

# Add a position
uv run scripts/portfolio.py add AAPL 100 --cost 145.00
 
# View full portfolio summary
uv run scripts/portfolio.py summary
 
# Performance breakdown
uv run scripts/portfolio.py performance

Cost basis tracking lets you see actual P&L, not just price change.

Setup Requirements

The skill requires uv (the Python package manager):

# Install uv
brew install uv
 
# Then run any script — uv handles dependencies automatically
uv run scripts/analyze_stock.py AAPL

No Yahoo Finance API key needed for basic stock data. Twitter/X integration for the Hot Scanner requires the bird CLI configured separately. Telegram notifications require a bot token.

How to Install

clawhub install stock-analysis

Practical Tips

1. Use --fast by default — The full analysis with insider trading and breaking news can be slow. --fast gives you 90% of the value in a fraction of the time. Use full mode for deeper research on specific tickers.

2. Run the Rumor Scanner at market open — Early signals are most actionable when the market is active. Checking at 9:30-10am gives you the most relevant pre-announcement signals.

3. Combine dividend analysis with watchlist alerts — Add high-yield stocks to the watchlist with signal-change alerts. You'll know immediately when the thesis shifts.

4. Use --output json for Claude analysis — When comparing multiple stocks, JSON output lets Claude do structured analysis across the dataset rather than reading formatted tables.

5. Set cron for daily Hot Scanner reports — The skill supports cron scheduling. A daily 8am Hot Scanner report gives you a consistent starting point for morning research.

Considerations

• Yahoo Finance data quality — Data is generally reliable for US stocks, but can have delays or gaps for smaller tickers, international markets, and some crypto.
• Rumor Scanner signal quality — Social media signals include noise. Impact scores help filter, but human judgment is still required to evaluate whether a signal is substantive.
• uv required — If uv isn't installed, the scripts won't run. One-time setup, but it's a prerequisite.
• Market hours dependency — Analysis during pre-market or after-hours may reflect outdated prices for some metrics.

The Bigger Picture

stock-analysis has evolved from a simple ticker lookup into a research assistant layer. The progression from v6.0 (watchlists + alerts) → v6.1 (Hot Scanner) → v6.2 (Rumor Scanner) shows a clear direction: moving earlier in the information chain, from lagging indicators to leading signals.

For individual investors, financial advisors, or analysts who want to bring AI-assisted research into their workflow, it's a ready-made toolkit that doesn't require Bloomberg Terminal pricing.

View the skill on ClawHub: stock-analysis