{
  "markdown": "# Tushare Finance Skill\n\n[![Version](https://img.shields.io/badge/version-2.1.0-blue.svg)](https://github.com/StanleyChanH/Tushare-Finance-Skill-for-Claude-Code)\n[![License](https://img.shields.io/badge/license-Apache--2.0-green.svg)](LICENSE)\n[![ClawHub](https://img.shields.io/badge/ClawHub-Available-purple.svg)](https://clawhub.com)\n[![Auto Sync](https://github.com/StanleyChanH/Tushare-Finance-Skill-for-Claude-Code/actions/workflows/sync-docs.yml/badge.svg)](https://github.com/StanleyChanH/Tushare-Finance-Skill-for-Claude-Code/actions/workflows/sync-docs.yml)\n\n获取中国金融市场数据的 OpenClaw Skill，支持 **220+ 个 Tushare Pro 接口**。\n\n## ✨ 特性\n\n- 🚀 **开箱即用** - 一键安装，无需复杂配置\n- 📊 **全面覆盖** - A股、港股、美股、基金、期货、债券\n- 🔧 **多种方式** - Python API、命令行工具、批量导出\n- 📈 **实时数据** - 支持股票行情、财务报表、宏观经济\n- 🔄 **OpenClaw 集成** - 无缝集成到自动化工作流\n- 📖 **完整文档** - 220+ 接口完整索引和使用示例\n- 🤖 **自动同步** - GitHub Actions 定期爬取官方文档，自动更新\n\n## 📥 安装\n\n### 方法 1：通过 ClawHub（推荐）\n\n```bash\nclawhub install tushare-finance\n```\n\n### 方法 2：手动安装\n\n```bash\ngit clone https://github.com/StanleyChanH/Tushare-Finance-Skill-for-Claude-Code.git\ncd Tushare-Finance-Skill-for-Claude-Code\npip install -r requirements.txt\n```\n\n## 🔑 配置\n\n### 获取 Tushare Token\n\n1. 访问 [Tushare Pro](https://tushare.pro) 注册账号\n2. 在个人中心获取 Token\n3. 配置环境变量：\n\n```bash\nexport TUSHARE_TOKEN=\"your_token_here\"\n```\n\n## 🚀 快速开始\n\n### Python API\n\n```python\nfrom scripts.api_client import TushareAPI\n\n# 初始化客户端\napi = TushareAPI()\n\n# 查询股票日线行情\ndf = api.get_stock_daily(\"000001.SZ\", \"2024-01-01\", \"2024-12-31\")\nprint(df.head())\n\n# 查询公司基本信息\ninfo = api.get_stock_info(\"000001.SZ\")\nprint(info)\n\n# 批量查询多只股票\nstocks = [\"000001.SZ\", \"000002.SZ\", \"600000.SH\"]\ndata = api.batch_query(stocks, \"2024-01-01\", \"2024-12-31\")\n```\n\n## 📊 支持的数据类型\n\n| 类别 | 接口数量 | 示例接口 |\n|------|---------|---------|\n| 股票数据 | 39 | `daily`, `stock_basic`, `fina_indicator`, `income` |\n| 指数专题 | 18 | `index_daily`, `index_weight`, `index_basic` |\n| 公募基金 | 11 | `fund_nav`, `fund_basic`, `fund_hold` |\n| 期货期权 | 16 | `futures_daily`, `opt_daily` |\n| 宏观经济 | 10 | `gdp`, `cpi`, `pmi`, `shibor` |\n| 港股美股 | 23 | `hk_daily`, `us_daily` |\n| 债券专题 | 16 | `cb_basic`, `cb_price` |\n| ETF专题 | 7 | `etf_basic`, `fund_etf_hist` |\n| 大模型语料 | 7 | `news`, `anns`, `policy` |\n| 行业经济 | 8 | `movie`, `box_office` |\n\n**完整接口列表**：查看 [接口文档索引](reference/README.md)\n\n## 🤖 文档自动同步\n\n本项目通过 GitHub Actions 自动从 [Tushare 官方文档](https://tushare.pro/document/2) 同步 API 文档。\n\n### 工作流程\n\n```\n每周一 10:00 CST (自动) / 手动触发\n    │\n    ├─ Playwright 登录 Tushare\n    ├─ ddddocr 自动识别验证码\n    ├─ 爬取 220+ 文档页面\n    ├─ SHA256 增量对比，只更新有变更的文档\n    ├─ 内容质量校验\n    └─ 自动创建 Pull Request\n```\n\n### 手动触发\n\n在 GitHub Actions 页面点击 **\"Run workflow\"**，支持以下参数：\n\n| 参数 | 说明 |\n|------|------|\n| `dry_run` | 只检测变更，不写入文件 |\n| `max_docs` | 最大爬取数量（测试用） |\n| `doc_id` | 只爬取指定文档 |\n\n### 配置 Secrets\n\n需要在仓库 Settings → Secrets 中配置：\n\n| Secret | 说明 |\n|--------|------|\n| `TUSHARE_ACCOUNT` | Tushare 登录手机号或邮箱 |\n| `TUSHARE_PASSWORD` | Tushare 登录密码 |\n\n## 📖 文档结构\n\n```\n├── SKILL.md              # Skill 定义文件\n├── QUICK_REFERENCE.md    # 快速参考\n├── scripts/\n│   ├── api_client.py     # Python API 客户端\n│   └── crawl_docs.py     # 文档自动同步爬虫\n├── reference/\n│   ├── README.md         # 接口文档索引\n│   ├── all_links.json    # 全部接口链接\n│   └── 接口文档/          # 220+ 个接口 Markdown 文件\n└── .github/workflows/\n    ├── sync-docs.yml     # 文档自动同步工作流\n    └── sync-to-clawhub.yml # ClawHub 发布工作流\n```\n\n## 🤝 贡献\n\n欢迎贡献代码、报告问题或提出建议！\n\n## 📄 许可证\n\nApache License 2.0\n\n## 🙏 致谢\n\n- [Tushare Pro](https://tushare.pro) - 提供高质量金融数据 API\n- [OpenClaw](https://github.com/openclaw/openclaw) - OpenClaw 框架\n\n## 📚 相关资源\n\n- **GitHub**：https://github.com/StanleyChanH/Tushare-Finance-Skill-for-Claude-Code\n- **ClawHub**：https://clawhub.com/skill/tushare-finance\n- **Tushare 文档**：https://tushare.pro/document/2\n\n## 📊 更新日志\n\n### v2.1.0 (2026-06-09)\n- 🤖 新增 GitHub Actions 文档自动同步（每周一 + 手动触发）\n- 🔐 支持 Playwright + ddddocr 自动登录并识别验证码\n- 📊 SHA256 增量对比，只更新有变更的文档\n- ✅ 内容质量校验，自动过滤非文档内容\n- 🔄 自动创建 PR，包含变更统计\n- 📖 自动更新 `all_links.json` 和 `README.md` 索引\n\n### v2.0.6 (2026-06-08)\n- 🐛 修复 ClawHub CLI 超时问题\n\n### v2.0.0 (2026-02-14)\n- ✨ 添加完整的 Python API 客户端\n- ✨ 添加命令行工具\n- ✨ 添加批量导出功能\n- 📖 完善 API 文档和使用示例\n- 🔄 配置 GitHub Actions 自动发布\n\n### v1.0.0 (2026-01-10)\n- 🎉 初始版本发布\n- 📊 支持 220+ Tushare Pro 接口\n",
  "bytes": 4182,
  "sha": "e2cab8266f2754defc999cb5b94f2286d7221d4fc9878ea9f69bd5ae9f5dd890",
  "repo_slug": "stanleychanh/tushare-finance-skill-for-claude-code",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_stanleychanh_tushare_finance_skill_for_c_f7798dad/readme"
}