顺盈数据
把自然语言财经数据请求，转成可执行的顺盈数据 / ShunPlus SDK 工作流。
What this skill is for
使用这个 skill 的典型场景：
- 看 A 股标的最近走势、涨跌、成交活跃度和 K 线表现
- 查询日线、分钟线、月线、年线以及前复权/后复权结果
- 拉取证券基础标的信息
- 查个股公告、个股资讯、富途快讯、富途要闻
- 查雪球/东方财富帖子与评论
- 处理分页抓取、字段筛选、DataFrame 输出和 CSV/parquet 导出
先理解用户要解决什么问题，再选择接口、取数、整理、解释、交付。
When to use
当用户表达以下意图时，优先使用本 skill：
- “看看这只票最近怎么样”“最近涨跌如何”“有没有放量”
- “帮我拉一下 301662.SZ 的日线/分钟线/K 线”
- “查一下深市/沪市有哪些标的”
- “查某只股票最近公告/新闻/消息面”
- “雪球/东方财富上这个票最近大家在说什么”
- “导出一份数据给我后面分析”
- “用 ShunPlus SDK 写个查询脚本”
Not for
这个 skill 不适合：
- 自动下单或执行交易
- 伪造未返回的数据、字段或权限
- 替代投资顾问给确定性买卖建议
- 需要毫秒级实时交易决策的场景
如果 Token 权限、接口能力、时间范围或字段不满足需求，要明确说明限制。
Environment check
真正请求数据前先做轻量检查：
- 检查 Python 环境可用，
shunplusSDK 可导入。 - 如果当前环境没有安装
shunplus，先安装再继续：
uv add shunplus
# 或
pip install shunplus
- 检查 Token：优先使用
SHUNPLUS_API_TOKEN或本地set_token()持久化配置。 - 缺 Token 时直接提示最短修复路径：
export SHUNPLUS_API_TOKEN="your_token"
- 必要时先跑低成本接口，例如
symbols(exchange="SZ", limit=1)。 - 如果用户请求高频、长历史或大批量，提醒可能受 Token 权益的条数、频率、并发和历史范围限制。
Quick start
from shunplus import Client, shun_api, set_token
set_token("your_token")
api = shun_api()
df = api.daily(ts_code="301662.SZ", start_date="2026-05-01", end_date="2026-05-10")
client = Client()
result = client.symbols(exchange="SZ", limit=5)
SDK usage rules
- 研究、Notebook、快速分析优先使用
shun_api()，默认返回 pandas DataFrame。 - 服务端、批量任务、需要游标和元数据时使用
Client()，默认返回TableResult。 - 已经有
Client()时，可用client.df切到 DataFrame 输出。 - 表格接口都可传
fields做字段筛选，可传format="table" | "dict" | "dataframe"控制返回格式。 - 需要自动翻页时使用
client.iter_pages()或client.fetch_all()。 - 不确定具体 SDK 方法但知道接口名时，使用
client.query(api_name, **params)。 - 非表格接口使用
client.request_json()；当前entitlements()返回权益快照。
Intent taxonomy
1. 行情 / 趋势
常用接口：
daily(ts_code, trade_date/start_date/end_date, fields=...)stk_mins(ts_code, freq, start_date, end_date, fields=...)kline(period, symbol, start_time, end_time, fields=...)kline_adjusted(period, symbol, adj="qfq" | "hfq", include_factor=True)daily_with_factors(ts_code, factors=...)
把“最近”解释成合理窗口，通常是近 20 到 60 个自然日；如果用户指定区间，以用户区间为准。
2. 标的识别 / 基础列表
常用接口：
symbols(exchange="SZ" | "SH", limit=...)
当前 SDK 支持 SZ301662、301662.SZ、SH603626、603626.SH 这类深沪代码写法；不要替用户猜纯数字代码。
3. 资讯 / 公告 / 消息面
常用接口：
announcements(symbol, start_time, end_time, fields=...)stock_news(symbol, source="xueqiu" | "futu", start_time, end_time, fields=...)news_flashes(start_time, end_time, fields=...)news_headlines(start_time, end_time, fields=...)
输出时先按时间倒序梳理关键标题，再给出数据来源和链接字段。
4. 社媒 / 舆情
常用接口：
social_posts(source="xueqiu" | "eastmoney", symbol, start_time, end_time, fields=...)social_comments(source="xueqiu" | "eastmoney", post_id, tree=True/False, fields=...)
注意不同来源的字段可能不同，先看返回字段再做汇总。
Output style
- 先给简短结论，再列数据口径、时间范围和关键字段。
- 分析类输出优先给 3 到 5 个要点，不要只贴原始表。
- 导出类请求直接给可运行代码片段，例如
df.to_csv(...)。 - 不要虚构字段名；需要字段或接口细节时读取
references/接口速查.md。 - 如果请求失败，说明是认证、权限、限流、参数还是服务端错误，并给下一步修复动作。
Bundled resources
references/接口速查.md：当前 SDK 的方法、参数和返回形态速查。scripts/market_data_demo.py：行情和基础标的 DataFrame 示例。scripts/news_data_demo.py：公告、资讯、要闻的结构化结果示例。
