🛠️ 開発・MCP コミュニティ

lark-openapi-explorer

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

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux

mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o lark-openapi-explorer.zip https://jpskill.com/download/19586.zip && unzip -o lark-openapi-explorer.zip && rm lark-openapi-explorer.zip

🪟 Windows (PowerShell)

$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/19586.zip -OutFile "$d\lark-openapi-explorer.zip"; Expand-Archive "$d\lark-openapi-explorer.zip" -DestinationPath $d -Force; ri "$d\lark-openapi-explorer.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)

1. 下の青いボタンを押して lark-openapi-explorer.zip をダウンロード
2. ZIPファイルをダブルクリックで解凍 → lark-openapi-explorer フォルダができる
3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
4. Claude Code を再起動

⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
- · macOS / Linux: ~/.claude/skills/
- · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →

最終更新: 2026-05-18
取得日時: 2026-05-18
同梱ファイル: 1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

OpenAPI Explorer

前提条件： 認証、ID 切り替え、およびセキュリティルールについては、まず ../lark-shared/SKILL.md をお読みください。

ユーザーの要求が既存の skill や CLI に登録されている API でカバーできない場合、このスキルを使用して、飛書（Feishu）の公式 Markdown ドキュメントライブラリからネイティブ OpenAPI インターフェースを階層的に掘り起こし、lark-cli api を使用して直接呼び出すことでタスクを完了します。

ドキュメントライブラリの構造

飛書（Feishu）の 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：既存の能力が不足していることを確認する

# まず、対応する skill または登録済みの API があるか確認します
lark-cli <可能なservice> --help

対応するコマンドまたはショートカットがすでに存在する場合は、それらを直接使用し、掘り起こしを続ける必要はありません。

Step 2：トップレベルインデックスからモジュールを特定する

WebFetch を使用してトップレベルインデックスを取得し、要求に関連するモジュールドキュメントへのリンクを見つけます。

WebFetch https://open.feishu.cn/llms.txt
  → 質問を抽出：「すべてのモジュールドキュメントリンクをリストアップし、<ユーザー要求キーワード> に関連するリンクを見つけ出す」

飛書（Feishu）ブランドは open.feishu.cn を使用します。
Lark ブランドは open.larksuite.com を使用します。
ユーザーのブランドが不明な場合は、デフォルトで飛書（Feishu）を使用します。

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：CLI を介して API を呼び出す

lark-cli api を使用して直接呼び出します。

# GET リクエスト
lark-cli api GET /open-apis/<path> --params '{"key":"value"}'

# POST リクエスト
lark-cli api POST /open-apis/<path> --data '{"key":"value"}'

# PUT リクエスト
lark-cli api PUT /open-apis/<path> --data '{"key":"value"}'

# DELETE リクエスト
lark-cli api DELETE /open-apis/<path>

出力仕様

ユーザーに掘り起こし結果を提示する際は、以下の形式で整理してください。

API 名と機能：一文で説明
HTTP メソッドとパス：METHOD /open-apis/...
主要パラメーター：必須パラメーターとよく使用されるオプションパラメーターをリストアップ
必要な権限：スコープのリスト
呼び出し例：lark-cli api の完全なコマンドを提供
注意事項：レート制限、特別な制約など

ユーザーが英語でコミュニケーションを取る場合、上記すべての内容を英語に翻訳します。

セキュリティルール

書き込み/削除系の API（POST/PUT/DELETE）を呼び出す前に、ユーザーの意図を確認する必要があります。
可能であれば、--dry-run を使用してリクエストをプレビューすることをお勧めします。
API のパスやパラメーターを推測しないでください。ドキュメントから確認する必要があります。
機密性の高い操作（グループの削除、メンバーの削除など）に関わる場合は、ユーザーに影響範囲を説明してください。

使用シナリオ例

シナリオ 1：ユーザーがグループにメンバーを追加する必要がある（CLI でカプセル化されていない）

# Step 1: CLI でカプセル化されていないことを確認
lark-cli im --help
# → chat_members に関連する create コマンドがないことを発見

# Step 2-4: ドキュメントを掘り起こして API 仕様を取得
# → POST /open-apis/im/v1/chats/:chat_id/members

# Step 5: 呼び出し
lark-cli api POST /open-apis/im/v1/chats/oc_xxx/members \
  --data '{"id_list":["ou_xxx","ou_yyy"]}' \
  --params '{"member_id_type":"open_id"}'

シナリオ 2：ユーザーがグループアナウンスを設定する必要がある

# Step 1: CLI でカプセル化されていないことを確認
lark-cli im --help
# → announcement に関連するコマンドがない

# Step 2-4: ドキュメントを掘り起こす
# → PATCH /open-apis/im/v1/chats/:chat_id/announcement

# Step 5: 呼び出し
lark-cli api PATCH /open-apis/im/v1/chats/oc_xxx/announcement \
  --data '{"revision":"0","requests":["<html>アナウンス内容</html>"]}'

参考

lark-shared — 認証とグローバルパラメーター
lark-skill-maker — 掘り起こした API を新しい Skill として固定化する必要がある場合

📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

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 的完整说明（方法/路径/参数/响应/错误码）

文档入口：

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

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

挖掘流程

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

Step 1：确认现有能力不足

# 先检查是否已有对应的 skill 或已注册 API
lark-cli <可能的service> --help

如果已有对应命令或 shortcut，直接使用，不需要继续挖掘。

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：通过 CLI 调用 API

使用 lark-cli api 裸调：

# GET 请求
lark-cli api GET /open-apis/<path> --params '{"key":"value"}'

# POST 请求
lark-cli api POST /open-apis/<path> --data '{"key":"value"}'

# PUT 请求
lark-cli api PUT /open-apis/<path> --data '{"key":"value"}'

# DELETE 请求
lark-cli api DELETE /open-apis/<path>

输出规范

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

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

如果用户使用英文交流，将以上所有内容翻译为英文。

安全规则

写入/删除类 API（POST/PUT/DELETE）调用前必须确认用户意图
建议先用 --dry-run 预览请求（如支持）
不要猜测 API 路径或参数——必须从文档中获取确认
涉及敏感操作（删除群、移除成员等）时，向用户说明影响范围

使用场景示例

场景 1：用户需要拉人进群（未被 CLI 封装）

# Step 1: 确认 CLI 没有封装
lark-cli im --help
# → 发现没有 chat_members 相关的 create 命令

# Step 2-4: 通过文档挖掘获得 API 规范
# → POST /open-apis/im/v1/chats/:chat_id/members

# Step 5: 调用
lark-cli api POST /open-apis/im/v1/chats/oc_xxx/members \
  --data '{"id_list":["ou_xxx","ou_yyy"]}' \
  --params '{"member_id_type":"open_id"}'

场景 2：用户需要设置群公告

# Step 1: 确认 CLI 没有封装
lark-cli im --help
# → 没有 announcement 相关命令

# Step 2-4: 挖掘文档
# → PATCH /open-apis/im/v1/chats/:chat_id/announcement

# Step 5: 调用
lark-cli api PATCH /open-apis/im/v1/chats/oc_xxx/announcement \
  --data '{"revision":"0","requests":["<html>公告内容</html>"]}'

参考

lark-shared — 认证和全局参数
lark-skill-maker — 如需将挖掘到的 API 固化为新 Skill