TuShare Stock Skill

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 环境中运行：

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 依赖：

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

• 技能只读取声明过的环境变量，不会主动读取其他无关凭证

其他命令

列出支持的接口目录：

python scripts/tushare_stock.py catalog

直接调用指定接口：

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

显式触发个股分析：

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

列出内置技术指标：

python scripts/tushare_stock.py indicators

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

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

  命令会自动识别