wecomcli-contact

Search WeCom directory contacts by name, pinyin, or alias via wecom-cli.

2.0k|291|Updated Jul 24, 2026
One-click install
npx skills add https://github.com/Pinvou/pinvou-agent --skill wecomcli-contact-pinvou
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wecomcli-contact
Source: https://github.com/Pinvou/pinvou-agent/tree/main/pinvou3-app/src-tauri/resources/common/bundle/wecom-skills/wecomcli-contact
Command: npx skills add https://github.com/Pinvou/pinvou-agent --skill wecomcli-contact-pinvou

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires wecom-cli.

What problem does it solve? Finding the right colleague in a WeCom (Enterprise WeChat) directory is hard when names are ambiguous, duplicated, or only partially known. This Skill searches the corporate directory by keyword and returns userid, department, and position so you can identify the exact person before messaging them. ## Core Features & Use Cases - Fuzzy multi-keyword search: Match people by Chinese name, pinyin, English name, or alias, with up to 10 keywords per query in OR relation. - Disambiguation support: Returns department paths, positions, and matched keywords to distinguish people sharing the same name, with a capped top-5 display and an option to expand. - Full-list mode: Pass search_mode "list" to enumerate all matches when the user explicitly asks for a complete roster of same-name people. - Use Case: Before sending a WeCom message to a colleague named "张伟", search the directory to list all matching users, confirm the correct department and userid, then proceed with the right person. ## Quick Start Search the WeCom directory for the colleague named 张三 and show me their userid and department.

Frequently Asked Questions about wecomcli-contact

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

FAQPage Schema
How do I search for a colleague in the WeCom directory?

Run wecom-cli contact users search with a JSON payload containing a keywords array. Keywords can be Chinese names, pinyin, English names, or aliases, and up to 10 keywords are matched with OR logic in a single query.

How to find someone in WeCom when multiple people share the same name?

The search returns each user's department paths, position, and alias so you can distinguish same-name colleagues. By default only the top 5 candidates are shown; ask to see more or use list mode to enumerate all matches.

What fields does the WeCom contact search return?

Each matched user includes userid, Chinese name, alias, email, position, department paths, and the keywords that matched. The response also contains a users_count and an optional hint field when results are truncated.

When should I use list mode in WeCom contact search?

Use search_mode "list" only when the user explicitly asks for a complete roster, such as listing all people named 张三. Default mode returns the most relevant candidates and is correct for ordinary single-person lookups.

Why does WeCom contact search show only partial results?

When matches exceed result limits, the API truncates output and explains the restriction in the hint field. The user should be told that only partial results were returned and can narrow keywords or request the full list.