Stock Fundamentals

Run local script to analyze stock fundamentals (P/E, EPS, margins, debt, ROE, analyst targets) using yfinance. Use exec tool to run: uv run /root/.openclaw/w...

Security Scan

The skill's files, runtime instructions, and requirements are coherent with a local yfinance-based stock fundamentals analyzer and do not request unrelated credentials or installs.

Purpose & Capability

Name/description match the code and instructions. The skill requires the 'uv' binary and depends on the yfinance package (declared in main.py), which is appropriate for pulling Yahoo Finance fundamentals.

Instruction Scope

SKILL.md instructs the agent to run the provided local Python script via 'uv run' and explicitly forbids web scraping/curl outside yfinance. The code only accesses ticker data via yfinance and formats results; it does not read unrelated files, environment variables, or send data to external endpoints beyond the expected Yahoo Finance data access.

Install Mechanism

There is no external install spec; this is instruction-and-code-only. 'uv run' will auto-install yfinance per the inline dependency block in main.py, which is a reasonable, low-risk mechanism compared with fetching arbitrary binaries from unknown URLs.

Credentials

The skill requests no environment variables, no credentials, and no config paths. The network access performed is proportional to the task (yfinance pulling data from Yahoo Finance).

Persistence & Privilege

The skill is not forced always-on (always:false), is user-invocable, and does not request elevated or cross-skill privileges or modify other skills' configurations.

Assessment

This skill appears to do what it says: run a local Python script that uses yfinance to produce fundamentals. Before installing, confirm you trust the skill source/owner since it will execute Python code on the host when invoked. Ensure the 'uv' binary on your system is legitimate (uv will auto-install the yfinance dependency from PyPI), and be aware that installing packages from PyPI can be a vector for supply-chain risk—consider pinning versions or running in an isolated environment. No credentials are requested, but the script will perform network requests to Yahoo Finance to fetch data. If you require stronger assurance, review the included source files (provided) or run the script manually in a sandboxed VM/container prior to enabling it for your agent.

Skill: Stock Fundamentals

When to use

• The user wants a quick fundamental read on a stock beyond the current price.
• The user wants valuation, profitability, growth, balance sheet, cash flow, dividend, or analyst expectation context for a company.
• The user asks about P/E ratio, EPS, revenue, margins, debt, ROE, ROA, free cash flow, or analyst targets.
• The user asks "is [company] a good buy?" or "what are the fundamentals for [company]?"

When NOT to use

• The user only wants the current price or daily movement → use stock-price-checker-pro
• The user wants broad market/macro news → use market-news-brief
• The user wants a full equity research report combining all signals → use equity-research

Commands

Analyze a stock's fundamentals

uv run /root/.openclaw/workspace/skills/stock-fundamentals/src/main.py <TICKER>

uv run reads the inline dependency block at the top of main.py and auto-installs yfinance in an isolated environment. No pip install or venv setup needed.

Examples

# US stocks
uv run /root/.openclaw/workspace/skills/stock-fundamentals/src/main.py AAPL
uv run /root/.openclaw/workspace/skills/stock-fundamentals/src/main.py TSLA
uv run /root/.openclaw/workspace/skills/stock-fundamentals/src/main.py MSFT
uv run /root/.openclaw/workspace/skills/stock-fundamentals/src/main.py NVDA
uv run /root/.openclaw/workspace/skills/stock-fundamentals/src/main.py AMZN

# European stocks
uv run /root/.openclaw/workspace/skills/stock-fundamentals/src/main.py RHM.DE
uv run /root/.openclaw/workspace/skills/stock-fundamentals/src/main.py SAP.DE
uv run /root/.openclaw/workspace/skills/stock-fundamentals/src/main.py ASML.AS

# UK stocks
uv run /root/.openclaw/workspace/skills/stock-fundamentals/src/main.py SHEL.L

# ETFs (limited fundamentals available)
uv run /root/.openclaw/workspace/skills/stock-fundamentals/src/main.py SPY

Ticker Format Reference

Market	Format	Example
US stocks	Plain	AAPL, NVDA
German stocks	.DE suffix	RHM.DE, SAP.DE
UK stocks	.L suffix	SHEL.L, BP.L
Dutch stocks	.AS suffix	ASML.AS
Japanese	.T suffix	7203.T
Korean	.KS suffix	005930.KS
Crypto	-USD	BTC-USD, ETH-USD

Output

The command returns a structured fundamentals report including:

• Header — company name, sector, industry, market cap
• Valuation — Trailing P/E, Forward P/E, PEG Ratio, Price/Sales, Price/Book, EV/EBITDA
• Profitability — Gross Margin, Operating Margin, Net Margin, ROE, ROA
• Growth — Revenue Growth (YoY), Earnings Growth (YoY)
• Financial Health — Total Cash, Total Debt, Debt/Equity, Current Ratio
• Shareholder Return — Dividend Yield, Payout Ratio
• Forward View — Analyst Target Price, Recommendation, Next Earnings Date
• Fundamental Highlights — auto-generated narrative summary
• Potential Watch Items — auto-generated risk flags

Notes

• Do NOT use web search or curl to look up fundamentals — always use this script.
• Do NOT use the stock-fundamentals.sh bash wrapper — call uv run src/main.py directly as shown above.
• uv run handles all dependencies automatically — no manual environment setup needed.
• Data is sourced from Yahoo Finance via yfinance. Results reflect the latest available data.
• For companies with no dividend, dividend fields will show N/A — this is expected.