mcpField
F
feishu-cli-api

feishu-cli-api

github.com/riba2534开发1.4k117 次安装3 周前更新
代码仓库

关于 feishu-cli-api

feishu-cli-api 是通过 feishu-cli 直接调用任意飞书 OpenAPI 的技能，适用于没有专用命令封装的接口。它提供身份选择、dry-run、响应格式化和过滤，并支持将原始响应写入文件。

主要功能

  1. 01调用任意飞书 OpenAPI 路径
  2. 02设置查询参数和请求体
  3. 03选择 User 或 Bot 身份
  4. 04dry-run 预览请求内容
  5. 05格式化或过滤 JSON 响应
  6. 06原样保存响应到文件

适用场景

  1. 01调用尚无专用命令的接口
  2. 02发送请求前检查请求体
  3. 03筛选 API 返回的 JSON 数据
  4. 04将文件或媒体响应写入文件

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/riba2534/feishu-cli --skill feishu-cli-api

安装后在 Claude Code 中输入/feishu-cli-api确认已加载。

详细介绍

来自项目 README

飞书 OpenAPI 裸调技能

feishu-cli api 直接调用任意飞书 OpenAPI 接口，覆盖尚未封装成专用命令的接口。是单工具栈下替代 lark-cli api 的兜底能力。

feishu-cli：如尚未安装，请前往 riba2534/feishu-cli 获取安装方式。

用法

feishu-cli api <METHOD> <path> [flags]
  • METHOD：GET | POST | PUT | DELETE | PATCH（大小写不敏感）
  • path：完整 API 路径，如 /open-apis/im/v1/messages（前导斜杠可省略；误传完整 URL 会自动剥掉 host）
Flags
Flag说明
--params '<json>'query 参数（JSON 对象），如 '{"page_size":10}'
--data '<json>' / --data-file <file>请求体：--data 传 JSON 字符串，或 --data-file 从文件读（- 表示 stdin）；二者互斥
--as auto|user|bot身份：auto（User 优先 Tenant 兜底，默认）/ user（强制 User Token，需先 auth login）/ bot（强制 Tenant/应用 Token）
--user-access-token显式传 User Access Token（--as user/auto 时用）
--dry-run只打印将发送的请求（method/path/query/body/identity），不实际调用
-o <file>写原始响应体到文件（binary-safe，适合下载类接口）
--format json|pretty|table|ndjson|csv响应渲染格式（指定后走内置渲染，覆盖默认 pretty；仅适用于 JSON 响应）
--jq '<expr>'用内置 gojq 过滤响应（无需外部 jq；仅适用于 JSON 响应）

-o 二进制下载 与 --format/--jq 互斥：默认 / --raw / 纯 -o 走原样写文件路径（binary-safe）；一旦带上 --format 或 --jq，响应会先按 JSON 解析再渲染，二进制响应会 decode 失败并报错「响应不是合法 JSON，无法用 --format/--jq 渲染（去掉这两个 flag 可用 --raw 原样输出）」。下载媒体/文件时只用 -o，不要叠加 --format/--jq。

大整数精度：响应用 UseNumber 解析，飞书 19 位 message_id/chat_id 等不会被降级丢精度。

三步调研法（不知道 path 时）

feishu-cli schema <service>                 # 1. 列出该 service 的 resource.method
feishu-cli schema <service>.<resource>.<method>   # 2. 查 path / 参数 / scope
feishu-cli api <METHOD> <path> ...          # 3. 裸调

示例

# GET + query + jq 过滤
feishu-cli api GET /open-apis/wiki/v2/spaces --params '{"page_size":10}' --jq '.data.items[].name'

# POST 发消息（先 dry-run 预览）
feishu-cli api POST /open-apis/im/v1/messages \
  --params '{"receive_id_type":"chat_id"}' \
  --data '{"receive_id":"oc_xxx","msg_type":"text","content":"{\"text\":\"hi\"}"}' --dry-run

# 请求体从文件读
feishu-cli api POST /open-apis/bitable/v1/apps/xxx/tables --data-file body.json

# 下载二进制到文件
feishu-cli api GET /open-apis/drive/v1/medias/<token>/download -o /tmp/file.bin

# 强制用户身份（访问用户私有资源）
feishu-cli api GET /open-apis/calendar/v4/calendars --as user

# 表格输出
feishu-cli api GET /open-apis/wiki/v2/spaces --jq '.data.items' --format table

何时用专用命令而非 api

api 是兜底。高频场景优先用封装好的专用命令（错误处理/参数校验/便捷 flag 更完善）：消息→msg、文档→doc、多维表格→bitable、表格→sheet、日历→calendar 等。仅当某接口没有对应专用命令时用 api 裸调。

评论

支持 Markdown