mcpField
S
stock-analysis

stock-analysis

github.com/moinsen-devData & databases677 installsUpdated 39w ago
Repository

About stock-analysis

A command-line skill for analyzing US stocks and cryptocurrencies, tracking portfolios and watchlists, and scanning market trends and rumors. It combines weighted analysis, dividend metrics, alerts, and data from multiple sources for investors monitoring markets.

Key features

  1. 01Eight-dimension stock analysis
  2. 02Crypto market analysis
  3. 03Portfolio and watchlist management
  4. 04Dividend metrics and alerts
  5. 05Trend and rumor scanning

Use cases

  1. 01Compare several US stocks
  2. 02Review dividend income and safety
  3. 03Track assets with price alerts
  4. 04Scan for market trends and rumors

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/moinsen-dev/stock-analysis --skill stock-analysis

After installing, type/stock-analysisin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.gitignore
README.md
App-Plan.md
TODO.md
.clawdhub/
origin.json
docs/
README.md
HOT_SCANNER.md
CONCEPT.md
USAGE.md
ARCHITECTURE.md
scripts/
rumor_scanner.py
test_stock_analysis.py
watchlist.py
dividends.py
portfolio.py
hot_scanner.py
analyze_stock.py

Details

From the project README

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

  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)
# 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
DimensionWeightDescription
Earnings Surprise30%EPS beat/miss
Fundamentals20%P/E, margins, growth
Analyst Sentiment20%Ratings, price targets
Historical10%Past earnings reactions
Market Context10%VIX, SPY/QQQ trends
Sector15%Relative strength
Momentum15%RSI, 52-week range
Sentiment10%Fear/Greed, shorts, insiders
Crypto
  • Market Cap & Category
  • BTC Correlation (30-day)
  • Momentum (RSI, range)

Sentiment Sub-Indicators

IndicatorSourceSignal
Fear & GreedCNNContrarian (fear=buy)
Short InterestYahooSqueeze potential
VIX StructureFuturesStress detection
Insider TradesSEC EDGARSmart money
Put/Call RatioOptionsSentiment 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

FlagEffectSpeed
(default)Full analysis5-10s
--no-insiderSkip SEC EDGAR3-5s
--fastSkip insider + news2-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

FileLocation
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.

Comments

Markdown supported