介绍
# Stock Analysis v6.1
使用 Yahoo Finance 数据分析美股与加密货币，支持 8 维度评分、投资组合管理、观察列表告警、股息分析，以及 **热点趋势检测**。
## v6.2 新增
- 🔮 **Rumor Scanner（传闻扫描）**：在主流新闻前捕捉早期信号 - 并购传闻与收购要约 - 内部人买卖动态 - 分析师上调/下调评级 - Twitter/X 中 “hearing that...” / “sources say...” 类信号 - 🎯 **Impact Scoring（影响评分）**：按潜在市场影响对传闻排序
## v6.1 包含
- 🔥 **Hot Scanner**：跨数据源发现热门股票与加密资产 - 🐦 **Twitter/X Integration**：通过 bird CLI 获取社交情绪 - 📰 **Multi-Source Aggregation**：聚合 CoinGecko、Google News、Yahoo Finance - ⏰ **Cron Support**：支持每日趋势报告
## v6.0 包含
- 🆕 **Watchlist + Alerts**：目标价、止损位、信号变化提醒 - 🆕 **Dividend Analysis**：收益率、派息率、增长与安全分 - 🆕 **Fast Mode**：`--fast` 跳过较慢分析（内部人、新闻） - 🆕 **性能优化**：`--no-insider` 加快执行
## Quick Commands
### Stock Analysis
```bash # 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)
```bash # 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)
```bash # 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
```bash # 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)
```bash # 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):** 1. Install bird: `npm install -g @steipete/bird` 2. Login to x.com in Safari/Chrome 3. Create `.env` with `AUTH_TOKEN` and `CT0`
### 🔮 Rumor Scanner (NEW v6.2)
```bash # 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, target changes - 🐦 Twitter Whispers — “hearing that...”, “sources say...”, “rumor” - ⚖️ SEC Activity — Investigations, filings
## Analysis Dimensions（股票 8 维 / 加密 3 维）
### 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)
## Risk Detection
- ⚠️ **Pre-Earnings** — 距离财报 < 14 天提醒 - ⚠️ **Post-Spike** — 5 天涨幅 >15% 预警 - ⚠️ **Overbought** — RSI >70 且接近 52 周高位 - ⚠️ **Risk-Off** — GLD/TLT/UUP 同时上行 - ⚠️ **Geopolitical** — 地缘政治关键词风险提示 - ⚠️ **Breaking News** — 近 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 数据可能延迟 15-20 分钟 - Short interest 数据通常滞后约 2 周（FINRA） - Insider trades 数据通常滞后 2-3 天（SEC filing） - 以美股市场为主，非美市场覆盖不完整 - Breaking news 为关键词匹配，且存在缓存延迟
## Disclaimer
⚠️ **NOT FINANCIAL ADVICE.** 本工具仅供信息参考。投资决策请咨询持牌专业顾问。