lark-openapi-explorer
Entdecken Sie unentdeckte Lark OpenAPI-Endpunkte aus der Dokumentation
Wenn vorhandene CLI-Befehle Ihre Anforderungen nicht erfüllen können, erkundet dieser Skill die offizielle Lark/Feishu-Dokumentation, um unentdeckte OpenAPI-Endpunkte zu finden und aufzurufen. Er überbrückt die Lücke zwischen vorgefertigten Befehlen und undokumentierten API-Funktionen.
スキルZIPをダウンロード
Claudeでアップロード
設定 → 機能 → スキル → スキルをアップロードへ移動
オンにして利用開始
テストする
「lark-openapi-explorer」を使用しています。 Add users ou_123 and ou_456 to chat oc_789
期待される結果:
- API entdeckt: POST /open-apis/im/v1/chats/:chat_id/members
- Erforderliche Parameter: chat_id (Pfad), id_list (Body), member_id_type (Query)
- Befehl: lark-cli api POST /open-apis/im/v1/chats/oc_789/members --data '{"id_list":["ou_123","ou_456"]}' --params '{"member_id_type":"open_id"}'
- Erforderliche Berechtigung: chat:member:write
- Diesen Befehl ausführen? [j/n]
「lark-openapi-explorer」を使用しています。 What APIs are available for managing group announcements?
期待される結果:
- 1 relevanter Endpunkt gefunden:
- PATCH /open-apis/im/v1/chats/:chat_id/announcement - Chat-Ankündigung aktualisieren
- Parameter: revision (string), requests (Array von HTML-Inhalten)
- Dokumentation: https://open.feishu.cn/document/server-docs/.../announcement
- Beispiel: lark-cli api PATCH /open-apis/im/v1/chats/oc_xxx/announcement --data '{"revision":"0","requests":["<html>Ankündigungstext</html>"]}'
セキュリティ監査
低リスクAll 38 static analyzer findings are false positives. External command patterns are documented lark-cli usage examples (skill's intended purpose). Hardcoded URLs point to official Lark/Feishu OpenAPI documentation. Path traversal patterns are markdown relative links for cross-referencing documentation. The skill follows safe practices with mandatory user confirmation for write/delete operations.
低リスクの問題 (2)
リスク要因
⚙️ 外部コマンド (4)
🌐 ネットワークアクセス (4)
品質スコア
作れるもの
Mitglieder zu einem Chat mit undokumentierter API hinzufügen
Wenn die CLI keinen eingebauten Befehl zum Hinzufügen von Chat-Mitgliedern hat, entdeckt dieser Skill den POST /open-apis/im/v1/chats/:chat_id/members-Endpunkt und führt ihn mit korrekten Parametern aus.
Benutzerdefinierte Chat-Ankündigungen festlegen
Finden und aufrufen des PATCH-Endpunkts für Chat-Ankündigungen, wenn keine CLI-Verknüpfung existiert, um benutzerdefinierte Gruppenankündigungen zu ermöglichen.
Neue API-Funktionen erkunden, bevor CLI-Unterstützung verfügbar ist
Zugreifen auf neu veröffentlichte Lark-APIs sofort durch Dokumentationserkundung, ohne auf CLI-Updates oder neue Skill-Entwicklung zu warten.
これらのプロンプトを試す
Ich muss [Aufgabe beschreiben] in Lark erledigen. Durchsuchen Sie die offizielle OpenAPI-Dokumentation, um den appropriate Endpunkt zu finden, und zeigen Sie mir, wie ich ihn mit lark-cli api aufrufen kann.
Schlagen Sie die API-Dokumentation für [API-Name oder Endpunkt] nach. Extrahieren Sie die HTTP-Methode, den URL-Pfad, erforderliche Parameter, optionale Parameter, das Antwortformat und die erforderlichen Berechtigungen.
Verwenden Sie die [Endpunktname] API und rufen Sie sie mit folgenden Parametern auf: [Parameter auflisten]. Bestätigen Sie die erwartete Anfrage und Antwort vor der Ausführung.
Überprüfen Sie, ob lark-cli einen eingebauten Befehl für [Aufgabe] hat. Falls nicht, erkunden Sie die offizielle Dokumentation, um den raw OpenAPI-Endpunkt zu finden, und geben Sie den entsprechenden lark-cli api-Befehl an.
ベストプラクティス
- Überprüfen Sie immer, ob der API-Endpunkt in der offiziellen Dokumentation existiert, bevor Sie ihn aufrufen
- Überprüfen Sie die erforderlichen Berechtigungen (Scope) und stellen Sie sicher, dass Ihre App autorisiert ist
- Verwenden Sie --dry-run oder den Vorschaumodus, wenn verfügbar, für Schreib-/Löschoperationen
回避
- Raten Sie keine API-Pfade oder Parameter - rufen Sie diese immer aus der offiziellen Dokumentation ab
- Vermeiden Sie es, Schreib-/Lösch-APIs aufzurufen, ohne die Benutzerabsicht zu bestätigen und die Auswirkungen zu erklären
- Überspringen Sie den Capability-Check-Schritt nicht - vorhandene CLI-Befehle werden gegenüber rohen API-Aufrufen bevorzugt