@sandbaseai/cli
AIエージェントに超能力を。1コマンドで2,000以上のAIモデルとAPI。
English | 中文 | 日本語 | 한국어 | Español | Français | Deutsch | Português
---
あなたのAIコーディングアシスタントは優秀ですが、箱の中に閉じ込められています。Web検索もSNS確認も画像生成もリアルタイムデータ取得も — 自分で各APIを接続しない限りできません。
**SandBaseがそれを変えます。** 1コマンドで、[Model Context Protocol](https://modelcontextprotocol.io)を通じてエージェントを2,000以上のAIモデルとAPIに接続。APIキー管理不要。設定の手間なし。
この 1 行をエージェントに渡すと、Skill を読み込み `connect` まで自分で実行します。ブラウザでの承認だけお願いします:
```
set up https://www.sandbase.ai/SKILL.md
```
自分で実行する場合:
```sh
npx -y @sandbaseai/cli@latest connect
```
macOS または Linux では、公式 Homebrew Formula も利用できます:
```sh
brew install sandbaseai/tap/sandbaseai-cli
sandbase connect
```
これだけ。あなたのエージェントはすべてにアクセスできるようになりました。
## SandBase オープンソーススタック
- **[SandBase Harness](https://github.com/sandbaseai/sandbase-harness)** — 永続セッション、サンドボックス分離、承認、監査、リプレイを備えたセルフホスト型エージェントランタイム。
- **[SandBase Agent Skills](https://github.com/sandbaseai/sandbase-skills)** — リサーチ、ソーシャルインテリジェンス、マーケティング、ビジネス向けのインストール可能な 88 Skills。
---
## 検証可能なエージェントワークフロー
接続後、エージェントに次の監査可能な手順を実行させます。
1. `sandbase_discover` でタスクに適したモデルや API を検索します。
2. `sandbase_inspect` で入力スキーマ、現在の料金、実行要件を確認します。
3. `sandbase_run` を呼び出す前に、エンドポイント、パラメータ、想定コストを確認します。
4. 非同期タスクは、返された `run_id` を使って `sandbase_run_get` で追跡します。
5. `sandbase_runs` で最近の実行状態と記録されたコストを確認します。
6. `sandbase_account` で現在のアカウント残高を確認します。
たとえば、課金されない検索リクエストから始めます。
> 正方形の商品イラストに適した画像モデルを探し、上位 2 候補の必須入力と現在の料金を比較してください。まだモデルは実行しないでください。
カタログ、料金、レイテンシ、可用性は変わる可能性があります。固定された例ではなく、現在のセッションで得られたツール応答を使用してください。
---
## 含まれるツール
| カテゴリ | ツール | できること |
|---------|--------|-----------|
| **Web検索** | Google、Exa、Tavily、Scholar | リアルタイムで何でも検索 |
| **SNS** | Twitter/X、YouTube、Reddit、Instagram、TikTok | トレンド監視、投稿取得、分析 |
| **スクレイピング** | Firecrawl、Exa Content | 任意の公開ページからデータ抽出 |
| **AIモデル** | GPT-4o、Claude、Gemini、DeepSeek、Qwen | キー管理なしで任意モデルを実行 |
| **画像生成** | Flux、DALL-E、Ideogram、Recraft | ロゴ、イラスト、モックアップ |
| **動画生成** | Kling、MiniMax、Runway、Luma | ショートクリップ、アニメーション |
| **音声** | ElevenLabs、Whisper | テキスト→音声、音声→テキスト |
| **EC** | Taobao、Amazon | 商品調査、価格比較 |
| **金融** | 株式データ、企業情報 | 市場調査と分析 |
---
## 対応クライアント(25ターゲット)
すべての主要AIコーディングツールで動作:
| 自動設定 | 手動設定 |
|---------|---------|
| Cursor、Cursor CLI | ChatGPT |
| Claude Code | Claude Desktop |
| Codex | |
| Kiro IDE、Kiro CLI | |
| Windsurf | |
| Gemini CLI | |
| Amp | |
| Warp | |
| OpenCode、Qwen Code、Kimi CLI | |
| Hermes、OpenClaw | |
サインインやファイル変更なしで、完全な互換性カタログを確認できます:
```sh
npx -y @sandbaseai/cli@latest catalog --json
```
各 GitHub リリースには SHA-256 が併記されており、特定バージョンに固定して検証できます。
```sh
# 検出されたすべてのクライアントを一度に接続
npx -y @sandbaseai/cli@latest connect
# 特定のクライアントを指定
npx -y @sandbaseai/cli@latest connect --client cursor
```
---
## 仕組み
```
┌─────────────────┐ ┌───────────────┐ ┌────────────────────┐
│ あなたのAgent │ MCP │ ローカルBridge │ HTTPS │ SandBase API │
│ (Cursorなど) │────────▶│ (オンデマンド) │────────▶│ 2,000+ モデル/API │
│ │◀────────│ │◀────────│ │
└─────────────────┘ └───────────────┘ └────────────────────┘
```
1. `connect`実行 → ブラウザ認証 → 承認
2. APIキーをローカル保存(権限 `0600`)
3. クライアントにMCP設定を自動書き込み
4. エージェントがオンデマンドでツール呼び出し。デーモンなし。
---
## 料金
- **データ API(検索、ソーシャル、スクレイピング、EC、金融)は無料。**
- discover、inspect、実行ステータス、残高、ファイルアップロードも無料。
- モデル(LLM、画像、動画、音声)は 1 回ごと、または 100 万トークンごとの課金。
`sandbase inspect ` は常に現在の価格を表示します。`base_price: 0` は無料です。価格は変わるため、実際のレスポンスを信頼してください。
## コマンド
### CLIコマンド
```sh
sandbase connect [--client ] # 認証 + 設定
sandbase doctor [--client ] # ヘルスチェック
sandbase unregister [--client ] # 設定削除
sandbase catalog --json # 対応クライアント一覧
```
### MCPツール(接続後にエージェントが使用可能)
| ツール | 用途 |
|--------|------|
| `sandbase_discover` | 2,000以上の利用可能なモデルとAPIを検索 |
| `sandbase_inspect` | 入力スキーマ、料金、実行テンプレートを取得 |
| `sandbase_run` | モデルまたはAPIエンドポイントを実行 |
| `sandbase_run_get` | 非同期タスクのステータス/結果をポーリング |
| `sandbase_runs` | 最近のAPI呼び出しとコストを一覧表示 |
| `sandbase_account` | アカウント残高を確認(無料) |
**エージェントが自動的に従うワークフロー:**
```
discover → inspect → run
```
```
1. sandbase_discover(q: "twitter search") → マッチするツールを検索
2. sandbase_inspect(name: "twitter_timeline") → スキーマ + 料金を取得
3. sandbase_run(name: "twitter_timeline", ...) → 実行してデータを返す
```
---
## セキュリティ
- **URLやCLI引数にシークレットなし** — OAuth device flow + PKCE
- **制限されたファイル権限** — 認証情報は `0600` で保存
- **所有権を認識した更新** — 既存の JSONC コメントとユーザー管理の MCP エントリを保持
- **正確なロールバック** — 失敗時や `unregister` 実行時には、SandBase が作成した設定だけを削除
- **いつでも取り消し** — [SandBase Dashboard](https://sandbase.ai/console/keys)でワンクリック
---
## 始めよう
```sh
npx -y @sandbaseai/cli@latest connect
```
そして、エージェントに今までできなかったことを頼んでみてください。
**[無料アカウント作成 →](https://sandbase.ai)**
SandBase でセットアップ時間を短縮できたら、[リポジトリに Star を付けてください](https://github.com/sandbaseai/cli)。より多くのエージェントユーザーがこのプロジェクトを見つけやすくなります。
---
## リンク
- [SandBase プラットフォーム](https://sandbase.ai)
- [ドキュメント](https://www.sandbase.ai/docs/)
- [Claude Code・Codex向け実践チュートリアル](https://github.com/sandbaseai/cli/discussions/49)
- [公式 MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sandbaseai%2Fcli)
- [npm パッケージ](https://www.npmjs.com/package/@sandbaseai/cli)
- [ダッシュボード](https://sandbase.ai/console)
## ライセンス
Apache-2.0