飞书搜索技能,用于搜索飞书云文档、消息和应用,所有搜索命令必须使用 User Access Token。安装方式请前往 riba2534/feishu-cli 获取。
用途与执行流程:每次搜索前先预检 scope,如 feishu-cli auth check --scope "search:docs:read",或同时检查 search:docs:read search:message search:app。返回 ok=true 直接搜索;not_logged_in 或 token_expired 需登录;missing 非空需先在飞书开放平台为应用开通缺失 scope 再重新登录。登录使用 Device Flow(RFC 8628),如 feishu-cli auth login --scope "search:docs:read search:message" --json,AI Agent 推荐后台阻塞模式。登录后所有搜索命令自动从 ~/.feishu-cli/token.json 读取 Token。
主要能力:一、搜索云文档,命令 feishu-cli search docs "关键词",scope 为 search:docs:read,支持 --docs-types、--count(0-50)、--offset、--owner-ids、--chat-ids、-o json;文档类型含 doc、docx、sheet、slides、bitable、mindnote、file、wiki、shortcut;offset + count 不能超过 200。二、搜索消息,命令 feishu-cli search messages "关键词",scope 为 search:message,支持 --chat-ids、--from-ids、--at-chatter-ids、--message-type、--chat-type、--from-type、--start-time、--end-time、--page-size、--page-token、--page-all、--page-limit、--enrich、--card-content-type、--format、--jq、--user-id-type、-o json;默认仅返回消息 ID,加 --enrich 才补全内容、发送者、群名和时间;--page-all 截断无提示,需全量时把 --page-limit 设为 0。三、搜索应用,命令 feishu-cli search apps "关键词",scope 为 search:app,支持 --page-size、--page-token、-o json。
适用场景:按关键词查找飞书文档、Wiki、电子表格、消息记录或内部应用;按群、发送者、时间、消息类型等条件筛选消息;search-chats 无法搜到 p2p 私聊会话时,用 search messages --chat-type p2p_chat 替代。
限制:应用权限需在飞书开放平台申请,search:app 默认不被 auth login --recommend 包含,需显式申请;权限报错 99991679 与 scope 相关;搜索结果为空可能是关键词不匹配或无权限;v1 search docs 与 v2 drive search 均需 search:docs:read,v2 支持更精细筛选。认证流程细节参考 feishu-cli-auth 技能。