核心功能
本 Skill 是一套基于 Python 的金融市场数据获取工具，通过命令行脚本提供实时报价与历史价格序列查询能力。支持资产类别涵盖股票、ETF、指数（如 AAPL、VOO、^GSPC）、外汇货币对（USD/ZAR、EURUSD）及部分加密货币，采用分层供应商策略：默认使用 Yahoo Finance（yfinance 库，免API密钥但非官方接口）获取权益类资产，ExchangeRate-API 免费端点处理外汇日频数据，同时预留 Twelve Data、Alpha Vantage 等付费服务商接入能力。
显著优点
- 零门槛快速启动：核心功能无需 API 密钥，Python 虚拟环境 + pip 安装即可运行
- 智能缓存机制：本地
.cache/finance目录持久化存储，有效规避 Yahoo Finance 非官方接口的速率限制 - 供应商容错设计：内置多供应商回退逻辑，单点故障时可切换至备用数据源
- 本地化观察清单：
market_watchlist.py支持持久化持仓组合，一键生成组合表现摘要
局限性与风险
- 数据时效性限制：免费外汇数据源为日频更新，Yahoo Finance 存在 15-20 分钟延迟，严禁声称"实时"
- 非官方接口脆弱性：yfinance 依赖 Yahoo 未公开 API，存在无预警封锁或结构变更风险
- 高频场景不适用：大量标的同时查询或高频轮询易触发限流，需升级至付费供应商
- 加密货币覆盖有限：依赖供应商支持情况，标注为"尽力而为"(best-effort)
适用人群
个人投资者、小型资管团队、量化研究初学者，需低成本获取日频/延迟行情用于持仓监控或策略回测，不适合高频交易或毫秒级决策场景。
安全建议
- 生产环境建议配置付费 API 密钥替代 Yahoo Finance
- 设置合理缓存 TTL（建议 ≥5 分钟），避免重复请求
- 敏感持仓数据存储于本地 watchlist 文件，注意文件权限管理