同花顺 iFinD 接入 Skill

核心用法

本 Skill 是 OpenClaw 接入同花顺 iFinD 金融数据平台的官方工具，覆盖股票实时/历史行情、基本面财务指标、研究报告、因子数据、资金流向、涨停榜单、日期序列等专业金融数据需求。

推荐入口：smart-query 是智能主入口，Agent 应优先使用而非手写 api-call。针对明确场景可直接调用稳定命令：quote-realtime（实时行情）、quote-history（历史行情）、market-snapshot（大盘快照）、fundamental-basic（基础财务）。

鉴权流程：自动复用本地缓存 token → 过期自动 refresh → 必要时浏览器半自动登录 → 兜底支持用户手动设置双 token。浏览器自动化仅用于鉴权，不用于数据爬取。

自动兜底机制：行情类请求 iFinD 失败时自动回退腾讯财经公开源；涨停数据与 A 股榜单失败时自动回退东方财富接口。基本面、个股画像、资金流暂无公开源兜底。

显著优点

• 专业数据权威：直连 iFinD 金融终端级数据，覆盖 A 股、港股、美股等多市场
• 智能路由降低门槛：smart-query 自动识别意图，无需用户了解 API 结构
• 多源容错保障：核心行情与榜单数据具备双源备份，提升可用性
• 安全鉴权设计：Token 分级管理（access/refresh），浏览器自动化隔离敏感操作

局限性与风险

• 依赖商业授权：iFinD 为付费服务，无有效 token 时核心功能不可用
• 部分场景无兜底：深度财务、因子、研报等 iFinD 独占数据无免费替代源
• 浏览器依赖：macOS 默认 Chrome 路径，其他环境需手动配置 --browser-executable
• Token 安全：本地明文存储 token，共享环境存在泄露风险（需遵循第 9 条规则不回显）

适合人群

证券分析师、量化研究员、财经内容创作者、智能投顾开发者，以及需要程序化获取高质量金融数据的机构/个人用户。

常规风险提示

金融数据实时性强，API 延迟或故障可能导致交易决策偏差；自动兜底数据源与 iFinD 官方数据存在精度差异，关键场景建议人工复核；需确保 iFinD 账号合规使用，避免违反平台服务协议。

核心用法

同花顺iFinD Skill是面向金融数据查询场景的专业级API接入工具。用户可通过自然语言描述需求，Skill智能路由至最优数据源：核心行情数据（个股实时价、历史走势、大盘快照、基础财务指标）优先调用iFinD官方API；涨停数据与A股榜单查询在iFinD异常时自动降级至东方财富公开接口；常规行情类请求则具备腾讯财经公开源的兜底能力。

主要命令面覆盖四大场景：smart-query作为智能主入口自动解析用户意图；quote-realtime/quote-history/market-snapshot/fundamental-basic提供确定性行情与财务数据获取；api-call保留为高级兜底能力，需先查阅路由文档后使用；auth-login与auth-set-tokens完成Token生命周期管理。鉴权流程采用缓存复用→自动续期→浏览器登录→手动设置的四层降级机制，最大限度保障服务连续性。

显著优点

数据源权威性：直连同花顺iFinD官方API（quantapi.51ifind.com），覆盖A股、港股、美股等多市场实时行情、财务指标、研报数据、因子库等专业金融数据，数据质量与更新频率显著优于纯公开源方案。

智能降级机制：独创三层数据源架构——iFinD官方源为首选，腾讯财经与东方财富公开API为备用，在保障数据权威性的同时显著提升服务可用性，避免单点故障导致查询中断。

Token管理自动化：内置完整的OAuth2 Token生命周期管理，支持access_token自动续期、refresh_token持久化存储、浏览器半自动登录抓取双Token，大幅降低用户手动维护成本。

代码安全规范：通过CLS-Certify v2.1.0全量扫描认证，无eval/exec/system危险函数，依赖requests/playwright均为成熟开源库，网络传输强制HTTPS加密，Token存储采用原子写入防止文件损坏。

潜在缺点与局限性

凭证管理门槛：iFinD为付费金融数据服务，用户需自行拥有有效账号；浏览器自动化登录需本地安装Chrome/Edge浏览器，部分企业安全策略严格的环境可能受限；Token明文本地存储虽有权限控制但未加密，存在系统入侵后的泄露风险。

公开源稳定性：降级依赖的腾讯财经、东方财富公开API无SLA保障，接口变更或限流可能导致降级功能失效；涨停数据与A股榜单的降级逻辑完善，但财务指标、个股画像等核心功能暂无公开源兜底，iFinD不可用时直接不可用。

功能边界限制：Skill定位为数据获取层，不提供数据分析、可视化、策略回测等上层能力；api-call作为高级入口要求用户具备iFinD API文档阅读能力，对非技术背景用户不够友好。

适合的目标群体

• 量化研究员与个人投资者：需要程序化获取高质量金融数据，用于策略研究、组合监控、风险分析
• 金融产品经理与分析师：快速验证数据需求、搭建原型系统、生成市场洞察报告
• 财经内容创作者：获取实时行情、涨停数据、板块轮动信息，支撑内容生产
• 开发者与数据工程师：在Agent/自动化工作流中集成权威金融数据源

使用风险

性能风险：iFinD API存在调用频率与并发限制，高频查询可能触发限流；降级公开源的数据延迟高于官方API，实时交易场景需谨慎评估。

依赖项风险：Playwright浏览器自动化依赖Chromium内核，首次运行需下载浏览器二进制文件（约100MB+），网络受限环境可能初始化失败；requests/playwright版本兼容性需关注。

合规风险：金融数据使用需遵守iFinD服务协议，禁止未经授权的转售或公开传播；公开源数据抓取需遵守各平台robots.txt与服务条款。

安全风险：Token本地文件未加密存储，建议运行环境具备磁盘加密（如macOS FileVault）；浏览器自动化登录时账号密码在内存中短暂存在，需在可信设备上操作。