Authentication variable:
TUSHARE_API_KEY。
Call the Tushare Pro API through the MCP server,no longer need to write Python scripts。
Core Rules
- Use MCP tool, do not write scripts — all data is retrieved through the
tushare_*tool - Load first with ToolSearch — MCP tools are deferred, before calling you must
ToolSearch("tushare ...")load - Date format YYYYMMDD or YYYY-MM-DD — both are supported, MCP converts automatically internally
- Default return is 100 rows — for more data use the
_limitparameter - Data output follows storage conventions — see output-storage.md
Usage Flow
1. 确认需求 → 需要什么数据?
2. 查 tool 索引 → reference/tool-index.md 找到对应 tool
3. ToolSearch 加载 → ToolSearch("+tushare <关键词>")
4. 调用 tool → 传参获取数据
5. 存储/展示 → 按 output-storage.md 规范处理
Quickly Locate Tools
| Requirement scenario | Which tool to use | Key parameters |
|---|---|---|
| Query a stock's quotes | tushare_daily |
ts_code, start_date, end_date |
| Query the three financial statements | tushare_income/balancesheet/cashflow |
ts_code, period |
| Query index trends | tushare_index_daily |
ts_code, start_date, end_date |
| Query ETF quotes | tushare_fund_daily |
ts_code, trade_date |
| Query Hong Kong stock quotes | tushare_hk_daily |
ts_code, start_date, end_date |
| Query US stock quotes | tushare_us_daily |
ts_code, start_date, end_date |
| Query macro GDP | tushare_cn_gdp |
q (quarter, e.g. 2024Q1) |
| Query Shibor interest rates | tushare_shibor |
start_date, end_date |
| Query the Dragon and Tiger List | tushare_top_list |
trade_date |
| Query research reports | tushare_research_report |
ts_code, start_date, end_date |
| Technical factors | tushare_stk_factor_pro |
ts_code, start_date, end_date |
| Chip distribution | tushare_cyq_chips |
ts_code, trade_date |
| Price limit up/down statistics | tushare_limit_list_d |
trade_date |
| Capital flow | tushare_moneyflow |
ts_code, trade_date |
| Margin trading and securities lending | tushare_margin |
trade_date |
| Real-time minute bars | tushare_rt_min |
ts_code |
Complete tool index:reference/tool-index.md
Code Format Description
| Market | Code format | Example |
|---|---|---|
| Shanghai market | XXXXXX.SH | 600000.SH |
| Shenzhen market | XXXXXX.SZ | 000001.SZ |
| Beijing Stock Exchange | XXXXXX.BJ | 430047.BJ |
| Hong Kong stocks | XXXXX.HK | 00700.HK |
| US stocks | TICKER | AAPL |
| Indices | XXXXXX.SH/SZ | 000001.SH (Shanghai Composite Index) |
| ETF | XXXXXX.SH/SZ | 510050.SH |
| Futures | variety code.exchange | CU2401.SHF |
Known Limitations
- Hong Kong/US stock financial data requires 15000 points; insufficient points will cause an error
- Some advanced interfaces require separate permission activation (e.g. rt_min real-time minute bars)
- A single request has a default limit of 100 rows; large batches require multiple requests or adjusting
_limit
Research Minutes/PDF Scenarios
When you need to process "research minutes original text/focus questions", first read:
Reference
- Complete Tool Index — 158 tools categorized by scenario
- Data Output Specification — file storage paths and formats
- Query Pattern Manual — tool combinations for common analysis scenarios
- Research Minutes/PDF Processing Guide — minutes scraping, permission fallback, and output templates