Skillget

Tushare-Finance-Skill-for-Claude-Code

skill
Security Audit
Pass
Health Pass
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 65 GitHub stars
Code Pass
  • Code scan — Scanned 6 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

专为 Claude Code 设计的 Tushare Pro 金融数据技能包，支持 220+ 个接口，用自然语言获取 A 股行情、财务数据、宏观经济等金融数据。

README.md

Tushare Finance Skill

Version
License
ClawHub

获取中国金融市场数据的 OpenClaw Skill，支持 220+ 个 Tushare Pro 接口。

✨ 特性

  • 🚀 开箱即用 - 一键安装，无需复杂配置
  • 📊 全面覆盖 - A股、港股、美股、基金、期货、债券
  • 🔧 多种方式 - Python API、命令行工具、批量导出
  • 📈 实时数据 - 支持股票行情、财务报表、宏观经济
  • 🔄 OpenClaw 集成 - 无缝集成到自动化工作流
  • 📖 完整文档 - 220+ 接口完整索引和使用示例

📥 安装

方法 1：通过 ClawHub（推荐）

clawhub install tushare-finance

方法 2：手动安装

git clone https://github.com/StanleyChanH/Tushare-Finance-Skill-for-Claude-Code.git
cd Tushare-Finance-Skill-for-Claude-Code
pip install -r requirements.txt

🔑 配置

获取 Tushare Token

  1. 访问 Tushare Pro 注册账号
  2. 在个人中心获取 Token
  3. 配置环境变量：
export TUSHARE_TOKEN="your_token_here"

# 或添加到 ~/.bashrc
echo 'export TUSHARE_TOKEN="your_token_here"' >> ~/.bashrc
source ~/.bashrc

🚀 快速开始

Python API

from scripts.api_client import TushareAPI

# 初始化客户端
api = TushareAPI()

# 查询股票日线行情
df = api.get_stock_daily("000001.SZ", "2024-01-01", "2024-12-31")
print(df.head())

# 查询公司基本信息
info = api.get_stock_info("000001.SZ")
print(info)

# 批量查询多只股票
stocks = ["000001.SZ", "000002.SZ", "600000.SH"]
data = api.batch_query(stocks, "2024-01-01", "2024-12-31")

命令行工具

# 查询单只股票
python scripts/quick_query.py --stock 000001.SZ --start 2024-01-01 --end 2024-12-31

# 批量查询
python scripts/quick_query.py --file stocks.txt --start 2024-01-01 --output result.csv

# 导出 Excel
python scripts/batch_export.py --stock 000001.SZ --start 2024-01-01 --end 2024-12-31 --format excel

📊 支持的数据类型

股票数据（39 个接口）

接口 说明 示例
daily 日线行情 api.get_stock_daily()
stock_basic 股票列表 api.get_stock_list()
fina_indicator 财务指标 api.get_financial_indicator()
income 利润表 api.get_income_statement()
balancesheet 资产负债表 api.get_balance_sheet()

指数数据（18 个接口）

接口 说明 示例
index_daily 指数日线 api.get_index_daily()
index_weight 指数成分 api.get_index_weight()
index_basic 指数列表 api.get_index_list()

基金数据（11 个接口）

接口 说明 示例
fund_nav 基金净值 api.get_fund_nav()
fund_basic 基金列表 api.get_fund_list()

期货数据（16 个接口）

接口 说明 示例
futures_daily 期货日线 api.get_futures_daily()

宏观数据（10 个接口）

接口 说明 示例
gdp GDP数据 api.get_gdp()
cpi CPI数据 api.get_cpi()
pmi PMI数据 api.get_pmi()

港股美股（23 个接口）

接口 说明 示例
hk_daily 港股日线 api.get_hk_daily()
us_daily 美股日线 api.get_us_daily()

完整接口列表：查看 接口文档索引

📖 API 文档

TushareAPI 类

__init__(token=None)

初始化 API 客户端

参数：

  • token (str, optional): Tushare Token，默认从环境变量读取

get_stock_daily(ts_code, start_date, end_date)

查询股票日线行情

参数：

  • ts_code (str): 股票代码（如 "000001.SZ"）
  • start_date (str): 开始日期（如 "2024-01-01"）
  • end_date (str): 结束日期（如 "2024-12-31"）

返回：

  • pd.DataFrame: 日线数据

示例：

df = api.get_stock_daily("000001.SZ", "2024-01-01", "2024-12-31")

batch_query(ts_codes, start_date, end_date)

批量查询多只股票

参数：

  • ts_codes (list): 股票代码列表
  • start_date (str): 开始日期
  • end_date (str): 结束日期

返回：

  • dict: {股票代码: DataFrame}

示例：

stocks = ["000001.SZ", "000002.SZ", "600000.SH"]
data = api.batch_query(stocks, "2024-01-01", "2024-12-31")

更多 API 请参考：docs/api_reference.md

🔧 使用示例

示例 1：股票数据分析

from scripts.api_client import TushareAPI

api = TushareAPI()

# 查询股票数据
df = api.get_stock_daily("000001.SZ", "2024-01-01", "2024-12-31")

# 计算收益率
df['return'] = df['close'].pct_change()
df['cum_return'] = (1 + df['return']).cumprod()

print(df[['trade_date', 'close', 'return', 'cum_return']].tail())

示例 2：批量导出

from scripts.api_client import TushareAPI

api = TushareAPI()

# 批量查询沪深300成分
stocks = api.get_index_weight("000300.SH", "2024-12-31")
stock_codes = stocks['con_code'].tolist()

# 批量获取数据
for code in stock_codes[:10]:  # 前10只
    df = api.get_stock_daily(code, "2024-01-01", "2024-12-31")
    df.to_csv(f"./data/{code}.csv", index=False)

示例 3：财务分析

# 查询财务指标
fina = api.get_financial_indicator("000001.SZ", "2024-01-01", "2024-12-31")

# 筛选关键指标
key_metrics = ['roe', 'roa', 'debt_to_assets', 'current_ratio']
print(fina[['ts_code', 'end_date'] + key_metrics].head())

更多示例：docs/examples.md

⚙️ 配置选项

环境变量

# Tushare Token（必需）
export TUSHARE_TOKEN="your_token_here"

# 数据缓存（可选）
export TUSHARE_CACHE_DIR="~/.tushare_cache"

# 日志级别（可选）
export TUSHARE_LOG_LEVEL="INFO"

配置文件

编辑 config/config.yaml：

api:
  # Token（优先级低于环境变量）
  token: "your_token_here"

  # 请求超时（秒）
  timeout: 30

  # 重试次数
  retry: 3

cache:
  # 是否启用缓存
  enabled: true

  # 缓存目录
  dir: ~/.tushare_cache

  # 缓存有效期（秒）
  ttl: 3600

logging:
  # 日志级别
  level: INFO

  # 日志文件
  file: logs/tushare.log

🧪 测试

# 运行所有测试
python -m pytest tests/

# 运行特定测试
python -m pytest tests/test_api.py

# 查看测试覆盖率
python -m pytest --cov=scripts tests/

🤝 贡献

欢迎贡献代码、报告问题或提出建议！

开发环境

git clone https://github.com/StanleyChanH/Tushare-Finance-Skill-for-Claude-Code.git
cd Tushare-Finance-Skill-for-Claude-Code
pip install -r requirements.txt
pip install -r requirements-dev.txt
python -m pytest tests/

📄 许可证

Apache License 2.0

🙏 致谢

📚 相关资源

📊 更新日志

v2.0.0 (2026-02-14)

  • ✨ 添加完整的 Python API 客户端
  • ✨ 添加命令行工具
  • ✨ 添加批量导出功能
  • 📖 完善 API 文档和使用示例
  • 🧪 添加自动化测试
  • 🔄 配置 GitHub Actions 自动发布

v1.0.0 (2026-01-10)

  • 🎉 初始版本发布
  • 📊 支持 220+ Tushare Pro 接口

Reviews (0)

No results found