| name | tushare-cli-rust |
| description | 使用 Tushare CLI 工具获取中国金融市场数据。支持 238 个 Tushare Pro 数据接口，包括股票行情、财务数据、宏观经济指标等。使用 Rust 编写的零依赖命令行工具直接调用 HTTP API，无需 Python SDK。务必在用户涉及中国股市、A股、港股、美股、基金、经济指标、财务报表、股票行情、K线数据、日线/周线/月线、技术分析、财务指标、上市公司数据、指数数据、期货、债券等任何中国金融市场数据查询需求时使用此 skill，即使用户没有明确提及 Tushare 或 CLI。 |
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 个接口，绝对不要猜测接口名称！ 必须先查看可用接口：
~/.claude/skills/tushare-cli/scripts/tushare list
~/.claude/skills/tushare-cli/scripts/tushare search <关键词>
~/.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. ⚠️ 定位正确的接口（必需步骤）
在调用任何接口之前，必须先定位正确的接口：
~/.claude/skills/tushare-cli/scripts/tushare list
~/.claude/skills/tushare-cli/scripts/tushare search <关键词>
~/.claude/skills/tushare-cli/scripts/tushare help <接口名>
重要：这个步骤确保你使用了正确的接口名称和参数，避免 40101 错误。
3. 直接执行查询
确定正确的接口后，直接执行命令，不要预先询问或检查 Token 配置。
~/.claude/skills/tushare-cli/scripts/tushare <接口名> \
--参数1 值1 \
--参数2 值2 \
--format markdown
4. 处理结果
- 成功：直接展示数据/进行分析
- 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: 获取股票基本信息
~/.claude/skills/tushare-cli/scripts/tushare search 股票基础
~/.claude/skills/tushare-cli/scripts/tushare help stock_basic
~/.claude/skills/tushare-cli/scripts/tushare stock_basic --ts-code 000001.SZ --format markdown
示例 2: 获取股票日线行情
~/.claude/skills/tushare-cli/scripts/tushare search 日线
~/.claude/skills/tushare-cli/scripts/tushare help daily
~/.claude/skills/tushare-cli/scripts/tushare daily \
--ts-code 000001.SZ \
--start-date 20240201 \
--end-date 20250228 \
--format markdown
示例 3: 获取指数实时行情
~/.claude/skills/tushare-cli/scripts/tushare search 实时指数
~/.claude/skills/tushare-cli/scripts/tushare help rt_idx_k
~/.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"
配置完成后，我可以重新执行查询。
权限不足
错误信息：
错误: 抱歉，您还没有获得该接口的调取权限
解决方案：
参数错误
错误信息：
错误: 参数错误
解决方案：
- 使用
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 csv
2. 使用命令行工具分析
推荐使用 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 脚本，使用命令行工具或直接展示数据
参考资源
