mirror of
https://github.com/StanleyChanH/Tushare-Finance-Skill-for-Claude-Code.git
synced 2026-09-18 21:13:48 +08:00
StanleyChanH
7736d44c4c
- Add GitHub Actions workflow for weekly doc sync from Tushare - Support Playwright + ddddocr auto login with CAPTCHA OCR - SHA256 incremental comparison, only update changed docs - Content quality validation, auto filter non-doc content - Auto create PR with change statistics - Update README with simplified structure and auto-sync docs - Bump version 2.0.6 → 2.1.0 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Tushare Finance Skill
获取中国金融市场数据的 OpenClaw Skill，支持 220+ 个 Tushare Pro 接口。
✨ 特性
- 🚀 开箱即用 - 一键安装，无需复杂配置
- 📊 全面覆盖 - A股、港股、美股、基金、期货、债券
- 🔧 多种方式 - Python API、命令行工具、批量导出
- 📈 实时数据 - 支持股票行情、财务报表、宏观经济
- 🔄 OpenClaw 集成 - 无缝集成到自动化工作流
- 📖 完整文档 - 220+ 接口完整索引和使用示例
- 🤖 自动同步 - GitHub Actions 定期爬取官方文档，自动更新
📥 安装
方法 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
- 访问 Tushare Pro 注册账号
- 在个人中心获取 Token
- 配置环境变量：
export TUSHARE_TOKEN="your_token_here"
🚀 快速开始
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")
📊 支持的数据类型
| 类别 | 接口数量 | 示例接口 |
|---|---|---|
| 股票数据 | 39 | daily, stock_basic, fina_indicator, income |
| 指数专题 | 18 | index_daily, index_weight, index_basic |
| 公募基金 | 11 | fund_nav, fund_basic, fund_hold |
| 期货期权 | 16 | futures_daily, opt_daily |
| 宏观经济 | 10 | gdp, cpi, pmi, shibor |
| 港股美股 | 23 | hk_daily, us_daily |
| 债券专题 | 16 | cb_basic, cb_price |
| ETF专题 | 7 | etf_basic, fund_etf_hist |
| 大模型语料 | 7 | news, anns, policy |
| 行业经济 | 8 | movie, box_office |
完整接口列表：查看 接口文档索引
🤖 文档自动同步
本项目通过 GitHub Actions 自动从 Tushare 官方文档 同步 API 文档。
工作流程
每周一 10:00 CST (自动) / 手动触发
│
├─ Playwright 登录 Tushare
├─ ddddocr 自动识别验证码
├─ 爬取 220+ 文档页面
├─ SHA256 增量对比，只更新有变更的文档
├─ 内容质量校验
└─ 自动创建 Pull Request
手动触发
在 GitHub Actions 页面点击 "Run workflow"，支持以下参数：
| 参数 | 说明 |
|---|---|
dry_run |
只检测变更，不写入文件 |
max_docs |
最大爬取数量（测试用） |
doc_id |
只爬取指定文档 |
配置 Secrets
需要在仓库 Settings → Secrets 中配置：
| Secret | 说明 |
|---|---|
TUSHARE_ACCOUNT |
Tushare 登录手机号或邮箱 |
TUSHARE_PASSWORD |
Tushare 登录密码 |
📖 文档结构
├── SKILL.md # Skill 定义文件
├── QUICK_REFERENCE.md # 快速参考
├── scripts/
│ ├── api_client.py # Python API 客户端
│ └── crawl_docs.py # 文档自动同步爬虫
├── reference/
│ ├── README.md # 接口文档索引
│ ├── all_links.json # 全部接口链接
│ └── 接口文档/ # 220+ 个接口 Markdown 文件
└── .github/workflows/
├── sync-docs.yml # 文档自动同步工作流
└── sync-to-clawhub.yml # ClawHub 发布工作流
🤝 贡献
欢迎贡献代码、报告问题或提出建议！
📄 许可证
Apache License 2.0
🙏 致谢
- Tushare Pro - 提供高质量金融数据 API
- OpenClaw - OpenClaw 框架
📚 相关资源
- GitHub：https://github.com/StanleyChanH/Tushare-Finance-Skill-for-Claude-Code
- ClawHub：https://clawhub.com/skill/tushare-finance
- Tushare 文档：https://tushare.pro/document/2
📊 更新日志
v2.1.0 (2026-06-09)
- 🤖 新增 GitHub Actions 文档自动同步（每周一 + 手动触发）
- 🔐 支持 Playwright + ddddocr 自动登录并识别验证码
- 📊 SHA256 增量对比，只更新有变更的文档
- ✅ 内容质量校验，自动过滤非文档内容
- 🔄 自动创建 PR，包含变更统计
- 📖 自动更新
all_links.json和README.md索引
v2.0.6 (2026-06-08)
- 🐛 修复 ClawHub CLI 超时问题
v2.0.0 (2026-02-14)
- ✨ 添加完整的 Python API 客户端
- ✨ 添加命令行工具
- ✨ 添加批量导出功能
- 📖 完善 API 文档和使用示例
- 🔄 配置 GitHub Actions 自动发布
v1.0.0 (2026-01-10)
- 🎉 初始版本发布
- 📊 支持 220+ Tushare Pro 接口