Lark Contact

contact (v1)

CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md)，其中包含认证、权限处理

Shortcuts（推荐优先使用）

Shortcut 是对常用操作的高级封装（lark-cli contact +<verb> [flags]）。有 Shortcut 的操作优先使用。

contact +get-user（获取用户信息）

前置条件： 先阅读 `../lark-shared/SKILL.md` 了解认证、全局参数和安全规则。

本 skill 对应 shortcut：lark-cli contact +get-user。

支持两种模式：

1. 不传 `--user-id`：获取当前用户自己的信息（底层 GET /open-apis/authen/v1/user_info） 2. 传 `--user-id`：获取指定用户信息（底层 GET /open-apis/contact/v3/users/{user_id}，默认 user_id_type=open_id）

命令

# 模式 1：获取当前用户
lark-cli contact +get-user

# 模式 2：获取指定用户（默认 user_id_type=open_id）
lark-cli contact +get-user --user-id ou_xxx

# 指定 user_id_type
lark-cli contact +get-user --user-id 4g3f... --user-id-type user_id

# 表格输出（默认 JSON）
lark-cli contact +get-user --user-id ou_xxx --table

参数

常见错误（41050）

如果返回提示无权限（常见错误码 41050），通常是组织架构可见范围限制导致：

• 建议联系管理员调整当前用户的组织架构可见范围
• 或改用应用身份（tenant_access_token）调用通讯录 API

参考

• lark-contact-search-user — 先搜到 open_id 再 get
• lark-shared — 认证和全局参数

contact +search-user（搜索员工）

前置条件： 先阅读 `../lark-shared/SKILL.md` 了解认证、全局参数和安全规则。

通过关键词搜索员工（姓名/邮箱/手机号等），结果通常按亲密度排序。

本 skill 对应 shortcut：lark-cli contact +search-user（底层调用 GET /open-apis/search/v1/user）。

命令

# 搜索员工（默认表格输出）
lark-cli contact +search-user --query "张三"

# 分页（取下一页）
lark-cli contact +search-user --query "张三" --page-size 50 --page-token <PAGE_TOKEN>

# 人类可读格式输出
lark-cli contact +search-user --query "张三" --format pretty

参数

常见用法（给 AI）

• 默认输出 JSON，可直接解析获取用户 open_id。用 --format pretty 查看人类可读格式。
• 如果结果 has_more=true，继续传 page_token 翻页，不要盲目调大 page_size。

参考

• lark-shared — 认证和全局参数