api2cli:ClaudeがあらゆるAPIをCLIに変換し、さらに使用マニュアルも自分で書く
api2cliはClaude Code Skillで、任意のAPIを使えるCLIツールに変換し、さらにSKILL.mdを生成する——これにより将来のClaudeセッションがコードを読まずに直接このCLIを使えるようになる。2層の入れ子構造:ClaudeがAPIをCLIに変換し、さらにそのCLIの使い方のマニュアルも書く。
使い方は超シンプル:「Resend APIをCLIにして」とClaudeに伝えるだけで、Claudeが全エンドポイントを自動発見(ドキュメントページの解析・ライブURLのプロービング・peek-apiネットワークキャプチャの3つの方法に対応)し、Commander.jsベースのCLIツールを生成する。出力はデュアルモード——端末で直接実行する時は人間が読みやすい形式、パイプ経由の時は自動的にJSON形式に切り替わり、AIエージェントが使いやすくなる。
コアな価値は「再利用性」:生成されたSKILL.mdが将来のClaudeセッションに全ての利用可能なコマンドと一般的なワークフローを伝える——一度生成すれば永久に使える。どのClaude Codeセッションも、APIドキュメントを再読することなく直接使えるようになる。
コアコンセプト
api2cliは「ツール発見可能性」の問題を解決する:APIがあって、Claude Agentに使わせたいが、毎回ドキュメントを再読させるのは遅すぎる。api2cliを使えば、CLI + Skillを一度生成するだけで、将来のすべてのセッションが直接呼び出せるようになる。
生成される成果物
1. Commander.js CLI
特徴:
- **デュアルモード出力**:端末では人間が読みやすい形式、パイプ時は自動的にJSONに切替
- **自己文書化**:引数なしで実行すると全コマンド一覧を出力
- **完全なAPIクライアント**:認証・ページネーション・リトライ(指数バックオフ)・レート制限・キャッシュを内蔵
- **Agentフレンドリーエラー**:エラーメッセージに修正提案(next_actions)が含まれる
2. SKILL.md
生成されたSKILL.mdは`.claude/skills/{service}/`に配置され、以下が含まれる:
- 全利用可能コマンド(パラメータ説明付き)
- 一般的な複数ステップのワークフロー
- 正しいトリガーフレーズ(Claudeが自動的に有効化するため)
- 認証設定方法
エンドポイント発見方法
| 方法 | 最適な用途 |
|------|----------|
| ドキュメントページ解析 | ドキュメントのある公開API |
| ライブURLプロービング | ベースURL+認証情報がある場合 |
| peek-apiキャプチャ | 内部エンドポイント発見のためのネットワークスニッフィングが必要な場合 |
インストール
git clone https://github.com/alexknowshtml/api2cli.git
cp -r api2cli/skill/ /path/to/your/project/.claude/skills/api2cli/
ユースケース
- **自動化ツールチェーン**:各種SaaS APIをClaudeが呼び出せるツールに変換
- **チーム共有**:Skillを一度生成すれば、全員のClaude Codeで使用可能
- **内部API**:peek-apiで社内APIのエンドポイントを発見してCLIを生成
- **テスト&デバッグ**:デュアルモード出力で手動テストもAgent呼び出しも便利
制限事項
- 実行にClaude Codeが必要(スタンドアロンツールではない)
- 生成品質はAPIドキュメントの完全性に依存
- 複雑な認証フロー(OAuth 2.0など)は手動で補完が必要な場合がある
深層分析と業界展望
マクロ的な視点から見ると、この展開はAI技術が実験室から産業応用へ加速的に移行するトレンドを体現している。業界アナリストは2026年がAI商業化の重要な転換年になると広く認識している。技術面では大規模モデルの推論効率が向上し導入コストが低下、中小企業もAI能力にアクセスできるようになった。市場面では企業のAI投資に対するROI期待が長期戦略から短期定量化に移行。
しかし急速な普及は新たな課題ももたらす:データプライバシーの複雑化、AI決定の透明性要求の増大、国境を越えたAIガバナンスの調整困難。各国規制当局が動向を注視しており、イノベーション促進とリスク防止のバランスを模索している。投資家にとっても持続可能な競争優位を持つAI企業の見極めがますます重要になっている。