tushare-mcp

Q: What does the tushare-mcp skill do?

通过 Tushare Pro MCP 获取中国金融市场数据。覆盖 A股/港股/美股/基金/期货/债券/宏观 共 158+ 个接口。当需要股价、财务、指数、宏观数据时，使用 tushare MCP tool 而非 Python 脚本。

Q: How do I install tushare-mcp?

Run npx skills add https://github.com/kirkluokun/awesome-a-stock-openclawskills --skill tushare-mcp in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/tushare-mcp/ (personal) or .claude/skills/tushare-mcp/ (project).

by kirkluokunAI & Agents

通过 Tushare Pro MCP 获取中国金融市场数据。覆盖 A股/港股/美股/基金/期货/债券/宏观共 158+ 个接口。当需要股价、财务、指数、宏观数据时，使用 tushare MCP tool 而非 Python 脚本。

Installs: 73
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/kirkluokun/awesome-a-stock-openclawskills --skill tushare-mcp

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads tushare-mcp automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Tushare MCP 数据技能

鉴权变量：TUSHARE_API_KEY。

通过 MCP 服务器调用 Tushare Pro API，不再需要写 Python 脚本。

核心规则

使用 MCP tool，不写脚本 — 所有数据通过 tushare_* tool 获取
先用 ToolSearch 加载 — MCP tool 是 deferred 的，调用前必须 ToolSearch("tushare ...") 加载
日期格式 YYYYMMDD 或 YYYY-MM-DD — 两种都支持，MCP 内部自动转换
默认返回 100 行 — 需要更多数据用 _limit 参数
数据输出遵循存储规范 — 见 output-storage.md

使用流程

1. 确认需求 → 需要什么数据？
2. 查 tool 索引 → reference/tool-index.md 找到对应 tool
3. ToolSearch 加载 → ToolSearch("+tushare <关键词>")
4. 调用 tool → 传参获取数据
5. 存储/展示 → 按 output-storage.md 规范处理

快速定位 Tool

需求场景	用哪个 tool	关键参数
查某只股票行情	`tushare_daily`	ts_code, start_date, end_date
查财务三表	`tushare_income/balancesheet/cashflow`	ts_code, period
查指数走势	`tushare_index_daily`	ts_code, start_date, end_date
查 ETF 行情	`tushare_fund_daily`	ts_code, trade_date
查港股行情	`tushare_hk_daily`	ts_code, start_date, end_date
查美股行情	`tushare_us_daily`	ts_code, start_date, end_date
查宏观 GDP	`tushare_cn_gdp`	q（季度如 2024Q1）
查利率 Shibor	`tushare_shibor`	start_date, end_date
查龙虎榜	`tushare_top_list`	trade_date
查研究报告	`tushare_research_report`	ts_code, start_date, end_date
技术面因子	`tushare_stk_factor_pro`	ts_code, start_date, end_date
筹码分布	`tushare_cyq_chips`	ts_code, trade_date
涨跌停统计	`tushare_limit_list_d`	trade_date
资金流向	`tushare_moneyflow`	ts_code, trade_date
融资融券	`tushare_margin`	trade_date
实时分钟线	`tushare_rt_min`	ts_code

完整 tool 索引：reference/tool-index.md

代码格式说明

市场	代码格式	示例
沪市	XXXXXX.SH	600000.SH
深市	XXXXXX.SZ	000001.SZ
北交所	XXXXXX.BJ	430047.BJ
港股	XXXXX.HK	00700.HK
美股	TICKER	AAPL
指数	XXXXXX.SH/SZ	000001.SH（上证综指）
ETF	XXXXXX.SH/SZ	510050.SH
期货	品种代码.交易所	CU2401.SHF

已知限制

港股/美股财务数据需 15000 积分，积分不足会报错
部分高级接口需要单独开通权限（如 rt_min 实时分钟线）
单次请求默认 100 行上限，大批量需多次请求或调 _limit

调研纪要/PDF 场景

需要处理“调研纪要原文/关注问题”时，先读：

调研纪要/PDF 处理指引

参考

Tool 完整索引 — 按场景分类的 158 个 tool
数据输出规范 — 文件存储路径和格式
查询模式手册 — 常见分析场景的 tool 组合
调研纪要/PDF 处理指引 — 纪要抓取、权限回退与输出模板

FAQ

What does the tushare-mcp skill do?

How do I install tushare-mcp?

Run npx skills add https://github.com/kirkluokun/awesome-a-stock-openclawskills --skill tushare-mcp in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/tushare-mcp/ (personal) or .claude/skills/tushare-mcp/ (project).

Which AI agents can use tushare-mcp?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is tushare-mcp safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains tushare-mcp?

It is published by kirkluokun in kirkluokun/awesome-a-stock-openclawskills. It has 73 recorded installs.

Source

kirkluokun/awesome-a-stock-openclawskills $View on skills.sh

Works with

Claude CodeCodexCursorGitHub CopilotGemini CLIWindsurfClineOpenCodeRoo CodeGooseAmpKiro

Files 67 · 753.9 KB

SKILL.md3.6 KB
_meta.json507 B
.env.example831 B
.gitignore171 B
docs/remaining-apis.md4.7 KB
pyproject.toml490 B
README.md5.2 KB
reference/output-storage.md1.5 KB
reference/query-patterns.md4.6 KB
reference/research-notes-pdf.md1.3 KB
reference/tool-index.md12.8 KB
src/tushare_mcp/__init__.py61 B
src/tushare_mcp/__main__.py82 B
src/tushare_mcp/client.py106.9 KB
src/tushare_mcp/errors.py663 B
src/tushare_mcp/formatter.py1.4 KB
src/tushare_mcp/rate_limiter.py854 B
src/tushare_mcp/server.py1.6 KB
src/tushare_mcp/storage.py10.6 KB
src/tushare_mcp/tools/__init__.py28 B
src/tushare_mcp/tools/billboard.py2.1 KB
src/tushare_mcp/tools/bond.py8.0 KB
src/tushare_mcp/tools/chips.py2.4 KB
src/tushare_mcp/tools/classify.py4.9 KB

+43 more files