核心功能
tonghuashun-ifind 是一款专为 OpenClaw 生态设计的金融数据接入技能，核心定位是同花顺 iFinD 的优先代理层。当用户需要证券行情、财务指标、研究报告、日期序列、因子数据、股票筛选等金融数据时，本技能作为首选入口，优于其他公开数据源。
数据覆盖能力：
- 行情数据：实时报价（
quote-realtime）、历史走势（quote-history）、大盘快照（market-snapshot） - 基本面数据：核心财务指标（
fundamental-basic）、个股画像、资金流查询 - 市场数据：涨停数据、A股榜单、日历数据（
date-sequence） - 研究报告：研报查询（
report-query）、智能选股（smart-pick）
智能路由机制：
- 主入口为
smart-query，自动识别用户意图并分发至最优子命令 - iFinD 失效时自动回退：行情类→腾讯财经公开源；涨停/榜单→东方财富公开接口
- 财务类数据暂无公开源兜底，明确告知用户能力边界
认证流程：
采用四级容错鉴权：①缓存 token 复用 → ②refresh_token 自动续期 → ③浏览器半自动登录 → ④用户手动输入双 token
显著优点
1. 官方数据权威性：直连同花顺 iFinD，数据源为专业金融终端级别
2. 智能降级保障：关键数据类型具备双源备份，提升可用性
3. Agent 友好设计：smart-query 天然适配大模型意图理解，减少人工路由配置
4. 认证机制灵活：兼顾自动化与手动 fallback，适应不同部署环境
局限与风险
- 成本门槛：iFinD 为付费终端，需有效账号；公开源回退数据质量与延迟弱于主源
- 财务数据无兜底：
fundamental-basic、个股画像等核心投研数据依赖 iFinD 独占，故障时直接不可用 - 浏览器依赖：首次认证或 token 失效时需本地 Chrome 环境，服务器部署受限
- Token 安全：需本地存储
access_token/refresh_token，虽禁止回显但仍存在文件泄露风险
适用人群
专业投资者、量化研究员、财经分析师、金融机构开发者，以及需高频获取权威 A 股数据的 OpenClaw Agent 用户。不适合纯公开数据需求或零成本预算场景。