lark-contact

Resolves Lark user and bot identities into open_ids via contact search commands.

2|Updated Aug 9, 2026
One-click install
npx skills add https://github.com/DeepJH/doubao-skill-and-info --skill lark-contact-deepjh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-contact
Source: https://github.com/DeepJH/doubao-skill-and-info/tree/main/skills/lark-contact
Command: npx skills add https://github.com/DeepJH/doubao-skill-and-info --skill lark-contact-deepjh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires lark-cli, and includes references (resource) components.

What problem does it solve? When working in Feishu/Lark, you often know a person's name or email but need their open_id before you can send a message or schedule a meeting. This Skill bridges that gap by searching the Lark contact directory, resolving names and emails to open_ids, looking up user profiles, and searching for visible bots and agents. ## Core Features & Use Cases - User Search: Find employees by name, email, or phone keyword and retrieve their open_id, department, enterprise email, and chat status, with filters for chatted users, same-tenant users, and enterprise email holders. - Profile Lookup: Batch-query user profiles including personal status and signature, or fetch your own info via +get-user or --user-ids me. - Bot & Agent Search: Search bots and intelligent agents visible to the current user by keyword, optionally scoped to specific chats, returning bot open_ids. - Use Case: A user says "send a message to 张三". You run lark-cli contact +search-user --query "张三" --has-chatted --as user, confirm the correct person from the candidates, then pass the open_id to the lark-im skill to deliver the message. ## Quick Start Ask the assistant to find a colleague's open_id by name or email using the lark contact search, then use that open_id to send them a message.

Frequently Asked Questions about lark-contact

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

FAQPage Schema
How do I find a Lark user's open_id by name?

Run lark-cli contact +search-user with the --query flag and the person's name or email, using user identity. The command returns matching users with open_id, department, and email fields so you can confirm the right person before messaging.

How to search for bots or agents in Feishu Lark?

Use lark-cli contact +search-bot with a keyword via --query, or multiple keywords via --queries. It returns bot open_ids, names, descriptions, and an is_agent flag, and can be scoped to specific chats with --chat-ids.

Can I look up multiple Lark users at once?

Yes. Pass up to 100 open_ids with --user-ids to batch-fetch user fields, or use --queries with up to 20 keywords for parallel name searches. Each result carries a matched_query field indicating which keyword produced it.

Why does Lark contact search return permission denied error 41050?

Error 41050 means the current identity's visibility scope does not cover the target users or bots. An administrator must adjust the visibility range in the Lark admin console before the search commands can return those results.

What are the limitations of Lark contact search?

Search does not auto-paginate, so has_more=true requires refining the query. Cross-tenant users return empty business fields, and department tree traversal or listing employees by department is out of scope and requires the native OpenAPI.