SandBase

@sandbaseai/cli

AI エージェントに強力な機能を。1 行だけで、2,000 以上の AI モデルと API に接続できます。データ API の呼び出しは 1 日 100 回まで無料。その後は、1 つの残高から呼び出しごとにお支払いいただけます。

English | 中文 | 日本語 | 한국어 | Español | Français | Deutsch | Português

---

AI コーディングアシスタントは賢いものの、閉じ込められています。API を自分でひとつずつ接続しない限り、ウェブ検索、ソーシャルメディアの確認、画像の生成、リアルタイムデータへのアクセスはできません。

SandBase がその問題を解決します。 コマンド 1 つで、Model Context Protocol を通じてエージェントを 2,000 以上の AI モデルと API に接続できます。API キーを管理する必要はありません。設定に悩まされることもありません。

MCP ではなく HTTP で直接開発する場合は、SandBase API のクイックスタートから始めるか、 統合型のLLM、画像、動画 APIと、特化型モデルゲートウェイを比較してください。

セットアップ

これをエージェントに貼り付ければ、あとはエージェントが実行します。

set up https://www.sandbase.ai/SKILL.md

SandBase Skill を読み込み、自動で connect を実行して、ブラウザーでのサインインを一度承認するよう求めます。自分で操作する場合はこちらです。

npx -y @sandbaseai/cli@latest connect

または、macOS または Linux に公式の Homebrew フォーミュラをインストールします。

brew install sandbaseai/tap/sandbaseai-cli
sandbase connect

Homebrew のリリース告知と macOS/Linux の CI 証跡をご覧ください。

ブラウザー認証を一度承認すると、各対応クライアントはローカル MCP ブリッジを通じて、利用可能な SandBase のモデルと API を検出、確認、実行できるようになります。その後、新しいセッションを開始して sandbase_* ツールを読み込んでください。

GitHub の各リリースでは、tarball の横に個別の SHA-256 が公開されています。そのため、latest を追跡する代わりに、特定のビルドを指定して検証できます。

V=$(npm view @sandbaseai/cli version)
curl -fL -O "https://github.com/sandbaseai/cli/releases/download/v$V/sandbaseai-cli-$V.tgz"
shasum -a 256 "sandbaseai-cli-$V.tgz"   # compare against the checksum on the release page
npx -y "./sandbaseai-cli-$V.tgz" connect

サインインや設定の変更を行う前に、互換性を確認しますか？クライアントカタログは読み取り専用のコマンドです。何も書き込まず、アカウントも必要ありません。

npx -y @sandbaseai/cli@latest catalog --json

_{書き込みなしのカタログ監査と、空の分離プロファイルに対する範囲を限定した doctor チェック。}

Homebrew ユーザーは、同じ読み取り専用チェックを sandbase catalog --json で実行できます。

費用

	価格
データ API — 検索、ソーシャル、スクレイピング、e コマース、金融	組織ごとに 1 日 100 回まで無料。その後は呼び出しごとに課金（価格は sandbase inspect に表示）
検出、確認、実行ステータス、残高、ファイルのアップロード	無料
モデル — LLM、画像、動画、音声	呼び出しごと、または 100 万トークンごとに課金

sandbase inspect <tool> は、何かを実行する前に必ず現在の価格を表示します。1 日の無料枠の対象となるデータ API では、pricing.free_quota も表示されます。100 回の無料呼び出しは、対象となるデータ API 間で共有され、00:00 UTC にリセットされます。その後は呼び出しごとに課金されます。sandbase balance --json では、本日残っている無料呼び出し数が free_api_quota として表示されます。価格は変更されることがあるため、このファイルの例ではなく、最新の応答を参照してください。

簡潔な概要については、SandBase CLI の公式プロジェクトページをご覧ください。 クライアントの検出、MCP ツール、ロールバックについて、セキュリティに重点を置いた手順を確認するには、25 クライアント対応の SandBase CLI セットアップガイドをご覧ください。 AI エージェントや自動インストーラーは、簡潔な llms-install.md の手順を利用できます。

SandBase オープンソーススタック

• SandBase Harness — 永続セッション、サンドボックス分離、承認、監査、再生機能を備えたセルフホスト可能なエージェントランタイムです。
• SandBase Agent Skills — リサーチ、ソーシャルインテリジェンス、マーケティング、ビジネスのワークフロー向けにインストール可能な88個のSkillsです。
• SandBase for Codex — SandBase MCP ブリッジとガイド付き Agent Skill をパッケージ化した公式 Codex プラグインです。必須の HOL セキュリティスキャンは main で合格しています。

認証済みのリモートブリッジは公式 MCP Registryで確認できます。 Registry のコミュニティショーケースをご覧いただくか、 Chinese Independent Developer、 Awesome MCP、 Glama、 TensorBlock MCP Index、 MCPRepository、 VaultPlane、 AIMCP、 MCP Server Hub、 MCP Server Spot、または Awesome AI API Proxyから見つけてください。 外部のメンテナーによって、SandBase は Awesome Codex CLI、 Awesome Agent Skills、および Awesome MCP Serverに追加されています。 Hermes インテグレーションは、独立して Hermes Atlasのエコシステムカタログに掲載されており、 Awesome Hermes Agentではベータ版として掲載されています。 検証済みの sandbase Agent Skill（skills.sh）、 SkillsCat の sandbaseai/cli/sandbase 掲載ページ、 skills.re の sandbaseai/cli/sandbase 掲載ページ、 vSkill の検証済み SandBase 掲載ページ（93/100）、 Skillstore のセキュリティ監査済み SandBase 掲載ページ、または Agent Skill Hub のバージョン付き sandbaseai/sandbase スナップショットからインストールしてください。

---

検証可能なエージェントのワークフロー

接続後、検索、データ API、言語モデル、画像生成、動画生成、その他のカタログ機能について、同じ確認可能な手順に従うようエージェントに依頼します。

1. sandbase_discover を使って、タスクや機能から候補を見つけます。
2. sandbase_inspect を使って、現在の入力スキーマ、料金、実行要件を確認します。
3. sandbase_run を呼び出す前に、選択したエンドポイントとパラメーターを確認します。データ API は、組織ごとに UTC 日あたり 100 回まで無料で、その後はモデルと同様に呼び出しごとに課金されます。有料で実行する前に、sandbase_inspect に表示された料金を確認してください。
4. 非同期の処理には、重複した実行を作成せず、返された run_id を使って sandbase_run_get を使用します。
5. sandbase_runs を使って、最近の実行状況と記録された料金を確認します。
6. sandbase_account を使って、現在のアカウント残高を確認します。

たとえば、まず課金されない探索リクエストから始めます。

正方形の商品イラストに適した画像モデルを探してください。有力な候補 2 つについて、必要な入力と現在の料金を比較してください。どちらのモデルもまだ実行しないでください。

探索と確認に料金はかからないため、エージェントはいつでもカタログを調べてから実行できます。

最新の応答を確認した後、実行するエンドポイントと入力を明示的に承認してください。カタログの項目、スキーマ、料金、レイテンシー、利用可能状況は変わる可能性があるため、固定の例ではなく、現在のセッションでツールが返した応答を使用してください。

Claude Code と Codex の完全な手順または中国語のワークフローガイドをご覧ください。実際のカタログ例については、GitHub コネクターの探索・確認に関するドッグフーディングの記録をご覧ください。

---

内容

カテゴリー	ツール	できること
ウェブ検索	Google, Exa, Tavily, Scholar	あらゆる情報をリアルタイムで調査
ソーシャルメディア	Twitter/X, YouTube, Reddit, Instagram, TikTok, Xiaohongshu, Weibo, Bilibili	トレンドの監視、投稿の取得、コンテンツの分析
スクレイピング	Firecrawl, Exa Content	公開ウェブページからデータを抽出
AI モデル	GPT-4o, Claude, Gemini, DeepSeek, Qwen, Llama	キーを管理せずにあらゆるモデルを実行
画像生成	Flux, DALL-E, Ideogram, Recraft	ロゴ、イラスト、モックアップを作成
動画生成	Kling, MiniMax, Runway, Luma	短い動画やアニメーションを生成
音声	ElevenLabs, Whisper	テキスト読み上げ、文字起こし
E コマース	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

サインインやファイルの変更を行わずに、互換性カタログの全内容をプレビューできます。

npx -y @sandbaseai/cli@latest catalog --json

# Connect all detected clients at once
npx -y @sandbaseai/cli@latest connect

# Or target one specific client
npx -y @sandbaseai/cli@latest connect --client cursor

OpenClaw クイックスタート

OpenClaw を直接ターゲットにしてから、管理対象の MCP サーバーと SandBase Skill を信頼して使う前に、それらを CLI に読み戻すよう依頼します。

npx -y @sandbaseai/cli@latest connect --client openclaw
npx -y @sandbaseai/cli@latest doctor --client openclaw

doctor で認証情報、MCP ブリッジ、Skill が設定済みと報告されたら、OpenClaw を再起動し、SandBase を必要とする自然言語のリクエストを行います。OpenClaw に SandBase 以外の sandbase という名前の MCP サーバーがすでにある場合、インストーラーはそれを上書きせず、そのまま残します。後で管理対象の MCP エントリーとローカル認証情報を削除するには、次のようにします。

npx -y @sandbaseai/cli@latest unregister --client openclaw

OpenClaw は現在、Skill の削除コマンドをサポートしていないため、unregister はこの制限を報告し、検証済みの SandBase Skill をインストールしたままにします。

Hermes クイックスタート

SandBase は、1 回の認証手続きで管理対象の Hermes Skill とローカルの MCP エントリを両方インストールできます。

npx -y @sandbaseai/cli@latest connect --client hermes
npx -y @sandbaseai/cli@latest doctor --client hermes

doctor は、管理対象のローカル認証情報、MCP エントリ、Skill を検証します。Hermes を再起動して、新しいクライアントセッションでネイティブに検出されることを確認したら、SandBase Skill または MCP ツールを使用します。既存の SandBase 以外の MCP エントリ sandbase は変更されません。他のクライアント用の共有ブリッジは残したまま、管理対象の Hermes 設定、Skill、ローカル認証情報のみを削除するには、次を実行します。

npx -y @sandbaseai/cli@latest unregister --client hermes

この連携は、Hermes Atlas および Awesome Hermes Agent にも独立して掲載されています。

---

仕組み

┌─────────────────┐         ┌───────────────┐         ┌────────────────────┐
│   Your Agent    │  MCP    │  Local Bridge │  HTTPS  │    SandBase API     │
│  (Cursor, etc.) │────────▶│  (on-demand)  │────────▶│ 2,000+ models/APIs │
│                 │◀────────│               │◀────────│                    │
└─────────────────┘         └───────────────┘         └────────────────────┘

1. connect を実行 → CLI がブラウザー認証を開始 → 承認する
2. API キーがローカルに保存される（ファイル権限は 0600）
3. クライアント用に MCP ブリッジが設定される
4. エージェントが必要に応じてツールを呼び出す。デーモンもバックグラウンドプロセスもありません。

---

コマンド

CLI コマンド

sandbase connect [--client <name>]    # Authorize + configure
sandbase setup                        # After upgrading: refresh the local bridge + Skill, test connectivity
sandbase doctor [--client <name>]     # Local checks plus one real round trip to SandBase
sandbase unregister [--client <name>] # Remove configuration
sandbase catalog --json               # List all supported clients

エージェントコマンド（シェルトランスポート、MCP ツールと同じ機能）

MCP を使用しないエージェントや、MCP セッションに問題があるエージェントは、シェルから同じカタログを利用できます。認証情報は connect によって自動的に取得されます（または SANDBASE_API_KEY / sandbase keys add -k <key> を使用します）。

sandbase discover -q "twitter posts"                       # search; -t api|llm|multimodal|embedding|service
sandbase inspect sandbase_twitter_web_search_timeline       # fields, price, ready-to-run command
sandbase run sandbase_twitter_web_search_timeline -i '{"keyword":"AI agents"}'
sandbase run <video_tool> -i '{"prompt":"..."}' -w -o result.json   # wait with backoff, save output to disk
sandbase runs get -r <run_id> -w -o result.json            # resume a long run instead of re-running it
sandbase upload ./photo.png                                # local image/audio/video -> public URL for tools that take a URL
sandbase runs list | sandbase balance

-j は JSON を出力します。エラーは {"error":{"code","message","hint"}} の形式で、次の手順は hint に示されます。終了コード：0 成功または実行中、1 失敗（実行の失敗を含む）、2 使用方法の誤り。

同期ツール（LLM、ほとんどのデータ API）は結果を直接返します。非同期ツール（画像、動画、音声のジョブ）は実行 ID を返します。-w で待機するか、後から sandbase runs get -r <run_id> で結果を取得します。api.sandbase.ai に接続できない場合、ブリッジはサーバーを削除せず、対処方法を示すエラーとともに SandBase ツールを表示し続けます。

MCP ツール（接続後にエージェントから利用可能）

ツール	目的
sandbase_discover	利用可能な 2,000 以上の AI モデルと API を検索 — 無料
sandbase_inspect	入力スキーマ、現在の料金、すぐに実行できるテンプレートを取得 — 無料
sandbase_run	モデルまたは API エンドポイントを実行 — 対象となるデータ API：組織ごとに 1 日 100 回まで無料、その後は呼び出しごとに有料。モデル：呼び出しごとに有料
sandbase_run_get	非同期実行（動画生成など）のステータス／結果を確認 — 無料
sandbase_runs	最近の実行とその料金を一覧表示 — 無料
sandbase_account	アカウント残高と本日の無料データ API 呼び出し回数（free_api_quota）を確認 — 無料
sandbase_run_cancel	Agent Service の実行をキャンセル — 無料

推奨ワークフロー：

discover → inspect → run

1. sandbase_discover(q: "twitter search")          → find current candidates
2. sandbase_inspect(name: discovered_name)          → get schema and pricing
3. sandbase_run(name: discovered_name, input: {...}) → run after confirmation

---

セキュリティ

• URL や CLI 引数にシークレットを含めない — PKCE を使用した OAuth デバイスフロー
• ファイル権限を制限 — 認証情報は 0600 で保存
• 所有権を認識した更新 — 既存の JSONC コメントとユーザー管理の MCP エントリを保持
• 完全なロールバック — 失敗時または unregister の実行時には、SandBase が所有する設定のみを削除
• いつでも取り消し可能 — SandBase Dashboard からワンクリックで操作

---

はじめに

npx -y @sandbaseai/cli@latest connect

これまでできなかったことを、エージェントに頼んでみましょう。

アカウントを作成 → — すべての組織に、毎日 100 回分の無料データ API 呼び出しが提供されます。

SandBase によってセットアップの時間を短縮できた場合は、リポジトリにスターを付けてください — より多くのエージェントユーザーにこのプロジェクトを知ってもらう助けになります。

---

リンク

• SandBase Platform
• ドキュメント
• CLI セットアップガイド
• CLI の詳細解説：英語 · 中文
• 6 つのツールを使った実践的なワークフロー：英語 · 中文
• npm パッケージ
• 公式 Codex プラグイン
• ダッシュボード

コミュニティ

• 質問したり、作成したものを共有したりする
• 再現可能なバグを報告する
• インテグレーションや改善を提案する
• SandBase CLI に貢献する

コミュニティが選定した掲載リスト：

• Official Registry のコミュニティ紹介
• VaultPlane MCP ディレクトリ
• AIMCP ディレクトリ
• Awesome MCP
• Awesome AI API Proxy
• Awesome Gemini CLI
• Hermes Atlas
• Awesome Hermes Agent
• Awesome AI Tools
• Awesome MCP Server
• Awesome Agent Cortex
• Awesome AI Agent Tools
• Awesome Codex CLI

ライセンス

Apache-2.0