@sandbaseai/cli 0.3.3 → 0.3.7

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 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 https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
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 https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json
88
+ npx -y @sandbaseai/cli@latest catalog --json
81
89
  ```
82
90
 
83
- Der Befehl verwendet das unveränderliche GitHub-Release-Archiv `v0.1.17`. SHA-256-Prüfsumme:
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 https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
90
- npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client cursor
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) sind kostenlos.**
103
+ - Suchen, Inspizieren, Laufstatus, Guthaben und Datei-Upload sind ebenfalls 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; `base_price: 0` heißt kostenlos. Preise können sich ändern — verlasse dich auf die echte Antwort.
107
+
95
108
  ## Befehle
96
109
 
97
110
  ```sh
@@ -126,7 +139,7 @@ sandbase catalog --json # Unterstützte Clients auflisten
126
139
  ## Loslegen
127
140
 
128
141
  ```sh
129
- npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
142
+ npx -y @sandbaseai/cli@latest connect
130
143
  ```
131
144
 
132
145
  **[Kostenloses Konto erstellen →](https://sandbase.ai)**
@@ -136,7 +149,7 @@ Wenn SandBase dir Einrichtungszeit spart, [gib dem Projekt einen Star](https://g
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/io.github.sandbaseai%2Fcli/versions/0.1.17)
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 https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
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 https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json
88
+ npx -y @sandbaseai/cli@latest catalog --json
81
89
  ```
82
90
 
83
- Este comando usa el archivo inmutable de la versión `v0.1.17` en GitHub. SHA-256:
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 https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
95
+ npx -y @sandbaseai/cli@latest connect
91
96
 
92
97
  # O uno específico
93
- npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client cursor
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) son gratuitas.**
106
+ - Descubrir, inspeccionar, consultar estado, saldo y subir archivos también 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; `base_price: 0` significa gratis. Los precios pueden cambiar: confía en la respuesta real.
110
+
98
111
  ## Comandos
99
112
 
100
113
  ```sh
@@ -129,7 +142,7 @@ sandbase catalog --json # Listar clientes soportados
129
142
  ## Comenzar
130
143
 
131
144
  ```sh
132
- npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
145
+ npx -y @sandbaseai/cli@latest connect
133
146
  ```
134
147
 
135
148
  **[Crear cuenta gratis →](https://sandbase.ai)**
@@ -139,7 +152,7 @@ Si SandBase te ahorra tiempo de configuración, [dale una estrella al proyecto](
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/io.github.sandbaseai%2Fcli/versions/0.1.17)
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 https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
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 https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json
88
+ npx -y @sandbaseai/cli@latest catalog --json
81
89
  ```
82
90
 
83
- Cette commande utilise l’archive immuable de la version GitHub `v0.1.17`. SHA-256 :
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 https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
90
- npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client cursor
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) sont gratuites.**
103
+ - La découverte, l’inspection, le statut des exécutions, le solde et l’envoi de fichiers sont également 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 ; `base_price: 0` signifie gratuit. Les prix peuvent changer : fiez-vous à la réponse réelle.
107
+
95
108
  ## Commandes
96
109
 
97
110
  ```sh
@@ -126,7 +139,7 @@ sandbase catalog --json # Lister les clients
126
139
  ## Commencer
127
140
 
128
141
  ```sh
129
- npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
142
+ npx -y @sandbaseai/cli@latest connect
130
143
  ```
131
144
 
132
145
  **[Créer un compte gratuit →](https://sandbase.ai)**
@@ -136,7 +149,7 @@ Si SandBase vous fait gagner du temps de configuration, [ajoutez une étoile au
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/io.github.sandbaseai%2Fcli/versions/0.1.17)
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 https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
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 https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json
111
+ npx -y @sandbaseai/cli@latest catalog --json
104
112
  ```
105
113
 
106
- このコマンドは変更されない GitHub `v0.1.17` リリースアーカイブを使用します。SHA-256:
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 https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
118
+ npx -y @sandbaseai/cli@latest connect
114
119
 
115
120
  # 特定のクライアントを指定
116
- npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client cursor
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、金融)は無料。**
146
+ - discover、inspect、実行ステータス、残高、ファイルアップロードも無料。
147
+ - モデル(LLM、画像、動画、音声)は 1 回ごと、または 100 万トークンごとの課金。
148
+
149
+ `sandbase inspect <tool>` は常に現在の価格を表示します。`base_price: 0` は無料です。価格は変わるため、実際のレスポンスを信頼してください。
150
+
138
151
  ## コマンド
139
152
 
140
153
  ### CLIコマンド
@@ -184,7 +197,7 @@ discover → inspect → run
184
197
  ## 始めよう
185
198
 
186
199
  ```sh
187
- npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
200
+ npx -y @sandbaseai/cli@latest connect
188
201
  ```
189
202
 
190
203
  そして、エージェントに今までできなかったことを頼んでみてください。
@@ -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/io.github.sandbaseai%2Fcli/versions/0.1.17)
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 https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
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 https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json
88
+ npx -y @sandbaseai/cli@latest catalog --json
81
89
  ```
82
90
 
83
- 이 명령은 변경되지 않는 GitHub `v0.1.17` 릴리스 아카이브를 사용합니다. SHA-256:
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 https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
95
+ npx -y @sandbaseai/cli@latest connect
91
96
 
92
97
  # 특정 클라이언트 지정
93
- npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client cursor
98
+ npx -y @sandbaseai/cli@latest connect --client cursor
94
99
  ```
95
100
 
96
101
  ---
97
102
 
103
+ ## 가격
104
+
105
+ - **데이터 API(검색, 소셜, 스크래핑, 커머스, 금융)는 무료입니다.**
106
+ - discover, inspect, 실행 상태, 잔액, 파일 업로드도 무료입니다.
107
+ - 모델(LLM, 이미지, 비디오, 오디오)은 호출당 또는 100만 토큰당 과금됩니다.
108
+
109
+ `sandbase inspect <tool>`은 현재 가격을 보여 주며 `base_price: 0`은 무료를 뜻합니다. 가격은 변경될 수 있으니 실제 응답을 기준으로 하세요.
110
+
98
111
  ## 명령어
99
112
 
100
113
  ### CLI 명령어
@@ -131,7 +144,7 @@ sandbase catalog --json # 지원 클라이언트 목록
131
144
  ## 시작하기
132
145
 
133
146
  ```sh
134
- npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
147
+ npx -y @sandbaseai/cli@latest connect
135
148
  ```
136
149
 
137
150
  **[무료 계정 만들기 →](https://sandbase.ai)**
@@ -141,7 +154,7 @@ SandBase로 설정 시간을 절약했다면 [프로젝트에 Star를 남겨 주
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/io.github.sandbaseai%2Fcli/versions/0.1.17)
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 command. 2,000+ AI models and APIs.</strong>
4
+ <strong>Give your AI agent superpowers. One line. 2,000+ AI models and APIs — data APIs are free.</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 https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
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,46 @@ 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
- For a reproducible install, verify the immutable release archive before
47
- running it. The SHA-256 for `sandbaseai-cli-0.1.17.tgz` is
48
- `1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa`.
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
- curl -fL -o sandbaseai-cli-0.1.17.tgz \
52
- https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz
53
- echo '1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa sandbaseai-cli-0.1.17.tgz' | shasum -a 256 -c -
54
- npx -y ./sandbaseai-cli-0.1.17.tgz connect
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
- Approve the browser authorization once; each supported client can then discover,
58
- inspect, and run available SandBase models and APIs through the local MCP bridge.
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 https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json
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 v0.1.17 catalog audit showing 25 client targets" width="49%"></a>
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 v0.1.17 doctor failing closed for an empty isolated profile" width="49%"></a>
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>Evidence captured from the immutable v0.1.17 release: a no-write catalog audit and a bounded doctor check against an empty isolated profile.</sub></p>
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
- The npm `latest` tag currently serves v0.1.14 while tokenless trusted publishing is
77
- being enabled. The GitHub release tarball is built from the immutable `v0.1.17` tag;
78
- its SHA-256 is published with the release.
85
+ ## What It Costs
86
+
87
+ | | Price |
88
+ |---|---|
89
+ | **Data APIs** — search, social, scraping, e-commerce, finance | **Free** |
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
+ `base_price: 0` means the call is free. Prices can change, so trust the live
95
+ response over any example in this file.
79
96
 
80
97
  Visit the [official SandBase CLI project page](https://sandbaseai.github.io/cli/) for a compact overview.
81
98
  For a security-focused walkthrough of client detection, MCP tools, and rollback,
@@ -127,8 +144,8 @@ other catalog capabilities:
127
144
  1. Use `sandbase_discover` to find candidates by task or capability.
128
145
  2. Use `sandbase_inspect` to read the current input schema, pricing, and
129
146
  execution requirements.
130
- 3. Confirm the selected endpoint, parameters, and possible cost before calling
131
- `sandbase_run`.
147
+ 3. Confirm the selected endpoint and parameters before calling `sandbase_run`.
148
+ Data API calls are free; confirm the cost first when the tool is a model.
132
149
  4. For asynchronous work, use `sandbase_run_get` with the returned `run_id`
133
150
  instead of creating a duplicate run.
134
151
  5. Use `sandbase_runs` to review recent run status and recorded cost.
@@ -140,6 +157,9 @@ For example, start with a non-billable discovery request:
140
157
  > required inputs and current pricing for the best two candidates. Do not run
141
158
  > either model yet.
142
159
 
160
+ Discovery and inspection never cost anything, so an agent can always survey the
161
+ catalog before it spends.
162
+
143
163
  After reviewing the live response, explicitly approve the endpoint and inputs
144
164
  you want to run. Catalog entries, schemas, pricing, latency, and availability
145
165
  can change, so use the tool response from the current session rather than a
@@ -187,15 +207,15 @@ Works with every major AI coding tool:
187
207
  Preview the complete compatibility catalog without signing in or changing any files:
188
208
 
189
209
  ```sh
190
- npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json
210
+ npx -y @sandbaseai/cli@latest catalog --json
191
211
  ```
192
212
 
193
213
  ```sh
194
214
  # Connect all detected clients at once
195
- npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
215
+ npx -y @sandbaseai/cli@latest connect
196
216
 
197
217
  # Or target one specific client
198
- npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client cursor
218
+ npx -y @sandbaseai/cli@latest connect --client cursor
199
219
  ```
200
220
 
201
221
  ### OpenClaw quickstart
@@ -204,8 +224,8 @@ Target OpenClaw directly, then ask the CLI to read back the managed MCP server
204
224
  and SandBase Skill before you rely on them:
205
225
 
206
226
  ```sh
207
- npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client openclaw
208
- npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz doctor --client openclaw
227
+ npx -y @sandbaseai/cli@latest connect --client openclaw
228
+ npx -y @sandbaseai/cli@latest doctor --client openclaw
209
229
  ```
210
230
 
211
231
  After `doctor` reports the credential, MCP bridge, and Skill as configured,
@@ -215,7 +235,7 @@ leaves it untouched instead of overwriting it. To remove the managed MCP entry
215
235
  and local credential later:
216
236
 
217
237
  ```sh
218
- npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz unregister --client openclaw
238
+ npx -y @sandbaseai/cli@latest unregister --client openclaw
219
239
  ```
220
240
 
221
241
  OpenClaw currently exposes no supported Skill removal command, so `unregister`
@@ -227,8 +247,8 @@ SandBase can install both its managed Hermes Skill and local MCP entry in one
227
247
  authorization transaction:
228
248
 
229
249
  ```sh
230
- npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client hermes
231
- npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz doctor --client hermes
250
+ npx -y @sandbaseai/cli@latest connect --client hermes
251
+ npx -y @sandbaseai/cli@latest doctor --client hermes
232
252
  ```
233
253
 
234
254
  `doctor` verifies the owned local credential, MCP entry, and Skill. Restart
@@ -238,7 +258,7 @@ SandBase Skill or MCP tools. A pre-existing, non-SandBase MCP entry named
238
258
  Skill, and local credential while retaining the shared bridge for other clients:
239
259
 
240
260
  ```sh
241
- npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz unregister --client hermes
261
+ npx -y @sandbaseai/cli@latest unregister --client hermes
242
262
  ```
243
263
 
244
264
  The integration is independently listed by
@@ -286,6 +306,7 @@ sandbase inspect sandbase_twitter_web_search_timeline # fields, price, rea
286
306
  sandbase run sandbase_twitter_web_search_timeline -i '{"keyword":"AI agents"}'
287
307
  sandbase run <video_tool> -i '{"prompt":"..."}' -w -o result.json # wait with backoff, save output to disk
288
308
  sandbase runs get -r <run_id> -w -o result.json # resume a long run instead of re-running it
309
+ sandbase upload ./photo.png # local image/audio/video -> public URL for tools that take a URL
289
310
  sandbase runs list | sandbase balance
290
311
  ```
291
312
 
@@ -297,12 +318,13 @@ Sync tools (LLMs, most data APIs) return their result directly; async tools (ima
297
318
 
298
319
  | Tool | Purpose |
299
320
  |------|---------|
300
- | `sandbase_discover` | Search all 2,000+ available AI models and APIs |
301
- | `sandbase_inspect` | Get input schema, pricing, and ready-to-use template |
302
- | `sandbase_run` | Execute a model or API endpoint |
303
- | `sandbase_run_get` | Poll status/result of an async run (video gen, etc.) |
304
- | `sandbase_runs` | List your recent API calls with cost breakdown |
305
- | `sandbase_account` | Check account balance (free, no cost) |
321
+ | `sandbase_discover` | Search all 2,000+ available AI models and APIs — free |
322
+ | `sandbase_inspect` | Get input schema, current price, and a ready-to-run template — free |
323
+ | `sandbase_run` | Execute a model or API endpoint — free for data APIs, paid for models |
324
+ | `sandbase_run_get` | Poll status/result of an async run (video gen, etc.) — free |
325
+ | `sandbase_runs` | List your recent runs with their cost — free |
326
+ | `sandbase_account` | Check account balance — free |
327
+ | `sandbase_run_cancel` | Cancel an Agent Service run — free |
306
328
 
307
329
  **Recommended workflow:**
308
330
 
@@ -331,12 +353,12 @@ discover → inspect → run
331
353
  ## Get Started
332
354
 
333
355
  ```sh
334
- npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
356
+ npx -y @sandbaseai/cli@latest connect
335
357
  ```
336
358
 
337
359
  Then ask your agent to do something it couldn't before.
338
360
 
339
- **[Create a free account →](https://sandbase.ai)**
361
+ **[Create a free account →](https://sandbase.ai)** — data APIs are free to call.
340
362
 
341
363
  If SandBase saves you setup time, [star the repository](https://github.com/sandbaseai/cli) — it helps more agent users discover the project.
342
364
 
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 https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
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 https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json
88
+ npx -y @sandbaseai/cli@latest catalog --json
81
89
  ```
82
90
 
83
- Esse comando usa o arquivo imutável da versão `v0.1.17` no GitHub. SHA-256:
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 https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
95
+ npx -y @sandbaseai/cli@latest connect
91
96
 
92
97
  # Ou um cliente específico
93
- npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client cursor
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) são gratuitas.**
106
+ - Descobrir, inspecionar, status de execução, saldo e upload de arquivos também 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; `base_price: 0` significa gratuito. Preços mudam: confie na resposta real.
110
+
98
111
  ## Comandos
99
112
 
100
113
  ```sh
@@ -129,7 +142,7 @@ sandbase catalog --json # Listar clientes suportados
129
142
  ## Começar
130
143
 
131
144
  ```sh
132
- npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
145
+ npx -y @sandbaseai/cli@latest connect
133
146
  ```
134
147
 
135
148
  **[Criar conta grátis →](https://sandbase.ai)**
@@ -139,7 +152,7 @@ Se o SandBase economizou seu tempo de configuração, [dê uma estrela ao projet
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/io.github.sandbaseai%2Fcli/versions/0.1.17)
155
+ - [Registro MCP oficial](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sandbaseai%2Fcli)
143
156
 
144
157
  ## Licença
145
158