westock-skill

name	westock-skill
description	提供实时行情，支持条件选股、自选管理、股价提醒与模拟交易
version	1.0.0
author	腾讯自选股

腾讯自选股 WeStock Skill

本 Skill 提供腾讯自选股/微证券 MCP 的完整能力：查询 A股/港股/美股等市场数据，按条件/策略/标签筛选股票，管理用户自选股、股价提醒与模拟交易。

返回格式：{ "ok": true|false, "data": ..., "message": "..." }。ok: false 时原样转述 message，禁止编造。

代码格式：sh600519（沪）/ sz000001（深）/ hk00700（港）/ usAAPL（美）；板块 pt01801080。

---

可用工具

data_search - 搜索股票/基金/板块

按名称、代码或拼音搜索标的。

参数说明：

参数	类型	必填	说明
query	string	✅	搜索关键词
type	string	-	stock/etf/bond/sector/index/futures/forex，默认 stock
jpkr_market	string	-	日韩市场 jp/kr
limit	integer	-	返回条数，默认 10

使用示例：

• 用户只说「宁德时代」：先 data_search，再用返回的 code 查行情
• 找 ETF：type=etf；找板块：type=sector

---

data_quote - 股票行情快照

最新价、涨跌幅等；支持多只批量（codes 逗号分隔）。

参数	类型	必填	说明
code / codes	string	二选一	单只或多只代码
date	string	-	历史日期 YYYY-MM-DD

使用示例：对比茅台和平安银行 → codes: "sh600519,sh600036"

---

data_kline - K 线

参数	类型	必填	说明
code	string	✅	股票代码
period	string	-	day/week/month/season/year
limit	integer	-	条数，默认 100
fq	string	-	qfq/hfq，空为不复权
start / end	string	-	日期范围

---

data_minute - 分时

参数	类型	必填	说明
code	string	-	股票代码
days	integer	-	天数，默认 1

---

data_technical - 技术指标

KDJ/MACD/RSI/BOLL 等。

参数	类型	必填	说明
code / codes	string	二选一	股票代码
group / indicator	string	-	指标名，逗号分隔，如 macd
date / start / end	string	-	单日或区间

---

data_chip - 筹码分布

参数	类型	必填	说明
code / codes	string	二选一	股票代码
date / start / end	string	-	日期

---

data_hot - 热门数据

热搜股、热基、热榜等。

参数	类型	必填	说明
kind	string	-	stock/wechat/news/board/etf
limit	integer	-	默认 50

---

data_stocklist - 股单/排行榜

参数	类型	必填	说明
mode	string	-	rank/detail
id	string	-	股单 ID
sort	string	-	排序字段
limit / offset	integer	-	分页

---

data_finance - 财务报表

利润表/资产负债表/现金流量表。

参数	类型	必填	说明
code / codes	string	二选一	股票代码
type	string	-	income/balance/cashflow；省略则拉取三大报表
num	integer	-	期数，默认 1
start / end	string	-	报告期范围

---

data_disclosure - 信息披露预约

参数	类型	必填	说明
code	string	✅	股票代码

---

data_rating - 机构评级

参数	类型	必填	说明
code	string	✅	股票代码

---

data_consensus - 机构一致预期

参数	类型	必填	说明
code	string	✅	股票代码

---

data_score - 诊股评分

指定股票多维诊股评分（Comp/Cap/Funm 等）。全市场排行用 tool_ranking，勿混淆。

参数	类型	必填	说明
code / codes	string	二选一	股票代码
date	string	-	可选日期

---

data_report - 研究报告

参数	类型	必填	说明
mode	string	-	list/detail，默认 list
symbol	string	list 时	股票代码
id	string	detail 时	研报 ID
page	integer	-	页码，默认 1
limit	integer	-	默认 20

---

data_dehydrated - 脱水研报

参数	类型	必填	说明
mode	string	-	list/detail
id	string	detail 时	研报 ID
page	integer	-	页码，默认 1
limit	integer	-	默认 10

---

data_profile - 公司概况

参数	类型	必填	说明
code	string	✅	股票代码

---

data_fund_flow - 资金流向

A 股最全；港股部分字段；美股为卖空相关数据。

参数	类型	必填	说明
code / codes	string	二选一	股票代码
date	string	-	快照日期；历史区间用 start+end（仅单 code）
start / end	string	-	历史日期区间（仅单 code）

---

data_fund_short - 融券数据

参数	类型	必填	说明
code / codes	string	二选一	股票代码
date / start / end	string	-	日期

---

data_fund_margin - 融资融券明细

参数	类型	必填	说明
code	string	-	股票代码
date	string	-	日期

---

data_fund_block - 大宗交易

参数	类型	必填	说明
code	string	-	股票代码
date	string	-	日期

---

data_north_holding - 北向资金持仓

参数	类型	必填	说明
code / codes	string	二选一	股票代码
date	string	-	YYYY-MM-DD

---

data_south_holding - 南下资金持仓

参数	类型	必填	说明
code / codes	string	二选一	仅港股 hk 前缀
date	string	-	YYYY-MM-DD

---

data_shareholder - 股东信息

参数	类型	必填	说明
code / codes	string	二选一	股票代码

---

data_dividend - 分红送转

参数	类型	必填	说明
code / codes	string	二选一	股票代码
years	integer	-	查询年数，默认 1
all	boolean	-	是否包含未实际分红记录，默认 false

---

data_buyback - 回购数据

参数	类型	必填	说明
code	string	-	股票代码
start / end	string	-	日期范围

---

data_news - 新闻资讯

参数	类型	必填	说明
mode	string	-	list/detail
symbol	string	list 时	股票代码
id	string	detail 时	新闻 ID
limit	integer	-	默认 20

---

data_notice - 公告查询

参数	类型	必填	说明
mode	string	-	list/detail，默认 list
symbol	string	list 时	股票代码
id	string	detail 时	公告 ID
type	string	-	公告类型，默认 0（全部）
limit	integer	-	默认 20

---

data_calendar - 财经日历

参数	类型	必填	说明
date	string	-	查询日期
event	string	-	事件类型
market	string	-	hs/hk/us（小写）
limit	integer	-	默认 10

---

data_trade_calendar - 交易日历

参数	类型	必填	说明
date	string	-	单日 YYYY-MM-DD（与 start/end/year 互斥）
start / end	string	-	区间
year	integer	-	查整年
trading_only	boolean	-	仅交易日，默认 false
limit	integer	-	返回条数上限，默认 50
offset	integer	-	偏移量，默认 0

---

data_suspension - 停牌列表

参数	类型	必填	说明
market	string	-	HS/HK/US

---

data_events - 公司事件

查指定股票的事件标签（大宗交易/分红/停牌等）。全市场事件选股用 tool_event；无 code 且 types 空时返回事件类型目录。

参数	类型	必填	说明
code / codes	string	二选一	股票代码
types	string	-	事件类型 ID(1-42) 逗号分隔；空参返回类型目录

---

data_risk - 风险提示

单股风险事件明细（质押/解禁/诉讼等，仅 A 股）。全市场筛 ST 等标签股用 tool_label；无 code 时返回风险类型列表。

参数	类型	必填	说明
code / codes	string	二选一	股票代码
types	string	-	如 st/pledge/unlock/lawsuit 等；逗号分隔

---

data_lhb - 龙虎榜

不传 date 时由上游返回最近可用交易日数据。

参数	类型	必填	说明
type	string	-	jg/yzb/yyb/gslmr/gslxw 或 institution/hotmoney 等；逗号分隔，默认全部
date	string	-	交易日 YYYY-MM-DD，可选

---

data_ipo - 新股 IPO

参数	类型	必填	说明
market	string	-	HS/HK/US

---

data_market_overview - 市场总览

参数	类型	必填	说明
type	string	-	summary/trade/interval/technical/updown/margin/valuation/rotation/all，默认 summary
date	string	-	日期

---

data_changedist - 涨跌分布

沪深 A 股涨跌分布（涨跌家数/涨跌停/区间/成交额）。type 默认 0。

参数	类型	必填	说明
type	string	-	市场类型，默认 0（沪深 A 股）

---

data_index - 指数数据

指数列表/搜索/成分股。mode: list(默认)|search|constituent。

参数	类型	必填	说明
mode	string	-	list/search/constituent
query	string	search 时	搜索关键词
code / codes	string	-	指数代码如 sh000300
limit	integer	-	默认 50

---

data_connect - 陆股通成份股

沪/深股通成份股名单（陆股通北向可买入标的）。查持股明细用 data_north_holding。

参数	类型	必填	说明
exchange	string	-	sh(沪股通)/sz(深股通)，默认 sh
limit / offset	integer	-	分页

---

data_sector - 板块数据

清单/搜索/成份股/概况/排名/经营数据。list 时 scope 用 sw1 等；板块码可作 tool_filter/tool_ranking 的 universe。

参数	类型	必填	说明
mode	string	-	list/search/constituent/info/ranking/oper，默认 list
query	string	search 时	关键词
code	string	constituent 时	板块代码，裸码 pt01801080 或 sw1_pt01801080
scope	string	list 时	industry_list_sw1 或 sw1(申万一级) 等
date	string	-	查询日期 YYYY-MM-DD，默认今天
limit	integer	-	默认 50

使用示例：「华为概念股」→ mode=search, query=华为 拿 code → mode=constituent, code=...

---

data_macro - 宏观经济数据

参数	类型	必填	说明
mode	string	-	list(指标目录)/indicator(默认拉数)/expect(海外预期)
names	string	-	指标名，逗号分隔，如 cn_cpi_ppi
region	string	-	地区
area	string	-	区域列表，逗号分隔
year / date / start / end	string	-	时间

---

data_industry_chain - 产业链

参数	类型	必填	说明
mode	string	-	list(主题列表，默认)/graph(需 theme)/stock(需 code 查个股归属)
theme	string	graph 时	产业主题名
code	string	stock 时	股票代码
category	string	list 时	upstream 仅上中下游

---

data_etf - ETF 数据

参数	类型	必填	说明
code / codes	string	二选一	ETF 代码
aspect	string	-	holdings/nav/company/holders/financial，默认详情快照
date / start / end	string	-	日期

---

data_futures - 期货

参数	类型	必填	说明
mode	string	-	search/list/quote/detail
query	string	search 时	关键词
code	string	-	合约代码

---

data_forex - 外汇

参数	类型	必填	说明
mode	string	-	list/quote
query	string	-	搜索关键词

---

data_bond - 债券/可转债

参数	类型	必填	说明
code / codes	string	-	债券代码
terms / schedule	boolean	-	是否查条款/付息计划

---

tool_filter - 条件选股

自定义表达式或预设条件筛选股票。标签股票池（央企/ST）请用 tool_label，勿作 universe。

参数	类型	必填	说明
expression / preset	string	二选一	表达式或预设名
market	string	-	hs/hk/us，默认 hs
universe	string	-	可选板块码(11010001/pt01801080 等)或 hs/hk/us
date	string	-	基准日期 YYYY-MM-DD，默认今天
orderby / order	string	-	排序字段 / asc
limit	integer	-	默认 20
max_pe / max_pb / min_dividend 等	string	-	预设调参，见 tool_list_presets

使用示例：expression: "intersect([PE_TTM > 0, PE_TTM < 20, ROETTM > 15])"

---

tool_list_presets - 列出预设选股条件

无必填参数。不确定可用预设时先调用本 Tool。

---

tool_strategy - 策略选股

参数	类型	必填	说明
names	string	✅	策略短名，逗号分隔，如 macd_golden（勿 strategy_ 前缀）
date	string	-	快照日期，默认今天
start / end	string	-	区间查询（与 date 互斥）
limit	integer	-	默认 20
offset	integer	-	偏移量，默认 0

使用示例：「MACD 金叉信号股」→ names: "macd_golden"

---

tool_list_strategies - 列出可用策略

不确定时先调本工具；部分付费策略不可用。

参数	类型	必填	说明
group	string	-	按分组过滤

---

tool_label - 标签选股

勿用 tool_filter 的 universe；单股风险明细用 data_risk。

参数	类型	必填	说明
names	string	✅	标签短名，如 shareholder_central_state、risk_st
asset	string	-	stock/etf，默认 stock
date	string	-	快照日期，默认今天
start / end	string	-	区间查询
limit	integer	-	默认 20
offset	integer	-	偏移量，默认 0

使用示例：「央企股票」→ names: "shareholder_central_state"

---

tool_list_labels - 列出可用标签

不确定 names 时先调本工具；部分付费标签不可用。

参数	类型	必填	说明
asset	string	-	stock/etf
group	string	-	分组过滤

---

tool_event - 事件驱动选股

查单股事件标签用 data_events。

参数	类型	必填	说明
names	string	✅	事件短名，逗号分隔
limit	integer	-	默认 20
offset	integer	-	偏移量，默认 0

---

tool_list_events - 列出可用事件

参数	类型	必填	说明
group	string	-	分组过滤

---

tool_ranking - 多因子排行选股

metric 必填且须与 asset 匹配；见 tool_list_ranking_metrics。已知 codes 查评分用 data_score。

参数	类型	必填	说明
metric	string	✅	排行指标；股票如 CompScore，ETF 如 size
asset	string	-	stock/etf，默认 stock
type	string	-	评分变动周期: cur/weekly/monthly（仅评分类指标）
date	string	-	基准日期，默认今天
universe	string	-	可选板块码；非标签
orderby / order	string	-	排序字段 / asc
limit	integer	-	默认 20
offset	integer	-	偏移量，默认 0
within_label	string	-	可选标签短名，如 shareholder_central_state
within_strategy	string	-	可选策略短名，与 within_label/event 互斥
within_event	string	-	可选事件短名，与 within_label/strategy 互斥
min_fields	string	-	最小阈值 JSON，如 {"CompScore":70}

---

tool_list_ranking_metrics - 列出排行指标

不确定 metric 时先调本工具。

参数	类型	必填	说明
asset	string	-	stock/etf
group	string	-	分组过滤

---

portfolio_watchlist - 查询自选股

参数	类型	必填	说明
group	string	-	分组 ID 或名称
market	string	-	A/HK/US
limit	integer	-	默认 200
offset	integer	-	偏移量，默认 0

---

portfolio_watchlist_groups - 查询自选分组

返回正式 group_id（写操作必用，勿用 tmp 前缀）。无必填参数。

使用示例：置顶/移动/备注前必须先调用本 Tool 获取 group_id。

---

portfolio_watchlist_add - 添加自选股

参数	类型	必填	说明
code	string	✅	股票代码
group_id	string	-	不传则加入「全部」

---

portfolio_watchlist_remove - 删除自选股（软删除）

将股票移入「待删除」分组，非物理删除；查「全部」时仍可能看到。

参数	类型	必填	说明
code / codes	string	二选一	股票代码

使用示例：用户说「删除自选茅台」→ 调用本 Tool；回复须说明已移入待删除分组，彻底清空需用户到 App 手动清「待删除」。

---

portfolio_watchlist_batch_add - 批量添加自选

参数	类型	必填	说明
code / codes	string	二选一	逗号分隔
group_id	string	-	目标分组 ID

---

portfolio_watchlist_move - 移动自选到其他分组

参数	类型	必填	说明
code	string	✅	股票代码
from	string	✅	源分组 ID
to	string	✅	目标分组 ID
retain	boolean	-	原分组是否保留

---

portfolio_watchlist_pin - 组内置顶

参数	类型	必填	说明
code	string	✅	股票代码
group_id	string	✅	分组 ID

---

portfolio_watchlist_unpin - 取消置顶

参数	类型	必填	说明
code	string	✅	股票代码
group_id	string	✅	分组 ID

---

portfolio_watchlist_bottom - 组内沉底

参数	类型	必填	说明
code	string	✅	股票代码
group_id	string	✅	分组 ID

---

portfolio_watchlist_note - 自选备注

参数	类型	必填	说明
code	string	✅	股票代码
group_id	string	✅	分组 ID
notes	string	-	空串表示删除备注

---

portfolio_watchlist_sort - 组内排序

参数	类型	必填	说明
group_id	string	✅	分组 ID
code / codes	string	二选一	按目标顺序排列的代码列表
star_count	integer	-	置顶数量，默认 0

---

portfolio_group_add - 新建自选分组

参数	类型	必填	说明
name	string	✅	分组名称，不可与已有分组重名

返回正式分组 ID，可直接用于后续写操作。

---

portfolio_group_rename - 重命名分组

参数	类型	必填	说明
group_id	string	✅	分组 ID
name	string	✅	新名称

---

portfolio_group_sort - 调整分组显示顺序

参数	类型	必填	说明
group_ids	string	✅	分组 ID 列表，逗号分隔，按目标顺序

---

portfolio_tips_query - 查询股价提醒

查询当前用户已设置的全部股价提醒。返回 tips 数组，字段空串或 0 表示未开启。无必填参数。

返回字段	说明
code	股票代码
high / low	价格涨至 / 跌至提醒
updown	涨跌幅阈值提醒(%)
pdrhigh / pdrlow	场内 ETF 溢折率涨至 / 跌至提醒
fundjz	基金净值提醒（仅基金有效）
notice / research	公告 / 研报提醒开关(1/0)
updatetime	更新时间

使用示例：修改单项提醒前，必须先调本 Tool 拿到该 code 现有提醒值，用于回填。

---

portfolio_tips_set - 新增/修改股价提醒

⚠️ 上游为全量覆盖语义：未传的字段会被清空，传空串也会清空。修改单项前必须先调 portfolio_tips_query 拿到该 code 现有提醒，把不想改动的字段原值一并带上；只有想取消的字段才传空串。

参数	类型	必填	说明
code	string	✅	股票代码，如 sh600519/sz000001/hk00700，兼容 600519.SH 等后缀格式
high	string	-	价格涨至提醒；传空串取消；不想改则回填 query 现值
low	string	-	价格跌至提醒；传空串取消；不想改则回填 query 现值
updown	string	-	涨跌幅超过阈值提醒(%)；传空串取消；不想改则回填 query 现值
pdrhigh	string	-	场内 ETF 溢折率涨至提醒；传空串取消
pdrlow	string	-	场内 ETF 溢折率跌至提醒；传空串取消
type	string	-	公告/研报订阅：2010 沪深公告、2011 沪深研报、2020 港股公告、2021 港股研报；传空串取消
isfund	string	-	是否基金：1 基金，0 非基金；仅 isfund=1 时 action=open 生效
action	string	-	基金净值提醒动作，open 表示打开（仅 isfund=1 有效）

使用示例：

• 「贵州茅台涨到 1300 元提醒我」→ 先 data_search 拿代码 → code: "sh600519", high: "1300"
• 「宁德时代跌破 300 元提醒我」→ code: "sz300750", low: "300"
• 「腾讯控股日涨幅超 5% 提醒我」→ code: "hk00700", updown: "5"
• 为已有提醒（low=1500）的 sh600519 新增 high=1800 → 先 query 回填 → code: "sh600519", high: "1800", low: "1500"

---

portfolio_paper_portfolio - 模拟交易账户概览

查询练习赛组合总资产、持仓市值、可用资金、总盈亏等。无必填参数。

使用示例：

• 「我的模拟账户概况」→ 直接调用
• 模拟买入/卖出前先查可用资金

---

portfolio_paper_positions - 模拟交易持仓

查询持仓列表（成本价、现价、浮盈浮亏）。无必填参数。

使用示例：

• 「模拟账户里有哪些持仓」→ 直接调用
• 模拟卖出前先调用，确认可用数量

---

portfolio_paper_profit - 模拟交易盈亏统计

查询胜率、已实现/未实现盈亏、个股收益贡献等。无必填参数。

使用示例：

• 「模拟交易收益怎么样」→ 结合 portfolio_paper_portfolio 综合分析

---

portfolio_paper_trade - 模拟限价下单

仅沪深 A 股；虚拟资金，非真实交易。须限价单，数量须 100 整数倍。

参数	类型	必填	说明
code	string	✅	A 股代码，如 sh600519/sz000001
direction	string	✅	buy / sell
price	number	✅	限价（元）
quantity	integer	-	数量（股），100 整数倍，默认 100

使用示例：

• 模拟买入平安银行 100 股 → 先 data_quote 拿现价，再 code: "sz000001", direction: "buy", price: 10.16, quantity: 100
• 用户只说「模拟买茅台」→ 先 data_search + data_quote，再下单
• 卖出无持仓时会返回业务错误，须先查 portfolio_paper_positions

---

portfolio_paper_cancel - 撤销模拟委托

仅可撤销待成交订单。

参数	类型	必填	说明
order_id	string	✅	订单 ID，来自 portfolio_paper_trade 或 portfolio_paper_history

使用示例：

• 撤单前先用 portfolio_paper_history（range: "today"）找待成交订单的 orderId

---

portfolio_paper_history - 模拟交易记录

参数	类型	必填	说明
range	string	-	today（默认）/ recent（近 3 月合并）/ history（指定月）
month	string	history 时 ✅	YYYYMM，如 202604
code	string	-	按股票过滤
direction	string	-	buy / sell
limit	integer	-	返回条数，默认 50
offset	integer	-	偏移量，默认 0

使用示例：

• 「今天的模拟交易记录」→ range: "today"
• 「近几个月模拟交易」→ range: "recent"（勿逐月遍历）
• 「2025 年 4 月模拟交易」→ range: "history", month: "202504"
• 「模拟交易里茅台的买卖记录」→ code: "sh600519", range: "recent"

---

注意事项

• 禁止绕过：不用 web_search 或训练数据替代本 Connector 的行情/财务/宏观数据
• 先 search 再查：用户只给股票名称时，先 data_search 拿代码
• 分工：单股明细用 data_*；批量筛选用 tool_*；用户自选/股价提醒/模拟交易用 portfolio_*
• 股价提醒：portfolio_tips_set 为全量覆盖语义，修改单项前必须先 portfolio_tips_query 回填其余字段，避免误清空已有提醒；用户只给股票名称时先 data_search 拿代码
• 多股批量：同一市场、支持 codes 的 Tool 只调 1 次，逗号分隔
• 概念股：用 data_sector（search → constituent），不要用 data_search 代替成份股
• 删除自选：portfolio_watchlist_remove 为软删除（移入「待删除」），告知用户彻底删除需到自选股 App 清空该分组
• 空结果：如实说明「暂无数据」，不要编造
• 模拟交易：仅沪深 A 股、限价单、数量 100 整数倍；虚拟资金，非真实交易；撤单仅待成交订单；下单前建议先 data_quote 确认价格
• 投资组合类能力（自选/股价提醒/模拟交易）操作用户本人数据，需用户完成 Connector 授权后方可使用

---

免责声明

仅提供客观市场数据与用户自选/模拟交易管理，不构成投资建议。模拟交易仅供学习体验，虚拟资金非真实交易。数据可能有延迟，以交易所官方为准。投资有风险，决策需谨慎。