顺盈数据

把自然语言财经数据请求，转成可执行的顺盈数据 / 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

真正请求数据前先做轻量检查：

1. 检查 Python 环境可用，shunplus SDK 可导入。
2. 如果当前环境没有安装 shunplus，先安装再继续：

uv add shunplus
# 或
pip install shunplus

3. 检查 Token：优先使用 SHUNPLUS_API_TOKEN 或本地 set_token() 持久化配置。
4. 缺 Token 时直接提示最短修复路径：

export SHUNPLUS_API_TOKEN="your_token"

5. 必要时先跑低成本接口，例如 symbols(exchange="SZ", limit=1)。
6. 如果用户请求高频、长历史或大批量，提醒可能受 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：公告、资讯、要闻的结构化结果示例。