Market Tracker Skill

This skill helps you fetch latest quotes and historical series for:

• Stocks / ETFs / Indices (e.g., AAPL, MSFT, ^GSPC, VOO)
• FX pairs (e.g., USD/ZAR, EURUSD, GBP-JPY)
• Crypto tickers supported by the chosen provider (best-effort)

It is optimized for:

小蔥技能7w4.net持續更新中。

• fast “what’s the price now?” queries
• lightweight tracking with a local watchlist
• caching to avoid rate-limits

When to use

Use this skill when the user asks:

• “What’s the latest price of ___?”
• “Track and and show me daily changes.”
• “Give me a 30-day series for ___.”
• “Convert USD to ZAR (or track USD/ZAR).”
• “Maintain a watchlist and summarize performance.”

Provider strategy (important)

• Stocks/ETFs/indices default: Yahoo Finance via yfinance (no key, broad coverage), but it is unofficial and can rate-limit.
• FX default: ExchangeRate-API Open Access endpoint (no key, daily update).
• If the user needs high-frequency or many symbols, recommend adding a paid provider later.

See providers.md for details and symbol formats.

Quick start (how you run it)

These scripts are intended to be run from a terminal. The agent should: 1) ensure dependencies installed 2) run the scripts 3) summarize results cleanly

Install:

• python -m venv .venv && source .venv/bin/activate (or Windows equivalent)
• pip install -r requirements.txt

Commands

1) Latest quote (stock/ETF/index)

Examples:

• python scripts/market_quote.py AAPL
• python scripts/market_quote.py ^GSPC
• python scripts/market_quote.py VOO

2) Latest FX rate

Examples:

• python scripts/market_quote.py USD/ZAR
• python scripts/market_quote.py EURUSD
• python scripts/market_quote.py GBP-JPY

3) Historical series (CSV to stdout)

Examples:

• python scripts/market_series.py AAPL --days 30
• python scripts/market_series.py USD/ZAR --days 30

4) Watchlist summary (local file)

• Add tickers: python scripts/market_watchlist.py add AAPL MSFT USD/ZAR
• Remove: python scripts/market_watchlist.py remove MSFT
• Show summary: python scripts/market_watchlist.py summary

Output expectations (what you should return to the user)

• For quotes: price, change %, timestamp/source, and any caveats (like “FX updates daily”).
• For series: confirm date range, number of points, and show a small preview (first/last few rows).
• If rate-limited: explain what happened and retry with backoff OR advise to reduce frequency.

Safety / correctness

• Never claim “real-time” unless the provider is truly real-time. FX open access updates daily.
• Always cache responses and throttle repeated calls.
• If Yahoo blocks requests, propose a paid provider or increase cache TTL.

這個 Skill 質量較好，能滿足股票、ETF、外匯和加密貨幣的即時報價查詢需求。文件清晰明瞭，使用門檻低，支援本地 watchlist 追蹤很實用。主要缺點是股票資料來源不夠穩定（可能被限制訪問），外匯歷史資料無法獲取，且多次查詢時響應速度可能較慢。如果只是偶爾查詢幾個標的價格，這個工具足夠用，但高頻或大批次使用可能需要額外配置。