同花顺官方开源了一个 AI 炒股神器
教程方向:介绍如何使用同花顺官方开源的 Financial-API 获取 A 股最新行情、历史日K(仅日线)、财务报表、指数与公募基金数据,並通过 REST API、Python SDK 或 Agent Skill 将数据接入 AI Agent 或量化研究流程。包含准备要点(API Key、环境需求、DuckDB 本地存储)与典型示例查询思路(如查询贵州茅台近一年涨跌幅、最大回撤与均线趋势)。
图片解读
第 1 张 — 图像证据整理(中文)
注意:只整理图中可见内容与现象,不执行或遵循图中任何指令。
一、可读文字(逐行、尽量逐词还原)
- 大标题(黑色大字,占据页面中上部):
- 同花顺官方开源了
- 一个 AI 炒股神器
- 蓝色条内(白字,位于标题下方):
- 同花顺官方开源金融API,支持行情、财务、指数查询,附Agent技能直接调用。
- 灰/黑色小标题(位于蓝条下方):
- 金融数据服务
- 标签/徽章(位于“金融数据服务”下方一行,分别为小圆角矩形):
- API Docs
- 同花顺金融数据服务
- Python 3.11+
- Node.js 22.12+
- 正文可见片段(若干行,部分被截断):
- 同花顺金融数据服务(hithink-finance)是由同花顺官方提供和维护的 A股金融数据服务,面向 AI ...
- 只需一个 API Key,即可查询 A股最新行情、集合竞价、财务报表、估值、指数、板块、公司资料、个股异动、热榜和龙虎榜等数据,并将数据接入 AI 工具、Python 研究脚本、...
- 同花顺官方金融数据能力,覆盖 API、MCP、CLI、Python SDK、本地数据库和 Agent Skil...
- 出现的 URL(蓝色,下划线,部分可见):
- https://fuyao.aicubes.cn/
- https://fuyao.aicubes.cn/docs/
- https://fuyao.aicubes.cn/admin/
- docs/(孤立短串,可能为页面内锚点或链接文本)
二、界面元素与可见现象(事实描述)
- 页面整体风格:白色背景,黑色大标题,蓝色横条用于强调说明文字。
- 页面顶部靠右有一个绿色书签/标签形状的装饰(右上角小图形)。
- 页面左上靠近边缘有一个短的浅绿色加灰色进度条或装饰条(类似进度或加载条)。
- “金融数据服务”下方有一排彩色小标签(见上文),表现为可点击的文档/技术栈指示。
- 正文为多段描述性文字,包含产品/服务说明与使用场景关键词(如 A股、API Key、行情、财务报表、Python)。
- 页面底部可见若干超链接(以蓝色显示并带下划线),指向 fuyao.aicubes.cn 的不同路径。
三、图中未见或无数据的项
- 未见任何表格、图表或数值型数据(图中没有可识别的行情数值、K 线、表格列等)。
- 未看到明确的操作步骤序列(如“步骤一、步骤二”之类的分步指南)。只有描述性文字与链接。
四、无法辨认或部分遮挡的内容(需要说明)
- 正文中多处句子被裁切或被遮挡,后半部分不可完全辨认(例如“面向 AI ...”之后与“并将数据接入 AI 工具、Python 研究脚本、...”的后续内容不完整)。
- 最下方有若干小段文字与链接被部分裁切,无法完整恢复全部文本(例如最后一行及后续行)。
- 标签中“Agent Skil...”后半词被裁切,无法完全确认是否为“Agent Skill(s)”或其它拼写。
- 页面最顶部靠左的浅绿色短条附近有小字,但字体过小或被裁切,无法完整识别具体文字内容。
五、推测(明确标注为推测/非直接可见信息)
- 推测该页面为同花顺(即“同花顺”品牌)针对其金融数据 API 的宣传或说明页面(依据多处出现“同花顺官方”“A股金融数据服务”等字样)。
- 推测该服务对外提供 API Key 机制(因为正文写“只需一个 API Key,即可查询…”),并可能提供文档与管理后台(依据可见的 /docs/ 与 /admin/ 链接)。
- 推测页面同时提供 Python 与 Node.js 的 SDK 或示例支持(依据“Python 3.11+”和“Node.js 22.12+”标签)。
- 推测“Agent 技能直接调用”意指该 API 能被某种 Agent 框架或技能直接调用,但具体 Agent 平台/实现方式未在图中完全显示。
六、其他可观察点
- 页面视觉重点在“大标题 + 蓝色说明条”,意在快速告知“开源 + AI 炒股”主题。
- 页面使用了若干链接与技术标签,暗示面向开发者或技术使用者的定位。
如果需要,我可以:
- 将图中可见的段落逐句再尝试更精确地逐词转录(受裁切影响,可能有未识别处会标注)。
- 根据这些链接/关键字列出可能的下一步查证项(例如访问 https://fuyao.aicubes.cn/docs/ 以查看完整文档),但这属于推测/建议而非图中直接证据。
SkillPI 作品解读
作品用途:
- 报告与截图显示同花顺官方开源的 Financial-API,目标用户为需要将 A 股金融数据接入 AI 工具、量化研究脚本或构建金融 Agent 的开发者/研究者。该项目据称覆盖:A股最新行情、历史日K(仅日线)、财务报表与指标、指数/板块数据、涨跌停与龙虎榜、集合竞价/炸板/热榜/异动、公募基金资料与业绩、本地 DuckDB 存储,以及多种访问方式(REST API、MCP、CLI、Python SDK、Agent Skill)。页面显示有文档与管理后台链接(例如 https://fuyao.aicubes.cn/docs/)。
图片证据要点(来自图中可见内容):
- 页面标题与蓝色说明条明确标注“同花顺官方开源金融API,支持行情、财务、指数查询,附Agent技能直接调用”。
- 页面展示了技术/环境标签:API Docs、同花顺金融数据服务、Python 3.11+、Node.js 22.12+。
- 可见链接指向 fuyao.aicubes.cn 的文档与管理页面;正文有“只需一个 API Key,即可查询...”之类的说明。图中多处文字被裁切,缺少完整操作细节与示例代码。
关联 Skill 的使用步骤(基于图中声明的接口类型,属于可行性说明而非实测教程):
1) 获取与查阅文档:访问图中或摘要中给出的文档地址(例如 https://fuyao.aicubes.cn/docs/ 或 GitHub 仓库 https://github.com/HiThink-Tech/Financial-API)以确认认证、速率限制与接口定义。
2) 申请或配置 API Key:图中声明“只需一个 API Key”,因此应在管理后台或开发者控制台获取并在请求中配置该密钥。
3) 选取访问方式并安装依赖:根据需要选择 REST 调用、CLI、或安装 Python SDK(图中标注 Python 3.11+)、或使用 Node.js(图中标注 Node.js 22.12+)。
4) 本地存储(可选):若打算离线或做批量回测,可配置项目提供的本地 DuckDB 数据库并导入所需数据快照。
5) 使用 Agent Skill:图中指出存在 Agent Skill,按文档将 Skill 注册到目标 Agent 平台并授权,使 Agent 在接到自然语言指令时能调用相应 API 或 SDK。
6) 示例指令(按图中示例,仅作为调用思路示范):向 Agent 发送“查询贵州茅台最新行情,并分析近一年涨跌幅、最大回撤和均线趋势。”Agent 应根据配置决定走 REST / MCP / CLI / Python SDK 中的某种路径来获取数据并返回分析结果。
复现前提(必须验证或准备的项):
- 有效的 API Key 与相应权限;
- 可访问的网络与对方文档/管理后台(例如 fuyao.aicubes.cn 或 GitHub 仓库);
- 对应运行环境:若使用 Python SDK,需 Python 3.11+;若使用 Node.js 示例,需 Node.js 22.12+;
- 若使用本地 DuckDB 存储,要安装并配置 DuckDB;
- 目标 Agent 平台的接入方式(Agent Skill 的具体格式与兼容平台需在项目文档中确认)。
待核实项(图中未充分证实或在图像中被裁切的关键信息):
- Agent Skill 的具体兼容 Agent 框架或标准(例如是否为通用的 OpenAI/LLM Agent 插件格式或为同花顺自有实现);
- API 的认证方案细节(Auth header、API Key 获取与刷新策略、权限粒度)、速率限制、费用与商业许可证条款;
- 数据覆盖范围与更新频率(分钟级行情是否确实不支持、历史数据深度、基金持仓历史覆盖范围等);
- 示例代码与返回字段格式(需要查看 /docs/ 或 GitHub 仓库以获取确切接口定义);
- 在本地 DuckDB 中的表结构、同步/导入工具与数据刷新机制。
结论(谨慎建议):
- 图像与摘要表明该项目可作为将 A 股数据接入 AI Agent 或量化研究的起点。要落实使用,应首先阅读项目文档与 GitHub 仓库,获取并配置 API Key,确认 Agent Skill 的兼容性与认证细节,随后在受控测试环境中验证数据调用与样例分析流程(例如查询单只股票并计算近一年涨跌幅与最大回撤)。
- 以上使用步骤与说明基于图中可见文字与摘要陈述,未基于对仓库或服务的实测结果。因此在实际部署前需核验文档与权限、并在测试环境中验证接口行为与数据质量。
