Skip to content
Conduit

skill

FTShare-skill

FTShare financial data Skill for AI agents｜通过自然语言路由基础金融数据与 FTShare 特色因子。

FTShare-Lab/FTShare-skillcommunitylistedunreviewednot running here yet
Use skill

Set up

Skills are installed by placing their folder where your agent loads skills.

Install instructions come from the README

Skills do not use an MCP config. Follow the steps in the README below; one-click install arrives with accounts.

README

synced Oct 14, 2026

[!IMPORTANT] 本仓库提供一个可安装的父 Skill：ftshare-market-data。Agent 读取父 Skill 后，再从内部子 Skill 中选择对应数据接口，通过 run.py 执行请求并读取 JSON。所有请求都需要环境变量 FTSHARE_API_KEY。

FTShare Skill 是什么

FTShare Skill 是 FTShare 面向 Agent 运行时提供的金融数据接入方式。将 ftshare-market-data 加载到 Claude Code、Codex、OpenClaw 等运行时后，用户可以直接用自然语言提出数据问题，由 Agent 完成接口选择、参数组织和结果读取。

三步开始使用

1. 获取仓库

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

2. 配置 API Key

登录 FTShare 账号中心 获取 API Key，然后设置环境变量：

export FTSHARE_API_KEY="YOUR_FTSHARE_API_KEY"

请勿将真实 API Key 提交到 Git 仓库、Issue、日志或公开截图。

3. 加载父 Skill

将完整的 ftshare-market-data 目录放入 Agent 运行时的 Skill 目录。

运行时Skill 目录示例
Claude Code 项目级.claude/skills/ftshare-market-data/
Claude Code 用户级~/.claude/skills/ftshare-market-data/
Codex 用户级~/.codex/skills/ftshare-market-data/
OpenClaw 等其他运行时以对应运行时的 Skill 文档为准

目录中必须完整保留 SKILL.md、run.py 和 sub-skills/。

用特色因子完成第一次调用

加载后可以直接向 Agent 提问：

使用 FTShare 查询贵州茅台 2026 年 8 月的新闻情绪因子

Agent 会路由到真实子 Skill：

ashare-news-sentiment-factors

对应的真实命令为：

python3 ftshare-market-data/run.py ashare-news-sentiment-factors \
  --trade-code 600519.SH \
  --start-date 20260801 \
  --end-date 20260831 \
  --page 1 \
  --page-size 5

[!NOTE] 该接口要求股票代码包含交易所后缀，例如 600519.SH。特色因子属于研究数据，具体可用范围取决于账号套餐，不构成股票推荐或未来收益判断。

路由是怎样工作的

用户提出金融数据问题
    ↓
Agent 读取 ftshare-market-data/SKILL.md
    ↓
选择 sub-skills/<名称>/SKILL.md
    ↓
run.py 校验并执行 scripts/handler.py
    ↓
FTShare 数据服务返回 JSON
    ↓
Agent 整理并回答

查看当前可用路由：

python3 ftshare-market-data/run.py

FTShare 的三种接入方式

接入方式适合场景调用形态仓库
Python SDKPython 程序、数据分析、量化研究pandas DataFrame、Python rows、原始 JSONFTShare-python-sdk
MCP支持 MCP 的 AI 客户端与 Agent标准 MCP 工具、结构化结果FTShare-MCP
SkillClaude Code、Codex、OpenClaw 等 Agent 运行时自然语言到数据接口的路由当前仓库

三种方式连接同一套 FTShare 金融数据服务。需要在 Python 程序中稳定调用时使用 SDK；需要标准 MCP 工具时使用 MCP；需要 Agent 根据问题自动选择数据接口时使用 Skill。

数据能力

当前 Skill 覆盖现货、宏观经济、大模型语料、股票、美股、公募基金、ETF、港股、期货、债券和指数等数据域。

股票数据进一步包含资金流向、财务、参考、行情、打板专题、两融及转融通、特色数据和基础数据；特色数据包括 A 股新闻情绪因子、A 股相关性 Top-K、K 线形态标注、供应链关系、信号最新快照和消息量价共振等。

最新接口、参数、字段、数据权限和更新状态，请查看：

FTShare 最新数据接口文档

仓库内每个子 Skill 的说明位于：

ftshare-market-data/sub-skills/<子 Skill 名称>/SKILL.md

输出与错误

  • 成功响应以格式化 JSON 输出到 stdout。
  • HTTP、网络、认证和参数诊断输出到 stderr。
  • 请求失败时使用非零退出状态。
  • 分页和返回字段以对应子 Skill 的 SKILL.md 与最新官方文档为准。
  • 缺少 FTSHARE_API_KEY 时，handler 不会发起网络请求。

安全约束

  • run.py 只执行 sub-skills/<名称>/scripts/handler.py 形式的已发现子 Skill。
  • handler 会校验请求协议和主机与当前 Base URL 一致。
  • 默认 Base URL 为 https://market.ft.tech/gateway。
  • 如需切换本地或内网环境，可使用 FTSHARE_BASE_URL；不要把内部服务地址写入公开文档。
  • 下载类接口只允许输出到当前工作目录及其子目录。
  • Skill 不应读取、记录或输出用户的 API Key。

项目结构

FTShare-skill/
├── README.md
├── README_EN.md
└── ftshare-market-data/
    ├── SKILL.md
    ├── README.md
    ├── run.py
    ├── test_handlers_contract.py
    └── sub-skills/
        └── <子 Skill 名称>/
            ├── SKILL.md
            └── scripts/handler.py

参与贡献

欢迎提交新的金融数据子 Skill、接口适配、测试和文档改进。贡献前请阅读 CONTRIBUTING.md，安全问题请按照 SECURITY.md 反馈。

社区与反馈

加入 FTShare 社区交流群

欢迎加入 FTShare 社区交流群，讨论 Skill 接入、特色因子、金融数据接口和 Agent 使用。

群内用于交流使用经验和补充问题信息；Bug、功能需求和 Skill 文档问题建议优先通过 GitHub Issues 提交。

如二维码失效，请在 Issues 中留言。

License

本仓库代码与 Skill 实现采用 MIT License。开源许可证不自动包含 FTShare 托管数据服务的访问额度、数据授权、再分发权或商业数据使用权。

↑↓ navigate openesc close