← Back to Skills Marketplace
udiedrichsen

Stock Analysis

by udiedrichsen · GitHub ↗ · v6.2.0
cross-platform ⚠ suspicious
54366
Downloads
243
Stars
626
Active Installs
10
Versions
Install in OpenClaw
/install stock-analysis
Description
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.
Usage Guidance
Install only if you are comfortable with the optional Twitter/X scanners. Avoid providing AUTH_TOKEN or CT0 unless you understand they are live session credentials, do not grant Terminal Full Disk Access casually, keep any .env file out of shared folders or repositories, and prefer running the finance-only commands or hot scanner with --no-social when you do not need social-media data.
Capability Analysis
Type: OpenClaw Skill Name: stock-analysis Version: 6.2.0 The skill is classified as suspicious due to its reliance on an external, user-installed `bird` CLI tool for Twitter/X integration, as detailed in `SKILL.md`, `README.md`, `scripts/hot_scanner.py`, and `scripts/rumor_scanner.py`. This external dependency introduces a supply chain risk, as the security of the skill becomes dependent on the security of the `bird` binary. Furthermore, the skill instructs users to manually extract sensitive `AUTH_TOKEN` and `CT0` session cookies from their browser and store them in a `.env` file, which are then loaded by the Python scripts and passed to the `bird` CLI. While the skill's own code does not appear to intentionally exfiltrate these credentials, this practice exposes sensitive user session tokens to an external binary, significantly increasing the attack surface and potential for unauthorized access if the `bird` CLI or the user's environment is compromised.
Capability Assessment
Purpose & Capability
Core stock, crypto, portfolio, watchlist, dividend, trend, and rumor analysis are coherent with the stated purpose, but the Twitter/X rumor and sentiment feature materially broadens the trust boundary by relying on browser session cookies and an external bird executable.
Instruction Scope
The docs disclose Twitter/X setup as optional, but they understate the sensitivity of AUTH_TOKEN and CT0 cookies and do not clearly separate safer read-only finance analysis from higher-risk social scraping paths; rumor_scanner runs Twitter searches by default.
Install Mechanism
The install metadata only declares uv, while the documentation separately instructs users to install bird via brew or npm; that external executable is unpinned and outside the skill's reviewed code.
Credentials
hot_scanner.py and rumor_scanner.py load .env values into the process environment and pass the full environment to bird, which can expose unrelated secrets as well as X/Twitter session tokens.
Persistence & Privilege
Portfolio and watchlist JSON persistence is purpose-aligned and documented, but the social setup also recommends Terminal Full Disk Access and local .env storage of session cookies, which is broader privilege and persistence than the optional feature warrants.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install stock-analysis
  3. After installation, invoke the skill by name or use /stock-analysis
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v6.2.0
🔮 Rumor Scanner: M&A rumors, insider activity, Twitter whispers, impact scoring
v6.1.0
**Major update: Viral trend detection ("Hot Scanner") and social media integration.** - Added Hot Scanner to detect trending stocks and crypto from CoinGecko, Yahoo Finance, Google News, and Twitter/X. - Introduced new /stock_hot command for finding viral assets. - Added Twitter/X integration for social sentiment in Hot Scanner (optional setup). - Expanded documentation: new concept, architecture, usage, and hot scanner docs. - Enhanced cron support for daily trend reports. - Existing features (analysis, alerts, dividend, portfolio) unchanged.
v6.0.0
Watchlist + Alerts, Dividend Analysis, Fast Mode, Tests
v5.0.0
Portfolio management, crypto analysis (Top 20), periodic reports (daily/weekly/monthly/quarterly/yearly)
v4.0.0
v4.0.0: Geopolitical Risk & News Sentiment Major new features: • Safe-haven indicators (GLD, TLT, UUP) with risk-off detection • Breaking news check (Google News RSS) for crisis keywords • Geopolitical sector risk mapping (Taiwan, China, Russia, Middle East, banking) • Automatic confidence penalties for affected tickers/sectors (15-30%) • Up to 5 caveats in output (was 3) Risk detection: • Flight to safety detection across gold, treasuries, USD • Crisis keyword scanning (war, recession, sanctions, disasters) • Sector-specific exposure warnings • 1-hour cache for breaking news and shared indicators
v3.5.0
Major performance upgrade: Async parallel fetching (6-10s → 3-5s per stock) + caching for shared indicators (Fear/Greed, VIX). Multi-stock analysis now ~3x faster. All 5 sentiment indicators fetch in parallel with 10s timeouts. Fear & Greed Index and VIX term structure cached for 1h.
v3.0.0
Add comprehensive sentiment analysis with 5 indicators: Fear & Greed Index, short interest, VIX term structure, insider trading, and put/call ratio. Sentiment adds 10% weight to overall recommendation. Runtime increased to 6-10s per stock.
v2.0.0
Major enhancement: Added market context (VIX, SPY/QQQ), sector performance comparison, earnings timing warnings (pre/post-earnings), and momentum analysis (RSI, 52w range). Now detects 'sell the news' scenarios, overbought conditions, and sector rotation. Helps avoid losses like the BAC scenario by warning about high-risk entry points. All 7 dimensions now analyzed with smart recommendation overrides.
v1.0.1
Fix: Add explicit instructions to prevent agent from adding extra text in command invocation
v1.0.0
Initial release: Analyze US stocks during earnings season with buy/hold/sell signals based on earnings surprises, fundamentals (P/E, margins, growth, debt), analyst sentiment, and historical patterns. Uses Yahoo Finance data via yfinance library.
Metadata
Slug stock-analysis
Version 6.2.0
License
All-time Installs 2072
Active Installs 626
Total Versions 10
Frequently Asked Questions

What is Stock Analysis?

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. It is an AI Agent Skill for Claude Code / OpenClaw, with 54366 downloads so far.

How do I install Stock Analysis?

Run "/install stock-analysis" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Stock Analysis free?

Yes, Stock Analysis is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Stock Analysis support?

Stock Analysis is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Stock Analysis?

It is built and maintained by udiedrichsen (@udiedrichsen); the current version is v6.2.0.

💬 Comments