📈 OpenClaw Research Analyst v1.0

AI-powered stock & crypto research with 8-dimension analysis, portfolio tracking, and trend detection.

Features

| Feature | Description | |---------|-------------| | 8-Dimension Analysis | Earnings, fundamentals, analysts, momentum, sentiment, sector, market, history | | Crypto Support | Top 20 cryptos with market cap, BTC correlation, momentum | | Portfolio Management | Track holdings, P&L, concentration warnings | | Watchlist + Alerts | Price targets, stop losses, signal changes | | Dividend Analysis | Yield, payout, growth, safety score | | Hot Scanner | Multi-source viral trend detection (CoinGecko, Google News, Twitter/X) | | Rumor Detector | Early signal detection for M&A, insider trades, analyst actions | | Risk Detection | Geopolitical, earnings timing, overbought, risk-off | | China Markets | A-share & Hong Kong stock data (东方财富, 新浪, 财联社, 腾讯, 同花顺) | | Breaking News | Crisis keyword scanning (last 24h) |

Quick Start

Analyze Stocks

uv run scripts/stock_analyzer.py AAPL
uv run scripts/stock_analyzer.py AAPL MSFT GOOGL
uv run scripts/stock_analyzer.py AAPL --fast  # Skip slow analyses

Analyze Crypto

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

Dividend Analysis

uv run scripts/dividend_analyzer.py JNJ PG KO

Watchlist

uv run scripts/watchlist_manager.py add AAPL --target 200 --stop 150
uv run scripts/watchlist_manager.py list
uv run scripts/watchlist_manager.py check --notify

Portfolio

uv run scripts/portfolio_manager.py create "My Portfolio"
uv run scripts/portfolio_manager.py add AAPL --quantity 100 --cost 150
uv run scripts/portfolio_manager.py show

🔥 Hot Scanner (NEW)

# Full scan with all sources
python3 scripts/trend_scanner.py

# Fast scan (skip social media)
python3 scripts/trend_scanner.py --no-social

# JSON output for automation
python3 scripts/trend_scanner.py --json

Analysis Dimensions

Stocks (8 dimensions)

1. Earnings Surprise (30%) — EPS beat/miss
2. Fundamentals (20%) — P/E, margins, growth, debt
3. Analyst Sentiment (20%) — Ratings, price targets
4. Historical Patterns (10%) — Past earnings reactions
5. Market Context (10%) — VIX, SPY/QQQ trends
6. Sector Performance (15%) — Relative strength
7. Momentum (15%) — RSI, 52-week range
8. Sentiment (10%) — Fear/Greed, shorts, insiders

Crypto (3 dimensions)

• Market Cap & Category
• BTC Correlation (30-day)
• Momentum (RSI, range)

Dividend Metrics

| Metric | Description | |--------|-------------| | Yield | Annual dividend / price | | Payout Ratio | Dividend / EPS | | 5Y Growth | CAGR of dividend | | Consecutive Years | Years of increases | | Safety Score | 0-100 composite | | Income Rating | Excellent → Poor |

🔥 Hot Scanner

Find what's trending RIGHT NOW across stocks & crypto.

Data Sources

| Source | What it finds | |--------|---------------| | CoinGecko Trending | Top 15 trending coins | | CoinGecko Movers | Biggest gainers/losers (>3%) | | Google News | Breaking finance & crypto news | | Yahoo Finance | Top gainers, losers, most active | | Twitter/X | Social sentiment (requires auth) |

Output

📊 TOP TRENDING (by buzz):
   1. BTC      (6 pts) [CoinGecko, Google News] 📉 bearish (-2.5%)
   2. ETH      (5 pts) [CoinGecko, Twitter] 📉 bearish (-7.2%)
   3. NVDA     (3 pts) [Google News, Yahoo] 📰 Earnings beat...

🪙 CRYPTO HIGHLIGHTS:
   🚀 RIVER    River              +14.0%
   📉 BTC      Bitcoin             -2.5%

📈 STOCK MOVERS:
   🟢 NVDA (gainers)
   🔴 TSLA (losers)

📰 BREAKING NEWS:
   [BTC, ETH] Crypto crash: $2.5B liquidated...

Twitter/X Setup (Optional)

1. Install bird CLI: npm install -g @steipete/bird
2. Login to x.com in Safari/Chrome
3. Create .env file:

AUTH_TOKEN=your_auth_token
CT0=your_ct0_token

Get tokens from browser DevTools → Application → Cookies → x.com

Automation

Set up a daily cron job for morning reports:

# Run at 8 AM daily
0 8 * * * python3 /path/to/hot_scanner.py --no-social >> /var/log/hot_scanner.log

Risk Detection

• ⚠️ Pre-earnings warning (< 14 days)
• ⚠️ Post-earnings spike (> 15% in 5 days)
• ⚠️ Overbought (RSI > 70 + near 52w high)
• ⚠️ Risk-off mode (GLD/TLT/UUP rising)
• ⚠️ Geopolitical keywords (Taiwan, China, etc.)
• ⚠️ Breaking news alerts

Performance Options

| Flag | Speed | Description | |------|-------|-------------| | (default) | 60-120s | Full analysis with all data sources | | --no-insider | 50-90s | Skip SEC EDGAR insider trading | | --fast | 45-75s | Skip insider trading + breaking news |

Data Sources

US & Global Markets

• Yahoo Finance — Prices, fundamentals, movers
• CoinGecko — Crypto trending, market data
• CNN Fear & Greed — Sentiment
• SEC EDGAR — Insider trading
• Google News RSS — Breaking news
• Twitter/X — Social sentiment (via bird CLI)

China Markets (A-Share & Hong Kong)

• East Money 东方财富 — A-share & HK rankings, volume
• Sina Finance 新浪财经 — Real-time quotes
• CLS 财联社 — Real-time financial news & telegraph
• Tencent Finance 腾讯财经 — Money flow, concept plates
• 10jqka 同花顺 — Stock diagnosis, industry analysis, reports

See CN_DATA_SOURCES.md for Chinese market integration details.

Storage

| Data | Location | |------|----------| | Portfolios | ~/.clawdbot/skills/stock-analysis/portfolios.json | | Watchlist | ~/.clawdbot/skills/stock-analysis/watchlist.json |

Testing

uv run pytest scripts/tests.py -v

Limitations

• Yahoo Finance may lag 15-20 minutes
• Short interest lags ~2 weeks (FINRA)
• US markets only

Disclaimer

⚠️ NOT FINANCIAL ADVICE. For informational purposes only. Consult a licensed financial advisor before making investment decisions.

Built for OpenClaw 🦞 | ClawHub