Backend 28,829 installs

lark-openapi-explorer

by larksuite/cli

飞书/Lark 原生 OpenAPI 探索:从官方文档库中挖掘未经 CLI 封装的原生 OpenAPI 接口。当用户的需求无法被现有 lark-* skill 或 lark-cli 已注册命令满足,需要查找并调用原生飞书 OpenAPI 时使用。

Skill content

Discover and call native Lark OpenAPI endpoints from official documentation when existing skills fall short.

- Systematically excavates raw OpenAPI interfaces from Lark's markdown documentation hierarchy (top-level index → module docs → individual API specs) when user needs exceed existing CLI commands

- Supports both Feishu (open.feishu.cn) and Lark (open.larksuite.com) brands; automatically translates Chinese documentation to English if needed

- Executes discovered APIs via lark-cli api with GET, POST, PUT, and DELETE methods, extracting HTTP method, path, parameters, required scopes, and error codes from official specs

- Enforces strict documentation-first lookup (no API guessing) and requires explicit user confirmation before executing write/delete operations

OpenAPI Explorer

前置条件: 先阅读 ../lark-shared/SKILL.md 了解认证、身份切换和安全规则。

当用户的需求无法被现有 skill 或 CLI 已注册 API 覆盖时,使用本技能从飞书官方 markdown 文档库中逐层挖掘原生 OpenAPI 接口,然后通过 lark-cli api 裸调完成任务。

文档库结构

飞书 OpenAPI 文档以 markdown 层级组织:

llms.txt                          ← 顶层索引,列出所有模块文档链接
  └─ llms-<module>.txt            ← 模块文档,包含功能概述 + 底层 API 文档链接
       └─ <api-doc>.md            ← 单个 API 的完整说明(方法/路径/参数/响应/错误码)

文档入口: