Shanxi Securities Tushare

山西证券 Tushare 数据技能

把自然语言财经数据请求转为可执行的 Tushare 工作流：环境校验 → 理解任务 → 解析标的 → 选接口 → 校验参数 → 取数 → 整理 → 解释 → 交付。

典型场景

本 skill 只负责取数与数据交付；若用户要求对标的进行分析/评估/对比/深度研究，应使用 sxsc-tushare-analysis skill。

• 获取单只股票/指数/ETF 的行情、估值、活跃度数据
• 多标的数据的批量取数（业绩、估值、涨幅、ROE 等字段）
• 获取财务数据（利润趋势、ROE、毛利率、现金流）
• 获取资金流数据（北向、主力、龙虎榜、板块吸金）
• 获取板块轮动、指数成分股数据
• 获取宏观数据（CPI / PPI / GDP / PMI / 利率 / 货币供应量）
• 数据导出（CSV / Parquet）供回测或后续分析

核心工作流

每次执行按这个顺序：

1. 环境校验 — 检查 scripts/env_check.json 缓存是否存在：
   • 有 → 直接读取，取 mode 字段（sdk/http）决定取数方式。
   • 无 → 先运行 python scripts/check_env.py 生成缓存，再读取。
   • 退出码非 0（token 缺失）→ 停下，先提示用户配置 SXSC_TUSHARE_TOKEN，不得进入取数。
2. 理解任务 — 识别用户要解决什么问题（见下方"任务分类"）。
3. 解析标的 — 名称/代码 → 标准 ts_code（如 600519.SH）；市场、时间窗、字段按默认值补全。
4. 查表选接口 — 先查 references/API接口对应表.md 拿到 pro.api_name 与对应文档路径，禁止凭记忆写接口。
5. 校验参数 — 日期 YYYYMMDD、起止顺序、冲突裁决、未来日期裁剪（规则见下方"关键默认值"第 71–73 行）。
6. 取数执行 — 按第 1 步的 mode 选择方式：
   • sdk：参考 scripts/ 下模板（stock_data_demo.py、fund_data_demo.py、index_sector_demo.py、fin_report_demo.py、moneyflow_demo.py）的 SDK 函数，走 references/调取数据.md 的 Python SDK 节。
   • http：参考模板中的 HTTP 函数（http_call），走 references/调取数据.md 的 HTTP 协议节（无 SDK 依赖）。
7. 结构化交付 — 一句话结论 → 口径 → 关键指标/表 → 风险/限制 → 文件路径。

关键原则：先想"这是什么任务、走哪条工作流"，再想"用哪个接口"。永远不要先翻接口名。取数前先确认环境就绪（第 1 步），token 缺失时任何取数都无意义。

任务分类

若用户要求对标的进行分析/评估/对比/深度研究，应切换至 sxsc-tushare-analysis skill。

关键默认值

裸代码（如 000001）能按规则补全就补全并说明，不能补全就最小澄清。
日期冲突（trade_date 与 start_date/end_date 同给）先裁决再调用。
未来日期自动裁剪到最近可用日期并提示用户。

What this skill is NOT for

• 买卖建议、替代投资顾问
• 自动下单或交易执行
• 实时行情（仅 T-1 日数据）
• 回测引擎、组合优化系统的实现
• 无 token / 无权限时伪造数据

环境校验

执行任取数任务前，先检查环境是否可用（结果缓存到 scripts/env_check.json，避免每次重复校验）：

python scripts/check_env.py          # token_set=true 则直接复用缓存，否则实时检测
python scripts/check_env.py --force  # 强制重新校验并覆盖缓存
python scripts/check_env.py --check  # 只校验不写缓存

校验项：

• 退出码非 0 表示 token 缺失，先解决环境再取数。
• 缓存仅存储 token_set 状态与 SDK 安装信息，不保存 token 本身或其哈希；token_set=true 时直接复用缓存。
• 取数方式按校验结果 mode 字段选择：sdk 用 references/调取数据.md 的 Python SDK 节，http 用 HTTP 协议节。

References 快速索引

Code Examples

初始化与日线

import sxsc_tushare as sx
import os

token = os.getenv('SXSC_TUSHARE_TOKEN') or 'YOUR_TOKEN_HERE'
sx.set_token(token)
pro = sx.get_api(env='prd')  # 'prd' 仿真, 'qa' 生产

# 股票列表
pro.stock_basic(exchange='', list_status='L',
                fields='ts_code,symbol,name,area,industry,list_date')

# 日线行情（ah_vol/ah_amount 为盘后成交量/额，2026-07-06 起有数据，需显式用 fields 指定）
pro.daily(ts_code='600519.SH', start_date='20250101', end_date='20251231')
# 取盘后数据示例：
# pro.daily(trade_date='20260707', fields='ts_code,open,close,ah_vol,ah_amount')

错误处理

try:
    df = pro.daily(ts_code='600519.SH', start_date='20250101', end_date='20251231')
except Exception as e:
    print(f"获取数据失败：{e}")

空结果不一定是失败：可能是非交易日、标未上市、参数错误、权限不足 —— 区分清楚再下结论。