# Tushare Stock

> 面向中国 A 股的 Tushare 专用技能，提供股票数据获取、个股分析与交易观察能力。

- Skill: `magica-chen/tushare-stock` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add magica-chen/tushare-stock`
- Raw SKILL.md: https://api.skillmd.com/api/skills/magica-chen/tushare-stock/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Magica-Chen (https://skillmd.com/u/magica-chen)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/magica-chen/tushare-stock

---


# Tushare A 股研究技能

一个更聚焦、也更实用的 Tushare A 股技能包，专门面向中国 A 股个股研究、数据查询与交易观察。

## 适用场景

当你希望围绕 A 股个股做数据获取、分析判断或交易观察时，使用这个技能。它覆盖的重点包括：

- 股票基础资料与上市清单
- 日线、周线、月线、复权、实时与分钟级行情
- `daily_basic` 每日指标与估值指标
- 财务报表、业绩预告、分红、审计与财务指标
- 十大股东、质押、回购、解禁、大宗交易、股东人数等股东侧数据
- 券商盈利预测、筹码分布、技术因子、CCASS、AH 比价
- 两融、转融通、资金流向
- 龙虎榜、涨跌停、THS / DC / TDX / KPL 题材与板块数据
- 个股估值、财务质量、成长性、趋势、风险提示等综合分析
- 偏交易观察的请求，例如量价结构、资金面、均线、动量、RSI、KDJ、布林线、MACD

不要把它当成一个“全市场全资产大而全”的金融数据技能。它的设计目标不是覆盖 ETF、基金、期货、期权、宏观、新闻或海外市场，而是把中国 A 股个股这件事做深。

## 核心价值

- 用自然语言直达 A 股常用 Tushare 接口
- 支持显式接口调用，适合稳定、可复现的数据提取
- 不只查数据，还能直接给出个股分析与交易观察结果
- 内建积分门槛、额外权限等访问限制识别
- 兼顾研究型场景与交易型场景

## 上架定位

和偏“大而全”的 Tushare 技能相比，这个包刻意选择了“更窄，但更深”的路线。

它不追求把所有资产类别、宏观指标和海外市场一次性打包，而是专注在中国 A 股个股研究这一条主线上，把：

- 数据查询
- 估值与财务分析
- 风险提示
- 资金流与龙虎榜观察
- 技术指标与交易观察

这些最常见、也最容易真正落地使用的能力做完整。

## 主入口

在已安装依赖的 Python 3 环境中运行：

```bash
python scripts/tushare_stock.py run --text "<请求内容>"
```

脚本会：

- 从环境变量读取 `TUSHARE_TOKEN`
- 只有在显式提供 `TUSHARE_STOCK_ENV_FILE` 时，才会从文件中读取 `TUSHARE_TOKEN`
- 作为统一入口调用 Tushare，避免临时拼接零散 `import tushare as ts` 代码
- 在可能时把股票名称解析成 `ts_code`
- 从自然语言中自动选择更合适的股票接口
- 规范化常见参数，如日期区间、季度表达、分钟频率
- 对积分不足或额外权限接口做显式拦截
- 对“分析 / 估值 / 基本面 / 趋势 / 风险”等请求自动切到综合分析
- 对“交易观察 / 技术分析 / 均线 / 动量 / RSI / KDJ / 布林线 / MACD”等请求自动切到交易观察
- 默认走快档交易观察；只有明确提出更深的需求时，才补扫龙虎榜与席位数据
- 返回结构化 JSON；查询场景优先给原始数据，分析场景给结论和支撑数据
- 不调用 `ts.set_token(...)`，避免主动生成本地 token 缓存文件

## 安装

使用前先安装 Python 依赖：

```bash
pip install -r requirements.txt
```

必需环境变量：

- `TUSHARE_TOKEN`：所有数据查询与分析命令都依赖它

可选环境变量：

- `TUSHARE_STOCK_ENV_FILE`：可选，指向包含 `TUSHARE_TOKEN` 的 env 文件
- `TUSHARE_POINTS`：可选，用于覆盖当前积分值判断，默认 `5120`
- `TUSHARE_STOCK_CACHE_DIR`：可选，缓存目录，默认 `/tmp/tushare_stock_skill`

## 安全与运行边界

- `run`、`fetch`、`analyze` 会访问 Tushare 网络接口
- `build_catalog.py` 会访问 `tushare.pro` 官方文档页面，用于刷新本地接口目录
- 技能不会隐式扫描家目录配置文件；如果使用文件型凭证，必须显式传入 `TUSHARE_STOCK_ENV_FILE`
- 技能只读取声明过的环境变量，不会主动读取其他无关凭证

## 其他命令

列出支持的接口目录：

```bash
python scripts/tushare_stock.py catalog
```

直接调用指定接口：

```bash
python scripts/tushare_stock.py fetch --endpoint daily_basic --param ts_code=600519.SH --param start_date=20250101 --param end_date=20250301
```

显式触发个股分析：

```bash
python scripts/tushare_stock.py analyze --text "分析贵州茅台的估值、财务质量和趋势"
```

列出内置技术指标：

```bash
python scripts/tushare_stock.py indicators
```

根据官方文档刷新接口目录：

```bash
python scripts/build_catalog.py
```

## 输出行为

- 面向用户的输出默认使用简体中文
- 查询类请求优先返回原始数据，再补最少必要解释
- 分析类请求默认返回结论、关键指标、风险提示与支撑摘要
- 交易观察优先输出趋势、量价、资金流、龙虎榜和技术指标信号
- 快档优先保证速度；深档才补充龙虎榜与席位扫描
- 明确说明实际调用了哪些接口，以及受哪些积分或权限限制
- 请求不明确时，先用中文追问一句，不要盲猜

## 示例请求

- `贵州茅台近一年 daily_basic 指标`
- `最近30天龙虎榜机构交易`
- `分析宁德时代的估值和成长性`
- `看看招商银行的基本面和趋势`
- `贵州茅台当前有哪些风险信号`
- `看看贵州茅台的交易观察`
- `看看贵州茅台的快档交易观察`
- `深度看看贵州茅台交易观察，带龙虎榜和机构席位`
- `分析宁德时代均线、RSI 和布林线`
- `贵州茅台技术分析`

## 参考资料

- 机器可读目录：`references/stock_endpoints.json`
- 人类可读摘要：`references/stock_endpoints.md`
- 技术指标注册表：`scripts/trading_analysis.py`
- 官方索引：<https://tushare.pro/document/2?doc_id=14>

## 扩展方式

- 如需新增技术指标，优先扩展 `scripts/trading_analysis.py`
- 使用 `@register_indicator(...)` 注册后，主技能与 `indicators` 命令会自动识别