同花顺金融数据服务

要解决的问题

金融数据查询在开发中常面临几个痛点：用户需要先理解 API 接口、参数格式和特定术语（如 thscode），这增加了集成成本和出错概率。不同的数据获取方式（如命令行工具、MCP 服务、REST API 或 Python 库）分散在不同生态中，缺乏一个统一入口来简化交互。此外，处理金融任务涉及多步骤逻辑：识别自然语言需求、消歧证券名称、选择合适的数据管道、执行查询并验证结果，这对工程师来说既繁琐又容易出错。

技能如何工作

该技能通过一个 统一 Agent 入口 来解决上述问题，其核心能力与关键步骤包括：

• 自然语言转换：用户可以直接用日常语言描述需求，例如“比较茅台和平安银行最近一年的走势”。技能会自动将其解析为明确的数据任务，无需用户指定技术参数。
• 智能任务路由：根据用户意图，技能将任务分类为 行情、财务、估值、指数与板块 等类别。例如，输入“查沪深 300 当前成分股”会被路由到指数与板块任务，并处理标的消歧（如将“沪深 300”转换为标准指数代码）。
• 接入方式决策：技能会探测当前环境（如是否安装 CLI、是否有 MCP 连接或 Python 项目），然后选择最合适的主路径：

- CLI：适合自动化或本地数据一体化场景，封装了远端取数与本地 DuckDB。
- MCP：适用于 Chat 或 IDE 会话，连接托管服务。
- REST API：提供零依赖的 HTTP 集成，可塑性最高。
- Python SDK：针对研究流程，支持二次开发。

• 统一凭据管理：所有远端方式共享一个 API Key，通过环境变量（如 HITHINK_FINANCE_API_KEY）或用户级凭据文件自动查找，避免重复配置。
• 执行与验证：查询完成后，技能会报告数据源、时间范围、复权口径（如默认使用前复权 forward）、结果行数和输出路径，并确保结果基于真实数据（不可用时明确说明原因）。

适用边界与注意点

该技能在设计上明确了能力范围，以帮助用户合理使用：

• 擅长领域：主要支持 A 股相关数据，包括行情与复权、集合竞价、财报与指标、最新估值快照、指数/板块/特色数据（如涨停、龙虎榜），以及公募基金资料、净值和场内行情。
• 需要用户确认的情况：当存在多个同名标的无法唯一消歧、或用户指定非默认参数（如特定复权方式或输出格式）时，技能会进行简短确认。
• 超出范围：明确不支持分钟级 K 线、tick 数据、Level-2 行情，也不涵盖港股/美股、基金申赎交易/推荐、期货/期权，或宏观数据/新闻公告原文/研报等。对于这些请求，技能会直接说明边界，而非提供近似数据。
• 最佳实践：避免先提供完整 thscode——技能会自动搜索消歧；切换接入方式时无需重复索要 Key，统一凭据可跨方式复用；使用最小有界请求（如单只股票查询）来验证认证状态，而非下载全市场数据。