Wecomcli Contact
This lets Claude query WeChat Work (WeCom) contact directories through the wecom-cli tool. It pulls the contact list visible to the current user and filters locally by name or alias to find userids, which you'll need for other WeCom operations like sending messages. Worth noting it's intentionally limited to directories with 10 or fewer visible contacts and will error out beyond that. It's designed for small team scenarios where you have restricted visibility, not company-wide lookups. The local filtering means you can search multiple people with a single API call, and it handles ambiguous matches by prompting the user to choose from candidates.
- skills.sh installs
- 26K
- GitHub stars
- 3.3K
- last updated
- Aug 21, 2026
Install
$ npx -y skills add wecomteam/wecom-cli --skill wecomcli-contact --agent claude-codeInstalls into .claude/skills of the current project.
Files
企业微信联系人搜索
执行任何
wecom-cli命令前，必须先读取并完成wecomcli-shared技能的公共前置检查。
使用 wecom-cli 按关键词搜索企业微信通讯录中的人员。
接口
按关键词批量模糊搜索人员，一次最多 10 个关键词，返回命中 users 数组（姓名 / 英文名 / 职务 / 部门）。关键词可匹配的字段包括：姓名（用户名）、姓名拼音、英文名、别名，而不仅限于中文名和别名。
命令
wecom-cli contact users search --json '<JSON 参数>'
参数
| 字段 | 类型 | 必填 | 默认值 | 语义 |
|---|---|---|---|---|
keywords | string[] | 是 | — | 搜索关键词列表，可按姓名（用户名）/ 拼音 / 英文名 / 别名匹配，最多 10 个；多个关键词之间是 OR 关系 |
search_mode | string | 否 | — | 搜索模式，默认不传该参数；仅当需要拿到完整人员名单时，才显式传 "list" |
- 默认（不传
search_mode）：返回最相关的候选结果，用于常规按名 / 拼音等查单个人的场景，绝大多数场景走此分支。 - 传
search_mode = "list"：返回全量命中列表。仅当用户明确要"完整名单"时才传，典型话术如"一共有几个张三 / 所有叫李四的人 / 列出全部同名 / 全部同名人员"等清点、穷举意图；此时不受"前 5 位"展示上限约束。
返回
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/wecomteam/wecom-cli
- Category
- CLI & Terminal
- First seen
- Apr 16, 2026
More from wecomteam/wecom-cli
All 21- Wecomcli Meeting26K
- Wecomcli Smartsheet21.4K
- Wecomcli Msg16.4K
- Wecomcli Schedule16.2K
- Wecomcli Sheet13.1K
- Wecomcli Smartpage13K
- Wecomcli Manage Doc2.4K
- Wecomcli Manage Smartsheet Data2.4K
- Wecomcli Get Meeting2.4K
- Wecomcli Get Todo List2.4K
- Wecomcli Edit Meeting2.4K
- Wecomcli Manage Smartsheet Schema2.4K
- Wecomcli Manage Schedule2.4K
- Wecomcli Get Msg2.4K
- Wecomcli Lookup Contact2.4K
- Wecomcli Get Todo Detail2.4K
- Wecomcli Edit Todo2.4K
- Wecomcli Create Meeting2.4K
- Wecomcli Doc26.3K
- Wecomcli Todo26K
Recommended
More CLI & Terminal
wecomcli-meetingwecomteam/wecom-cli企业微信会议技能，支持创建预约会议、查询会议列表、获取会议详情、取消会议、更新会议成员。当用户需要"创建会议"、"预约会议"、"约会议"、"安排会议"、"查看会议"、"查询会议列表"、"会议详情"、"什么时候开会"、"有哪些会议"、"查找会议"、"取消会议"、"删除会议"、"修改会议成员"、"添加会议参与人"、"移除会26Kskills.sh installs
meeglelarksuite/meegle-cli飞书项目（Meego/Meegle）操作工具。支持查询和管理工作项、节点流转、视图查询、个人待办、排期统计等功能。 Use when user needs to work with Feishu/Lark Meego project management — including querying work items,16.9Kskills.sh installswecomcli-msgwecomteam/wecom-cli企业微信消息技能。提供会话列表查询、消息记录拉取（支持文本/图片/文件/语音/视频）、多媒体文件获取和文本消息发送能力。当用户需要"查看消息"、"看聊天记录"、"发消息给某人"、"最近有什么消息"、"给群里发消息"、"看看发了什么图片/文件"时触发。16.4Kskills.sh installswecomcli-schedulewecomteam/wecom-cli企业微信日程管理技能。适用于用户对企业微信日程的各类管理需求。当用户需要：(1) 查询指定时间范围内的日程列表或获取日程详细信息（标题、时间、地点、参与者等），(2) 创建新日程并设置提醒、参与人等，(3) 修改已有日程的标题、时间、地点等信息或取消日程，(4) 添加或移除日程参与人，(5) 查询多个成员的闲忙状态并分16.2Kskills.sh installs