TuShare Stock Skill

核心用法

Tushare Stock Skill 是一款面向中国 A 股市场的专业数据获取与分析工具，基于 Tushare Pro API 构建。用户可通过自然语言指令调用数十类数据端点，涵盖行情数据（日线/周线/月线/分钟线）、基本面数据（财务报表、估值指标、分红派息）、市场行为数据（龙虎榜、资金流向、融资融券）、以及技术分析指标（MA、MACD、RSI、KDJ、布林带等）。

主要入口支持三种模式：

• 查询模式：直接获取原始数据，如 600519.SH 近一年 daily_basic 指标
• 分析模式：综合评估个股的估值、财务质量、成长性、趋势与风险
• 交易观测模式：聚焦价格量能结构、资金流、龙虎榜信号及技术指标，支持快速/深度两种扫描级别

显著优点

1. 智能路由：自然语言自动匹配最优端点，无需记忆复杂 API 参数
2. 全量覆盖：整合 Tushare 股票类全部端点，含财务、行情、资金、筹码、主题等多维数据
3. 内置分析引擎：封装常用财务分析与技术分析逻辑，输出结构化结论
4. 权限感知：自动识别积分门槛与额外权限要求，避免无效调用
5. 中文原生：面向简体中文用户设计，输出与交互均为中文

潜在缺点与局限性

• 数据范围限定：明确不支持 ETF、指数、基金、期货、期权、宏观及新闻类数据
• Token 依赖：需自行申请 Tushare Pro Token，且部分高阶数据需额外积分或权限
• 网络依赖：所有数据实时取自 Tushare 云端，无离线缓存机制
• A 股专属：港股、美股等其他市场数据不在支持范围内

适合人群

• 量化研究员与策略开发者
• 基本面/技术面分析师
• 个人投资者进行日常交易观测
• 需要程序化获取 A 股结构化数据的开发者

常规风险

• 数据延迟风险：分钟级与实时数据可能存在数分钟延迟，不宜用于高频交易决策
• API 配额限制：积分耗尽后将无法调用高消耗端点
• 模型依赖风险：内置分析结论基于规则化计算，不构成投资建议
• 环境配置风险：需妥善保管 TUSHARE_TOKEN，避免硬编码泄露

核心用法

tushare-stock-skill 是基于 Tushare Pro API 构建的中国 A 股专业数据工具，提供自然语言驱动的数据查询、股票分析与交易观测三大核心能力。

数据查询：覆盖股票基础信息、日/周/月/分钟级行情、实时报价、财务指标、估值数据、股东结构、融资融券、资金流向、龙虎榜等 20+ 类数据集。支持通过自然语言（如"贵州茅台过去一年的 daily_basic 指标"）自动路由至最优端点。

股票分析：内置估值、财务质量、成长性、趋势、股东活跃度及风险六大分析维度，可生成中文结论与关键指标摘要。

交易观测：提供快速模式与深度模式，涵盖量价结构、资金流向、龙虎榜行为、移动平均线、RSI、KDJ、布林带、MACD 等技术指标分析。

显著优点

1. 端点覆盖全面：完整对接 Tushare A 股股票端点，排除 ETF、期货、期权等无关资产，专注 A 股投研场景。
2. 自然语言交互：用户无需记忆端点名称与参数格式，用中文描述需求即可自动解析日期窗口、季度引用、分钟频率等参数。
3. 权限与积分管控：内置积分阈值检测与额外权限门控，避免调用受限端点时产生意外失败。
4. 安全设计规范：Token 通过环境变量或指定文件注入，不硬编码、不隐式创建本地缓存，符合安全最佳实践。
5. 可扩展架构：技术指标通过 @register_indicator 装饰器注册，易于新增自定义因子。

潜在缺点与局限性

• 仅限 A 股：明确不支持 ETF、指数基金、期货、期权、宏观数据及新闻舆情，跨资产研究者需配合其他工具。
• 依赖外部服务：所有数据源自 Tushare 官方 API，需有效 Token 与网络连接，存在服务商可用性与积分消耗约束。
• 中文输出优先：用户面向输出为简体中文，英文场景下可能需额外处理。
• 缓存管理责任：虽支持本地缓存加速，但用户需自行配置目录权限（建议 700）与定期清理。

适合人群

• 量化研究员：需程序化获取 A 股历史行情、财务数据及另类数据（龙虎榜、融资融券、筹码分布）。
• 个人投资者：希望用自然语言快速查询持仓股票的估值、资金流向或技术指标信号。
• 策略开发者：需标准化数据接口与可扩展的技术指标注册机制，用于因子研究与回测。

常规风险

• Token 泄露风险：若将 TUSHARE_TOKEN 硬编码于 shell 配置或共享环境变量，可能导致 API 配额被盗用。建议使用专用 .env 文件并通过 TUSHARE_STOCK_ENV_FILE 显式指定。
• 缓存数据暴露：默认缓存目录 /tmp/tushare_stock_skill 若权限配置不当，多用户环境下可能泄露持仓或查询记录。
• 积分消耗：部分高价值端点（如龙虎榜明细、分钟级行情）消耗积分较高，需关注 TUSHARE_POINTS 配置与调用频率。
• 服务商依赖：数据质量、更新时效及 API 稳定性完全依赖 Tushare 官方，建议建立异常重试与降级机制。

---

使用示例

# 自然语言查询
python scripts/tushare_stock.py run --text "分析宁德时代估值与成长"

# 直接调用端点
python scripts/tushare_stock.py fetch --endpoint daily_basic --param ts_code=300750.SZ --param start_date=20240101

# 交易观测（快速模式）
python scripts/tushare_stock.py run --text "贵州茅台交易观测"