Magica-Chen 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：可选，用于覆盖当前积分值判断，默认5120TUSHARE_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命令会自动识别