lark-contact
bylarksuite· 47 skills
飞书 / Lark 通讯录:按姓名 / 邮箱解析成 open_id,或按 open_id 反查姓名 / 部门 / 邮箱 / 联系方式 / 个人状态 / 签名。当用户提到某人姓名要下一步发消息 / 排日程,或拿到 open_id 想查具体信息时使用。不负责部门树遍历、按部门列员工、组织架构图,这类需求走原生 OpenAPI。
How to install lark-contact?
larksuite/cli/lark-contact
$npx -y skills add larksuite/cli --skill lark-contactInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Run `npx skills use "https://github.com/larksuite/cli" --skill "larksuite/cli/lark-contact"` and follow the generated skill instructions now. Read its complete output, redirecting it to a temporary file first if necessary. Resolve relative paths from the supporting-files directory it provides.
Use the skills in "https://github.com/larksuite/cli" that are relevant to the current task. Run `npx skills add "https://github.com/larksuite/cli"` and select the relevant skills, then follow their instructions.
SKILL.md
| 1 | ## 选哪个命令 |
| 2 | |
| 3 | **user 身份和 bot 身份是两条完全独立的路径**。先确定当前身份,再按下表选命令: |
| 4 | |
| 5 | | 想做什么 | user 身份 | bot 身份 | |
| 6 | |---|---|---| |
| 7 | | 按姓名 / 邮箱搜员工拿 open_id | [`+search-user`](references/lark-contact-search-user.md) | 不支持 | |
| 8 | | 已知 open_id 取他人资料 | `+search-user --user-ids <id>` | [`+get-user --user-id <id>`](references/lark-contact-get-user.md) | |
| 9 | | 查看自己 | `+get-user` 或 `+search-user --user-ids me` | 不支持 | |
| 10 | | 查同事的个人状态 / 签名 | `user_profiles batch_query` | 不支持 | |
| 11 | |
| 12 | 已知 open_id 只是想发消息 / 排日程,不必经过 contact —— 直接 [`lark-im`](../lark-im/SKILL.md) / [`lark-calendar`](../lark-calendar/SKILL.md)。 |
| 13 | |
| 14 | ## 典型场景 |
| 15 | |
| 16 | 找张三给他发消息:先搜,确认 open_id,再发: |
| 17 | |
| 18 | ```bash |
| 19 | lark-cli contact +search-user --query "张三" --has-chatted --as user |
| 20 | lark-cli im +messages-send --user-id ou_xxx --text "Hi!" |
| 21 | ``` |
| 22 | |
| 23 | 批量查同事的个人状态 / 个性签名(先用 schema 看参数)。 |
| 24 | |
| 25 | ```bash |
| 26 | lark-cli schema contact.user_profiles.batch_query |
| 27 | lark-cli contact user_profiles batch_query \ |
| 28 | --params '{"user_id_type":"open_id"}' \ |
| 29 | --data '{"user_ids":["ou_xxx","ou_yyy"],"query_option":{"include_personal_status":true,"include_description":true}}' \ |
| 30 | --as user |
| 31 | ``` |
| 32 | |
| 33 | 搜索命中多条且后续操作有副作用(发消息、邀请会议等),把候选列给用户挑;不要擅自选第一条。 |
| 34 | |
| 35 | ## 注意事项 |
| 36 | |
| 37 | - **41050 / Permission denied** 受当前身份的可见范围限制(两条命令都可能遇到)。换 bot 身份或让管理员调整可见范围,细节见 [`lark-shared`](../lark-shared/SKILL.md)。 |
| 38 | - **跨租户用户**(`is_cross_tenant=true`)多数业务字段为空字符串,这是飞书可见性规则,下游做空值兜底。 |
| 39 | - **ID 类型**:默认 `open_id`。`+get-user` 可改 `--user-id-type union_id|user_id`;`+search-user` 只接受 `open_id`。 |
| 40 | |
| 41 | ## 不在本 skill 范围 |
| 42 | |
| 43 | - 发消息 / 查聊天记录 → [`lark-im`](../lark-im/SKILL.md) |
| 44 | - 排日程 / 邀请会议 → [`lark-calendar`](../lark-calendar/SKILL.md) |
| 45 | - 部门树 / 按部门列员工 / 组织架构 → [`lark-openapi-explorer`](../lark-openapi-explorer/SKILL.md) 查找原生接口 |
Related
6 picksType
- cavemanUltra-compressed communication mode. Cuts output tokens 65% (measured) by speaking like caveman while keeping full technical accuracy.Jul 2026
- lark-im飞书即时通讯：收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件（支持大文件分片下载）、管理表情回复、发送应用内/短信/电话加急、发送和处理交互卡片（Interactive…Jul 2026
- lark-calendar飞书日历：管理日历日程和会议室。查看/搜索日程、创建/更新日程、管理参会人、查询忙闲和推荐时段、预定会议室。当用户需要查看日程安排、创建/修改会议、查询/预定会议室时使用。不负责：查询过去的视频会议记录（走 lark-vc）、待办任务（走 lark-task）。Jul 2026
- lark-workflow-meeting-summary会议纪要整理工作流：汇总指定时间范围内的会议纪要并生成结构化报告。当用户需要整理会议纪要、生成会议周报、回顾一段时间内的会议内容时使用。Jul 2026
- lark-workflow-standup-report日程待办摘要：编排 calendar +agenda 和 task +get-my-tasks，生成指定日期的日程与未完成任务摘要。适用于了解今天/明天/本周的安排。Jul 2026
- lark-approval飞书审批：查询和处理审批待办/已办/实例，搜索可发起审批定义、查看定义详情并发起原生审批实例。当用户要处理审批任务、查看审批实例、搜索或发起审批时使用。审批待办不是飞书任务；非审批类待办走 lark-task。不负责创建审批定义；三方审批定义不走原生提单。Jul 2026
