westock-data

name	westock-data
description	通过 westock-mcp 连接器查询 A股/港股/美股个股/指数/ETF 数据——行情、K线、财报、资金、技术指标、板块成份、宏观等。触发词：查行情、看K线、查财报、资金流向、板块概念、宏观数据。需已连接 westock-mcp 连接器。

WeStock Data（MCP 模式）

数据源：腾讯自选股 westock-mcp 连接器 | 支持市场：A股、港股、美股

前置条件：专家包已声明 dependencies.connectors: ["westock-mcp"]。

连接器已连接时（铁律）：取数必须且只能调用连接器的 data_* MCP Tool。禁止运行本地 scripts/、禁止 web_search / WebSearch 替代行情/财务/K线/资金等结构化数据、禁止使用其他 skill 或 MCP 取数。westock-data / westock-tool 技能仅提供「何时调哪个 Tool」的方法论，实际取数通道只有 westock-mcp。

腾讯自选股连接器未连接时：无法调用 data_* Tool。降级使用 WebSearch 及环境中其他可用 skill/MCP 取数，效果会明显变差；主理人会在 chat 单独提示「腾讯自选股连接器未连接」。

与 westock-tool 的分工：

• westock-data（本技能）：查个股/指数/板块详情、宏观、新闻公告、板块成份股
• westock-tool：筛选/选股——找出满足条件的股票列表
• 用户自选股管理：连接器 portfolio_* Tool（非本技能）

返回处理：MCP 返回 { ok, data, message }。ok: false 时如实转述 message；ok: true 时将 data 转为表格或可读格式展示，禁止输出原始 JSON 堆砌。

完整 Tool 映射见 references/mcp-tool-map.md。

---

调用规范

1. 先 search 再查：用户只给名称时，先 data_search 拿 code，再调其他 Tool
2. 多股批量：支持 codes 的 Tool 用逗号分隔，只调 1 次（如 data_quote codes=sh600519,sz000001）
3. 概念股两步：data_sector mode=search → data_sector mode=constituent
4. 参数不确定：先读 Tool schema（tools/data_*.json）再调用

---

常用 Tool 速查

搜索与行情

data_search      query=腾讯控股                    # 搜股票
data_search      query=华夏 type=etf               # 搜 ETF
data_search      query=银行 type=sector            # 搜板块（仅名称+代码）
data_quote       code=sh600519                     # 单股行情
data_quote       codes=sh600519,sz000001,hk00700   # 批量行情
data_score       code=sh600519                     # 诊股评分

K 线与分时

data_kline       code=sh600000 period=day limit=20 fq=qfq
data_minute      code=sh600000 days=5

周期：day/week/month/season/year；复权：qfq/hfq/空(不复权)

财务与公司

data_finance     code=sh600000 num=4               # 最近 4 期财报
data_finance     code=hk00700 type=income num=4    # 港股损益表
data_profile     code=sh600000
data_rating      code=sh600519
data_consensus   code=sh600519

资金与交易

data_fund_flow   code=sh600000 date=2026-03-10
data_fund_short  code=usAAPL
data_fund_margin code=sz000001
data_fund_block  code=sz000001
data_buyback     code=sh600519
data_lhb         type=jg date=2026-03-20
data_risk        code=sh600000 types=pledge,unlock  # 仅 A 股

新闻与研究

data_news        mode=list symbol=sh600000 limit=20
data_news        mode=detail id=<新闻ID>
data_notice      mode=list symbol=sh600000
data_report      mode=list symbol=sh600000 limit=20
data_dehydrated  mode=list limit=10

技术与筹码

data_technical   code=sh600000 group=macd,rsi
data_chip        code=sh600519
data_shareholder code=sh600519
data_dividend    code=sh600519 years=5

市场与板块

data_hot         kind=stock
data_stocklist   mode=rank                        # 热门股单（非用户自选）
data_changedist  type=hs
data_connect     exchange=sh limit=50             # 沪股通
data_ipo         market=HS
data_calendar    date=2026-03-10 limit=30
data_macro       mode=list                        # 列出指标
data_macro       names=cn_cpi_ppi year=2025
data_sector      mode=search query=华为           # 搜概念
data_sector      mode=constituent code=style_pt01801517  # 成份股
data_index       code=sh000300                    # 指数成份

---

已知限制

限制项	说明
风险事件 data_risk	仅 A 股（sh/sz/bj）
龙虎榜 data_lhb	仅 A 股
筹码 data_chip	仅沪深京 A 股
货币单位	港股港元/美元，美股美元，展示时须标注
data_search/data_minute	不支持批量

---

股票代码格式

市场	格式	示例
沪市/科创板	sh + 6位	sh600000、sh688981
深市	sz + 6位	sz000001
北交所	bj + 6位	bj430047
港股	hk + 5位	hk00700
美股	us + 代码	usAAPL
板块	pt 或 sw 前缀	pt01801080、sw1_pt01801080

---

常见场景

查股票：data_search 腾讯 → data_quote hk00700
K线分析：data_kline sz002714 period=day limit=20
多股对比：data_quote hk00700,usBABA
资金流向：data_fund_flow sh688981
概念股：data_sector search 华为 → data_sector constituent <code>
板块排行：data_sector mode=ranking ...
宏观：data_macro names=cn_pmi start=2024 end=2025

完整场景（33 个）见 references/scenarios-guide.md（CLI 示例请对照 mcp-tool-map.md 转换）。

字段说明见 references/ai_usage_guide.md。

---

重要声明

1. 本技能仅提供客观市场数据查询与展示，不构成投资建议。
2. 数据可能有延迟，以交易所官方为准。
3. 投资有风险，决策需谨慎。

数据来源：腾讯自选股 westock-mcp 连接器