git:20260903.8f74c9b to git:20260903.6431274

---

name: ftshare-market-data

description: FTShare 市场数据技能集。根据用户对股票、ETF、指数、基金、可转债、期货、港股、美股、资金流、财务数据或宏观数据的查询意图，匹配并执行对应子 skill。

---

# FTShare Market Data Skills

本 skill 是统一路由入口。子 skill 位于 `sub-skills/`，由同目录的 `run.py` 动态发现和执行。

## 调用

```bash

python <RUN_PY> <子skill名> [参数...]

```

`<RUN_PY>` 是本文件同级的 `run.py` 绝对路径。不带参数运行会列出当前可用子 skill。

## 认证与请求约束

- 所有请求必须提供 `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 与基础地址一致。

## 常用示例

```bash

python <RUN_PY> stock-list-all-stocks

python <RUN_PY> stock-realtime-minute-kline --symbols 600519.SH 000001.SZ

python <RUN_PY> stock-minutes --symbol 600519.SH --since-ts-millis 1787189400000 --until-ts-millis 1787191200000

python <RUN_PY> etf-realtime-day-kline --symbols 510300.SH

python <RUN_PY> index-minutes --symbol 000300.SH --since-ts-millis 1787189400000 --until-ts-millis 1787191200000

python <RUN_PY> stock-reports --stock-code 600036.SH --page 1 --page-size 20

python <RUN_PY> stock-announcements --stock-code 600000 --page 1 --page-size 20

python <RUN_PY> semantic-search-news --query 人工智能

```

## 能力范围

当前子 skill 仅覆盖《FTShare 四档套餐全量接口表》中的接口；接口详细参数、响应字段和限制以对应子目录的 `SKILL.md` 及 `ftshare-doc/api-doc/` 活动源文档为准。`api-doc/已下线` 和 `api-doc/未发布` 不属于当前范围。

## 输出与错误

- 成功响应以格式化 JSON 输出到 stdout。

- HTTP、网络、参数和认证诊断输出到 stderr。

- 请求失败时返回非零退出状态。

- 下载类子 skill 只允许将文件写入当前工作目录及其子目录。

## 运行时发现

`run.py` 仅执行 `sub-skills/<名称>/scripts/handler.py` 形式的动态发现结果，不维护重复的静态注册表。新增或移除子 skill 时，应同步其目录中的 `SKILL.md` 和 handler，并以套餐接口表和源接口文档进行核对。

本包是 Agent Skill，不是 Python SDK；SDK 的同步由独立任务负责。