@sandbaseai/cli 0.3.6 → 0.3.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.de.md +25 -12
- package/README.es.md +25 -12
- package/README.fr.md +25 -12
- package/README.ja.md +25 -12
- package/README.ko.md +25 -12
- package/README.md +67 -41
- package/README.pt-BR.md +25 -12
- package/README.zh-CN.md +37 -25
- package/llms-install.md +8 -8
- package/package.json +1 -1
- package/skills/sandbase/SKILL.md +11 -7
- package/skills/sandbase/skill.json +1 -1
package/README.de.md
CHANGED
|
@@ -25,8 +25,16 @@ Dein KI-Coding-Assistent ist schlau, aber in einer Box gefangen. Er kann nicht i
|
|
|
25
25
|
|
|
26
26
|
**SandBase ändert das.** Ein Befehl verbindet deinen Agenten mit 2.000+ KI-Modellen und APIs über das [MCP](https://modelcontextprotocol.io). Keine API-Keys verwalten. Kein Konfigurationsaufwand.
|
|
27
27
|
|
|
28
|
+
Füge diese Zeile in deinen Agent ein, er übernimmt den Rest: Er liest die Skill, führt `connect` selbst aus und bittet dich nur, die Anmeldung im Browser zu bestätigen:
|
|
29
|
+
|
|
30
|
+
```
|
|
31
|
+
set up https://www.sandbase.ai/SKILL.md
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
Wenn du es selbst machen willst:
|
|
35
|
+
|
|
28
36
|
```sh
|
|
29
|
-
npx -y
|
|
37
|
+
npx -y @sandbaseai/cli@latest connect
|
|
30
38
|
```
|
|
31
39
|
|
|
32
40
|
Oder installiere die offizielle Homebrew-Formel unter macOS oder Linux:
|
|
@@ -77,21 +85,26 @@ Katalog, Preise, Latenz und Verfügbarkeit können sich ändern. Verwende daher
|
|
|
77
85
|
Möchtest du die Kompatibilität prüfen, bevor du dich anmeldest oder lokale Konfigurationen änderst? Mit dem schreibgeschützten Katalogbefehl kannst du die 25 unterstützten Clients überprüfen:
|
|
78
86
|
|
|
79
87
|
```sh
|
|
80
|
-
npx -y
|
|
88
|
+
npx -y @sandbaseai/cli@latest catalog --json
|
|
81
89
|
```
|
|
82
90
|
|
|
83
|
-
|
|
84
|
-
`1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa`
|
|
85
|
-
|
|
86
|
-
Das npm-Tag `latest` verweist derzeit noch auf v0.1.14. Verwende bis zur Aktivierung von Trusted Publishing die oben angegebene versionierte GitHub-URL.
|
|
91
|
+
Jedes GitHub-Release veröffentlicht seinen eigenen SHA-256, sodass du einen exakten Build pinnen und prüfen kannst.
|
|
87
92
|
|
|
88
93
|
```sh
|
|
89
|
-
npx -y
|
|
90
|
-
npx -y
|
|
94
|
+
npx -y @sandbaseai/cli@latest connect
|
|
95
|
+
npx -y @sandbaseai/cli@latest connect --client cursor
|
|
91
96
|
```
|
|
92
97
|
|
|
93
98
|
---
|
|
94
99
|
|
|
100
|
+
## Preise
|
|
101
|
+
|
|
102
|
+
- Daten-APIs (Suche, Social Media, Scraping, E-Commerce, Finanzen): 100 kostenlose Aufrufe pro Tag und Organisation (geteilt über alle berechtigten APIs, Reset um 00:00 UTC), danach Abrechnung pro Aufruf zum Preis, den `sandbase inspect` anzeigt.
|
|
103
|
+
- Suchen, Inspizieren, Laufstatus, Guthaben und Datei-Upload sind kostenlos.
|
|
104
|
+
- Modelle (LLM, Bild, Video, Audio) werden pro Aufruf oder pro Million Tokens berechnet.
|
|
105
|
+
|
|
106
|
+
`sandbase inspect <tool>` zeigt immer den aktuellen Preis und bei berechtigten APIs `pricing.free_quota`; `sandbase balance --json` zeigt die heute verbleibenden Gratis-Aufrufe als `free_api_quota`. Preise können sich ändern — verlasse dich auf die echte Antwort.
|
|
107
|
+
|
|
95
108
|
## Befehle
|
|
96
109
|
|
|
97
110
|
```sh
|
|
@@ -110,7 +123,7 @@ sandbase catalog --json # Unterstützte Clients auflisten
|
|
|
110
123
|
| `sandbase_run` | Modell oder API ausführen |
|
|
111
124
|
| `sandbase_run_get` | Status asynchroner Aufgaben abfragen |
|
|
112
125
|
| `sandbase_runs` | Letzte API-Aufrufe und Kosten anzeigen |
|
|
113
|
-
| `sandbase_account` | Kontostand prüfen (kostenlos) |
|
|
126
|
+
| `sandbase_account` | Kontostand und heutige kostenlose Daten-API-Aufrufe (`free_api_quota`) prüfen (kostenlos) |
|
|
114
127
|
|
|
115
128
|
---
|
|
116
129
|
|
|
@@ -126,17 +139,17 @@ sandbase catalog --json # Unterstützte Clients auflisten
|
|
|
126
139
|
## Loslegen
|
|
127
140
|
|
|
128
141
|
```sh
|
|
129
|
-
npx -y
|
|
142
|
+
npx -y @sandbaseai/cli@latest connect
|
|
130
143
|
```
|
|
131
144
|
|
|
132
|
-
**[
|
|
145
|
+
**[Konto erstellen →](https://sandbase.ai)**
|
|
133
146
|
|
|
134
147
|
Wenn SandBase dir Einrichtungszeit spart, [gib dem Projekt einen Star](https://github.com/sandbaseai/cli). So können weitere Agent-Nutzer es leichter entdecken.
|
|
135
148
|
|
|
136
149
|
## Praktische Anleitung
|
|
137
150
|
|
|
138
151
|
- [Claude Code und Codex: entdecken, Preis prüfen und ausführen](https://github.com/sandbaseai/cli/discussions/53)
|
|
139
|
-
- [Offizielle MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers
|
|
152
|
+
- [Offizielle MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sandbaseai%2Fcli)
|
|
140
153
|
|
|
141
154
|
## Lizenz
|
|
142
155
|
|
package/README.es.md
CHANGED
|
@@ -25,8 +25,16 @@ Tu asistente de codificación IA es inteligente, pero está atrapado en una caja
|
|
|
25
25
|
|
|
26
26
|
**SandBase cambia eso.** Un comando conecta tu agente a 2,000+ modelos y API de IA a través del [MCP](https://modelcontextprotocol.io). Sin gestionar claves API. Sin dolores de cabeza de configuración.
|
|
27
27
|
|
|
28
|
+
Pega esta línea en tu agente y se encarga del resto: lee la Skill, ejecuta `connect` y solo te pide aprobar el inicio de sesión en el navegador:
|
|
29
|
+
|
|
30
|
+
```
|
|
31
|
+
set up https://www.sandbase.ai/SKILL.md
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
Si prefieres hacerlo tú:
|
|
35
|
+
|
|
28
36
|
```sh
|
|
29
|
-
npx -y
|
|
37
|
+
npx -y @sandbaseai/cli@latest connect
|
|
30
38
|
```
|
|
31
39
|
|
|
32
40
|
O instala la fórmula oficial de Homebrew en macOS o Linux:
|
|
@@ -77,24 +85,29 @@ El catálogo, los precios, la latencia y la disponibilidad pueden cambiar. Usa l
|
|
|
77
85
|
¿Quieres comprobar la compatibilidad antes de iniciar sesión o modificar la configuración local? Ejecuta el catálogo de solo lectura para verificar los 25 clientes compatibles:
|
|
78
86
|
|
|
79
87
|
```sh
|
|
80
|
-
npx -y
|
|
88
|
+
npx -y @sandbaseai/cli@latest catalog --json
|
|
81
89
|
```
|
|
82
90
|
|
|
83
|
-
|
|
84
|
-
`1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa`
|
|
85
|
-
|
|
86
|
-
La etiqueta `latest` de npm todavía apunta a v0.1.14; hasta que se habilite Trusted Publishing, usa la URL versionada de GitHub anterior.
|
|
91
|
+
Cada versión de GitHub publica su propio SHA-256, así que puedes fijar y verificar una compilación exacta.
|
|
87
92
|
|
|
88
93
|
```sh
|
|
89
94
|
# Conectar todos los clientes detectados
|
|
90
|
-
npx -y
|
|
95
|
+
npx -y @sandbaseai/cli@latest connect
|
|
91
96
|
|
|
92
97
|
# O uno específico
|
|
93
|
-
npx -y
|
|
98
|
+
npx -y @sandbaseai/cli@latest connect --client cursor
|
|
94
99
|
```
|
|
95
100
|
|
|
96
101
|
---
|
|
97
102
|
|
|
103
|
+
## Precios
|
|
104
|
+
|
|
105
|
+
- Las APIs de datos (búsqueda, redes sociales, scraping, e-commerce, finanzas) incluyen 100 llamadas gratis al día por organización (compartidas entre las APIs elegibles, se reinician a las 00:00 UTC); después se pagan por llamada, al precio que muestra `sandbase inspect`.
|
|
106
|
+
- Descubrir, inspeccionar, consultar estado, saldo y subir archivos es gratis.
|
|
107
|
+
- Los modelos (LLM, imagen, vídeo, audio) se pagan por llamada o por millón de tokens.
|
|
108
|
+
|
|
109
|
+
`sandbase inspect <tool>` muestra siempre el precio actual y, en las APIs elegibles, `pricing.free_quota`; `sandbase balance --json` muestra las llamadas gratis que quedan hoy en `free_api_quota`. Los precios pueden cambiar: confía en la respuesta real.
|
|
110
|
+
|
|
98
111
|
## Comandos
|
|
99
112
|
|
|
100
113
|
```sh
|
|
@@ -113,7 +126,7 @@ sandbase catalog --json # Listar clientes soportados
|
|
|
113
126
|
| `sandbase_run` | Ejecutar un modelo o API |
|
|
114
127
|
| `sandbase_run_get` | Consultar estado de tareas asíncronas |
|
|
115
128
|
| `sandbase_runs` | Ver llamadas recientes y costos |
|
|
116
|
-
| `sandbase_account` | Verificar saldo (gratis) |
|
|
129
|
+
| `sandbase_account` | Verificar saldo y las llamadas gratuitas a APIs de datos de hoy (`free_api_quota`) (gratis) |
|
|
117
130
|
|
|
118
131
|
---
|
|
119
132
|
|
|
@@ -129,17 +142,17 @@ sandbase catalog --json # Listar clientes soportados
|
|
|
129
142
|
## Comenzar
|
|
130
143
|
|
|
131
144
|
```sh
|
|
132
|
-
npx -y
|
|
145
|
+
npx -y @sandbaseai/cli@latest connect
|
|
133
146
|
```
|
|
134
147
|
|
|
135
|
-
**[Crear cuenta
|
|
148
|
+
**[Crear cuenta →](https://sandbase.ai)**
|
|
136
149
|
|
|
137
150
|
Si SandBase te ahorra tiempo de configuración, [dale una estrella al proyecto](https://github.com/sandbaseai/cli). Así será más fácil que otros usuarios de agentes lo descubran.
|
|
138
151
|
|
|
139
152
|
## Guía práctica
|
|
140
153
|
|
|
141
154
|
- [Claude Code y Codex: descubre, comprueba el precio y ejecuta modelos o API](https://github.com/sandbaseai/cli/discussions/50)
|
|
142
|
-
- [Registro MCP oficial](https://registry.modelcontextprotocol.io/v0.1/servers
|
|
155
|
+
- [Registro MCP oficial](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sandbaseai%2Fcli)
|
|
143
156
|
|
|
144
157
|
## Licencia
|
|
145
158
|
|
package/README.fr.md
CHANGED
|
@@ -25,8 +25,16 @@ Votre assistant de codage IA est intelligent, mais il est enfermé dans une boî
|
|
|
25
25
|
|
|
26
26
|
**SandBase change la donne.** Une commande connecte votre agent à 2 000+ modèles IA et APIs via le [MCP](https://modelcontextprotocol.io). Pas de clés API à gérer. Pas de prise de tête.
|
|
27
27
|
|
|
28
|
+
Collez cette ligne dans votre agent, il fait le reste : il lit la Skill, exécute `connect` et vous demande seulement d’approuver la connexion dans le navigateur :
|
|
29
|
+
|
|
30
|
+
```
|
|
31
|
+
set up https://www.sandbase.ai/SKILL.md
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
Pour le faire vous-même :
|
|
35
|
+
|
|
28
36
|
```sh
|
|
29
|
-
npx -y
|
|
37
|
+
npx -y @sandbaseai/cli@latest connect
|
|
30
38
|
```
|
|
31
39
|
|
|
32
40
|
Ou installez la formule Homebrew officielle sur macOS ou Linux :
|
|
@@ -77,21 +85,26 @@ Le catalogue, les prix, la latence et la disponibilité peuvent évoluer. Utilis
|
|
|
77
85
|
Vous voulez vérifier la compatibilité avant de vous connecter ou de modifier la configuration locale ? Exécutez le catalogue en lecture seule pour confirmer les 25 clients pris en charge :
|
|
78
86
|
|
|
79
87
|
```sh
|
|
80
|
-
npx -y
|
|
88
|
+
npx -y @sandbaseai/cli@latest catalog --json
|
|
81
89
|
```
|
|
82
90
|
|
|
83
|
-
|
|
84
|
-
`1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa`
|
|
85
|
-
|
|
86
|
-
Le tag npm `latest` pointe encore vers la v0.1.14 ; jusqu’à l’activation de Trusted Publishing, utilisez l’URL GitHub versionnée ci-dessus.
|
|
91
|
+
Chaque version GitHub publie son propre SHA-256 : vous pouvez donc épingler et vérifier une archive exacte.
|
|
87
92
|
|
|
88
93
|
```sh
|
|
89
|
-
npx -y
|
|
90
|
-
npx -y
|
|
94
|
+
npx -y @sandbaseai/cli@latest connect
|
|
95
|
+
npx -y @sandbaseai/cli@latest connect --client cursor
|
|
91
96
|
```
|
|
92
97
|
|
|
93
98
|
---
|
|
94
99
|
|
|
100
|
+
## Tarifs
|
|
101
|
+
|
|
102
|
+
- Les API de données (recherche, réseaux sociaux, scraping, e-commerce, finance) incluent 100 appels gratuits par jour et par organisation (partagés entre les API éligibles, remis à zéro à 00:00 UTC), puis sont facturées à l’appel, au prix affiché par `sandbase inspect`.
|
|
103
|
+
- La découverte, l’inspection, le statut des exécutions, le solde et l’envoi de fichiers sont gratuits.
|
|
104
|
+
- Les modèles (LLM, image, vidéo, audio) sont facturés à l’appel ou au million de tokens.
|
|
105
|
+
|
|
106
|
+
`sandbase inspect <tool>` affiche toujours le prix actuel et, pour les API éligibles, `pricing.free_quota` ; `sandbase balance --json` indique les appels gratuits restants du jour dans `free_api_quota`. Les prix peuvent changer : fiez-vous à la réponse réelle.
|
|
107
|
+
|
|
95
108
|
## Commandes
|
|
96
109
|
|
|
97
110
|
```sh
|
|
@@ -110,7 +123,7 @@ sandbase catalog --json # Lister les clients
|
|
|
110
123
|
| `sandbase_run` | Exécuter un modèle ou une API |
|
|
111
124
|
| `sandbase_run_get` | Vérifier le statut des tâches asynchrones |
|
|
112
125
|
| `sandbase_runs` | Voir les appels récents et les coûts |
|
|
113
|
-
| `sandbase_account` | Vérifier le solde (gratuit) |
|
|
126
|
+
| `sandbase_account` | Vérifier le solde et les appels gratuits aux API de données du jour (`free_api_quota`) (gratuit) |
|
|
114
127
|
|
|
115
128
|
---
|
|
116
129
|
|
|
@@ -126,17 +139,17 @@ sandbase catalog --json # Lister les clients
|
|
|
126
139
|
## Commencer
|
|
127
140
|
|
|
128
141
|
```sh
|
|
129
|
-
npx -y
|
|
142
|
+
npx -y @sandbaseai/cli@latest connect
|
|
130
143
|
```
|
|
131
144
|
|
|
132
|
-
**[Créer un compte
|
|
145
|
+
**[Créer un compte →](https://sandbase.ai)**
|
|
133
146
|
|
|
134
147
|
Si SandBase vous fait gagner du temps de configuration, [ajoutez une étoile au projet](https://github.com/sandbaseai/cli). Cela aidera d’autres utilisateurs d’agents à le découvrir.
|
|
135
148
|
|
|
136
149
|
## Guide pratique
|
|
137
150
|
|
|
138
151
|
- [Claude Code et Codex : découvrir, vérifier le prix, puis exécuter](https://github.com/sandbaseai/cli/discussions/52)
|
|
139
|
-
- [Registre MCP officiel](https://registry.modelcontextprotocol.io/v0.1/servers
|
|
152
|
+
- [Registre MCP officiel](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sandbaseai%2Fcli)
|
|
140
153
|
|
|
141
154
|
## Licence
|
|
142
155
|
|
package/README.ja.md
CHANGED
|
@@ -25,8 +25,16 @@
|
|
|
25
25
|
|
|
26
26
|
**SandBaseがそれを変えます。** 1コマンドで、[Model Context Protocol](https://modelcontextprotocol.io)を通じてエージェントを2,000以上のAIモデルとAPIに接続。APIキー管理不要。設定の手間なし。
|
|
27
27
|
|
|
28
|
+
この 1 行をエージェントに渡すと、Skill を読み込み `connect` まで自分で実行します。ブラウザでの承認だけお願いします:
|
|
29
|
+
|
|
30
|
+
```
|
|
31
|
+
set up https://www.sandbase.ai/SKILL.md
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
自分で実行する場合:
|
|
35
|
+
|
|
28
36
|
```sh
|
|
29
|
-
npx -y
|
|
37
|
+
npx -y @sandbaseai/cli@latest connect
|
|
30
38
|
```
|
|
31
39
|
|
|
32
40
|
macOS または Linux では、公式 Homebrew Formula も利用できます:
|
|
@@ -100,20 +108,17 @@ sandbase connect
|
|
|
100
108
|
サインインやファイル変更なしで、完全な互換性カタログを確認できます:
|
|
101
109
|
|
|
102
110
|
```sh
|
|
103
|
-
npx -y
|
|
111
|
+
npx -y @sandbaseai/cli@latest catalog --json
|
|
104
112
|
```
|
|
105
113
|
|
|
106
|
-
|
|
107
|
-
`1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa`
|
|
108
|
-
|
|
109
|
-
npm の `latest` は現在も v0.1.14 のため、Trusted Publishing が有効になるまでは上記のバージョン固定 GitHub URL を使用してください。
|
|
114
|
+
各 GitHub リリースには SHA-256 が併記されており、特定バージョンに固定して検証できます。
|
|
110
115
|
|
|
111
116
|
```sh
|
|
112
117
|
# 検出されたすべてのクライアントを一度に接続
|
|
113
|
-
npx -y
|
|
118
|
+
npx -y @sandbaseai/cli@latest connect
|
|
114
119
|
|
|
115
120
|
# 特定のクライアントを指定
|
|
116
|
-
npx -y
|
|
121
|
+
npx -y @sandbaseai/cli@latest connect --client cursor
|
|
117
122
|
```
|
|
118
123
|
|
|
119
124
|
---
|
|
@@ -135,6 +140,14 @@ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cl
|
|
|
135
140
|
|
|
136
141
|
---
|
|
137
142
|
|
|
143
|
+
## 料金
|
|
144
|
+
|
|
145
|
+
- データ API(検索、ソーシャル、スクレイピング、EC、金融)は組織ごとに 1 日 100 回まで無料(UTC 基準でリセット、対象 API 全体で共有)。それ以降は 1 回ごとの課金で、料金は `sandbase inspect` で表示されます。
|
|
146
|
+
- discover、inspect、実行ステータス、残高、ファイルアップロードは無料。
|
|
147
|
+
- モデル(LLM、画像、動画、音声)は 1 回ごと、または 100 万トークンごとの課金。
|
|
148
|
+
|
|
149
|
+
`sandbase inspect <tool>` は常に現在の価格を表示し、無料枠の対象 API には `pricing.free_quota` が表示されます。今日の残り無料回数は `sandbase balance --json` の `free_api_quota` で確認できます。価格は変わるため、実際のレスポンスを信頼してください。
|
|
150
|
+
|
|
138
151
|
## コマンド
|
|
139
152
|
|
|
140
153
|
### CLIコマンド
|
|
@@ -155,7 +168,7 @@ sandbase catalog --json # 対応クライアント一覧
|
|
|
155
168
|
| `sandbase_run` | モデルまたはAPIエンドポイントを実行 |
|
|
156
169
|
| `sandbase_run_get` | 非同期タスクのステータス/結果をポーリング |
|
|
157
170
|
| `sandbase_runs` | 最近のAPI呼び出しとコストを一覧表示 |
|
|
158
|
-
| `sandbase_account` |
|
|
171
|
+
| `sandbase_account` | アカウント残高と本日の無料データ API 呼び出し(`free_api_quota`)を確認(無料) |
|
|
159
172
|
|
|
160
173
|
**エージェントが自動的に従うワークフロー:**
|
|
161
174
|
|
|
@@ -184,12 +197,12 @@ discover → inspect → run
|
|
|
184
197
|
## 始めよう
|
|
185
198
|
|
|
186
199
|
```sh
|
|
187
|
-
npx -y
|
|
200
|
+
npx -y @sandbaseai/cli@latest connect
|
|
188
201
|
```
|
|
189
202
|
|
|
190
203
|
そして、エージェントに今までできなかったことを頼んでみてください。
|
|
191
204
|
|
|
192
|
-
**[
|
|
205
|
+
**[アカウント作成 →](https://sandbase.ai)**
|
|
193
206
|
|
|
194
207
|
SandBase でセットアップ時間を短縮できたら、[リポジトリに Star を付けてください](https://github.com/sandbaseai/cli)。より多くのエージェントユーザーがこのプロジェクトを見つけやすくなります。
|
|
195
208
|
|
|
@@ -200,7 +213,7 @@ SandBase でセットアップ時間を短縮できたら、[リポジトリに
|
|
|
200
213
|
- [SandBase プラットフォーム](https://sandbase.ai)
|
|
201
214
|
- [ドキュメント](https://www.sandbase.ai/docs/)
|
|
202
215
|
- [Claude Code・Codex向け実践チュートリアル](https://github.com/sandbaseai/cli/discussions/49)
|
|
203
|
-
- [公式 MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers
|
|
216
|
+
- [公式 MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sandbaseai%2Fcli)
|
|
204
217
|
- [npm パッケージ](https://www.npmjs.com/package/@sandbaseai/cli)
|
|
205
218
|
- [ダッシュボード](https://sandbase.ai/console)
|
|
206
219
|
|
package/README.ko.md
CHANGED
|
@@ -25,8 +25,16 @@ AI 코딩 어시스턴트는 똑똑하지만 상자 안에 갇혀 있습니다.
|
|
|
25
25
|
|
|
26
26
|
**SandBase가 이를 바꿉니다.** 한 줄 명령어로 에이전트를 2,000개 이상의 AI 모델과 API에 [MCP](https://modelcontextprotocol.io)를 통해 연결합니다. API 키 관리 불필요. 설정 고민 없음.
|
|
27
27
|
|
|
28
|
+
이 한 줄을 에이전트에 붙여넣으면 Skill을 읽고 `connect`까지 직접 실행합니다. 브라우저 로그인만 승인해 주세요:
|
|
29
|
+
|
|
30
|
+
```
|
|
31
|
+
set up https://www.sandbase.ai/SKILL.md
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
직접 실행하려면:
|
|
35
|
+
|
|
28
36
|
```sh
|
|
29
|
-
npx -y
|
|
37
|
+
npx -y @sandbaseai/cli@latest connect
|
|
30
38
|
```
|
|
31
39
|
|
|
32
40
|
macOS 또는 Linux에서는 공식 Homebrew Formula로 설치할 수도 있습니다.
|
|
@@ -77,24 +85,29 @@ sandbase connect
|
|
|
77
85
|
로그인하거나 로컬 설정을 변경하지 않고 먼저 호환성만 확인하려면 읽기 전용 카탈로그 명령으로 현재 지원되는 25개 클라이언트를 확인하세요:
|
|
78
86
|
|
|
79
87
|
```sh
|
|
80
|
-
npx -y
|
|
88
|
+
npx -y @sandbaseai/cli@latest catalog --json
|
|
81
89
|
```
|
|
82
90
|
|
|
83
|
-
|
|
84
|
-
`1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa`
|
|
85
|
-
|
|
86
|
-
npm의 `latest` 태그는 아직 v0.1.14이므로 Trusted Publishing이 활성화될 때까지 위의 버전 고정 GitHub URL을 사용하세요.
|
|
91
|
+
모든 GitHub 릴리스는 SHA-256을 함께 게시하므로 특정 버전에 고정해 검증할 수 있습니다.
|
|
87
92
|
|
|
88
93
|
```sh
|
|
89
94
|
# 감지된 모든 클라이언트 한번에 연결
|
|
90
|
-
npx -y
|
|
95
|
+
npx -y @sandbaseai/cli@latest connect
|
|
91
96
|
|
|
92
97
|
# 특정 클라이언트 지정
|
|
93
|
-
npx -y
|
|
98
|
+
npx -y @sandbaseai/cli@latest connect --client cursor
|
|
94
99
|
```
|
|
95
100
|
|
|
96
101
|
---
|
|
97
102
|
|
|
103
|
+
## 가격
|
|
104
|
+
|
|
105
|
+
- 데이터 API(검색, 소셜, 스크래핑, 커머스, 금융)는 조직당 하루 100회 무료(UTC 기준 초기화, 대상 API 전체 공유)이며, 이후에는 호출당 과금됩니다. 가격은 `sandbase inspect`에 표시됩니다.
|
|
106
|
+
- discover, inspect, 실행 상태, 잔액, 파일 업로드는 무료입니다.
|
|
107
|
+
- 모델(LLM, 이미지, 비디오, 오디오)은 호출당 또는 100만 토큰당 과금됩니다.
|
|
108
|
+
|
|
109
|
+
`sandbase inspect <tool>`은 현재 가격을 보여 주며, 무료 한도 대상 API에는 `pricing.free_quota`가 표시됩니다. 오늘 남은 무료 호출 수는 `sandbase balance --json`의 `free_api_quota`에서 확인할 수 있습니다. 가격은 변경될 수 있으니 실제 응답을 기준으로 하세요.
|
|
110
|
+
|
|
98
111
|
## 명령어
|
|
99
112
|
|
|
100
113
|
### CLI 명령어
|
|
@@ -115,7 +128,7 @@ sandbase catalog --json # 지원 클라이언트 목록
|
|
|
115
128
|
| `sandbase_run` | 모델 또는 API 실행 |
|
|
116
129
|
| `sandbase_run_get` | 비동기 작업 상태/결과 조회 |
|
|
117
130
|
| `sandbase_runs` | 최근 API 호출 및 비용 확인 |
|
|
118
|
-
| `sandbase_account` | 계정
|
|
131
|
+
| `sandbase_account` | 계정 잔액과 오늘의 무료 데이터 API 호출(`free_api_quota`) 확인 (무료) |
|
|
119
132
|
|
|
120
133
|
---
|
|
121
134
|
|
|
@@ -131,17 +144,17 @@ sandbase catalog --json # 지원 클라이언트 목록
|
|
|
131
144
|
## 시작하기
|
|
132
145
|
|
|
133
146
|
```sh
|
|
134
|
-
npx -y
|
|
147
|
+
npx -y @sandbaseai/cli@latest connect
|
|
135
148
|
```
|
|
136
149
|
|
|
137
|
-
**[
|
|
150
|
+
**[계정 만들기 →](https://sandbase.ai)**
|
|
138
151
|
|
|
139
152
|
SandBase로 설정 시간을 절약했다면 [프로젝트에 Star를 남겨 주세요](https://github.com/sandbaseai/cli). 더 많은 에이전트 사용자가 프로젝트를 발견하는 데 도움이 됩니다.
|
|
140
153
|
|
|
141
154
|
## 실전 가이드
|
|
142
155
|
|
|
143
156
|
- [Claude Code·Codex: 모델/API 탐색, 가격 확인, 실행](https://github.com/sandbaseai/cli/discussions/51)
|
|
144
|
-
- [공식 MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers
|
|
157
|
+
- [공식 MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sandbaseai%2Fcli)
|
|
145
158
|
|
|
146
159
|
## 라이선스
|
|
147
160
|
|
package/README.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
<p align="center">
|
|
2
2
|
<h1 align="center">@sandbaseai/cli</h1>
|
|
3
3
|
<p align="center">
|
|
4
|
-
<strong>Give your AI agent superpowers. One
|
|
4
|
+
<strong>Give your AI agent superpowers. One line. 2,000+ AI models and APIs. 100 free data API calls a day, then pay per call from one balance.</strong>
|
|
5
5
|
</p>
|
|
6
6
|
<p align="center">
|
|
7
7
|
English | <a href="./README.zh-CN.md">中文</a> | <a href="./README.ja.md">日本語</a> | <a href="./README.ko.md">한국어</a> | <a href="./README.es.md">Español</a> | <a href="./README.fr.md">Français</a> | <a href="./README.de.md">Deutsch</a> | <a href="./README.pt-BR.md">Português</a>
|
|
@@ -30,8 +30,18 @@ Building directly over HTTP instead of MCP? Start with the [SandBase API quickst
|
|
|
30
30
|
or compare the unified [LLM, image, and video API](https://blog.sandbase.ai/unified-ai-api-llm-image-video-2026/)
|
|
31
31
|
with specialized model gateways.
|
|
32
32
|
|
|
33
|
+
## Setup
|
|
34
|
+
|
|
35
|
+
Paste this into your agent and let it do the rest:
|
|
36
|
+
|
|
37
|
+
```
|
|
38
|
+
set up https://www.sandbase.ai/SKILL.md
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
It reads the SandBase Skill, runs `connect` itself, and asks you to approve one browser sign-in. Prefer to drive it yourself:
|
|
42
|
+
|
|
33
43
|
```sh
|
|
34
|
-
npx -y
|
|
44
|
+
npx -y @sandbaseai/cli@latest connect
|
|
35
45
|
```
|
|
36
46
|
|
|
37
47
|
Or install the official Homebrew formula on macOS or Linux:
|
|
@@ -43,39 +53,49 @@ sandbase connect
|
|
|
43
53
|
|
|
44
54
|
See the [Homebrew launch announcement and macOS/Linux CI evidence](https://github.com/sandbaseai/cli/discussions/55).
|
|
45
55
|
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
`
|
|
56
|
+
Approve the browser authorization once; each supported client can then discover,
|
|
57
|
+
inspect, and run available SandBase models and APIs through the local MCP bridge.
|
|
58
|
+
Start a new session afterwards so the `sandbase_*` tools load.
|
|
59
|
+
|
|
60
|
+
Every GitHub release publishes its own SHA-256 next to the tarball, so you can pin
|
|
61
|
+
and verify an exact build instead of tracking `latest`:
|
|
49
62
|
|
|
50
63
|
```sh
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
npx -y ./sandbaseai-cli
|
|
64
|
+
V=$(npm view @sandbaseai/cli version)
|
|
65
|
+
curl -fL -O "https://github.com/sandbaseai/cli/releases/download/v$V/sandbaseai-cli-$V.tgz"
|
|
66
|
+
shasum -a 256 "sandbaseai-cli-$V.tgz" # compare against the checksum on the release page
|
|
67
|
+
npx -y "./sandbaseai-cli-$V.tgz" connect
|
|
55
68
|
```
|
|
56
69
|
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
Want to inspect compatibility before signing in or changing configuration? The current
|
|
61
|
-
[`v0.1.17` GitHub release](https://github.com/sandbaseai/cli/releases/tag/v0.1.17)
|
|
62
|
-
includes a verified 25-client catalog:
|
|
70
|
+
Want to inspect compatibility before signing in or changing configuration? The
|
|
71
|
+
client catalog is a read-only command — it writes nothing and needs no account:
|
|
63
72
|
|
|
64
73
|
```sh
|
|
65
|
-
npx -y
|
|
74
|
+
npx -y @sandbaseai/cli@latest catalog --json
|
|
66
75
|
```
|
|
67
76
|
|
|
68
77
|
<p align="center">
|
|
69
|
-
<a href="https://static.sandbase.ai/blog/screenshots/sandbase-cli-mcp-bridge-25-ai-clients/catalog-audit-5eea5978a1ed.webp"><img src="https://static.sandbase.ai/blog/screenshots/sandbase-cli-mcp-bridge-25-ai-clients/catalog-audit-5eea5978a1ed.webp" alt="Read-only SandBase CLI
|
|
70
|
-
<a href="https://static.sandbase.ai/blog/screenshots/sandbase-cli-mcp-bridge-25-ai-clients/doctor-readback-3c86ac73e463.webp"><img src="https://static.sandbase.ai/blog/screenshots/sandbase-cli-mcp-bridge-25-ai-clients/doctor-readback-3c86ac73e463.webp" alt="SandBase CLI
|
|
78
|
+
<a href="https://static.sandbase.ai/blog/screenshots/sandbase-cli-mcp-bridge-25-ai-clients/catalog-audit-5eea5978a1ed.webp"><img src="https://static.sandbase.ai/blog/screenshots/sandbase-cli-mcp-bridge-25-ai-clients/catalog-audit-5eea5978a1ed.webp" alt="Read-only SandBase CLI catalog audit showing 25 client targets" width="49%"></a>
|
|
79
|
+
<a href="https://static.sandbase.ai/blog/screenshots/sandbase-cli-mcp-bridge-25-ai-clients/doctor-readback-3c86ac73e463.webp"><img src="https://static.sandbase.ai/blog/screenshots/sandbase-cli-mcp-bridge-25-ai-clients/doctor-readback-3c86ac73e463.webp" alt="SandBase CLI doctor failing closed for an empty isolated profile" width="49%"></a>
|
|
71
80
|
</p>
|
|
72
|
-
<p align="center"><sub>
|
|
81
|
+
<p align="center"><sub>A no-write catalog audit and a bounded doctor check against an empty isolated profile.</sub></p>
|
|
73
82
|
|
|
74
83
|
Homebrew users can run the same read-only check with `sandbase catalog --json`.
|
|
75
84
|
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
85
|
+
## What It Costs
|
|
86
|
+
|
|
87
|
+
| | Price |
|
|
88
|
+
|---|---|
|
|
89
|
+
| Data APIs — search, social, scraping, e-commerce, finance | 100 free calls/day per organization, then paid per call (price shown by `sandbase inspect`) |
|
|
90
|
+
| Discovery, inspection, run status, balance, file upload | **Free** |
|
|
91
|
+
| Models — LLM, image, video, audio | Paid per call or per million tokens |
|
|
92
|
+
|
|
93
|
+
`sandbase inspect <tool>` always shows the current price before you run anything;
|
|
94
|
+
data APIs covered by the daily allowance also show `pricing.free_quota`. The 100
|
|
95
|
+
free calls are shared across eligible data APIs and reset at 00:00 UTC; after
|
|
96
|
+
that, calls are billed per call. `sandbase balance --json` shows today's remaining free
|
|
97
|
+
calls as `free_api_quota`. Prices can change, so trust the live response over
|
|
98
|
+
any example in this file.
|
|
79
99
|
|
|
80
100
|
Visit the [official SandBase CLI project page](https://sandbaseai.github.io/cli/) for a compact overview.
|
|
81
101
|
For a security-focused walkthrough of client detection, MCP tools, and rollback,
|
|
@@ -127,8 +147,10 @@ other catalog capabilities:
|
|
|
127
147
|
1. Use `sandbase_discover` to find candidates by task or capability.
|
|
128
148
|
2. Use `sandbase_inspect` to read the current input schema, pricing, and
|
|
129
149
|
execution requirements.
|
|
130
|
-
3. Confirm the selected endpoint
|
|
131
|
-
|
|
150
|
+
3. Confirm the selected endpoint and parameters before calling `sandbase_run`.
|
|
151
|
+
Data APIs include 100 free calls per organization per UTC day, then are
|
|
152
|
+
billed per call like models; confirm the cost shown by `sandbase_inspect`
|
|
153
|
+
before paid runs.
|
|
132
154
|
4. For asynchronous work, use `sandbase_run_get` with the returned `run_id`
|
|
133
155
|
instead of creating a duplicate run.
|
|
134
156
|
5. Use `sandbase_runs` to review recent run status and recorded cost.
|
|
@@ -140,6 +162,9 @@ For example, start with a non-billable discovery request:
|
|
|
140
162
|
> required inputs and current pricing for the best two candidates. Do not run
|
|
141
163
|
> either model yet.
|
|
142
164
|
|
|
165
|
+
Discovery and inspection never cost anything, so an agent can always survey the
|
|
166
|
+
catalog before it spends.
|
|
167
|
+
|
|
143
168
|
After reviewing the live response, explicitly approve the endpoint and inputs
|
|
144
169
|
you want to run. Catalog entries, schemas, pricing, latency, and availability
|
|
145
170
|
can change, so use the tool response from the current session rather than a
|
|
@@ -187,15 +212,15 @@ Works with every major AI coding tool:
|
|
|
187
212
|
Preview the complete compatibility catalog without signing in or changing any files:
|
|
188
213
|
|
|
189
214
|
```sh
|
|
190
|
-
npx -y
|
|
215
|
+
npx -y @sandbaseai/cli@latest catalog --json
|
|
191
216
|
```
|
|
192
217
|
|
|
193
218
|
```sh
|
|
194
219
|
# Connect all detected clients at once
|
|
195
|
-
npx -y
|
|
220
|
+
npx -y @sandbaseai/cli@latest connect
|
|
196
221
|
|
|
197
222
|
# Or target one specific client
|
|
198
|
-
npx -y
|
|
223
|
+
npx -y @sandbaseai/cli@latest connect --client cursor
|
|
199
224
|
```
|
|
200
225
|
|
|
201
226
|
### OpenClaw quickstart
|
|
@@ -204,8 +229,8 @@ Target OpenClaw directly, then ask the CLI to read back the managed MCP server
|
|
|
204
229
|
and SandBase Skill before you rely on them:
|
|
205
230
|
|
|
206
231
|
```sh
|
|
207
|
-
npx -y
|
|
208
|
-
npx -y
|
|
232
|
+
npx -y @sandbaseai/cli@latest connect --client openclaw
|
|
233
|
+
npx -y @sandbaseai/cli@latest doctor --client openclaw
|
|
209
234
|
```
|
|
210
235
|
|
|
211
236
|
After `doctor` reports the credential, MCP bridge, and Skill as configured,
|
|
@@ -215,7 +240,7 @@ leaves it untouched instead of overwriting it. To remove the managed MCP entry
|
|
|
215
240
|
and local credential later:
|
|
216
241
|
|
|
217
242
|
```sh
|
|
218
|
-
npx -y
|
|
243
|
+
npx -y @sandbaseai/cli@latest unregister --client openclaw
|
|
219
244
|
```
|
|
220
245
|
|
|
221
246
|
OpenClaw currently exposes no supported Skill removal command, so `unregister`
|
|
@@ -227,8 +252,8 @@ SandBase can install both its managed Hermes Skill and local MCP entry in one
|
|
|
227
252
|
authorization transaction:
|
|
228
253
|
|
|
229
254
|
```sh
|
|
230
|
-
npx -y
|
|
231
|
-
npx -y
|
|
255
|
+
npx -y @sandbaseai/cli@latest connect --client hermes
|
|
256
|
+
npx -y @sandbaseai/cli@latest doctor --client hermes
|
|
232
257
|
```
|
|
233
258
|
|
|
234
259
|
`doctor` verifies the owned local credential, MCP entry, and Skill. Restart
|
|
@@ -238,7 +263,7 @@ SandBase Skill or MCP tools. A pre-existing, non-SandBase MCP entry named
|
|
|
238
263
|
Skill, and local credential while retaining the shared bridge for other clients:
|
|
239
264
|
|
|
240
265
|
```sh
|
|
241
|
-
npx -y
|
|
266
|
+
npx -y @sandbaseai/cli@latest unregister --client hermes
|
|
242
267
|
```
|
|
243
268
|
|
|
244
269
|
The integration is independently listed by
|
|
@@ -298,12 +323,13 @@ Sync tools (LLMs, most data APIs) return their result directly; async tools (ima
|
|
|
298
323
|
|
|
299
324
|
| Tool | Purpose |
|
|
300
325
|
|------|---------|
|
|
301
|
-
| `sandbase_discover` | Search all 2,000+ available AI models and APIs |
|
|
302
|
-
| `sandbase_inspect` | Get input schema,
|
|
303
|
-
| `sandbase_run` | Execute a model or API endpoint |
|
|
304
|
-
| `sandbase_run_get` | Poll status/result of an async run (video gen, etc.) |
|
|
305
|
-
| `sandbase_runs` | List your recent
|
|
306
|
-
| `sandbase_account` | Check account balance
|
|
326
|
+
| `sandbase_discover` | Search all 2,000+ available AI models and APIs — free |
|
|
327
|
+
| `sandbase_inspect` | Get input schema, current price, and a ready-to-run template — free |
|
|
328
|
+
| `sandbase_run` | Execute a model or API endpoint — eligible data APIs: 100 free calls/day per organization, then paid per call; models: paid per call |
|
|
329
|
+
| `sandbase_run_get` | Poll status/result of an async run (video gen, etc.) — free |
|
|
330
|
+
| `sandbase_runs` | List your recent runs with their cost — free |
|
|
331
|
+
| `sandbase_account` | Check account balance and today's free data API calls (`free_api_quota`) — free |
|
|
332
|
+
| `sandbase_run_cancel` | Cancel an Agent Service run — free |
|
|
307
333
|
|
|
308
334
|
**Recommended workflow:**
|
|
309
335
|
|
|
@@ -332,12 +358,12 @@ discover → inspect → run
|
|
|
332
358
|
## Get Started
|
|
333
359
|
|
|
334
360
|
```sh
|
|
335
|
-
npx -y
|
|
361
|
+
npx -y @sandbaseai/cli@latest connect
|
|
336
362
|
```
|
|
337
363
|
|
|
338
364
|
Then ask your agent to do something it couldn't before.
|
|
339
365
|
|
|
340
|
-
**[Create
|
|
366
|
+
**[Create an account →](https://sandbase.ai)** — every organization gets 100 free data API calls a day.
|
|
341
367
|
|
|
342
368
|
If SandBase saves you setup time, [star the repository](https://github.com/sandbaseai/cli) — it helps more agent users discover the project.
|
|
343
369
|
|
package/README.pt-BR.md
CHANGED
|
@@ -25,8 +25,16 @@ Seu assistente de codificação IA é inteligente, mas está preso em uma caixa.
|
|
|
25
25
|
|
|
26
26
|
**SandBase muda isso.** Um comando conecta seu agente a 2.000+ modelos de IA e APIs pelo [MCP](https://modelcontextprotocol.io). Sem gerenciar chaves de API. Sem dor de cabeça.
|
|
27
27
|
|
|
28
|
+
Cole esta linha no seu agente e ele faz o resto: lê a Skill, executa `connect` e só pede que você aprove o login no navegador:
|
|
29
|
+
|
|
30
|
+
```
|
|
31
|
+
set up https://www.sandbase.ai/SKILL.md
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
Se preferir fazer você mesmo:
|
|
35
|
+
|
|
28
36
|
```sh
|
|
29
|
-
npx -y
|
|
37
|
+
npx -y @sandbaseai/cli@latest connect
|
|
30
38
|
```
|
|
31
39
|
|
|
32
40
|
Ou instale a fórmula oficial do Homebrew no macOS ou Linux:
|
|
@@ -77,24 +85,29 @@ Catálogo, preços, latência e disponibilidade podem mudar. Use a resposta atua
|
|
|
77
85
|
Quer verificar a compatibilidade antes de entrar ou alterar a configuração local? Execute o catálogo somente leitura para confirmar os 25 clientes compatíveis:
|
|
78
86
|
|
|
79
87
|
```sh
|
|
80
|
-
npx -y
|
|
88
|
+
npx -y @sandbaseai/cli@latest catalog --json
|
|
81
89
|
```
|
|
82
90
|
|
|
83
|
-
|
|
84
|
-
`1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa`
|
|
85
|
-
|
|
86
|
-
A tag `latest` do npm ainda aponta para a v0.1.14; até a ativação do Trusted Publishing, use a URL versionada do GitHub acima.
|
|
91
|
+
Cada release do GitHub publica o próprio SHA-256, então você pode fixar e verificar um build exato.
|
|
87
92
|
|
|
88
93
|
```sh
|
|
89
94
|
# Conectar todos os clientes detectados
|
|
90
|
-
npx -y
|
|
95
|
+
npx -y @sandbaseai/cli@latest connect
|
|
91
96
|
|
|
92
97
|
# Ou um cliente específico
|
|
93
|
-
npx -y
|
|
98
|
+
npx -y @sandbaseai/cli@latest connect --client cursor
|
|
94
99
|
```
|
|
95
100
|
|
|
96
101
|
---
|
|
97
102
|
|
|
103
|
+
## Preços
|
|
104
|
+
|
|
105
|
+
- As APIs de dados (busca, redes sociais, scraping, e-commerce, finanças) incluem 100 chamadas grátis por dia por organização (compartilhadas entre as APIs elegíveis, reiniciadas às 00:00 UTC); depois, são cobradas por chamada, pelo preço exibido em `sandbase inspect`.
|
|
106
|
+
- Descobrir, inspecionar, status de execução, saldo e upload de arquivos são gratuitos.
|
|
107
|
+
- Modelos (LLM, imagem, vídeo, áudio) são cobrados por chamada ou por milhão de tokens.
|
|
108
|
+
|
|
109
|
+
`sandbase inspect <tool>` sempre mostra o preço atual e, nas APIs elegíveis, `pricing.free_quota`; `sandbase balance --json` mostra as chamadas grátis restantes do dia em `free_api_quota`. Preços mudam: confie na resposta real.
|
|
110
|
+
|
|
98
111
|
## Comandos
|
|
99
112
|
|
|
100
113
|
```sh
|
|
@@ -113,7 +126,7 @@ sandbase catalog --json # Listar clientes suportados
|
|
|
113
126
|
| `sandbase_run` | Executar um modelo ou API |
|
|
114
127
|
| `sandbase_run_get` | Verificar status de tarefas assíncronas |
|
|
115
128
|
| `sandbase_runs` | Ver chamadas recentes e custos |
|
|
116
|
-
| `sandbase_account` | Verificar saldo (grátis) |
|
|
129
|
+
| `sandbase_account` | Verificar saldo e as chamadas gratuitas a APIs de dados de hoje (`free_api_quota`) (grátis) |
|
|
117
130
|
|
|
118
131
|
---
|
|
119
132
|
|
|
@@ -129,17 +142,17 @@ sandbase catalog --json # Listar clientes suportados
|
|
|
129
142
|
## Começar
|
|
130
143
|
|
|
131
144
|
```sh
|
|
132
|
-
npx -y
|
|
145
|
+
npx -y @sandbaseai/cli@latest connect
|
|
133
146
|
```
|
|
134
147
|
|
|
135
|
-
**[Criar conta
|
|
148
|
+
**[Criar conta →](https://sandbase.ai)**
|
|
136
149
|
|
|
137
150
|
Se o SandBase economizou seu tempo de configuração, [dê uma estrela ao projeto](https://github.com/sandbaseai/cli). Isso ajuda mais usuários de agentes a encontrá-lo.
|
|
138
151
|
|
|
139
152
|
## Guia prático
|
|
140
153
|
|
|
141
154
|
- [Claude Code e Codex: descobrir, conferir o preço e executar](https://github.com/sandbaseai/cli/discussions/54)
|
|
142
|
-
- [Registro MCP oficial](https://registry.modelcontextprotocol.io/v0.1/servers
|
|
155
|
+
- [Registro MCP oficial](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sandbaseai%2Fcli)
|
|
143
156
|
|
|
144
157
|
## Licença
|
|
145
158
|
|
package/README.zh-CN.md
CHANGED
|
@@ -26,36 +26,40 @@
|
|
|
26
26
|
|
|
27
27
|
**SandBase 改变了这一切。** 一行命令,通过 [Model Context Protocol](https://modelcontextprotocol.io) 将你的 Agent 连接到 2,000+ AI 模型与 API。不用管理 API Key,不用折腾配置。
|
|
28
28
|
|
|
29
|
-
|
|
29
|
+
把这一行发给你的 agent,它会自己读取 Skill、运行 `connect`,只需你在浏览器里确认一次登录:
|
|
30
|
+
|
|
31
|
+
```
|
|
32
|
+
set up https://www.sandbase.ai/SKILL.md
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
想自己动手:
|
|
30
36
|
|
|
31
37
|
```sh
|
|
32
|
-
|
|
33
|
-
sandbase connect
|
|
38
|
+
npx -y @sandbaseai/cli@latest connect
|
|
34
39
|
```
|
|
35
40
|
|
|
36
|
-
|
|
41
|
+
在 macOS 或 Linux 上使用官方 Homebrew Formula:
|
|
37
42
|
|
|
38
43
|
```sh
|
|
39
|
-
|
|
44
|
+
brew install sandbaseai/tap/sandbaseai-cli
|
|
45
|
+
sandbase connect
|
|
40
46
|
```
|
|
41
47
|
|
|
42
48
|
想先验证兼容性、暂不登录也不修改本地配置?运行只读目录命令,确认当前版本支持的 25 个客户端:
|
|
43
49
|
|
|
44
50
|
```sh
|
|
45
|
-
npx -y
|
|
51
|
+
npx -y @sandbaseai/cli@latest catalog --json
|
|
46
52
|
```
|
|
47
53
|
|
|
48
54
|
<p align="center">
|
|
49
|
-
<a href="https://static.sandbase.ai/blog/screenshots/sandbase-cli-mcp-bridge-25-ai-clients/catalog-audit-5eea5978a1ed.webp"><img src="https://static.sandbase.ai/blog/screenshots/sandbase-cli-mcp-bridge-25-ai-clients/catalog-audit-5eea5978a1ed.webp" alt="SandBase CLI
|
|
50
|
-
<a href="https://static.sandbase.ai/blog/screenshots/sandbase-cli-mcp-bridge-25-ai-clients/doctor-readback-3c86ac73e463.webp"><img src="https://static.sandbase.ai/blog/screenshots/sandbase-cli-mcp-bridge-25-ai-clients/doctor-readback-3c86ac73e463.webp" alt="SandBase CLI
|
|
55
|
+
<a href="https://static.sandbase.ai/blog/screenshots/sandbase-cli-mcp-bridge-25-ai-clients/catalog-audit-5eea5978a1ed.webp"><img src="https://static.sandbase.ai/blog/screenshots/sandbase-cli-mcp-bridge-25-ai-clients/catalog-audit-5eea5978a1ed.webp" alt="SandBase CLI 只读目录审计显示 25 个客户端目标" width="49%"></a>
|
|
56
|
+
<a href="https://static.sandbase.ai/blog/screenshots/sandbase-cli-mcp-bridge-25-ai-clients/doctor-readback-3c86ac73e463.webp"><img src="https://static.sandbase.ai/blog/screenshots/sandbase-cli-mcp-bridge-25-ai-clients/doctor-readback-3c86ac73e463.webp" alt="SandBase CLI doctor 对空白隔离配置按预期安全失败" width="49%"></a>
|
|
51
57
|
</p>
|
|
52
|
-
<p align="center"><sub
|
|
58
|
+
<p align="center"><sub>证据:不写配置的目录审计,以及针对空白隔离配置的受限 doctor 检查。</sub></p>
|
|
53
59
|
|
|
54
|
-
|
|
55
|
-
`1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa`。
|
|
56
|
-
目前 npm 的 `latest` 标签仍是 v0.1.14,因此在可信发布启用完成前,请使用上面的版本化 GitHub 地址。
|
|
60
|
+
每个 GitHub 发布版都会随包公布自己的 SHA-256,可据此校验并固定到某个确切版本。
|
|
57
61
|
|
|
58
|
-
项目已进入[官方 MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers
|
|
62
|
+
项目已进入[官方 MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sandbaseai%2Fcli),并被[中国独立开发者项目(程序员版)](https://github.com/1c7/chinese-independent-developer/blob/master/pages/README-Programmer-Edition.md#sandbase---github)独立收录。
|
|
59
63
|
|
|
60
64
|
查看[中文项目页](https://sandbaseai.github.io/cli/zh/)和[中文工作流指南](https://github.com/sandbaseai/cli/discussions/48)。如果 SandBase CLI 对你有帮助,请[给仓库一个 Star](https://github.com/sandbaseai/cli),让更多开发者发现它。
|
|
61
65
|
|
|
@@ -124,15 +128,15 @@ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cl
|
|
|
124
128
|
无需登录或修改任何文件,即可预览完整兼容性目录:
|
|
125
129
|
|
|
126
130
|
```sh
|
|
127
|
-
npx -y
|
|
131
|
+
npx -y @sandbaseai/cli@latest catalog --json
|
|
128
132
|
```
|
|
129
133
|
|
|
130
134
|
```sh
|
|
131
135
|
# 一次连接所有检测到的客户端
|
|
132
|
-
npx -y
|
|
136
|
+
npx -y @sandbaseai/cli@latest connect
|
|
133
137
|
|
|
134
138
|
# 或者指定某个客户端
|
|
135
|
-
npx -y
|
|
139
|
+
npx -y @sandbaseai/cli@latest connect --client cursor
|
|
136
140
|
```
|
|
137
141
|
|
|
138
142
|
### OpenClaw 快速开始
|
|
@@ -140,8 +144,8 @@ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cl
|
|
|
140
144
|
直接指定 OpenClaw,并在使用前让 CLI 回读验证由 SandBase 管理的 MCP 服务与 Skill:
|
|
141
145
|
|
|
142
146
|
```sh
|
|
143
|
-
npx -y
|
|
144
|
-
npx -y
|
|
147
|
+
npx -y @sandbaseai/cli@latest connect --client openclaw
|
|
148
|
+
npx -y @sandbaseai/cli@latest doctor --client openclaw
|
|
145
149
|
```
|
|
146
150
|
|
|
147
151
|
当 `doctor` 确认凭证、MCP bridge 和 Skill 均已配置后,重启 OpenClaw,
|
|
@@ -150,7 +154,7 @@ SandBase 管理、但同样名为 `sandbase` 的 MCP 服务,安装器会保持
|
|
|
150
154
|
以后若要移除由 SandBase 管理的 MCP 条目和本地凭证:
|
|
151
155
|
|
|
152
156
|
```sh
|
|
153
|
-
npx -y
|
|
157
|
+
npx -y @sandbaseai/cli@latest unregister --client openclaw
|
|
154
158
|
```
|
|
155
159
|
|
|
156
160
|
OpenClaw 目前没有受支持的 Skill 移除命令,因此 `unregister` 会明确报告这一限制,
|
|
@@ -161,8 +165,8 @@ OpenClaw 目前没有受支持的 Skill 移除命令,因此 `unregister` 会
|
|
|
161
165
|
SandBase 可以在同一次授权事务中安装由它管理的 Hermes Skill 和本地 MCP 条目:
|
|
162
166
|
|
|
163
167
|
```sh
|
|
164
|
-
npx -y
|
|
165
|
-
npx -y
|
|
168
|
+
npx -y @sandbaseai/cli@latest connect --client hermes
|
|
169
|
+
npx -y @sandbaseai/cli@latest doctor --client hermes
|
|
166
170
|
```
|
|
167
171
|
|
|
168
172
|
`doctor` 会验证所有权明确的本地凭证、MCP 条目与 Skill。随后重启 Hermes,
|
|
@@ -172,7 +176,7 @@ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cl
|
|
|
172
176
|
共用的 bridge:
|
|
173
177
|
|
|
174
178
|
```sh
|
|
175
|
-
npx -y
|
|
179
|
+
npx -y @sandbaseai/cli@latest unregister --client hermes
|
|
176
180
|
```
|
|
177
181
|
|
|
178
182
|
该集成已被独立收录于
|
|
@@ -198,6 +202,14 @@ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cl
|
|
|
198
202
|
|
|
199
203
|
---
|
|
200
204
|
|
|
205
|
+
## 价格
|
|
206
|
+
|
|
207
|
+
- 数据 API(搜索、社交、抓取、电商、金融)每个组织每天 100 次免费调用(按 UTC 日重置,所有适用的数据 API 共享),超出后按次计费,价格以 `sandbase inspect` 显示为准。
|
|
208
|
+
- discover、inspect、运行状态、余额、文件上传免费,不扣费。
|
|
209
|
+
- 模型(LLM、图像、视频、音频)按次或按百万 token 计费。
|
|
210
|
+
|
|
211
|
+
`sandbase inspect <工具名>` 会显示当前价格,适用每日免费额度的数据 API 会带有 `pricing.free_quota`;`sandbase balance --json` 的 `free_api_quota` 显示今天剩余的免费次数。价格可能变动,请以实时返回为准。
|
|
212
|
+
|
|
201
213
|
## 命令
|
|
202
214
|
|
|
203
215
|
### CLI 命令
|
|
@@ -236,7 +248,7 @@ sandbase runs list | sandbase balance
|
|
|
236
248
|
| `sandbase_run` | 执行模型或 API |
|
|
237
249
|
| `sandbase_run_get` | 轮询异步任务状态/结果(视频生成等) |
|
|
238
250
|
| `sandbase_runs` | 查看最近的 API 调用记录和费用 |
|
|
239
|
-
| `sandbase_account` |
|
|
251
|
+
| `sandbase_account` | 查看账户余额和今日免费数据 API 调用次数(`free_api_quota`),免费,不扣费 |
|
|
240
252
|
|
|
241
253
|
**Agent 自动遵循的调用流程:**
|
|
242
254
|
|
|
@@ -265,12 +277,12 @@ discover → inspect → run
|
|
|
265
277
|
## 开始使用
|
|
266
278
|
|
|
267
279
|
```sh
|
|
268
|
-
npx -y
|
|
280
|
+
npx -y @sandbaseai/cli@latest connect
|
|
269
281
|
```
|
|
270
282
|
|
|
271
283
|
然后让你的 Agent 做一些它以前做不到的事。
|
|
272
284
|
|
|
273
|
-
**[
|
|
285
|
+
**[注册账号 →](https://sandbase.ai)**
|
|
274
286
|
|
|
275
287
|
如果 SandBase 帮你节省了配置时间,欢迎[为项目点个 Star](https://github.com/sandbaseai/cli)——这会让更多 Agent 用户发现它。
|
|
276
288
|
|
package/llms-install.md
CHANGED
|
@@ -16,7 +16,7 @@ This read-only command prints the 25 supported client targets. It does not open
|
|
|
16
16
|
a browser or change local configuration:
|
|
17
17
|
|
|
18
18
|
```sh
|
|
19
|
-
npx -y
|
|
19
|
+
npx -y @sandbaseai/cli@latest catalog --json
|
|
20
20
|
```
|
|
21
21
|
|
|
22
22
|
## Install with Homebrew
|
|
@@ -29,20 +29,20 @@ sandbase catalog --json
|
|
|
29
29
|
sandbase connect --client <client-id>
|
|
30
30
|
```
|
|
31
31
|
|
|
32
|
-
The formula installs the
|
|
32
|
+
The formula installs the latest release archive and verifies its published
|
|
33
33
|
SHA-256 before installation.
|
|
34
34
|
|
|
35
35
|
## Connect a client
|
|
36
36
|
|
|
37
|
-
Alternatively, run the
|
|
37
|
+
Alternatively, run the latest GitHub Release directly while npm
|
|
38
38
|
`latest` is being updated:
|
|
39
39
|
|
|
40
40
|
```sh
|
|
41
|
-
npx -y
|
|
41
|
+
npx -y @sandbaseai/cli@latest connect --client <client-id>
|
|
42
42
|
```
|
|
43
43
|
|
|
44
|
-
For an offline
|
|
45
|
-
|
|
44
|
+
For an offline integrity check, compare the tarball against the SHA-256 published
|
|
45
|
+
on its [release page](https://github.com/sandbaseai/cli/releases/latest).
|
|
46
46
|
|
|
47
47
|
Common client IDs include `codex`, `claude-code`, `cursor`, `gemini-cli`,
|
|
48
48
|
`windsurf`, and `opencode`. To configure every supported client detected on the
|
|
@@ -56,7 +56,7 @@ permissions and adds only the SandBase-owned MCP entry.
|
|
|
56
56
|
## Verify
|
|
57
57
|
|
|
58
58
|
```sh
|
|
59
|
-
npx -y
|
|
59
|
+
npx -y @sandbaseai/cli@latest doctor --client <client-id>
|
|
60
60
|
```
|
|
61
61
|
|
|
62
62
|
Restart the target client after a successful connection so it reloads its MCP
|
|
@@ -67,7 +67,7 @@ configuration. The client should then expose six SandBase tools:
|
|
|
67
67
|
## Remove the managed entry
|
|
68
68
|
|
|
69
69
|
```sh
|
|
70
|
-
npx -y
|
|
70
|
+
npx -y @sandbaseai/cli@latest unregister --client <client-id>
|
|
71
71
|
```
|
|
72
72
|
|
|
73
73
|
This removes only the SandBase-owned configuration. It leaves unrelated and
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@sandbaseai/cli",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.8",
|
|
4
4
|
"mcpName": "io.github.sandbaseai/cli",
|
|
5
5
|
"description": "Give 25 AI clients—Claude Code, Codex, Cursor, Hermes, OpenClaw and more—2,000+ models and APIs through one MCP server and an agent-friendly CLI",
|
|
6
6
|
"type": "module",
|
package/skills/sandbase/SKILL.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: sandbase
|
|
3
|
-
version: 0.3.
|
|
3
|
+
version: 0.3.8
|
|
4
4
|
description: >-
|
|
5
5
|
Discover better ways to complete tasks. Proactively search SandBase (the
|
|
6
6
|
sandbase_discover MCP tool, or `sandbase discover` in a shell) before writing a
|
|
@@ -10,7 +10,8 @@ description: >-
|
|
|
10
10
|
data (X/Twitter, TikTok, Douyin, Xiaohongshu, Instagram, YouTube, Reddit,
|
|
11
11
|
Weibo, Bilibili, LinkedIn); search results; web scraping; product, company, or
|
|
12
12
|
people data; embeddings; or a specific third-party model. 2,000+ models and
|
|
13
|
-
APIs, paid per call from one balance
|
|
13
|
+
APIs, paid per call from one balance, with 100 free calls per day on eligible
|
|
14
|
+
data APIs (inspect shows free_quota). Exceptions: if the user already has a
|
|
14
15
|
dedicated MCP server, API key, or tool for that specific service, use it; and
|
|
15
16
|
if your built-in web search or page fetch already gives what the task needs,
|
|
16
17
|
use that — SandBase fills gaps in the user's stack, it does not replace it.
|
|
@@ -67,10 +68,10 @@ Discovery, inspection, run status, and balance are **free**; only `sandbase_run`
|
|
|
67
68
|
|---|---|
|
|
68
69
|
| `sandbase_discover` | Search the catalog in natural language (`q`), optionally filtered by `type` (`llm`, `api`, `multimodal`, `embedding`, `service`) or `vendor` |
|
|
69
70
|
| `sandbase_inspect` | Input schema (`inputSchema`), pricing, and an `execute_as` template for one tool |
|
|
70
|
-
| `sandbase_run` | Execute a tool (**
|
|
71
|
+
| `sandbase_run` | Execute a tool (**may be billed**) |
|
|
71
72
|
| `sandbase_run_get` | Status, cost, and output of a run — poll with this |
|
|
72
73
|
| `sandbase_runs` | Recent runs with cost |
|
|
73
|
-
| `sandbase_account` | Balance |
|
|
74
|
+
| `sandbase_account` | Balance and today's free data API calls (`free_api_quota`) |
|
|
74
75
|
| `sandbase_run_cancel` | Cancel an Agent Service run |
|
|
75
76
|
|
|
76
77
|
### MCP workflow
|
|
@@ -211,9 +212,12 @@ Do not use SandBase for purely local work (editing files, reasoning over code al
|
|
|
211
212
|
|
|
212
213
|
## 6. Cost and budget
|
|
213
214
|
|
|
214
|
-
-
|
|
215
|
-
-
|
|
216
|
-
-
|
|
215
|
+
- **`inspect` is the source of truth for price**: per call (`base_price`), per million tokens (`input_per_million` / `output_per_million`), or a `formula`.
|
|
216
|
+
- **Data APIs have a daily free quota** (search, social, scraping, e-commerce, finance): every organization gets **100 free calls per UTC day, shared across all eligible data APIs**. Eligible tools show `pricing.free_quota` in `inspect`; `sandbase_account` (`sandbase balance --json`) shows today's allowance as `free_api_quota` (`daily_limit`, `used_today`, `remaining`, `resets_at`). Each eligible data API call counts toward the 100, whichever tool it hits. After the quota is used up, calls keep working and are **billed per call** at the price `inspect` shows; they are not blocked. A zero-balance organization can still use its free calls.
|
|
217
|
+
- Models (LLM, image, video, audio) are always billed. Discovery, inspection, run status, balance, and `upload` are never billed.
|
|
218
|
+
- Read the price with `inspect` before running instead of guessing what a call costs.
|
|
219
|
+
- When a tool is billed **per result**, limits often apply **per query**: three search terms with `limit: 10` can return 30 results. Pass one search term per call and start with small limits (5–10).
|
|
220
|
+
- Check `sandbase_account` before a batch of calls (balance, plus `free_api_quota.remaining` for data APIs: a batch larger than the remaining free calls is billed for the rest), and report cost when the user cares about budget (`cost` appears on `sandbase_run_get` and `sandbase_runs`).
|
|
217
221
|
- Never re-run a slow tool just because it is still running; poll it.
|
|
218
222
|
- A key can carry a **spending limit** set in the Dashboard. When it is reached, calls fail with "spending limit" until the user raises or removes it; topping up does not help.
|
|
219
223
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "sandbase",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.8",
|
|
4
4
|
"description": "Discover and run 2,000+ AI models and APIs (media generation, social data, search, scraping) through one MCP interface or CLI, paid per call from one balance.",
|
|
5
5
|
"author": "SandBase AI",
|
|
6
6
|
"license": "Apache-2.0",
|