聚合智能
juhe-cli 开放平台
返回首页

juhecli-wx-label 个微标签

SKILL: juhecli-wx-label — 微信个微标签管理功能，包括标签增删改查、联系人标签管理、按标签查询联系人等操作

使用案例

创建标签 VIP 客户给张三打上 VIP 客户标签查看 VIP 客户标签下的所有人

查看所有标签

获取当前微信账号的全部标签列表
>看看我有哪些标签
// Agent 调用 wx label list 获取标签列表
$juhe-cli wx label list '{}'
{ "labels": [ { "label_id": 1, "label_name": "客户" }, { "label_id": 2, "label_name": "潜在客户" }, { "label_id": 3, "label_name": "VIP客户" } ] }

创建VIP标签

创建新的标签并应用到联系人
>创建一个 VIP 标签
// Agent 调用 wx label add 创建标签
$juhe-cli wx label add '{"label_name": "VIP客户"}'
{ "label_id": 3, "label_name": "VIP客户" }

概述

个微标签 SKILL 由 juhecli-wx-label 提供，支持完整的微信标签管理功能。 包括创建、修改、删除标签，给联系人打标签或移除标签，按标签查询联系人，查询标签使用数量等 7 个命令。 适用于需要对联系人进行分类管理、精准营销等场景。

标签是微信联系人管理的重要工具，可以用于客户分类、群组管理、精准营销等场景。 建议根据业务需求合理规划标签体系，避免标签过多导致管理混乱。

SKILL 包

SKILL 名称说明
juhecli-wx-label个微标签管理 - 标签增删改查、联系人标签管理、按标签查询联系人

触发方式

当用户提出以下意图时，Agent 应激活此 SKILL：

  • "查看标签列表" / "有哪些标签"
  • "创建 VIP 标签" / "新建标签" / "添加标签"
  • "给张三打上客户标签" / "给联系人加标签"
  • "查看 VIP 标签下的联系人" / "按标签查联系人"
  • "把标签改名" / "删除无用标签"
  • "各标签使用情况" / "标签使用数量"

详细说明

获取标签列表 (list)

获取当前微信账号的所有标签。

bash
wx label list '{}'

返回值：

  • 标签列表，每条包含 label_id（标签 ID）、label_name（标签名称）

创建标签 (add)

bash
wx label add '{"label_name": "客户"}'

参数：

  • label_name (string, 必填) — 标签名称 [用户提供]

返回值：

  • 新创建标签的 label_id

修改标签 (update)

bash
wx label update '{"label_id": 1, "label_name": "VIP客户"}'

参数：

  • label_id (int, 必填) — 标签 ID [需查询] — 通过 label list 获取
  • label_name (string, 必填) — 新标签名 [用户提供]

删除标签 (del)

bash
wx label del '{"label_id": 1}'

参数：

  • label_id (int, 必填) — 标签 ID [需查询]
删除标签会同时移除所有联系人的该标签关联，操作不可恢复，请谨慎使用。

修改联系人标签 (modify)

为指定联系人设置标签，此操作会覆盖联系人原有的标签列表。

bash
wx label modify '{"username_list": ["wxid_a", "wxid_b"], "label_id_list": [1, 2]}'

参数：

  • username_list (array, 必填) — 联系人 username 列表 [需查询]
  • label_id_list (array, 必填) — 标签 ID 列表 [需查询]
此操作会覆盖联系人原有的标签。如需移除所有标签，传入空数组 []。 如需追加标签，需要先查询原有标签，将新旧标签合并后一起传入。

按标签查询联系人 (contacts)

bash
wx label contacts '{"label_id_list": [1, 2]}'

参数：

  • label_id_list (array, 必填) — 标签 ID 列表 [需查询]

返回值：

  • 匹配标签的联系人列表

查询标签使用数量 (usage)

bash
wx label usage '{"label_id_list": [1, 2]}'

参数：

  • label_id_list (array, 必填) — 标签 ID 列表 [需查询]

返回值：

  • 每个标签的使用数量统计

参数来源说明

参数来源标记获取方式
label_name[用户提供]用户直接提供标签名称
label_id[需查询]通过 wx label list 获取标签列表中的 ID
label_id_list[需查询]通过 wx label list 获取多个标签 ID
username_list[需查询]通过 db contact search 查询联系人获取

典型工作流

创建标签并应用到联系人

  1. wx label add — 创建新标签，获取 label_id
  2. db contact search — 查询目标联系人的 username
  3. wx label modify — 将标签应用到联系人

按标签查找联系人

  1. wx label list — 查看所有标签，找到目标标签 ID
  2. wx label contacts — 查询该标签下的联系人

标签整理和维护

  1. wx label list — 查看所有标签
  2. wx label usage — 查看各标签使用数量
  3. wx label update — 重命名标签
  4. wx label del — 删除无用标签（使用数量为 0 的）

追加标签到联系人

  1. wx label list — 获取标签 ID
  2. 查询联系人当前标签
  3. 将原有标签和新标签合并
  4. wx label modify — 传入合并后的完整标签列表

AI Agent 调用示例

wx label add + modify

text
// 用户：创建一个"客户"标签
AI: 好的，我来创建标签。
[调用 wx label add {"label_name":"客户"}]
AI: 标签创建成功！标签 ID 为 1。

// 用户：给张三打上客户标签
AI: 好的，我先查询张三的信息。
[调用 db contact search {"keyword":"张三"}] → username="wxid_zhangsan"

[调用 wx label modify {"username_list":["wxid_zhangsan"],"label_id_list":[1]}]
AI: 已成功为张三添加"客户"标签。

wx label contacts + usage

text
// 用户：查看所有 VIP 客户
AI: 好的，我先查询 VIP 客户标签的 ID。
[调用 wx label list] → VIP 客户标签 ID 为 3

[调用 wx label contacts {"label_id_list":[3]}]
AI: 找到 15 位 VIP 客户：
1. 张三 (wxid_zhangsan)
2. 李四 (wxid_lisi)
...

// 用户：看看各标签的使用情况
AI: 好的，我来查询。
[调用 wx label list 获取所有标签 ID]
[调用 wx label usage {"label_id_list":[1,2,3,4]}]
AI: 标签使用情况：
- VIP 客户：15 人
- 潜在客户：32 人
- 普通客户：89 人
- 测试标签：0 人

wx label update + del

text
// 用户：把"潜在客户"改成"意向客户"
AI: 好的，我先查询标签 ID。
[调用 wx label list] → "潜在客户"标签 ID 为 2

[调用 wx label update {"label_id":2,"label_name":"意向客户"}]
AI: 标签重命名成功！

// 用户：删除没有使用的标签
AI: 我来查看使用数量。
[调用 wx label usage] → 测试标签（0人）、旧标签（0人）

确认删除这些标签吗？
用户：确认

[调用 wx label del {"label_id":5}] + [调用 wx label del {"label_id":6}]
AI: 已删除 2 个未使用的标签。

完整工作流：批量打标签

text
// 用户：帮我把这三位客户打上 VIP 标签：张三、李四、王五
AI: 好的，我先查询联系人和标签信息。

[步骤 1: 查询 VIP 标签]
[调用 wx label list] → VIP 客户: label_id=3

[步骤 2: 查询联系人]
[调用 db contact search {"keyword":"张三"}] → wxid_zhangsan
[调用 db contact search {"keyword":"李四"}] → wxid_lisi
[调用 db contact search {"keyword":"王五"}] → wxid_wangwu

[步骤 3: 应用标签]
[调用 wx label modify {"username_list":["wxid_zhangsan","wxid_lisi","wxid_wangwu"],"label_id_list":[3]}]

AI: 已成功为张三、李四、王五添加 VIP 客户标签！

错误处理

  • 标签名重复：返回已存在错误，请使用不同的名称
  • label_id 不存在：返回标签不存在错误，请通过 label list 确认 ID
  • username 不存在：返回联系人不存在错误，请先添加好友
  • 标签数量超限：微信对标签数量有一定限制，需要清理无用标签
  • modify 覆盖问题：注意 modify 是覆盖操作，追加标签时需先查询原有标签
微信对标签数量有一定限制，建议定期通过 wx label usage 查看使用情况， 清理不再使用的标签，保持标签体系的简洁和有效。