微信扫一扫板块异动
查询当前市场的板块异动情况。需要三步调用：list → detail → stock_price。交易日交易时间内数据变动快，Agent 每次查询都应重新调用本接口，不要使用缓存数据。
数据说明：数据由山西证券提供。本 Skill 中的分析、结论、建议等内容由使用方的大模型/平台基于参考数据生成，山西证券仅提供参考数据，不构成投资建议。
适用场景
- "看看板块异动"
- "今天有什么板块异动"
- "半导体板块有什么异动"
- "最新异动板块是什么"
- "哪个板块在领涨"
配置
编辑 .env 文件：
MCP_API_KEY=sk_xxxxxxxx_xxxxxxxx
MCP_API_URL=https://app.i618.com.cn
请求
三步调用已封装为 Python 脚本 scripts/query_plate.py，Agent 直接执行即可，无需手写 curl。
| 步骤 | tool_name | 脚本命令 | 说明 |
|------|-----------|----------|------|
| 1 | list | python scripts/query_plate.py --step list | 获取异动板块列表 |
| 2 | detail | python scripts/query_plate.py --step detail --code BK0428 | 获取板块详情 + 成分股 |
| 3 | stock_price | python scripts/query_plate.py --step stock_price --codes 000881.SZ,600973.SH,300667.SZ | 批量查询成分股实时行情 |
脚本内置处理：
- 自动读取
../.env中的MCP_API_KEY和MCP_API_URL stock_price步骤需要传入已拼接市场后缀的 code，格式为stockCode.SH/stockCode.SZ/stockCode.BZ- 成分股超过 100 只时自动截断前 100 个
- 请求超时 15 秒，失败自动重试 1 次
- 错误时输出结构化错误信息到 stderr，退出码非 0
code 格式转换规则
从 section_stocks.stockList 的 stockCode 与 mktType 直接拼接为 code.SUFFIX：
| mktType | 后缀 | 示例 |
|---------|------|------|
| SH（沪市） | .SH | 600973 → 600973.SH |
| SZ（深市） | .SZ | 000881 → 000881.SZ |
| BZ（北证） | .BZ | 920526 → 920526.BZ |
板块选取规则
Agent 从第一步返回的异动列表中选取板块：
| 场景 | 选取逻辑 |
|------|---------|
| 用户未指定板块 | 按 time 字段降序，取时间最近的一条 |
| 用户指定板块名称（如"半导体"） | 按 platName 模糊匹配，找到对应 item |
| 匹配不到 | 回退到最新一条，提示用户"未找到相关板块，已展示最新异动" |
调用上限保护
- 成分股超过 100 只时，只取前 100 只查询股价（取
stockList列表顺序的前 100 个） stock_price一次 POST 请求传入全部 code，无需分批
响应
各 tool 返回字段说明见 references/api_fields.md；数据解读与转换规则见 references/data_rules.md。
可视化建议
Agent 渲染板块异动数据时，按两种视图组织：异动列表（时间轴布局）和板块详情（卡片布局）。完整 HTML 模板、渲染规则、示例流程见 references/render_templates.md。
风险提示
- 非交易日（周末、节假日）无交易数据，接口可能返回上次交易日残留数据或空数据，Agent 应提示用户当前非交易日
- 板块异动数据依赖实时行情，存在数秒延迟
- 异动列表只展示最近若干条，不代表全天所有异动
- 个股行情来自实时行情服务，存在数秒延迟
- 数据不构成投资建议
免责声明
Agent 必须在回答末尾附加以下免责声明，不可省略：
以上数据仅供参考，不构成任何投资建议。股市有风险，投资需谨慎。历史表现不代表未来走势，请投资者根据自身风险承受能力做出独立判断，据此操作风险自担。数据来源以交易所官方信息为准，如有差异请以官方信息为准。