1d5deac346
The locale switcher appeared broken because hardcoded markdown links (`](/docs/X)`) got double-prefixed by Docusaurus to `/docs/<locale>/docs/X` (404) in non-English locales, and the MDX hero `<a href>` on the index page escaped locale routing entirely. Changes: - Rewrite 922 `](/docs/X)` -> `](/X)` across 166 docs files (strip trailing .md too). Docusaurus prepends locale + baseUrl itself. - docs/index.md -> index.mdx; hero "Get Started" anchor -> Docusaurus <Link> so it stays inside the active locale. - Drop `ko` locale entirely from docusaurus.config.ts + delete i18n/ko/ (4 stale auto-translated kanban pages, <2% coverage, misleading). Verified `npm run build` succeeds for both en and zh-Hans; `build/zh-Hans/ index.html` has no /docs/zh-Hans/docs/... double-prefixed paths. PR2 will translate the 335 English docs into i18n/zh-Hans/.
3.5 KiB
| title | sidebar_label | description |
|---|---|---|
| Stocks — Stock quotes, history, search, compare, crypto via Yahoo | Stocks | Stock quotes, history, search, compare, crypto via Yahoo |
{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}
Stocks
Stock quotes, history, search, compare, crypto via Yahoo.
Skill metadata
| Source | Optional — install with hermes skills install official/finance/stocks |
| Path | optional-skills/finance/stocks |
| Version | 0.1.0 |
| Author | Mibay (Mibayy), Hermes Agent |
| License | MIT |
| Platforms | linux, macos, windows |
| Tags | Stocks, Finance, Market, Crypto, Investing |
| Related skills | dcf-model, comps-analysis, lbo-model |
Reference: full SKILL.md
:::info The following is the complete skill definition that Hermes loads when this skill is triggered. This is what the agent sees as instructions when the skill is active. :::
Stocks 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.