核心用法
同花顺iFinD Skill 是面向证券金融数据的统一接入层，专为需要实时行情、历史走势、基本面指标、研究报告、日期序列及因子筛选等场景设计。核心入口为 smart-query，可自动识别用户意图并路由至最优数据源；对于明确需求，可直接调用稳定命令如 quote-realtime（实时行情）、quote-history（历史走势）、market-snapshot（大盘快照）、fundamental-basic（基础财务指标）。行情类请求具备智能兜底机制：iFinD 不可用时自动回退至腾讯财经公开行情源。
鉴权采用三级缓存策略：优先复用本地 token 缓存，过期自动续期，无可用 token 时触发浏览器半自动登录，极端情况下支持用户手动注入双 token。所有敏感凭证（access_token/refresh_token）均不向用户回显。
显著优点
- 智能路由：
smart-query自动解析自然语言需求，降低 Agent 手写 API 调用的复杂度 - 稳定兜底：行情数据 iFinD 失效时自动切换腾讯财经，保障服务连续性
- 鉴权灵活：支持缓存复用、自动续期、浏览器登录、手动注入四种模式，适配不同环境
- 命令丰富：覆盖实时/历史行情、基本面、研报、日期序列、智能选股等全场景
- 安全可控：token 生命周期本地托管，禁止回显敏感凭证
潜在局限
- 基本面无兜底：
fundamental-basic暂不支持公开源 fallback，iFinD 不可用时直接失败 - 浏览器依赖：首次登录或 token 失效时需本地 Chrome 环境，无头服务器场景受限
- 高级接口需人工决策：非标准需求需人工查阅
references/routing.md和use-cases.md，自动化程度有限 - iFinD 覆盖盲区：部分细分数据 iFinD 未支持时，需明确告知用户而非自动扩展
适合人群
- 金融研究员、量化分析师、投资顾问等需要高频证券数据的专业用户
- 构建智能投研助手的 Agent 开发者
- 对数据实时性与多源可靠性有要求的企业级场景
常规风险
- 合规风险：iFinD 数据受同花顺商业授权约束，需确保调用方具备合法数据使用权限
- 稳定性风险：浏览器登录环节受本地环境（Chrome 版本、网络、验证码）影响，可能中断自动化流程
- 数据一致性：兜底至腾讯财经公开源时，行情延迟或字段精度可能与 iFinD 存在差异