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
使用流程
- 确认需求 → 需要什么数据？
- 查 tool 索引 → reference/tool-index.md 找到对应 tool
- ToolSearch 加载 → ToolSearch("+tushare <关键词>")
- 调用 tool → 传参获取数据
- 存储/展示 → 按 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 处理指引 — 纪要抓取、权限回退与输出模板