Stock Market Pro

Yahoo Finance (yfinance) powered stock analysis skill: quotes, fundamentals, ASCII trends, high-resolution charts (RSI/MACD/BB/VWAP/ATR), plus optional web a...

Security Scan

The skill's code, dependencies, and instructions match its stated purpose (yfinance-based quoting, charting, optional DDG news and UnusualWhales scraping); there are no unexplained credential or install demands and no evidence of hidden exfiltration.

Purpose & Capability

Name/description (yfinance charts, quotes, news, options links) align with included files: yf.py implements yfinance charting/indicators, ddg_search.py and news.py provide DuckDuckGo searches, options_links.py prints Unusual Whales URLs, and uw.py implements an optional Playwright scraper. No unrelated credentials, binaries, or config paths are requested.

Instruction Scope

SKILL.md commands and subcommands map directly to the vendored scripts and their behaviors. The instructions remain within the stated scope (price/fundamentals/history/report/news/options). The only noteworthy expansion is the uw.py scraper which navigates UnusualWhales for optional live flow — this is consistent with the 'browser-first options/flow' description and the SKILL.md explicitly notes browser fallback.

Install Mechanism

This is instruction-only (no packaged install). Scripts include commented dependency lists and SKILL.md expects use of 'uv run --script' and pip installs (e.g., ddgs). uw.py depends on Playwright, which typically downloads browser binaries on install/runtime; SKILL.md does not automate that. This is not malicious but may surprise users: installing Playwright and other Python packages will pull network resources and write files to disk.

Credentials

The skill declares no required environment variables or credentials and the code does not attempt to read secrets or external config paths. Network access is used (yfinance, ddgs, Playwright-driven scraping) which is appropriate for a market-data/news/website-scraping tool.

Persistence & Privilege

The skill is not always-enabled and does not request elevated platform privileges. It does not modify other skills or agent-wide settings. The only persistence risk is typical for local Python tools (installed packages and Playwright browser binaries), which are limited to the host environment and expected for the provided functionality.

Assessment

This skill appears to do what it says: run local Python scripts that fetch market data, create charts, and optionally search news or scrape UnusualWhales. Before installing or running: 1) Review the included scripts (you already have the source) and run them in an isolated environment (virtualenv or container) if you don't trust the author. 2) Expect to pip-install dependencies (yfinance, ddgs, plot/ML libs) and for Playwright to download browser binaries; these actions require network access and will write files to disk. 3) The UnusualWhales helper scrapes a third-party site — respect that site's terms of use and be aware scraping may fail or require a browser session/cookies. 4) No credentials are required by the skill, so do not provide secrets. If you want higher assurance, run the tooling in a sandbox and monitor outgoing network connections during first use.

Stock Market Pro is a fast, local-first market research toolkit. Get clean price + fundamentals, generate publication-ready charts with indicator panels (RSI/MACD/BB/VWAP/ATR), and run a one-shot report that outputs both a summary and a high-res PNG. Optional add-ons: quick news link sweep (DDG) + browser-first options/flow (Unusual Whales).

What you can do

• Get real-time quotes (price + change)
• Summarize fundamentals (Market Cap, Forward PE, EPS, ROE)
• Print ASCII trends (terminal-friendly)
• Generate high-resolution PNG charts with overlays/panels:
  • RSI / MACD / Bollinger Bands / VWAP / ATR
• Run a one-shot report that prints a compact summary and emits a chart path
• Search news links via DuckDuckGo (ddgs)
• Open options / flow pages (browser-first, Unusual Whales)

---

Commands (Local)

This skill uses uv run --script for dependency handling. If you don't have uv: install from https://github.com/astral-sh/uv

1) Quotes

uv run --script scripts/yf.py price TSLA
# shorthand
uv run --script scripts/yf.py TSLA

2) Fundamentals

uv run --script scripts/yf.py fundamentals NVDA

3) ASCII trend

uv run --script scripts/yf.py history AAPL 6mo

4) Pro chart (PNG)

# candlestick (default)
uv run --script scripts/yf.py pro 000660.KS 6mo

# line chart
uv run --script scripts/yf.py pro 000660.KS 6mo line

Indicators (optional)

uv run --script scripts/yf.py pro TSLA 6mo --rsi --macd --bb
uv run --script scripts/yf.py pro TSLA 6mo --vwap --atr

• --rsi : RSI(14)
• --macd: MACD(12,26,9)
• --bb : Bollinger Bands(20,2)
• --vwap: VWAP (cumulative over the selected range)
• --atr : ATR(14)

5) One-shot report

Prints a compact text summary and generates a chart PNG.

uv run --script scripts/yf.py report 000660.KS 6mo
# output includes: CHART_PATH:/tmp/<...>.png

Optional web add-ons (news/options) can be appended by the agent workflow.

---

Web Add-ons (Optional)

A) News search (DuckDuckGo via ddgs)

This skill vendors a helper script (scripts/ddg_search.py).

Dependency:

pip3 install -U ddgs

Run:

python3 scripts/news.py NVDA --max 8
# or
python3 scripts/ddg_search.py "NVDA earnings guidance" --kind news --max 8 --out md

B) Options / Flow (browser-first)

Unusual Whales frequently blocks scraping/headless access. So the recommended approach is: open the pages in a browser and summarize what you can see.

Quick link helper:

python3 scripts/options_links.py NVDA

Common URLs:

• https://unusualwhales.com/stock/{TICKER}/overview
• https://unusualwhales.com/live-options-flow?ticker_symbol={TICKER}
• https://unusualwhales.com/stock/{TICKER}/options-flow-history

---

Subcommands (yf.py)

yf.py supports:

• price
• fundamentals
• history
• pro
• chart (alias)
• report
• option (best-effort; browser fallback recommended)

Check:

python3 scripts/yf.py --help

Ticker examples

• US: AAPL, NVDA, TSLA
• KR: 005930.KS, 000660.KS
• Crypto: BTC-USD, ETH-KRW
• FX: USDKRW=X