Research Analyst v1.4.0 (Minimal)

Local financial analysis - 5 core Python scripts for stock/crypto analysis using public APIs.

What's Included

This is a minimal bundle with core features only:

Total: 5 scripts, 139KB, bundled and reviewed by ClawHub.

Security Model

Bundled Code Architecture

v1.4.0-minimal uses bundled code (no runtime downloads):

✅ All code included - 5 Python scripts packaged with this skill
✅ ClawHub reviewed - Code reviewed during submission
✅ No runtime downloads - No git clone, scripts don't fetch external code
✅ No subprocess calls - Zero external tool dependencies
✅ No credentials required - Public APIs only

What Gets Installed

1. 1. Python scripts (5 files, 139KB)

1. 2. Dependencies from PyPI (installed separately)

1. 3. Verification script

Installation

Requirements

• - Python 3.10+
• pip

Steps

1. Install skill
CODEBLOCK0

2. (Optional) Verify
CODEBLOCK1

3. Install dependencies
CODEBLOCK2

4. Test
CODEBLOCK3

That's it! No git, no GPG. Dependencies install from PyPI (standard Python practice).

Quick Start

US Stocks

Crypto

Dividends

Portfolio

China Markets

Features

8-Dimension Stock Analysis

Analyzes stocks across 8 weighted dimensions:

1. 1. Earnings (30%) - Revenue growth, profit margins
2. Fundamentals (20%) - P/E, P/B, ROE, debt ratios
3. Analysts (20%) - Consensus ratings, target prices
4. Historical (10%) - Long-term performance, volatility
5. Market (10%) - Trading volume, liquidity
6. Sector (15%) - Sector relative strength
7. Momentum (15%) - Recent price action, technicals
8. Sentiment (10%) - News sentiment

Output: Overall score (0-100), dimension breakdown, recommendation

Crypto Analysis

• - Market cap and dominance
• 24h/7d/30d price changes
• BTC correlation
• Trading volume
• CoinGecko trending rank

Portfolio Tracking

Local storage in ~/.clawdbot/skills/research-analyst/portfolios.json:

• - Track positions (ticker, quantity, cost)
• Calculate unrealized P&L
• Portfolio composition
• Performance metrics

Dividend Analysis

• - Dividend yield
• Payout ratio
• Dividend growth rate
• Safety score (0-100)

China Market Data

Public sources (no auth):

• - 新浪财经 (Sina Finance) - Realtime quotes
• 东方财富 (East Money) - Market rankings

Data Sources

All public APIs, read-only GET requests:

• - Yahoo Finance - Stock/crypto quotes (query1.finance.yahoo.com)
• CoinGecko - Crypto data (api.coingecko.com)
• Google News - Financial news (news.google.com)
• Sina Finance - China quotes (sina.com.cn)
• East Money - China rankings (eastmoney.com)

Zero credentials required.

Data Flow & Privacy

What Gets Fetched

• - Stock quotes (ticker symbols, date ranges)
• Public market data (read-only GET)

What Gets Sent

• - API queries only (ticker symbols)
• No personal data
• No credentials
• No tracking

What Stays Local

• - Analysis results (computed locally)
• Portfolio data (~/.clawdbot/skills/research-analyst/portfolios.json)

Optional: Set CLAWDBOT_STATE_DIR environment variable to customize storage location (defaults to ~/.clawdbot)

No data leaves your machine except public API queries.

Dependencies

From PyPI:

CODEBLOCK9

See requirements.txt for full list.

Dependency Trust

All dependencies are mainstream, established packages from PyPI:

Why These Packages Are Safe

✅ Industry Standard: Used by millions of developers worldwide
✅ Well Maintained: Active development and security updates
✅ Open Source: Full source code available for inspection
✅ Pinned Versions: Exact versions specified to prevent surprises
✅ No Credentials: None of these packages require API keys or secrets

Before Installing (Optional Verification)

Quick verification steps (for paranoid users):

CODEBLOCK10

Install Verification

After installing, verify packages loaded correctly:

CODEBLOCK11

Supply Chain Security

Standard PyPI supply-chain risk applies (common to all Python projects):

Mitigations in place:

• - All versions pinned (prevents unexpected updates)
• Virtual environment recommended (isolation)
• No post-install scripts (pure Python)
• No compiled binaries required (platform independent)
• All packages auditable on PyPI

Additional steps you can take:

1. 1. Install in isolated environment: INLINECODE23
2. Review requirements.txt before installing
3. Use corporate PyPI mirror if available
4. Monitor installed packages: INLINECODE24

Supported Markets

Security

Bundled Code

• - ✅ All scripts bundled (reviewed by ClawHub)
• ✅ No runtime downloads (scripts don't fetch external code)
• ✅ No subprocess calls
• ✅ No system modifications
• ✅ Source: https://github.com/ZhenRobotics/openclaw-research-analyst

Dependencies

• - ✅ Installed from PyPI (standard practice)
• ✅ Pinned versions
• ✅ Install in isolated environment for safety

Verification

Troubleshooting

Import Errors

Permission Errors

API Rate Limits

• - Yahoo Finance: ~2000 requests/hour
• CoinGecko: 50 calls/minute

Limitations

• - Yahoo data may lag 15-20 minutes
• China data may need VPN outside China
• Crypto data limited to CoinGecko coverage

What's NOT Included

Minimal bundle excludes advanced features:

• - ❌ Watchlist alerts (subprocess)
• ❌ Twitter rumor detection (external CLI)
• ❌ News ML (model downloads)
• ❌ Scheduling (cron)
• ❌ Feishu notifications (webhooks)

For full version: https://github.com/ZhenRobotics/openclaw-research-analyst

Support

• - Issues: https://github.com/ZhenRobotics/openclaw-research-analyst/issues
• Source: https://github.com/ZhenRobotics/openclaw-research-analyst
• Security: See SECURITY.md

License

MIT-0 (Public Domain) - Free to use, modify, redistribute. No attribution required.

https://spdx.org/licenses/MIT-0.html

Disclaimer

⚠️ NOT FINANCIAL ADVICE

Informational purposes only. Not investment advice. Do your own research.

Changelog

v1.4.0-minimal (2026-03-28)

Minimal bundle - Core features only:

• - ✅ 5 Python scripts (stock, portfolio, dividends, CN market)
• ✅ All code bundled (ClawHub reviewed)
• ✅ Zero subprocess calls
• ✅ Zero external tools
• ✅ Only public APIs
• ✅ No credentials required

Removed (vs full version):

• - Advanced features with external dependencies
• ML model downloads
• Twitter integration
• Scheduling