watchlist_add
Idempotent
把用户明确指定的股票加入当前 API key 所属用户的私有自选股,支持批量、去重、自动分组、标签和备注。写入工具,仅在用户明确要求加入自选时使用。 何时使用: 把用户明确指定的一只或多只股票加入当前 API key 所属用户的自选股。自选总数最多 300 只,每组最多 50 只;同一股票可属于多个组。支持股票名称/代码混输、批量去重、自动分组(连板/首板/题材/行业)和备注标签。只有用户明确要求"加入自选/加到观察池/帮我收藏这些票"时调用。 【链接】rows/items/嵌套股票对象含 code/name;列股必须用 [name(code)](https://stock.quicktiny.cn/quote/<code>) markdown 链接。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | 可选备注。 | |
| tags | No | 可选标签数组,例如 ["机器人","连板观察"]。也兼容逗号分隔字符串。 | |
| codes | No | 兼容字段。逗号/空格分隔的股票代码或名称,例如 "中际旭创,300750,600839"。 | |
| stock | No | 单只股票代码或名称,例如 600519、贵州茅台。与 stocks/codes 任传其一。 | |
| format | No | content[0].text:默认1行 headline;markdown=完整 markdown 表格;json=完整 JSON。 | |
| stocks | No | 批量股票代码或名称数组,例如 ["中际旭创","300750","600839"]。单次最多 50 只;自选总数最多 300 只。 | |
| position | No | 加入位置。top=放到自选股最前;bottom=放到末尾。默认 top。 | top |
| groupName | No | 手动分组名。传入后默认使用该分组。每组最多 50 只股票;同一股票可属于多个组。 | |
| detailLevel | No | 档位:默认 standard(Agent 可计算标准字段);summary=压缩摘要;raw=全字段+原始数据。 | |
| groupStrategy | No | 分组策略。auto=按连板/首板/题材/行业自动分组;manual=使用 groupName;none=不分组。默认:有 groupName 时 manual,否则 auto。 | |
| sourceContext | No | 可选来源上下文,例如"盘后复盘看到承接不错"。 |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | ||
| meta | No | ||
| success | No |