FTShare 金融数据
下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/fttech--ftshare-market-data.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @fttech/ftshare-market-data。FTShare 金融数据与特色因子查询技能。根据用户关于股票、ETF、指数、基金、可转债、期货、港股、美股、资金流、财务、宏观经济或特色因子的需求,匹配并调用对应数据接口。
阅读全文 (展开查看完整说明)
概述
FTShare Market Data Skills
本 skill 是统一路由入口。子 skill 源码来自固定的 FTShare GitHub 仓库,由同目录的scripts/bootstrap.py 负责下载和缓存,scripts/run.py 只负责执行。包内清单只用于初步匹配,实际仓库内容具有最高优先级。
调用
python scripts/bootstrap.py
python scripts/run.py <子skill名> [参数...]不带参数运行会列出运行时缓存中的当前可用子 skill。根据用户问题可先查阅 references/index.md,但最终必须以运行时 GitHub 源码和 scripts/run.py 的实际输出为准。
认证与请求约束
- 所有请求必须提供
FTSHARE_API_KEY环境变量。 - handler 将其作为
FTSHARE_API_KEY请求头发送,并设置Content-Type: application/json。 - 未设置凭据时,handler 在发起请求前以非零状态退出。
- 默认基础地址为
https://market.ft.tech/gateway,可通过FTSHARE_BASE_URL覆盖。 - 请求使用各子 skill 文档声明的
/api/v1、/api/v2、/api/v3或/api/v4路由;handler 会限制请求 scheme 和 host 与基础地址一致。 - 运行时需要访问 GitHub;源码仅从
FTShare-Lab/FTShare-skill的main分支获取。 - 包内
references/index.md可能滞后于上游,不得作为完整或最终接口清单。 - 实际可用子 Skill、参数、文档、接口路径和 handler 行为必须以运行时缓存的 GitHub 源码为准。
scripts/run.py启动时调用scripts/bootstrap.py的缓存逻辑检查上游 commit;更新失败时回退到上一次校验通过的缓存版本。- 可设置
FTSHARE_AUTO_UPDATE=0禁用更新检查并仅使用已有缓存。
常用示例
python scripts/run.py stock-description-all --symbol-id 600000.SH --page 1 --page-size 1
python scripts/run.py stock-realtime-minute-kline --symbols 600519.SH 000001.SZ
python scripts/run.py stock-minutes --symbol 600519.SH --since-ts-millis 1787189400000 --until-ts-millis 1787191200000
python scripts/run.py etf-realtime-day-kline --symbols 510300.SH
python scripts/run.py index-minutes --symbol 000300.SH --since-ts-millis 1787189400000 --until-ts-millis 1787191200000
python scripts/run.py stock-reports --stock-code 600036.SH --page 1 --page-size 20
python scripts/run.py stock-announcements --stock-code 600000 --page 1 --page-size 20
python scripts/run.py semantic-search-news --query 人工智能能力范围
当前子 skill 覆盖 FTShare 基础金融数据与特色因子接口;特色因子包括新闻情绪因子、相关公司Top-K、K 线形态标注、供应链关系和最新信号快照等。接口详细参数、响应字段和限制以references/index.md 中对应章节及源接口文档为准。已下线或未发布接口不属于当前范围。
输出与错误
- 成功响应以格式化 JSON 输出到 stdout。
- HTTP、网络、参数和认证诊断输出到 stderr。
- 请求失败时返回非零退出状态。
运行时发现
scripts/bootstrap.py 从固定 GitHub 来源获取标准子技能目录和执行脚本;scripts/run.py 只执行已校验缓存中的源码,不接受用户提供的任意远程地址。references/index.md 是随包提供的非权威路由提示,源码更新后可能变化。
本包是 Agent Skill,不是 Python SDK;SDK 的同步由独立任务负责。
兼容调用
若运行时将本文件所在目录作为 Skill 根目录,可直接执行:
python scripts/run.py stock-list-all-stocks
python scripts/run.py economic-china-cpi-monthly