核心用法
YFinance Skill 是一套基于 Python yfinance 库的本地化股票数据获取方案。用户需先启动本地 FastAPI 服务（uvicorn main:app --host 0.0.0.0 --port 8000），随后通过 RESTful 端点获取：
1. 实时行情 (/price) —— 最新价格、涨跌幅度
2. 历史 OHLCV (/history) —— 支持自定义周期（period）与粒度（interval）
3. 公司基本面 (/fundamentals) —— P/E、市值、EPS、ROE 等关键指标
4. 股利历史 (/dividends)
5. 拆股记录 (/splits)
针对印尼雅加达交易所（IDX）做了深度优化：无后缀代码自动追加 .JK，无需手动输入。同时支持全球其他市场（如美股 AAPL、韩股 005930.KS）。
---
显著优点
- 本地化部署：数据经本地服务器中转，降低对外部 API 的直接依赖，便于内网或隐私敏感场景
- IDX 自动识别：简化印尼股票查询流程，降低用户门槛
- 多维度数据：覆盖价格、基本面、股利、拆股，满足投资分析全链路
- 双语支持：自动识别印尼语/英语请求并切换响应语言
- 轻量易扩展：基于 FastAPI，开发者可快速二次开发
---
潜在缺点与局限性
- 服务依赖：必须预装 Python3、pip/uv，并手动启动服务器，使用门槛高于纯 SaaS 方案
- 单点故障：本地服务崩溃或端口占用将导致全部功能不可用
- 数据源质量：Yahoo Finance 数据偶有延迟或错误，尤其小盘股、刚上市股票
- 无实时推送：仅支持轮询，非 WebSocket 实时流
- 印尼市场深度有限：部分 IDX 股票财务数据更新不及时
---
适合人群
- 印尼投资者：关注 BBCA、BBRI、TLKM、GOTO、ASII 等本地蓝筹
- 量化分析爱好者：需要结构化历史数据做回测
- 开发者/数据分析师：希望自建数据管道，避免第三方 API 限制
---
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据准确性 | Yahoo Finance 数据未经官方交易所认证，重大决策需交叉验证 |
| 服务可用性 | 本地服务器需常驻内存，重启后需手动拉起 |
| 依赖管理 | Python 环境、包版本冲突可能导致启动失败 |
| 合规风险 | 金融数据使用需遵守当地证券法规，禁止用于内幕交易或操纵市场 |