| name | shanxi-securities-tushare |
| description | 使用山西证券 Tushare (sxsc_tushare) 获取专业结构化金融市场历史数据。特点：数据为 T-1 日（无实时行情）、数据规范适合批量处理和导出。触发条件：用户提及 tushare、sxsc_tushare、山西证券tushare、历史行情批量拉取、财务报表批量导出、回测数据准备、数据导出 CSV/Parquet、宏观历史数据(CPI/PPI/PMI/社融/利率)、指数成分股、申万/中信行业分类、多标的横向对比、可转债数据、期货数据、债券数据、历史资金流向、历史K线、涨跌停统计、分红送股、限售解禁、基金净值历史、港股数据、国债收益率、Shibor利率、停复牌信息、沪深股通十大成交股时，或说"拉份数据""导出CSV""批量取数""对比几家公司"等。适用场景：历史数据批量获取、财务分析、回测数据表准备、研究简报生成。
|
山西证券 Tushare 数据技能
把自然语言财经数据请求转为可执行的 Tushare 工作流：理解任务 → 选接口 → 校验参数 → 取数 → 整理 → 解释 → 交付。
典型场景
- 看单只股票/指数/ETF 的走势、估值、活跃度
- 多标的横向对比（业绩、估值、涨幅、ROE 等）
- 财务质量快照（利润趋势、ROE、毛利率、现金流）
- 资金流追踪（北向、主力、龙虎榜、板块吸金）
- 板块/题材轮动、指数成分股
- 宏观数据（CPI / PPI / GDP / PMI / 利率 / 货币供应量）
- 数据导出（CSV / Parquet）供回测或后续分析
- 生成可复用研究简报
核心工作流
每次执行按这个顺序：
- 理解任务 — 识别用户要解决什么问题（见下方"任务分类"）。
- 解析标的 — 名称/代码 → 标准
ts_code（如 600519.SH）；市场、时间窗、字段按默认值补全。
- 查表选接口 — 先查
references/API接口对应表.md 拿到 api_name 与对应文档路径，禁止凭记忆写接口。
- 校验参数 — 日期
YYYYMMDD、起止顺序、冲突裁决、未来日期裁剪（细节见下方「关键默认值」）。
- 取数执行 — 优先复用
scripts/stock_data_demo.py、scripts/fund_data_demo.py。
- 结构化交付 — 一句话结论 → 口径 → 关键指标/表 → 风险/限制 → 文件路径。
关键原则：先想"这是什么任务、走哪条工作流"，再想"用哪个接口"。永远不要先翻接口名。
任务分类
| 任务类型 | 典型表达 |
|---|
| 行情/趋势 | 最近怎么样、涨了多少、放量没有 |
| 基本资料 | 什么公司、什么时候上市、行业 |
| 财务/公司质量 | 财报、利润趋势、ROE、现金流 |
| 估值/筛选 | 估值高不高、谁便宜、低估值高股息 |
| 资金流/市场行为 | 北向、主力、龙虎榜、板块吸金 |
| 板块/指数/主题 | 哪个板块最强、成分股、概念主题 |
| 涨跌停/情绪 | 涨停梯队、连板、活跃度 |
| 公告/新闻/研报 | 公告、催化、新闻面（受限：仅告知边界 + 替代路径） |
| 宏观/跨市场 | CPI、PMI、利率、港股、美股 |
| 数据导出/研究准备 | 拉 CSV、回测数据表、Parquet |
| 综合研究简报 | 快速研究 XX、全景判断 |
关键默认值
| 模糊中文 | 默认口径 |
|---|
| "最近"/"近期" | 近 20 个交易日 |
| "最近一段时间"/"最近三个月" | 近 60 个交易日 |
| "今年" | 当年 1 月 1 日至今 |
| "财报"/"业绩" | 最近 8 个季度 + 最近年度 |
| "资金流最近如何" | 近 5–20 个交易日 |
| "宏观最近如何" | 最近 6–12 期 |
| 行业分类 | 申万/中信（更稳定） |
| 概念分类 | 同花顺/东方财富（主题更热） |
| 证券代码 | 600519.SH / 000001.SZ 标准格式 |
裸代码（如 000001）能按规则补全就补全并说明，不能补全就最小澄清。
日期冲突（trade_date 与 start_date/end_date 同给）先裁决再调用。
未来日期自动裁剪到最近可用日期并提示用户。
What this skill is NOT for
- 买卖建议、替代投资顾问
- 自动下单或交易执行
- 实时行情（仅 T-1 日数据）
- 回测引擎、组合优化系统的实现
- 无 token / 无权限时伪造数据
References 快速索引
| 用途 | 路径 |
|---|
| 接口名 ↔ 文档映射 | references/API接口对应表.md |
| 安装与 HTTP 调取 | references/调取数据.md |
| 股票示例脚本 | scripts/stock_data_demo.py |
| 基金示例脚本 | scripts/fund_data_demo.py |
Code Examples
HTTP 直连（零外部依赖）
import os, json, urllib.request
API_URL = 'http://221.204.19.233:7172'
token = os.getenv('SXSC_TUSHARE_TOKEN') or 'YOUR_TOKEN_HERE'
def call_api(api_name, fields='', **params):
"""通用 HTTP 调取：POST JSON Body，返回 list[dict]。code 非 0 抛错。"""
payload = {'api_name': api_name, 'token': token, 'params': params, 'fields': fields}
req = urllib.request.Request(
API_URL, data=json.dumps(payload).encode('utf-8'),
headers={'Content-Type': 'application/json'}, method='POST')
with urllib.request.urlopen(req, timeout=30) as r:
res = json.loads(r.read().decode('utf-8'))
if res.get('code') != 0:
raise RuntimeError(f"{api_name} 调用失败：code={res.get('code')} msg={res.get('msg')}")
d = res.get('data') or {}
return [dict(zip(d.get('fields', []), row)) for row in d.get('items', [])]
call_api('stock_basic', fields='ts_code,symbol,name,area,industry,list_date',
exchange='', list_status='L')
call_api('daily', ts_code='600519.SH', start_date='20250101', end_date='20251231')
生产环境（PTrade 客户端）的 HTTP 端点需咨询山西证券；上述端点适用于 Python / 仿真环境。
错误处理
try:
rows = call_api('daily', ts_code='600519.SH', start_date='20250101', end_date='20251231')
except Exception as e:
print(f"获取数据失败：{e}")
空结果不一定是失败：可能是非交易日、标未上市、参数错误、权限不足 —— 区分清楚再下结论。
