wecomcli-lookup-contact

Queries WeCom contact directory and filters members by name or alias locally.

3|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/Liangdi/wecom-pro --skill wecomcli-lookup-contact-liangdi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wecomcli-lookup-contact
Source: https://github.com/Liangdi/wecom-pro/tree/main/skills/wecomcli-lookup-contact
Command: npx skills add https://github.com/Liangdi/wecom-pro --skill wecomcli-lookup-contact-liangdi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding a colleague's userid in WeCom (Enterprise WeChat) normally requires manual directory browsing, and many WeCom APIs require a userid rather than a display name. This Skill retrieves the visible contact list via the wecom-pro CLI and resolves names or aliases to userids locally. ## Core Features & Use Cases - Directory Retrieval: Fetches all members within the current user's visible scope using wecom-pro contact get_userlist, returning userid, name, and alias. - Local Name/Alias Matching: Performs exact and fuzzy matching on names and aliases, presenting candidates when multiple members match. - Userid Resolution for Other Operations: Converts a person's name into the userid required by messaging, scheduling, and other WeCom APIs. - Use Case: A user asks "send a message to Zhang San" — the Skill fetches the contact list once, matches "Zhang San" to userid zhangsan, and passes it to the message-sending command. ## Quick Start Ask the assistant to look up a colleague by name or alias, for example: "Find Sam in the WeCom contacts and tell me his userid."

Frequently Asked Questions about wecomcli-lookup-contact

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find a WeCom user's userid by name?▼

Run `wecom-pro contact get_userlist '{}'` to fetch all visible members, then match the name or alias locally against the returned userlist. Each entry contains userid, name, and alias fields.

How to search WeCom contacts from the command line?▼

Use the wecom-pro CLI contact command to retrieve the visible member list as JSON, then filter results locally by name or alias. There is no server-side search endpoint; all matching happens on the fetched list.

Does the WeCom contact lookup return all company members?▼

No, it only returns members within the current user's visible scope, filtered by WeCom visibility rules. The result is not the full company directory, and fields are limited to userid, name, and alias.

Why does the WeCom contact query fail with large directories?▼

This Skill treats any result over 10 visible members as an error and stops processing. It is designed for small visible scopes; larger directories require narrowing the visible range or using a different query method.

What happens when multiple WeCom members match the same name?▼

All matching candidates are displayed with their name, alias, and userid so the user can choose. The Skill never auto-selects among ambiguous matches.