Stocks
FreeAccess real-time stock and crypto market data easily.
Free · Opens the source repo
What Stocks does
The Stocks skill provides users with read-only access to market data sourced from Yahoo Finance. It allows for a variety of commands to retrieve information about stock prices, historical data, ticker searches, and cryptocurrency prices. With this skill, developers and designers can seamlessly integrate financial data queries into their applications or workflows without the need for API keys or additional library installations. It relies solely on Python's standard library, making it lightweight and easy to use.
This skill offers five primary commands: quote, search, history, compare, and crypto. Users can quickly get the current price of a stock or cryptocurrency, search for tickers by company name, retrieve historical price data over specified ranges, compare multiple stocks side by side, and access real-time cryptocurrency prices. The output from these commands is formatted as JSON, which can be easily parsed or manipulated using tools like jq for further analysis or integration.
While the Stocks skill is powerful, it does come with some caveats. Since it uses an unofficial API endpoint from Yahoo Finance, there is a risk of rate limiting or changes to the API that could affect functionality. Users can mitigate some of these risks by optionally setting an ALPHA_VANTAGE_KEY to provide additional data for certain fields that may return null due to session issues. This skill is particularly useful for developers looking to incorporate financial data into their applications without the overhead of managing API keys or external libraries.
Overall, the Stocks skill is an efficient tool for anyone needing quick access to stock and cryptocurrency information. Whether you're a developer building a finance-related application or a designer looking to incorporate market data into your projects, this skill provides a straightforward solution for accessing essential financial information.
When to use it
Use this skill when you need to retrieve current stock prices, historical data, or cryptocurrency prices in a Python environment.
When not to use it
This skill is not suitable for placing orders or integrating with trading accounts, as it only provides read-only data.
What you can build with it
Retrieving Current Stock Prices
Quickly get the latest prices for stocks like AAPL or TSLA using the `quote` command.
Historical Performance Analysis
Analyze stock performance over time by retrieving OHLCV data with the `history` command.
Comparing Multiple Stocks
Use the `compare` command to view side-by-side comparisons of several stocks to evaluate their performance.
How to install Stocks
View source1. Install with the skills CLI
npx skills add nousresearch/hermes-agent/stocks --agent claude-code2. Or install it manually
Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.
Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs
Inside SKILL.md
Written by nousresearchStocks Skill
Read-only market data via Yahoo Finance. Five commands: quote, search,
history, compare, crypto. Python stdlib only — no API key, no pip
installs. Yahoo's endpoint is unofficial and may rate-limit or change.
When to Use
- User asks for a current stock price (AAPL, TSLA, MSFT, ...)
- User wants to look up a ticker by company name
- User wants OHLCV history or performance over a date range
- User wants to compare several tickers side by side
- User asks for a crypto price (BTC, ETH, SOL, ...)
Prerequisites
Python 3.8+ stdlib only. Optional: set ALPHA_VANTAGE_KEY to enrich
market_cap, pe_ratio, and 52-week levels when Yahoo's crumb-protected
fields come back null. Free key: https://www.alphavantage.co/support/#api-key
How to Run
Invoke through the terminal tool. Once installed:
SCRIPT=~/.hermes/skills/finance/stocks/scripts/stocks_client.py
python3 $SCRIPT quote AAPL
All output is JSON on stdout — pipe through jq if you want to slice it.
Quick Reference
python3 $SCRIPT quote AAPL
python3 $SCRIPT quote AAPL MSFT GOOGL TSLA
python3 $SCRIPT search "Tesla"
python3 $SCRIPT history NVDA --range 6mo
python3 $SCRIPT compare AAPL MSFT GOOGL
python3 $SCRIPT crypto BTC ETH SOL
Commands
quote SYMBOL [SYMBOL2 ...]
Current price, change, change%, volume, 52-week high/low.
search QUERY
Find tickers by company name. Returns top 5: symbol, name, exchange, type.
history SYMBOL [--range RANGE]
Daily OHLCV plus stats (min, max, avg, total return %). Ranges: 1mo,
3mo, 6mo, 1y, 5y. Default: 1mo.
compare SYMBOL1 SYMBOL2 [...]
Side-by-side: price, change%, 52-week performance.
crypto SYMBOL [SYMBOL2 ...]
Crypto prices. Pass BTC (the script appends -USD automatically).
Pitfalls
- Yahoo Finance's API is unofficial. Endpoints can change or rate-limit without notice — if requests start failing, that's why.
market_capandpe_ratiomay return null onquotewhen Yahoo's crumb session isn't established. SetALPHA_VANTAGE_KEYto backfill.- Add a small delay between bulk requests to avoid rate-limiting.
- This is read-only — no order placement, no account integration.
Verification
python3 ~/.hermes/skills/finance/stocks/scripts/stocks_client.py quote AAPL
Returns a JSON object with symbol: "AAPL" and a numeric price field.
Frequently asked questions about Stocks
Similar skills
Initiating Coverage
Create institutional-quality equity research reports.
Financial Tear Sheet Generator
Create professional company profiles with live data.
Pitch Deck Population
Effortlessly fill pitch deck templates with data.
Tax Season Organizer
Streamline your tax prep for accountants.
Month End Prep
Streamline your month-end close process with ease.
Funding Digest
Summarize funding rounds in a single slide.