Skills

tushare-cli-rust

Installation
SKILL.md

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 markdown

4. 处理结果

  • 成功：直接展示数据/进行分析
  • Token 错误：提示用户配置 Token（见错误处理部分）
  • 权限错误：提示用户积分不足
  • 参数错误：使用 help 命令检查参数格式并重试

5. 数据分析（如需要）

对于需要分析的场景（如技术指标分析）：

  1. 使用 --format csv 获取数据
  2. 使用命令行工具（如 awk、csvtool）进行分析
  3. 或者直接展示数据并提供分析思路

不要：编写 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 查看积分规则
  • 完成任务获取积分，或升级到付费版本

参数错误

错误信息：

错误: 参数错误

解决方案：

  1. 使用 help 命令查看接口文档： 
    ~/.claude/skills/tushare-cli/scripts/tushare help <接口名>
  2. 检查参数格式：
    • 日期：YYYYMMDD（如 20240228）
    • 股票代码：000001.SZ 格式
  3. 确认必填参数是否提供

技术分析指南

对于技术指标分析需求，使用以下方法：

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}'

对于复杂分析，可以：

  1. 展示数据给用户，让用户自己分析
  2. 使用其他专业分析工具
  3. 简单描述分析方法，不直接计算

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 其他数据接口

最佳实践

  1. 直接执行：不要预先检查 Token，直接执行命令
  2. 格式选择：
    • 展示给用户 → 用 markdown
    • 需要处理 → 用 csv
    • 调试时 → 用 table
  3. 路径统一：始终使用 ~/.claude/skills/tushare-cli/scripts/tushare 相对路径
  4. 合理设置日期范围：避免请求过多数据
  5. 错误友好提示：遇到错误时，清楚说明原因和解决方案
  6. 避免脚本化：不要创建 Python 脚本，使用命令行工具或直接展示数据

参考资源

Installs
9
Repository
sandysong/tusha…cli-rust
GitHub Stars
4
First Seen
Mar 2, 2026
Security Audits
Gen Agent Trust HubPass
SocketPass
SnykWarn