Tushare CLI Skill
使用 Tushare CLI 工具获取中国金融市场数据的技能。
CLI 工具路径
~/.claude/skills/tushare-cli/scripts/tushare📋 数据覆盖
支持 238 个 Tushare Pro API 接口，包括：
- 股票数据（108个）：基础信息、行情、财务、交易、筹码、管理层等
- 宏观经济（21个）：GDP、CPI、PPI、利率、货币供应等
- 指数专题（19个）：基础信息、日线、权重、行业指数
- 债券专题（15个）：可转债、国债、企业债、回购等
- 期货数据（12个）：合约、行情、仓单、持仓等
- 港股数据（11个）：行情、财务数据
- 美股数据（9个）：行情、财务数据
- ETF专题（8个）：ETF基本信息、行情、份额等
- 公募基金（8个）：基金净值、持仓、分红、规模
- 行业经济（8个）：TMT行业、影视票房等
- 大模型语料专题数据（6个）：新闻、公告、研报、政策等
- 期权数据（3个）：合约信息、行情
- 财富管理（2个）：基金销售数据
- 外汇数据（2个）：外汇基础信息、行情
- 现货数据（2个）：黄金现货数据
- 基金数据（1个）：基金相关数据
- 其他（3个）：其他数据接口
💡 完整的接口列表：参见 references/api-index.md
功能特点
- 零依赖：单一可执行文件，无需 Python 或其他运行时
- 多种输出格式：JSON、Table、CSV、Markdown
- 自动参数转换：支持 kebab-case 到 snake_case 的自动转换
- 智能搜索：支持按关键词搜索接口
🚨 关键原则
⚠️ 必须先定位接口，不要猜测！
Tushare 有 238 个接口，绝对不要猜测接口名称！ 必须先查看可用接口：
# ⚠️ 步骤 1: 查看所有接口（按类别分组，显示名称和用途）
~/.claude/skills/tushare-cli/scripts/tushare list
# ⚠️ 步骤 2: 搜索相关接口（使用关键词）
~/.claude/skills/tushare-cli/scripts/tushare search <关键词>
# ⚠️ 步骤 3: 查看接口详细文档（参数、输出字段等）
~/.claude/skills/tushare-cli/scripts/tushare help <接口名>错误示例（不要这样做）：
- ❌ 直接猜测接口名：
tushare realtime_quote --ts-code...（接口名错误） - ❌ 直接猜测接口名：
tushare stock_realtime --ts-code...（接口名错误）
正确示例：
- ✅ 先运行：
tushare search 实时 - ✅ 找到正确接口：
rt_idx_k（指数实时日线） - ✅ 查看文档：
tushare help rt_idx_k - ✅ 正确调用：
tushare rt_idx_k --ts-code 000001.SH
⚠️ 不要预检查 Token
直接执行命令，不要预先询问或检查 Token 配置。如果 Token 未配置，工具会返回明确的错误信息。
工作流程
当用户请求获取金融数据时，严格遵循以下流程：
1. 理解需求
- 用户需要什么类型的数据？（股票、基金、宏观经济等）
- 具体的查询参数？（股票代码、日期范围等）
- 数据用途？（直接展示、技术分析、对比研究）
2. ⚠️ 定位正确的接口（必需步骤）
在调用任何接口之前，必须先定位正确的接口：
# 步骤 2.1: 查看所有接口（快速了解可用接口）
~/.claude/skills/tushare-cli/scripts/tushare list
# 步骤 2.2: 搜索相关接口（使用关键词缩小范围）
~/.claude/skills/tushare-cli/scripts/tushare search <关键词>
# 步骤 2.3: 查看接口文档（确认参数和输出字段）
~/.claude/skills/tushare-cli/scripts/tushare help <接口名>重要：这个步骤确保你使用了正确的接口名称和参数，避免 40101 错误。
3. 直接执行查询
确定正确的接口后，直接执行命令，不要预先询问或检查 Token 配置。
# 示例：直接执行查询
~/.claude/skills/tushare-cli/scripts/tushare <接口名> \
--参数1 值1 \
--参数2 值2 \
--format markdown4. 处理结果
- 成功：直接展示数据/进行分析
- Token 错误：提示用户配置 Token（见错误处理部分）
- 权限错误：提示用户积分不足
- 参数错误：使用
help命令检查参数格式并重试
5. 数据分析（如需要）
对于需要分析的场景（如技术指标分析）：
- 使用
--format csv获取数据 - 使用命令行工具（如
awk、csvtool）进行分析 - 或者直接展示数据并提供分析思路
不要：编写 Python 脚本或创建临时文件进行处理
命令格式
基本格式
~/.claude/skills/tushare-cli/scripts/tushare <接口名> [参数] [选项]通用选项
-h, --help: 显示帮助信息-v, --version: 显示版本信息-f, --format: 输出格式 (json|table|csv|markdown)-p, --pretty: JSON 美化输出-t, --token: Tushare API Token
参数格式
- 日期：YYYYMMDD（如 20240228）
- 股票代码：ts_code 格式（如 000001.SZ, 600000.SH）
- 参数命名：支持 kebab-case（自动转换为 snake_case）
- --ts-code → ts_code - --start-date → start_date
输出格式选择
| 格式 | 适用场景 | 示例命令 |
|---|---|---|
| markdown | 在对话中展示数据（推荐） | --format markdown |
| csv | 需要进一步处理分析 | --format csv |
| json | 程序处理 | --format json |
| table | 终端直接查看 | --format table |
常用接口速查
| 数据类型 | 接口方法 | 说明 |
|---|---|---|
| 股票列表 | stock_basic | 获取所有股票列表 |
| 日线行情 | daily | 获取日线行情数据 |
| 周线行情 | weekly | 获取周线行情数据 |
| 月线行情 | monthly | 获取月线行情数据 |
| 财务指标 | fina_indicator | 财务指标（ROE等） |
| 利润表 | income | 利润表数据 |
| 资产负债表 | balancesheet | 资产负债表数据 |
| 现金流量表 | cashflow | 现金流量表数据 |
| 指数行情 | index_daily | 指数日线数据 |
| 基金净值 | fund_nav | 基金净值数据 |
| GDP数据 | cn_gdp | 国内生产总值 |
| CPI数据 | cn_cpi | 居民消费价格指数 |
使用示例
基础查询示例
示例 1: 获取股票基本信息
# 步骤 1: 搜索接口
~/.claude/skills/tushare-cli/scripts/tushare search 股票基础
# 步骤 2: 查看接口文档
~/.claude/skills/tushare-cli/scripts/tushare help stock_basic
# 步骤 3: 执行查询
~/.claude/skills/tushare-cli/scripts/tushare stock_basic --ts-code 000001.SZ --format markdown示例 2: 获取股票日线行情
# 步骤 1: 搜索接口
~/.claude/skills/tushare-cli/scripts/tushare search 日线
# 步骤 2: 查看接口文档
~/.claude/skills/tushare-cli/scripts/tushare help daily
# 步骤 3: 执行查询
~/.claude/skills/tushare-cli/scripts/tushare daily \
--ts-code 000001.SZ \
--start-date 20240201 \
--end-date 20250228 \
--format markdown示例 3: 获取指数实时行情
# 步骤 1: 搜索接口
~/.claude/skills/tushare-cli/scripts/tushare search 实时指数
# 步骤 2: 查看接口文档
~/.claude/skills/tushare-cli/scripts/tushare help rt_idx_k
# 步骤 3: 执行查询
~/.claude/skills/tushare-cli/scripts/tushare rt_idx_k --ts-code 000001.SH --format markdown错误处理
Token 未配置或无效
错误信息：
错误: TUSHARE_TOKEN 未设置
或
错误: 401 Unauthorized仅在遇到此错误时，提示用户：
需要配置 Tushare Token 才能继续：
1. 访问 https://tushare.pro 注册账号
2. 在个人中心获取 API Token
3. 配置环境变量：
export TUSHARE_TOKEN="你的Token"
配置完成后，我可以重新执行查询。权限不足
错误信息：
错误: 抱歉，您还没有获得该接口的调取权限解决方案：
- 某些接口需要更高积分才能调用
- 访问 https://tushare.pro 查看积分规则
- 完成任务获取积分，或升级到付费版本
参数错误
错误信息：
错误: 参数错误解决方案：
- 使用
help命令查看接口文档：~/.claude/skills/tushare-cli/scripts/tushare help <接口名> - 检查参数格式：
- 日期：YYYYMMDD（如 20240228） - 股票代码：000001.SZ 格式
- 确认必填参数是否提供
技术分析指南
对于技术指标分析需求，使用以下方法：
1. 获取数据
使用 CSV 格式获取数据：
~/.claude/skills/tushare-cli/scripts/tushare daily \
--ts-code 000725.SZ \
--start-date 20240201 \
--end-date 20250228 \
--format csv2. 使用命令行工具分析
推荐使用 awk 进行简单的技术指标计算：
# 计算移动平均线
~/.claude/skills/tushare-cli/scripts/tushare daily \
--ts-code 000725.SZ \
--start-date 20240201 \
--end-date 20250228 \
--format csv | awk -F, 'NR>1 {print $3}' | \
awk 'BEGIN{ORS=","} {print} END{print "\n"}' | \
tr ',' '\n' | \
tail -5 | \
awk '{sum+=$1; print $1} END{print "MA5:", sum/5}'对于复杂分析，可以：
- 展示数据给用户，让用户自己分析
- 使用其他专业分析工具
- 简单描述分析方法，不直接计算
3. 不要做的事
- ❌ 不要编写 Python 脚本
- ❌ 不要创建临时文件存储数据
- ❌ 不要假设用户有 pandas 等依赖
- ✅ 直接展示 CLI 输出
- ✅ 提供分析思路和观察点
- ✅ 使用命令行工具进行简单计算
支持的数据类型
| 类别 | 接口数量 | 说明 |
|---|---|---|
| 股票数据 | 108 | A股行情、财务、交易、筹码、管理层等 |
| 宏观经济 | 21 | GDP、CPI、PPI、利率、货币供应等 |
| 指数专题 | 19 | 各类指数行情、权重、行业分类 |
| 债券专题 | 15 | 可转债、国债、企业债、回购等 |
| 期货数据 | 12 | 期货合约行情、仓单、持仓 |
| 港股数据 | 11 | 港股行情、财务数据 |
| 美股数据 | 9 | 美股行情、财务数据 |
| ETF专题 | 8 | ETF基本信息、行情、份额 |
| 公募基金 | 8 | 基金净值、持仓、分红、规模 |
| 行业经济 | 8 | TMT行业、影视票房等 |
| 大模型语料专题数据 | 6 | 新闻、公告、研报、政策等 |
| 期权数据 | 3 | 期权合约信息、行情 |
| 财富管理 | 2 | 基金销售数据 |
| 外汇数据 | 2 | 外汇基础信息、行情 |
| 现货数据 | 2 | 黄金现货数据 |
| 基金数据 | 1 | 基金相关数据 |
| 其他 | 3 | 其他数据接口 |
最佳实践
- 直接执行：不要预先检查 Token，直接执行命令
- 格式选择：
- 展示给用户 → 用 markdown - 需要处理 → 用 csv - 调试时 → 用 table
- 路径统一：始终使用
~/.claude/skills/tushare-cli/scripts/tushare相对路径 - 合理设置日期范围：避免请求过多数据
- 错误友好提示：遇到错误时，清楚说明原因和解决方案
- 避免脚本化：不要创建 Python 脚本，使用命令行工具或直接展示数据
参考资源
- Tushare 官方文档：https://tushare.pro/document/2
- API 测试工具：https://tushare.pro/document/1
- 积分获取规则：https://tushare.pro/user/ticket