Stock Analysis v6.1
Analyze US stocks and cryptocurrencies with 8-dimension analysis, portfolio management, watchlists, alerts, dividend analysis, and viral trend detection.
What's New in v6.2
- 🔮 Rumor Scanner — Early signals before mainstream news
- M&A rumors and takeover bids
- Insider buying/selling activity
- Analyst upgrades/downgrades
- Twitter/X "hearing that...", "sources say..." detection
- 🎯 Impact Scoring — Rumors ranked by potential market impact
What's in v6.1
- 🔥 Hot Scanner — Find viral stocks & crypto across multiple sources
- 🐦 Twitter/X Integration — Social sentiment via bird CLI
- 📰 Multi-Source Aggregation — CoinGecko, Google News, Yahoo Finance
- ⏰ Cron Support — Daily trend reports
What's in v6.0
- 🆕 Watchlist + Alerts — Price targets, stop losses, signal changes
- 🆕 Dividend Analysis — Yield, payout ratio, growth, safety score
- 🆕 Fast Mode —
--fast skips slow analyses (insider, news)
- 🆕 Improved Performance —
--no-insider for faster runs
Quick Commands
Stock Analysis
# Basic analysis
uv run {baseDir}/scripts/analyze_stock.py AAPL
# Fast mode (skips insider trading & breaking news)
uv run {baseDir}/scripts/analyze_stock.py AAPL --fast
# Compare multiple
uv run {baseDir}/scripts/analyze_stock.py AAPL MSFT GOOGL
# Crypto
uv run {baseDir}/scripts/analyze_stock.py BTC-USD ETH-USD
Dividend Analysis (NEW v6.0)
# Analyze dividends
uv run {baseDir}/scripts/dividends.py JNJ
# Compare dividend stocks
uv run {baseDir}/scripts/dividends.py JNJ PG KO MCD --output json
Dividend Metrics:
- Dividend Yield & Annual Payout
- Payout Ratio (safe/moderate/high/unsustainable)
- 5-Year Dividend Growth (CAGR)
- Consecutive Years of Increases
- Safety Score (0-100)
- Income Rating (excellent/good/moderate/poor)
Watchlist + Alerts (NEW v6.0)
# Add to watchlist
uv run {baseDir}/scripts/watchlist.py add AAPL
# With price target alert
uv run {baseDir}/scripts/watchlist.py add AAPL --target 200
# With stop loss alert
uv run {baseDir}/scripts/watchlist.py add AAPL --stop 150
# Alert on signal change (BUY→SELL)
uv run {baseDir}/scripts/watchlist.py add AAPL --alert-on signal
# View watchlist
uv run {baseDir}/scripts/watchlist.py list
# Check for triggered alerts
uv run {baseDir}/scripts/watchlist.py check
uv run {baseDir}/scripts/watchlist.py check --notify # Telegram format
# Remove from watchlist
uv run {baseDir}/scripts/watchlist.py remove AAPL
Alert Types:
- 🎯 Target Hit — Price >= target
- 🛑 Stop Hit — Price <= stop
- 📊 Signal Change — BUY/HOLD/SELL changed
Portfolio Management
# Create portfolio
uv run {baseDir}/scripts/portfolio.py create "Tech Portfolio"
# Add assets
uv run {baseDir}/scripts/portfolio.py add AAPL --quantity 100 --cost 150
uv run {baseDir}/scripts/portfolio.py add BTC-USD --quantity 0.5 --cost 40000
# View portfolio
uv run {baseDir}/scripts/portfolio.py show
# Analyze with period returns
uv run {baseDir}/scripts/analyze_stock.py --portfolio "Tech Portfolio" --period weekly
🔥 Hot Scanner (NEW v6.1)
# Full scan - find what's trending NOW
python3 {baseDir}/scripts/hot_scanner.py
# Fast scan (skip social media)
python3 {baseDir}/scripts/hot_scanner.py --no-social
# JSON output for automation
python3 {baseDir}/scripts/hot_scanner.py --json
Data Sources:
- 📊 CoinGecko Trending — Top 15 trending coins
- 📈 CoinGecko Movers — Biggest gainers/losers
- 📰 Google News — Finance & crypto headlines
- 📉 Yahoo Finance — Gainers, losers, most active
- 🐦 Twitter/X — Social sentiment (requires auth)
Output:
- Top trending by mention count
- Crypto highlights with 24h changes
- Stock movers by category
- Breaking news with tickers
Twitter Setup (Optional):
- Install bird:
npm install -g @steipete/bird
- Login to x.com in Safari/Chrome
- Create
.env with AUTH_TOKEN and CT0
🔮 Rumor Scanner (NEW v6.2)
# Find early signals, M&A rumors, insider activity
python3 {baseDir}/scripts/rumor_scanner.py
What it finds:
- 🏢 M&A Rumors — Merger, acquisition, takeover bids
- 👔 Insider Activity — CEO/Director buying/selling
- 📊 Analyst Actions — Upgrades, downgrades, price target changes
- 🐦 Twitter Whispers — "hearing that...", "sources say...", "rumor"
- ⚖️ SEC Activity — Investigations, filings
Impact Scoring:
- Each rumor is scored by potential market impact (1-10)
- M&A/Takeover: +5 points
- Insider buying: +4 points
- Upgrade/Downgrade: +3 points
- "Hearing"/"Sources say": +2 points
- High engagement: +2 bonus
Best Practice: Run at 07:00 before US market open to catch pre-market signals.
Analysis Dimensions (8 for stocks, 3 for crypto)
Stocks
| Dimension |
Weight |
Description |
| Earnings Surprise |
30% |
EPS beat/miss |
| Fundamentals |
20% |
P/E, margins, growth |
| Analyst Sentiment |
20% |
Ratings, price targets |
| Historical |
10% |
Past earnings reactions |
| Market Context |
10% |
VIX, SPY/QQQ trends |
| Sector |
15% |
Relative strength |
| Momentum |
15% |
RSI, 52-week range |
| Sentiment |
10% |
Fear/Greed, shorts, insiders |
Crypto
- Market Cap & Category
- BTC Correlation (30-day)
- Momentum (RSI, range)
Sentiment Sub-Indicators
| Indicator |
Source |
Signal |
| Fear & Greed |
CNN |
Contrarian (fear=buy) |
| Short Interest |
Yahoo |
Squeeze potential |
| VIX Structure |
Futures |
Stress detection |
| Insider Trades |
SEC EDGAR |
Smart money |
| Put/Call Ratio |
Options |
Sentiment extreme |
Risk Detection
- ⚠️ Pre-Earnings — Warns if < 14 days to earnings
- ⚠️ Post-Spike — Flags if up >15% in 5 days
- ⚠️ Overbought — RSI >70 + near 52w high
- ⚠️ Risk-Off — GLD/TLT/UUP rising together
- ⚠️ Geopolitical — Taiwan, China, Russia, Middle East keywords
- ⚠️ Breaking News — Crisis keywords in last 24h
Performance Options
| Flag |
Effect |
Speed |
| (default) |
Full analysis |
5-10s |
--no-insider |
Skip SEC EDGAR |
3-5s |
--fast |
Skip insider + news |
2-3s |
Supported Cryptos (Top 20)
BTC, ETH, BNB, SOL, XRP, ADA, DOGE, AVAX, DOT, MATIC, LINK, ATOM, UNI, LTC, BCH, XLM, ALGO, VET, FIL, NEAR
(Use -USD suffix: BTC-USD, ETH-USD)
Data Storage
| File |
Location |
| Portfolios |
~/.clawdbot/skills/stock-analysis/portfolios.json |
| Watchlist |
~/.clawdbot/skills/stock-analysis/watchlist.json |
Limitations
- Yahoo Finance may lag 15-20 minutes
- Short interest lags ~2 weeks (FINRA)
- Insider trades lag 2-3 days (SEC filing)
- US markets only (non-US incomplete)
- Breaking news: 1h cache, keyword-based
Disclaimer
⚠️ NOT FINANCIAL ADVICE. For informational purposes only. Consult a licensed financial advisor before making investment decisions.
1---2name: stock-analysis3description: Analyze stocks and cryptocurrencies using Yahoo Finance data. Supports portfolio management, watchlists with alerts, dividend analysis, 8-dimension stock scoring, viral trend detection (Hot Scanner), and rumor/early signal detection. Use for stock analysis, portfolio tracking, earnings reactions, crypto monitoring, trending stocks, or finding rumors before they hit mainstream.4---56# Stock Analysis v6.178Analyze US stocks and cryptocurrencies with 8-dimension analysis, portfolio management, watchlists, alerts, dividend analysis, and **viral trend detection**.910## What's New in v6.21112- 🔮 **Rumor Scanner** — Early signals before mainstream news13 - M&A rumors and takeover bids14 - Insider buying/selling activity15 - Analyst upgrades/downgrades16 - Twitter/X "hearing that...", "sources say..." detection17- 🎯 **Impact Scoring** — Rumors ranked by potential market impact1819## What's in v6.12021- 🔥 **Hot Scanner** — Find viral stocks & crypto across multiple sources22- 🐦 **Twitter/X Integration** — Social sentiment via bird CLI23- 📰 **Multi-Source Aggregation** — CoinGecko, Google News, Yahoo Finance24- ⏰ **Cron Support** — Daily trend reports2526## What's in v6.02728- 🆕 **Watchlist + Alerts** — Price targets, stop losses, signal changes29- 🆕 **Dividend Analysis** — Yield, payout ratio, growth, safety score30- 🆕 **Fast Mode** — `--fast` skips slow analyses (insider, news)31- 🆕 **Improved Performance** — `--no-insider` for faster runs3233## Quick Commands3435### Stock Analysis36```bash37# Basic analysis38uv run {baseDir}/scripts/analyze_stock.py AAPL3940# Fast mode (skips insider trading & breaking news)41uv run {baseDir}/scripts/analyze_stock.py AAPL --fast4243# Compare multiple44uv run {baseDir}/scripts/analyze_stock.py AAPL MSFT GOOGL4546# Crypto47uv run {baseDir}/scripts/analyze_stock.py BTC-USD ETH-USD48```4950### Dividend Analysis (NEW v6.0)51```bash52# Analyze dividends53uv run {baseDir}/scripts/dividends.py JNJ5455# Compare dividend stocks56uv run {baseDir}/scripts/dividends.py JNJ PG KO MCD --output json57```5859**Dividend Metrics:**60- Dividend Yield & Annual Payout61- Payout Ratio (safe/moderate/high/unsustainable)62- 5-Year Dividend Growth (CAGR)63- Consecutive Years of Increases64- Safety Score (0-100)65- Income Rating (excellent/good/moderate/poor)6667### Watchlist + Alerts (NEW v6.0)68```bash69# Add to watchlist70uv run {baseDir}/scripts/watchlist.py add AAPL7172# With price target alert73uv run {baseDir}/scripts/watchlist.py add AAPL --target 2007475# With stop loss alert76uv run {baseDir}/scripts/watchlist.py add AAPL --stop 1507778# Alert on signal change (BUY→SELL)79uv run {baseDir}/scripts/watchlist.py add AAPL --alert-on signal8081# View watchlist82uv run {baseDir}/scripts/watchlist.py list8384# Check for triggered alerts85uv run {baseDir}/scripts/watchlist.py check86uv run {baseDir}/scripts/watchlist.py check --notify # Telegram format8788# Remove from watchlist89uv run {baseDir}/scripts/watchlist.py remove AAPL90```9192**Alert Types:**93- 🎯 **Target Hit** — Price >= target94- 🛑 **Stop Hit** — Price <= stop95- 📊 **Signal Change** — BUY/HOLD/SELL changed9697### Portfolio Management98```bash99# Create portfolio100uv run {baseDir}/scripts/portfolio.py create "Tech Portfolio"101102# Add assets103uv run {baseDir}/scripts/portfolio.py add AAPL --quantity 100 --cost 150104uv run {baseDir}/scripts/portfolio.py add BTC-USD --quantity 0.5 --cost 40000105106# View portfolio107uv run {baseDir}/scripts/portfolio.py show108109# Analyze with period returns110uv run {baseDir}/scripts/analyze_stock.py --portfolio "Tech Portfolio" --period weekly111```112113### 🔥 Hot Scanner (NEW v6.1)114```bash115# Full scan - find what's trending NOW116python3 {baseDir}/scripts/hot_scanner.py117118# Fast scan (skip social media)119python3 {baseDir}/scripts/hot_scanner.py --no-social120121# JSON output for automation122python3 {baseDir}/scripts/hot_scanner.py --json123```124125**Data Sources:**126- 📊 CoinGecko Trending — Top 15 trending coins127- 📈 CoinGecko Movers — Biggest gainers/losers128- 📰 Google News — Finance & crypto headlines129- 📉 Yahoo Finance — Gainers, losers, most active130- 🐦 Twitter/X — Social sentiment (requires auth)131132**Output:**133- Top trending by mention count134- Crypto highlights with 24h changes135- Stock movers by category136- Breaking news with tickers137138**Twitter Setup (Optional):**1391. Install bird: `npm install -g @steipete/bird`1402. Login to x.com in Safari/Chrome1413. Create `.env` with `AUTH_TOKEN` and `CT0`142143### 🔮 Rumor Scanner (NEW v6.2)144```bash145# Find early signals, M&A rumors, insider activity146python3 {baseDir}/scripts/rumor_scanner.py147```148149**What it finds:**150- 🏢 **M&A Rumors** — Merger, acquisition, takeover bids151- 👔 **Insider Activity** — CEO/Director buying/selling152- 📊 **Analyst Actions** — Upgrades, downgrades, price target changes153- 🐦 **Twitter Whispers** — "hearing that...", "sources say...", "rumor"154- ⚖️ **SEC Activity** — Investigations, filings155156**Impact Scoring:**157- Each rumor is scored by potential market impact (1-10)158- M&A/Takeover: +5 points159- Insider buying: +4 points160- Upgrade/Downgrade: +3 points161- "Hearing"/"Sources say": +2 points162- High engagement: +2 bonus163164**Best Practice:** Run at 07:00 before US market open to catch pre-market signals.165166## Analysis Dimensions (8 for stocks, 3 for crypto)167168### Stocks169| Dimension | Weight | Description |170|-----------|--------|-------------|171| Earnings Surprise | 30% | EPS beat/miss |172| Fundamentals | 20% | P/E, margins, growth |173| Analyst Sentiment | 20% | Ratings, price targets |174| Historical | 10% | Past earnings reactions |175| Market Context | 10% | VIX, SPY/QQQ trends |176| Sector | 15% | Relative strength |177| Momentum | 15% | RSI, 52-week range |178| Sentiment | 10% | Fear/Greed, shorts, insiders |179180### Crypto181- Market Cap & Category182- BTC Correlation (30-day)183- Momentum (RSI, range)184185## Sentiment Sub-Indicators186187| Indicator | Source | Signal |188|-----------|--------|--------|189| Fear & Greed | CNN | Contrarian (fear=buy) |190| Short Interest | Yahoo | Squeeze potential |191| VIX Structure | Futures | Stress detection |192| Insider Trades | SEC EDGAR | Smart money |193| Put/Call Ratio | Options | Sentiment extreme |194195## Risk Detection196197- ⚠️ **Pre-Earnings** — Warns if < 14 days to earnings198- ⚠️ **Post-Spike** — Flags if up >15% in 5 days199- ⚠️ **Overbought** — RSI >70 + near 52w high200- ⚠️ **Risk-Off** — GLD/TLT/UUP rising together201- ⚠️ **Geopolitical** — Taiwan, China, Russia, Middle East keywords202- ⚠️ **Breaking News** — Crisis keywords in last 24h203204## Performance Options205206| Flag | Effect | Speed |207|------|--------|-------|208| (default) | Full analysis | 5-10s |209| `--no-insider` | Skip SEC EDGAR | 3-5s |210| `--fast` | Skip insider + news | 2-3s |211212## Supported Cryptos (Top 20)213214BTC, ETH, BNB, SOL, XRP, ADA, DOGE, AVAX, DOT, MATIC, LINK, ATOM, UNI, LTC, BCH, XLM, ALGO, VET, FIL, NEAR215216(Use `-USD` suffix: `BTC-USD`, `ETH-USD`)217218## Data Storage219220| File | Location |221|------|----------|222| Portfolios | `~/.clawdbot/skills/stock-analysis/portfolios.json` |223| Watchlist | `~/.clawdbot/skills/stock-analysis/watchlist.json` |224225## Limitations226227- Yahoo Finance may lag 15-20 minutes228- Short interest lags ~2 weeks (FINRA)229- Insider trades lag 2-3 days (SEC filing)230- US markets only (non-US incomplete)231- Breaking news: 1h cache, keyword-based232233## Disclaimer234235⚠️ **NOT FINANCIAL ADVICE.** For informational purposes only. Consult a licensed financial advisor before making investment decisions.
kbarbel640-del