tushare-data

把自然语言财经数据请求，转成可执行的 Tushare 数据工作流。

这是一个面向自然语言的金融数据研究 skill。

What this skill is for

使用这个 skill 的典型场景：

看某只股票、指数、ETF 最近走势
查公司基本资料、估值、财务趋势
做多标的横向对比
看资金流、北向资金、龙虎榜、板块强弱
梳理公告、新闻、研报、政策线索
查看 CPI / PPI / PMI / 社融 / 利率等宏观数据
导出 CSV / parquet 供后续分析或回测使用
生成简洁研究摘要，而不是只吐原始字段表

先理解用户要解决什么问题，再去选接口、取数、整理、解释、交付。

When to use

当用户表达以下意图时，优先使用本 skill：

行情 / 趋势

看下 XX 最近怎么样
XX 这段时间涨得怎么样
今年以来表现如何
最近有没有放量
这票最近强不强

财务 / 估值 / 公司质量

看下 XX 财报
最近几个季度利润趋势
财务质量怎么样
现金流好不好
现在估值算高吗
帮我看 PE / PB / ROE / 毛利率

对比 / 排行 / 筛选

XX 和 YY 谁更强
帮我横向比较一下
哪些公司利润增长更快
帮我筛一下高 ROE 低负债
给我排个前十

板块 / 指数 / 主题

最近哪个板块最强
半导体最近怎么样
机器人为什么涨
指数成分股有哪些
哪些主题最热

资金流 / 情绪

最近资金在买什么
北向资金最近流向哪里
哪个板块最吸金
主力资金流入最多的是谁
龙虎榜上有什么看点

公告 / 新闻 / 研报 / 政策

最近有什么公告
帮我梳理下 XX 公告
最近有没有什么催化
最近新闻面怎么样
最近有什么重要政策

宏观 / 跨市场

最近宏观环境怎么样
CPI / PMI 最近怎么看
当前市场风格偏什么
大盘环境偏多还是偏空
港股 / 美股 / 美债最近怎么样

数据导出 / 研究准备

给我导出一份行情数据
把近两年日线拉成 CSV
生成可回测的数据表
拉一个研究表供后续分析

What this skill is NOT for

这个 skill 不适合：

直接给买卖建议或替代投资顾问
自动下单或执行交易
需要毫秒级实时交易决策的场景
复杂回测引擎、组合优化系统本身的实现（那是另一个工程）
在没有 Tushare 权限/积分支持的情况下强行伪造数据

如果数据权限不够、接口不可用或时间范围不合理，要明确说出限制，不要硬编。

Natural-language trigger guide

即使用户完全不说 tushare、financials、macro 这些术语，只要意图符合以下含义，也应该触发本 skill。

常见口语触发

看看这个股票最近怎么样
给我快速研究一下 XX
上次说的那只票现在什么情况
帮我看下财报
最近哪个板块最强
北向最近在买什么
有什么催化消息
这个公司值不值得重点看
给我拉份数据
导出成 CSV
帮我筛一批票
把这几个公司对比一下

中文自然语言优先原则

用户说人话时，先理解任务，不要先回到接口名和字段名。优先把：

“最近” 解释成合理时间窗
“财报” 解释成最近 8 个季度 / 最近年度
“强不强” 解释成走势 + 相对强弱 + 活跃度
“资金关注” 解释成净流入、活跃成交、龙虎榜/北向等可用口径

如果任务有多个合理解释，再做最小澄清。

Environment check

在真正请求数据之前，先做前置校验：

检查 Python 是否可用，版本要求 3.7+
检查 tushare 包是否已安装·
检查 TUSHARE_TOKEN 是否存在, 或者运行py脚本import tushare as ts; print(ts.get_token())"检查本地是否已配置
必要时做一次轻量接口冒烟测试（如交易日历 / 基础接口）
如用户请求高权限接口，提前提示可能存在积分/权限限制

若缺失 token，直接提示最短修复路径，例如：

export TUSHARE_TOKEN=your_token

不要等到主查询跑失败了才暴露环境问题。

Intent taxonomy

先识别任务类型，再决定接口组合。

1. 行情 / 趋势

典型问题：

最近走势怎么样
今年涨了多少
最近波动大不大
最近有没有放量

常用接口：

daily
pro_bar
weekly
monthly
stk_mins
rt_k / rt_min（如确需实时口径且权限允许）
daily_basic

2. 基本资料 / 标的识别

典型问题：

这是什么公司 / 什么指数 / 什么基金
是创业板吗 / 是 ST 吗 / 什么时候上市

常用接口：

stock_basic
fund_basic
index_basic
stock_company
stock_st / st

3. 财务 / 公司质量

典型问题：

最近几个季度利润趋势
最近几个季度营收和净利润趋势
财务质量怎么样
ROE / 毛利率 / 现金流如何

常用接口：

income（营收 / 净利润趋势优先）
fina_indicator（ROE / 毛利率 / 净利率等质量指标补充）
balancesheet
cashflow
forecast
express
disclosure_date

4. 估值 / 基本面指标

典型问题：

现在估值高不高
谁更便宜
PE / PB / 股息率如何

常用接口：

daily_basic
fina_indicator

5. 资金流 / 市场行为

典型问题：

北向最近买什么
主力资金流向
龙虎榜情况

常用接口：

moneyflow
moneyflow_hsgt
hsgt_top10
top_list
top_inst
moneyflow_ind_dc
moneyflow_mkt_dc

6. 板块 / 指数 / 主题

典型问题：

最近哪个板块最强
行业轮动如何
某板块有哪些成分股

常用接口：

index_basic
index_daily
index_classify
index_member_all
sw_daily
ths_index
ths_member
dc_index
dc_member

7. 打板 / 情绪 / 活跃度

典型问题：

今天涨停梯队
连板结构
炸板率 / 情绪强弱

常用接口：

limit_list_d
limit_step
kpl_list
dc_hot
ths_hot

8. 公告 / 新闻 / 研报 / 政策

典型问题：

最近有什么公告或催化
最近有什么研究报告
最近政策面发生了什么

常用接口：

anns_d
news
major_news
research_report
npr
irm_qa_sh
irm_qa_sz

9. 宏观 / 跨市场

典型问题：

CPI / PMI / 社融 / M2
利率与收益率曲线
港股 / 美股 / 美债数据

常用接口：

cn_cpi
cn_ppi
cn_pmi
cn_gdp
cn_m
sf_month
shibor
shibor_lpr
us_tycr
us_daily
hk_daily
index_global

10. 导出 / 研究准备

典型问题：

导出某标的一段时间行情
生成回测用数据表
输出 CSV / parquet

常用接口：

取决于上游任务，核心是统一输出规则与命名规范

Entity resolution rules

标的解析

优先识别股票名、股票代码、指数名、ETF 名、基金名
对中文简称先尝试匹配标准对象
若重名或多解，列出候选并做最小澄清
证券代码内部统一为标准格式，如：600519.SH、000001.SZ

市场识别

默认先按 A 股理解，除非用户明确提到港股 / 美股 / 基金 / 债券 / 期货
指数、ETF、个股要分开判断，不要混用接口

时间默认值

若用户没有明确给时间范围，使用合理默认：

“最近走势” → 默认近 20 个交易日
“这段时间 / 最近一段时间” → 默认近 3 个月
“财报 / 业绩” → 默认最近 8 个季度 + 最近年度
“资金流最近如何” → 默认近 5～20 个交易日，按任务粒度调整
“宏观最近如何” → 默认看最近 6～12 期

板块口径默认值

若用户只说“板块 / 行业 / 概念”但未指定分类体系：

行业优先用申万 / 中信等较稳定口径
概念优先同花顺 / 东方财富等主题口径
若结论依赖具体口径差异，要明确说明使用了哪种分类

Input normalization rules

在请求数据前先做规范化：

日期统一为 YYYYMMDD
检查 start_date <= end_date
用户输入未来日期时，自动裁剪到最近可用日期并提示
裸代码如 000001 不要盲猜，能补全则说明补全规则，不能补全则澄清
对冲突参数（如 trade_date 与 start_date/end_date 同时给）要先裁决，不要直接乱传

Data retrieval rules

文档先行

在写请求代码前，先确认：

接口名是否正确
必填参数
可选参数
返回字段
积分 / 频率限制

不要仅凭记忆硬写字段名。

字段确认

对 fields 参数，优先使用已知字段白名单或接口文档确认。若用户要求字段不存在，应明确说明，而不是盲查。

默认分段拉取

长区间数据不要一次性全拉。建议：

日线 / 周线 / 月线：按年或季度切片
财报：按年份 / 报告期切片
分钟数据：按月 / 周切片
大批量多标的：按标的分批 + 日期分段

重试与限流

仅对瞬时错误（网络抖动、超时、429）进行有限重试
参数错误、权限不足、字段错误不要盲重试
批量拉取时加入节流，避免高频撞限

分段合并

分段拉取后：

合并
去重
按主键排序
记录失败分段
若部分成功，要明确告诉用户哪些段失败了

Output contract

除非用户明确只要原始表，否则优先按这个结构输出：

一句话结论
数据范围与口径
关键指标 / 关键表格
异常点 / 风险点 / 解释限制
如有本地输出，给出文件路径

结果交付形态

按任务复杂度选择：

小结果：Markdown 摘要 + 简短表格
中等数据表：CSV
大规模 / 后续分析：Parquet
需要可复用流程：附 Python 脚本
需要可视化时：输出图表 PNG 或说明可绘制图表

元信息

生成数据文件时，尽量同时记录：

接口名
请求参数
拉取时间
数据行数
字段列表
是否存在失败分段 / 缺失

Workflow templates

下面这些模板，是本 skill 的核心。不要直接从接口想起，而要从任务模板想起。

1. 单标的行情分析

适用：

看下 XX 最近怎么样
这票最近强不强
今年以来表现如何

默认流程：

解析标的
确定时间范围
取行情 + 必要基础指标
总结区间涨跌、成交活跃度、高低点、波动
输出一句结论 + 关键数字

2. 多标的横向对比

适用：

XX 和 YY 谁更强
把这几家公司对比一下

默认流程：

锁定对象
统一时间口径
选 3～5 个关键指标
输出对比表
给出“谁在哪方面更强”的总结

3. 财务质量快照

适用：

看下 XX 财报
最近几个季度利润趋势
财务质量怎么样

默认流程：

拉最近 8 个季度 + 最近年度财务核心数据
区分营收、利润、毛利率、ROE、现金流
标出改善 / 恶化 / 波动点
说明累计值、单季值、同比口径

4. 估值分析 / 筛选

适用：

现在估值高不高
谁更便宜
筛低估值高股息

默认流程：

明确标的池
拉 daily_basic 等估值指标
必要时联动财务质量
输出排序、极值、口径说明

5. 资金流追踪

适用：

最近资金在买什么
北向最近流向哪里
主力资金流入最多的是谁

默认流程：

明确资金口径（北向 / 主力 / 龙虎榜 / 板块资金）
确定时间窗
拉净流入 / 活跃成交 / 持续性
和价格表现联动解释
避免把单日噪声说成趋势

6. 板块 / 题材轮动分析

适用：

最近哪个板块最强
机器人最近强在哪
某概念板块里有哪些成分股

默认流程：

确定分类口径
拉板块区间表现
必要时联动成分股、资金流、涨停梯队
输出强势板块排行与代表标的

7. 公告 / 新闻 / 事件梳理

适用：

最近有什么公告
有没有什么催化
最近新闻面怎么样

默认流程：

明确对象和时间窗
拉公告 / 新闻 / 研报 / 政策数据
去噪，提炼 3～5 条主线
区分事实、公告、媒体解读
必要时结合股价异动做弱因果解释

8. 数据导出与研究准备

适用：

拉一份 CSV
做回测数据表
导出某段时间的行情/财务数据

默认流程：

明确数据范围、频率、字段
采用分段策略取数
清洗、去重、统一字段类型
输出 CSV / parquet
给出文件路径和元信息

9. 综合研究简报

适用：

给我快速研究一下 XX
做个投资者视角简报
先给个全景判断

默认流程：

一句话结论
行情表现
财务趋势
估值水平
资金流情况
公告 / 新闻催化
风险点
值得继续深挖的问题

Data quality rules

拉取完成后，至少做这些检查：

schema 校验
关键字段存在性检查
主键去重
固定排序
日期标准化
数值字段类型规范化

空结果处理

空表不一定是失败，要区分：

非交易日
区间无数据
股票未上市
参数错误
接口权限不足

不要把所有空结果都说成“接口坏了”。

Cache and reuse rules

为了让 skill 可长期复用，应优先支持：

基础表缓存（如 stock_basic、交易日历、指数基础信息）
增量更新，而不是每次全量重拉
大任务断点续跑
结果文件规范命名

推荐命名格式：

daily_600519.SH_20230101_20231231_20260322.csv
fina_indicator_300750.SZ_20260322.parquet

缓存命中时，最好说明哪些来自缓存，哪些是新拉取的数据。

Error handling

优先用“人话 + 调试细节分层”的方式输出错误。

用户可见层

token 未配置
当前接口可能需要更高积分/权限
时间范围过大，已自动改为分段拉取
股票名称不唯一，请确认是哪一个
当前结果为空，可能因为该日期非交易日 / 标的未上市 / 无权限

调试层

必要时补：

接口名
参数
失败分段
异常原文

部分成功原则

如果部分分段失败，不要说“成功完成”。应明确说：

哪些部分成功
哪些部分失败
是否已生成不完整结果

Recommended minimal interface set

主 skill 正文不要塞几百个接口。优先记住 80% 常用任务的核心接口集：

stock_basic
trade_cal
daily
pro_bar
daily_basic
fina_indicator
income
balancesheet
cashflow
forecast
express
moneyflow
moneyflow_hsgt
hsgt_top10
top_list
index_basic
index_daily
index_classify
sw_daily
ths_index
ths_member
limit_list_d
limit_step
news
major_news
research_report
anns_d
cn_cpi
cn_pmi
us_tycr

全部数据接口，请参考 references/数据接口.md。

Best practices

先理解任务，再选接口
能少取就少取，先核心数据，再扩展
先给结论，再给证据
默认说人话，不堆字段名
对“最近 / 财报 / 强不强 / 资金关注”这类模糊中文表达，要有合理默认口径
大任务先给执行计划，再开跑
导出任务尽量保留脚本、元信息、文件路径，方便复用

Examples

单票行情

看下宁德时代最近三个月走势
茅台今年以来涨了多少
招行这两年最大回撤大概多少

财务 / 估值

看下比亚迪最近 8 个季度营收和净利润趋势
茅台现在估值算高吗
帮我找高 ROE 低负债的公司

对比

比一下茅台、五粮液、泸州老窖近一年的涨幅和估值
对比一下沪深300、中证500、创业板今年表现

资金流 / 板块

今天北向资金流入最多的股票有哪些
最近哪个板块最强
半导体板块最近一个月强不强

公告 / 事件

帮我梳理下寒武纪最近的重要公告
最近机器人板块有什么消息面催化

宏观

看一下最近 CPI、PPI、PMI 变化
当前市场风格偏成长还是价值

导出

把沪深300成分股近两年日线导成 CSV
下载宁德时代 2020 到现在的复权行情
把最近 3 年 ROE、PE、PB、营收增速拉成一个表

Quick rule

当用户在说：

看走势
查财报
比较公司
看板块
看资金流
梳理公告新闻
看宏观
拉数据导出

就不要先想“有哪些接口”。先想： 这是什么任务？默认该走哪条数据工作流？结果应该怎样交付才真正有用？