FTShare Skill

FTShare Skill

[中文](README.md) | [English](README_EN.md)

[](https://opensource.org/licenses/MIT) [](https://www.python.org/downloads/)

`FTShare Skill` 是 FTShare 面向 AI Agent 提供的金融数据 Skill 接入方式。它把 FTShare 的行情、财务、宏观、指数、ETF、基金、板块与新闻数据封装成 Agent 可以识别和调用的 Skill。

将本仓库中的 `ftshare-market-data` 加载到 Claude Code、Codex、OpenClaw 等 Agent 运行时后，用户可以直接用自然语言提出数据问题。Agent 会根据 `SKILL.md` 选择对应接口，通过统一入口执行请求，并读取结构化 JSON 结果。

FTShare 的三种接入方式

FTShare 目前提供 SDK、MCP 和 Skill 三种接入方式。三种方式连接同一套 FTShare 金融数据能力，适合不同的使用环境。

接入方式	适合场景	调用方式	项目地址
Python SDK	Python 程序、数据分析、量化研究	在代码中调用，返回 pandas DataFrame	FTShare-python-sdk
MCP	支持 MCP 的 AI 客户端与 Agent	将 FTShare 配置为标准 MCP 工具	FTShare-MCP
Skill	Claude Code、Codex、OpenClaw 等 Agent 运行时	加载 SKILL.md，由 Agent 自动选择并执行	本仓库

需要在 Python 项目里稳定编程时使用 SDK。需要给 AI 客户端提供标准工具接口时使用 MCP。需要让 Agent 直接理解数据能力并完成自然语言到接口调用的路由时使用 Skill。

当前 Skill

本仓库当前提供一个可安装的父 Skill。

ftshare-market-data

它包含 164 个金融数据接口子路由，每个路由对应一项 FTShare 数据能力。Agent 运行时只需加载父 Skill，再由父 Skill 根据用户问题选择内部路由。

用户提出金融数据问题
    ↓
Agent 读取 ftshare-market-data/SKILL.md
    ↓
选择对应的子 Skill
    ↓
通过 run.py 调用 FTShare 数据服务
    ↓
读取 JSON 并组织回答

数据能力

当前 164 个接口子路由覆盖以下方向。

数据域	代表能力
A 股	股票列表、实时行情、分时、K 线、IPO、大宗交易、融资融券、资金流、涨跌停
财务与公司数据	利润表、资产负债表、现金流量表、业绩预告、业绩快报、股东、质押、解禁、重大合同
ETF 与基金	ETF 行情、成份、PCF、基金净值、收益、持仓、费率、风险等级
指数与板块	指数行情、指数权重、指数说明、东财板块、同花顺板块
港股与美股	行情、K 线、估值、公司资料、财务报表、恒生指数权重
可转债与期货	可转债资料与 K 线、期货行情与持仓排名
宏观与资讯	中国宏观数据、美国经济指标、财经日历、新闻语义搜索

完整接口、参数和字段说明见 [ftshare-market-data/README.md](ftshare-market-data/README.md) 与各子 Skill 的 `SKILL.md`。

安装

先克隆仓库。

git clone https://github.com/FTShare-Lab/FTShare-skills.git
cd FTShare-skills

将 `ftshare-m