83 lines
3.1 KiB
Markdown
83 lines
3.1 KiB
Markdown
---
|
||
name: finance
|
||
description: "追踪股票、ETF、指数、加密货币（如可用）和外汇货币对，具备缓存和提供商回退功能。"
|
||
metadata: {"clawdbot":{"config":{"requiredEnv":["TWELVEDATA_API_KEY","ALPHAVANTAGE_API_KEY"],"stateDirs":[".cache/finance"],"example":"# Optional (only if you add a paid provider later)\n# export TWELVEDATA_API_KEY=\"...\"\n# export ALPHAVANTAGE_API_KEY=\"...\"\n"}}}
|
||
---
|
||
|
||
# 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:
|
||
- 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.
|