larksuite/cli

何を解決するか

lark-cli は Lark/Feishu の公式コマンドラインインターフェースであり、人間の開発者と AI エージェントの間のギャップを埋めるように設計されています。Lark Open Platform とのやり取りを簡素化し、メッセージ、ドキュメント、カレンダー、スプレッドシートなどのビジネスドメインを、複雑な API インテグレーションをゼロから書く必要なく、構造的で安全かつ最適化された方法で管理できるようにします。

動作方法

このツールは、使いやすさとプラットフォーム全体のカバレッジのバランスを取るために、3層構造のコマンドアーキテクチャを使用しています。

1. ショートカット: 高レベルで人間と AI に優しいコマンド（+ で始まる）で、スマートなデフォルト値と構造化出力を使用します。
2. API コマンド: 公式プラットフォームエンドポイントと 1:1 でマッピングされた 100 以上のカスタマイズ済みコマンド。
3. ロウ API 呼び出し: 2,500 以上の Lark Open Platform API に直接アクセス可能で、完全な柔軟性を提供します。

26 の事前定義された「スキル」（モジュール化された機能セット）を備えており、AI エージェントが Lark 機能（例：lark-calendar、lark-im）を設定なしで操作できます。認証は OAuth を使用し、資格情報を OS のネイティブキーチェーンを使って安全に保存します。

対象ユーザー

• 個人開発者: ターミナルから自分の Lark ワークスペースを管理したい人。
• AI エージェント開発者: Lark 内でアクションを実行する必要があるエージェントを開発している人（例：ドキュメントの読み取り、メッセージの送信、タスクの管理）。
• 企業の IT / ISV: 自社プラットフォームに CLI を統合し、集中型の資格情報管理と監査ログを実現したい組織。

特徴

• エージェントネイティブ設計: AI 呼び出しの成功率を最大化するように最適化された構造化スキルとパラメータを内蔵。
• 広範なカバレッジ: メッセンジャー、ドキュメント、Base、スプレッドシート、スライド、カレンダー、メール、OKR を含む 18 のビジネスドメインをサポート。
• デフォルトで安全: 入力インジェクション保護、ターミナル出力のサニタイズ、異常行動を検出するリスク制御信号を備えています。
• 柔軟な出力形式: JSON、見やすい形式、テーブル、ndjson、CSV など、複数のフォーマットをサポート。
• 迅速なセットアップ: 3 分以内に利用可能なインタラクティブなガイド付き設定とログインプロセス。