skills.rest
yuezhen-huang
yuezhen-huangCOMMUNITY
Explore all skills by this author →
GitHub

lark-contact

Search employees and retrieve user profiles from the Feishu contact directory.

Updated Apr 30, 2026
Search Tags:#directory#feishu#lark#lark-cli#contact#user search#open_id
One-click install
npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill lark-contact-yuezhen-huang
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: lark-contact
Source: https://github.com/yuezhen-huang/my-bytedance-skillhub/tree/main/lark-contact
Command: npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill lark-contact-yuezhen-huang

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Finding colleague information in Feishu (Lark) often requires manual searching through the app. This Skill lets you programmatically query the organizational directory, look up user details, and resolve open_id values needed by other Feishu API operations. ## Core Features & Use Cases - Employee Search: Search users by name, email, or phone number with relevance-sorted results and pagination support. - User Profile Retrieval: Get detailed information for the current user or any specified user via open_id, union_id, or user_id. - Use Case: Before sending a message with lark-im, search for a colleague by name to obtain their open_id, then use that ID to address the message correctly. ## Quick Start Ask the AI to search Feishu contacts for a colleague named Zhang San and show their profile details.

Frequently Asked Questions about lark-contact

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

FAQPage Schema
How do I search for an employee in Feishu by name?▼

Run lark-cli contact +search-user with the --query flag containing the name, email, or phone number. Results are sorted by relevance and returned as JSON by default, or use --format pretty for human-readable output.

How to get a user's open_id in Lark for API calls?▼

Search for the user with lark-cli contact +search-user and parse the open_id field from the JSON results. You can then pass that open_id to lark-cli contact +get-user --user-id to fetch full profile details.

Can I get my own Feishu user info from the command line?▼

Yes, run lark-cli contact +get-user without the --user-id flag. This calls the authen user_info endpoint and returns the current authenticated user's profile information.

Why does Feishu contact search return error 41050?▼

Error 41050 indicates insufficient permission, usually caused by organizational visibility scope restrictions on the current user. Ask an administrator to adjust the visibility range, or call the contact API using a tenant_access_token with app identity instead.

How do I paginate through large Feishu user search results?▼

When the response shows has_more=true, pass the returned page_token via --page-token on the next call to fetch the following page. Avoid blindly increasing --page-size beyond the 200 maximum.

Related Skills

Explore More Software Engineering Skills→
MiniMax-AIMiniMax-AI
1.3k

lark-contact

Query Feishu organization structure, search employees, and retrieve user information via lark-cli.

Official
Basic
U1traVenoU1traVeno

lark-contact

Resolves Lark contact names and emails to open_ids and retrieves user profiles.

Community
Intermediate
DingTalk-Real-AIDingTalk-Real-AI
2.7k

dingtalk-wiki

Create, search, and manage DingTalk wiki spaces via the dws CLI.

Official
Advanced
SpaceZephyrSpaceZephyr
14

lark-openapi-explorer

Parse Feishu/Lark OpenAPI markdown docs to locate and invoke native endpoints via lark-cli.

Community
Intermediate