lark-openapi-explorer

OpenAPI Explorer

(authentication is handled automatically by the MCP server)

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

文档库结构

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

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

文档入口：

品牌	入口 URL
飞书 (Feishu)	https://open.feishu.cn/llms.txt
Lark	https://open.larksuite.com/llms.txt

所有文档以中文编写。如果用户使用英文交流，需将文档内容翻译为英文后输出。

挖掘流程

严格按以下步骤逐层检索，不要跳步或猜测 API：

Step 1：确认现有能力不足

# 先检查是否已有对应的 MCP tool
lark_discover(category="<可能的service>")

如果已有对应工具，直接使用，不需要继续挖掘。

Step 2：从顶层索引定位模块

用 WebFetch 获取顶层索引，找到与需求相关的模块文档链接：

WebFetch https://open.feishu.cn/llms.txt
  → 提取问题："列出所有模块文档链接，找出与 <用户需求关键词> 相关的链接"

• 飞书品牌使用 open.feishu.cn
• Lark 品牌使用 open.larksuite.com
• 如不确定用户品牌，默认使用飞书

Step 3：从模块文档定位具体 API

用 WebFetch 获取模块文档，找到具体 API 的文档链接：

WebFetch https://open.feishu.cn/llms-docs/zh-CN/llms-<module>.txt
  → 提取问题："找出与 <用户需求> 相关的 API 说明和文档链接"

Step 4：获取 API 完整规范

用 WebFetch 获取具体 API 文档，提取完整的调用规范：

WebFetch https://open.feishu.cn/document/server-docs/.../<api>.md
  → 提取问题："返回完整 API 规范：HTTP 方法、URL 路径、路径参数、查询参数、请求体字段（名称/类型/必填/说明）、响应字段、所需权限、错误码"

Step 5：通过 MCP tool 调用 API

使用 lark_invoke 裸调：

# GET 请求
lark_invoke(tool_name="lark_api_GET", args={
  params: {"path": "/open-apis/<path>", "key": "value"}
})

# POST 请求
lark_invoke(tool_name="lark_api_POST", args={
  params: {"path": "/open-apis/<path>"},
  data: {"key": "value"}
})

# PUT 请求
lark_invoke(tool_name="lark_api_PUT", args={
  params: {"path": "/open-apis/<path>"},
  data: {"key": "value"}
})

# DELETE 请求
lark_invoke(tool_name="lark_api_DELETE", args={
  params: {"path": "/open-apis/<path>"}
})

输出规范

向用户呈现挖掘结果时，按以下格式组织：

1. API 名称与功能：一句话描述
2. HTTP 方法与路径：METHOD /open-apis/...
3. 关键参数：列出必填和常用可选参数
4. 所需权限：scope 列表
5. 调用示例：给出 lark_invoke 的完整工具调用
6. 注意事项：频率限制、特殊约束等