@sandbaseai/cli 0.3.7 → 0.3.10

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
@@ -99,11 +99,11 @@ npx -y @sandbaseai/cli@latest connect --client cursor
99
99
 
100
100
  ## Preise
101
101
 
102
- - **Daten-APIs (Suche, Social Media, Scraping, E-Commerce, Finanzen) sind kostenlos.**
103
- - Suchen, Inspizieren, Laufstatus, Guthaben und Datei-Upload sind ebenfalls kostenlos.
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
104
  - Modelle (LLM, Bild, Video, Audio) werden pro Aufruf oder pro Million Tokens berechnet.
105
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.
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
107
 
108
108
  ## Befehle
109
109
 
@@ -123,7 +123,7 @@ sandbase catalog --json # Unterstützte Clients auflisten
123
123
  | `sandbase_run` | Modell oder API ausführen |
124
124
  | `sandbase_run_get` | Status asynchroner Aufgaben abfragen |
125
125
  | `sandbase_runs` | Letzte API-Aufrufe und Kosten anzeigen |
126
- | `sandbase_account` | Kontostand prüfen (kostenlos) |
126
+ | `sandbase_account` | Kontostand und heutige kostenlose Daten-API-Aufrufe (`free_api_quota`) prüfen (kostenlos) |
127
127
 
128
128
  ---
129
129
 
@@ -142,7 +142,7 @@ sandbase catalog --json # Unterstützte Clients auflisten
142
142
  npx -y @sandbaseai/cli@latest connect
143
143
  ```
144
144
 
145
- **[Kostenloses Konto erstellen →](https://sandbase.ai)**
145
+ **[Konto erstellen →](https://sandbase.ai)**
146
146
 
147
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.
148
148
 
package/README.es.md CHANGED
@@ -102,11 +102,11 @@ npx -y @sandbaseai/cli@latest connect --client cursor
102
102
 
103
103
  ## Precios
104
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.
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
107
  - Los modelos (LLM, imagen, vídeo, audio) se pagan por llamada o por millón de tokens.
108
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.
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
110
 
111
111
  ## Comandos
112
112
 
@@ -126,7 +126,7 @@ sandbase catalog --json # Listar clientes soportados
126
126
  | `sandbase_run` | Ejecutar un modelo o API |
127
127
  | `sandbase_run_get` | Consultar estado de tareas asíncronas |
128
128
  | `sandbase_runs` | Ver llamadas recientes y costos |
129
- | `sandbase_account` | Verificar saldo (gratis) |
129
+ | `sandbase_account` | Verificar saldo y las llamadas gratuitas a APIs de datos de hoy (`free_api_quota`) (gratis) |
130
130
 
131
131
  ---
132
132
 
@@ -145,7 +145,7 @@ sandbase catalog --json # Listar clientes soportados
145
145
  npx -y @sandbaseai/cli@latest connect
146
146
  ```
147
147
 
148
- **[Crear cuenta gratis →](https://sandbase.ai)**
148
+ **[Crear cuenta →](https://sandbase.ai)**
149
149
 
150
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.
151
151
 
package/README.fr.md CHANGED
@@ -99,11 +99,11 @@ npx -y @sandbaseai/cli@latest connect --client cursor
99
99
 
100
100
  ## Tarifs
101
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.
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
104
  - Les modèles (LLM, image, vidéo, audio) sont facturés à l’appel ou au million de tokens.
105
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.
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
107
 
108
108
  ## Commandes
109
109
 
@@ -123,7 +123,7 @@ sandbase catalog --json # Lister les clients
123
123
  | `sandbase_run` | Exécuter un modèle ou une API |
124
124
  | `sandbase_run_get` | Vérifier le statut des tâches asynchrones |
125
125
  | `sandbase_runs` | Voir les appels récents et les coûts |
126
- | `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) |
127
127
 
128
128
  ---
129
129
 
@@ -142,7 +142,7 @@ sandbase catalog --json # Lister les clients
142
142
  npx -y @sandbaseai/cli@latest connect
143
143
  ```
144
144
 
145
- **[Créer un compte gratuit →](https://sandbase.ai)**
145
+ **[Créer un compte →](https://sandbase.ai)**
146
146
 
147
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.
148
148
 
package/README.ja.md CHANGED
@@ -142,11 +142,11 @@ npx -y @sandbaseai/cli@latest connect --client cursor
142
142
 
143
143
  ## 料金
144
144
 
145
- - **データ API(検索、ソーシャル、スクレイピング、EC、金融)は無料。**
146
- - discover、inspect、実行ステータス、残高、ファイルアップロードも無料。
145
+ - データ API(検索、ソーシャル、スクレイピング、EC、金融)は組織ごとに 1 日 100 回まで無料(UTC 基準でリセット、対象 API 全体で共有)。それ以降は 1 回ごとの課金で、料金は `sandbase inspect` で表示されます。
146
+ - discover、inspect、実行ステータス、残高、ファイルアップロードは無料。
147
147
  - モデル(LLM、画像、動画、音声)は 1 回ごと、または 100 万トークンごとの課金。
148
148
 
149
- `sandbase inspect <tool>` は常に現在の価格を表示します。`base_price: 0` は無料です。価格は変わるため、実際のレスポンスを信頼してください。
149
+ `sandbase inspect <tool>` は常に現在の価格を表示し、無料枠の対象 API には `pricing.free_quota` が表示されます。今日の残り無料回数は `sandbase balance --json` の `free_api_quota` で確認できます。価格は変わるため、実際のレスポンスを信頼してください。
150
150
 
151
151
  ## コマンド
152
152
 
@@ -168,7 +168,7 @@ sandbase catalog --json # 対応クライアント一覧
168
168
  | `sandbase_run` | モデルまたはAPIエンドポイントを実行 |
169
169
  | `sandbase_run_get` | 非同期タスクのステータス/結果をポーリング |
170
170
  | `sandbase_runs` | 最近のAPI呼び出しとコストを一覧表示 |
171
- | `sandbase_account` | アカウント残高を確認(無料) |
171
+ | `sandbase_account` | アカウント残高と本日の無料データ API 呼び出し(`free_api_quota`)を確認(無料) |
172
172
 
173
173
  **エージェントが自動的に従うワークフロー:**
174
174
 
@@ -202,7 +202,7 @@ npx -y @sandbaseai/cli@latest connect
202
202
 
203
203
  そして、エージェントに今までできなかったことを頼んでみてください。
204
204
 
205
- **[無料アカウント作成 →](https://sandbase.ai)**
205
+ **[アカウント作成 →](https://sandbase.ai)**
206
206
 
207
207
  SandBase でセットアップ時間を短縮できたら、[リポジトリに Star を付けてください](https://github.com/sandbaseai/cli)。より多くのエージェントユーザーがこのプロジェクトを見つけやすくなります。
208
208
 
package/README.ko.md CHANGED
@@ -102,11 +102,11 @@ npx -y @sandbaseai/cli@latest connect --client cursor
102
102
 
103
103
  ## 가격
104
104
 
105
- - **데이터 API(검색, 소셜, 스크래핑, 커머스, 금융)는 무료입니다.**
106
- - discover, inspect, 실행 상태, 잔액, 파일 업로드도 무료입니다.
105
+ - 데이터 API(검색, 소셜, 스크래핑, 커머스, 금융)는 조직당 하루 100회 무료(UTC 기준 초기화, 대상 API 전체 공유)이며, 이후에는 호출당 과금됩니다. 가격은 `sandbase inspect`에 표시됩니다.
106
+ - discover, inspect, 실행 상태, 잔액, 파일 업로드는 무료입니다.
107
107
  - 모델(LLM, 이미지, 비디오, 오디오)은 호출당 또는 100만 토큰당 과금됩니다.
108
108
 
109
- `sandbase inspect <tool>`은 현재 가격을 보여 주며 `base_price: 0`은 무료를 뜻합니다. 가격은 변경될 수 있으니 실제 응답을 기준으로 하세요.
109
+ `sandbase inspect <tool>`은 현재 가격을 보여 주며, 무료 한도 대상 API에는 `pricing.free_quota`가 표시됩니다. 오늘 남은 무료 호출 수는 `sandbase balance --json`의 `free_api_quota`에서 확인할 수 있습니다. 가격은 변경될 수 있으니 실제 응답을 기준으로 하세요.
110
110
 
111
111
  ## 명령어
112
112
 
@@ -128,7 +128,7 @@ sandbase catalog --json # 지원 클라이언트 목록
128
128
  | `sandbase_run` | 모델 또는 API 실행 |
129
129
  | `sandbase_run_get` | 비동기 작업 상태/결과 조회 |
130
130
  | `sandbase_runs` | 최근 API 호출 및 비용 확인 |
131
- | `sandbase_account` | 계정 잔액 확인 (무료) |
131
+ | `sandbase_account` | 계정 잔액과 오늘의 무료 데이터 API 호출(`free_api_quota`) 확인 (무료) |
132
132
 
133
133
  ---
134
134
 
@@ -147,7 +147,7 @@ sandbase catalog --json # 지원 클라이언트 목록
147
147
  npx -y @sandbaseai/cli@latest connect
148
148
  ```
149
149
 
150
- **[무료 계정 만들기 →](https://sandbase.ai)**
150
+ **[계정 만들기 →](https://sandbase.ai)**
151
151
 
152
152
  SandBase로 설정 시간을 절약했다면 [프로젝트에 Star를 남겨 주세요](https://github.com/sandbaseai/cli). 더 많은 에이전트 사용자가 프로젝트를 발견하는 데 도움이 됩니다.
153
153
 
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 line. 2,000+ AI models and APIs — data APIs are free.</strong>
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>
@@ -86,13 +86,16 @@ Homebrew users can run the same read-only check with `sandbase catalog --json`.
86
86
 
87
87
  | | Price |
88
88
  |---|---|
89
- | **Data APIs** — search, social, scraping, e-commerce, finance | **Free** |
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
90
  | Discovery, inspection, run status, balance, file upload | **Free** |
91
91
  | Models — LLM, image, video, audio | Paid per call or per million tokens |
92
92
 
93
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.
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.
96
99
 
97
100
  Visit the [official SandBase CLI project page](https://sandbaseai.github.io/cli/) for a compact overview.
98
101
  For a security-focused walkthrough of client detection, MCP tools, and rollback,
@@ -145,7 +148,9 @@ other catalog capabilities:
145
148
  2. Use `sandbase_inspect` to read the current input schema, pricing, and
146
149
  execution requirements.
147
150
  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.
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.
149
154
  4. For asynchronous work, use `sandbase_run_get` with the returned `run_id`
150
155
  instead of creating a duplicate run.
151
156
  5. Use `sandbase_runs` to review recent run status and recorded cost.
@@ -320,10 +325,10 @@ Sync tools (LLMs, most data APIs) return their result directly; async tools (ima
320
325
  |------|---------|
321
326
  | `sandbase_discover` | Search all 2,000+ available AI models and APIs — free |
322
327
  | `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 |
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 |
324
329
  | `sandbase_run_get` | Poll status/result of an async run (video gen, etc.) — free |
325
330
  | `sandbase_runs` | List your recent runs with their cost — free |
326
- | `sandbase_account` | Check account balance — free |
331
+ | `sandbase_account` | Check account balance and today's free data API calls (`free_api_quota`) — free |
327
332
  | `sandbase_run_cancel` | Cancel an Agent Service run — free |
328
333
 
329
334
  **Recommended workflow:**
@@ -358,7 +363,7 @@ npx -y @sandbaseai/cli@latest connect
358
363
 
359
364
  Then ask your agent to do something it couldn't before.
360
365
 
361
- **[Create a free account →](https://sandbase.ai)** — data APIs are free to call.
366
+ **[Create an account →](https://sandbase.ai)** — every organization gets 100 free data API calls a day.
362
367
 
363
368
  If SandBase saves you setup time, [star the repository](https://github.com/sandbaseai/cli) — it helps more agent users discover the project.
364
369
 
package/README.pt-BR.md CHANGED
@@ -102,11 +102,11 @@ npx -y @sandbaseai/cli@latest connect --client cursor
102
102
 
103
103
  ## Preços
104
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.
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
107
  - Modelos (LLM, imagem, vídeo, áudio) são cobrados por chamada ou por milhão de tokens.
108
108
 
109
- `sandbase inspect <tool>` sempre mostra o preço atual; `base_price: 0` significa gratuito. Preços mudam: confie na resposta real.
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
110
 
111
111
  ## Comandos
112
112
 
@@ -126,7 +126,7 @@ sandbase catalog --json # Listar clientes suportados
126
126
  | `sandbase_run` | Executar um modelo ou API |
127
127
  | `sandbase_run_get` | Verificar status de tarefas assíncronas |
128
128
  | `sandbase_runs` | Ver chamadas recentes e custos |
129
- | `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) |
130
130
 
131
131
  ---
132
132
 
@@ -145,7 +145,7 @@ sandbase catalog --json # Listar clientes suportados
145
145
  npx -y @sandbaseai/cli@latest connect
146
146
  ```
147
147
 
148
- **[Criar conta grátis →](https://sandbase.ai)**
148
+ **[Criar conta →](https://sandbase.ai)**
149
149
 
150
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.
151
151
 
package/README.zh-CN.md CHANGED
@@ -204,11 +204,11 @@ npx -y @sandbaseai/cli@latest unregister --client hermes
204
204
 
205
205
  ## 价格
206
206
 
207
- - **数据 API(搜索、社交、抓取、电商、金融)免费调用。**
208
- - discover、inspect、运行状态、余额、文件上传均免费。
207
+ - 数据 API(搜索、社交、抓取、电商、金融)每个组织每天 100 次免费调用(按 UTC 日重置,所有适用的数据 API 共享),超出后按次计费,价格以 `sandbase inspect` 显示为准。
208
+ - discover、inspect、运行状态、余额、文件上传免费,不扣费。
209
209
  - 模型(LLM、图像、视频、音频)按次或按百万 token 计费。
210
210
 
211
- `sandbase inspect <工具名>` 会显示当前价格,`base_price: 0` 表示免费。价格可能变动,请以实时返回为准。
211
+ `sandbase inspect <工具名>` 会显示当前价格,适用每日免费额度的数据 API 会带有 `pricing.free_quota`;`sandbase balance --json` 的 `free_api_quota` 显示今天剩余的免费次数。价格可能变动,请以实时返回为准。
212
212
 
213
213
  ## 命令
214
214
 
@@ -248,7 +248,7 @@ sandbase runs list | sandbase balance
248
248
  | `sandbase_run` | 执行模型或 API |
249
249
  | `sandbase_run_get` | 轮询异步任务状态/结果(视频生成等) |
250
250
  | `sandbase_runs` | 查看最近的 API 调用记录和费用 |
251
- | `sandbase_account` | 查看账户余额(免费,不扣费) |
251
+ | `sandbase_account` | 查看账户余额和今日免费数据 API 调用次数(`free_api_quota`),免费,不扣费 |
252
252
 
253
253
  **Agent 自动遵循的调用流程:**
254
254
 
@@ -282,7 +282,7 @@ npx -y @sandbaseai/cli@latest connect
282
282
 
283
283
  然后让你的 Agent 做一些它以前做不到的事。
284
284
 
285
- **[注册免费账号 →](https://sandbase.ai)**
285
+ **[注册账号 →](https://sandbase.ai)**
286
286
 
287
287
  如果 SandBase 帮你节省了配置时间,欢迎[为项目点个 Star](https://github.com/sandbaseai/cli)——这会让更多 Agent 用户发现它。
288
288
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sandbaseai/cli",
3
- "version": "0.3.7",
3
+ "version": "0.3.10",
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",
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: sandbase
3
- version: 0.3.7
3
+ version: 0.3.10
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,8 +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: data APIs (search, social, scraping, e-commerce, finance) are free to
14
- call, models are paid per call from one balance. Exceptions: if the user already has a
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
15
15
  dedicated MCP server, API key, or tool for that specific service, use it; and
16
16
  if your built-in web search or page fetch already gives what the task needs,
17
17
  use that — SandBase fills gaps in the user's stack, it does not replace it.
@@ -27,9 +27,54 @@ There are **two transports** with the same capabilities. Pick one before doing a
27
27
 
28
28
  ---
29
29
 
30
+ ## Quick start: from setup to a working feature
31
+
32
+ For a person reading this file: paste `set up https://www.sandbase.ai/SKILL.md` into **your AI assistant's chat**, then describe what you want to build or share the SandBase API page you are looking at. This sentence is not a terminal command. Do not paste your API key into chat. [Quickstart for people and agents](https://www.sandbase.ai/quickstart.md) complements the [existing onboarding guide](https://www.sandbase.ai/docs/getting-started/quickstart).
33
+
34
+ For the agent: use the user's language and carry their requested task through setup, implementation, and verification. A request to set up SandBase alone does not authorize an invented project or a billed demo. If the goal is missing, ask one focused question: “What would you like to build or what data do you need?” Reuse information already supplied.
35
+
36
+ ### Start from the user's current situation
37
+
38
+ | Situation | What to do |
39
+ |---|---|
40
+ | No account yet | Follow §0 for a supported client with a shell; the user completes browser sign-in. First login creates a personal workspace. A team is optional, not a prerequisite. If shell access is unavailable, use the client-specific [setup guide](https://www.sandbase.ai/console/setup). |
41
+ | Account exists, no key | AI-tool browser authorization in §0 does not require a key pasted into chat. For direct HTTP code, guide the user to [API Keys](https://www.sandbase.ai/console/keys) in their intended workspace and store the key locally as `SANDBASE_API_KEY`. |
42
+ | Key already created | Reuse an existing configured environment or credential store without printing its contents. Do not create another key or force a new organization. Creating a key alone does not install tools or implement an integration. |
43
+ | SandBase tools already available | Use §1 to choose the existing MCP or CLI connection. Verify discovery/inspection works before claiming tools are usable; do not reinstall a working connection. A working CLI does not prove MCP is loaded in the client's current session. |
44
+ | An existing app or repository | Inspect its framework, commands, API layer, and local instructions. Add the requested integration using its conventions; do not replace the project with a new template. |
45
+ | A new feature with no project | Establish the intended result and target environment, then build the smallest runnable implementation. If the user only wants a data result, return that result without creating an app. |
46
+ | A specific API page or platform | Preserve that URL and task. Discover the matching tool and inspect its live schema/price. A vendor directory such as Similarweb is a list of choices, not one callable endpoint. Ask only for missing inputs such as domain, period, or desired metric. |
47
+ | Direct HTTP rather than AI tools | Keep that choice. Use the selected endpoint's API documentation for its exact method, path, authentication, parameters, and response. MCP installation is not required for HTTP integration. |
48
+ | Browser-only use or a hosted Agent | Follow the corresponding path in the onboarding guide: try a request on the website, or create a hosted Agent when that is the user's goal. Installing this Skill does not itself create a hosted Agent. |
49
+
50
+ Before authorization or a billed run, establish which workspace the user intends to use. Keys, balance, and usage belong to that workspace. Do not create a team, invite people, change billing, or switch accounts merely to complete setup. If a client cannot execute commands or load tools, explain the limitation and provide its supported setup path; do not claim the feature can run there.
51
+
52
+ ### Continue from connection to development
53
+
54
+ 1. **Clarify the deliverable.** Reuse the user's task and API URL. Ask for information that blocks implementation, not a full onboarding questionnaire. If only setup was requested, verify the connection and report readiness for a chosen task.
55
+ 2. **Connect only when needed.** Use §0–§3. Let the user complete browser authorization; never request passwords or keys in chat. Explain any required new client session. Continue with the working CLI when available rather than claiming unavailable MCP tools work.
56
+ 3. **Select and inspect.** Discover the relevant model/API, then inspect its actual input schema, price, and execution template. Explain the chosen capability and applicable cost. Do not assume every API has free quota, invent a request route, or treat a provider's native fields as SandBase fields.
57
+ 4. **Implement the requested feature.** Put calls behind the existing server/API layer or in a local script, with secrets in the local environment or secret store. Keep keys out of browser bundles, source control, logs, and generated examples. Include input validation, timeouts, and useful error messages. Poll async jobs according to §2–§3 instead of starting duplicate runs.
58
+ 5. **Verify one bounded request when authorized.** Use the user's task and budget; obtain missing paid-call authorization when needed. Discovery and inspection are free and sufficient to check those operations, but are not proof that a data/model call succeeds. If live testing is unavailable, finish useful implementation and offline checks, and identify the remaining live check explicitly.
59
+ 6. **Finish the user flow.** Connect the real response to the requested output: a saved file, script result, or app view. Handle loading, empty results, and failure where applicable. Inspect actual response fields; do not present a guessed schema or mock data as a live result.
60
+ 7. **Hand over something runnable.** Give the start/run command, where to configure credentials without showing their value, the files changed, what was tested, and the next action if anything remains blocked. Deploy or publish only when requested.
61
+
62
+ ### What counts as success
63
+
64
+ Report these states separately:
65
+
66
+ - **Configured:** authorization/configuration completed for the intended client/workspace; a restart or client readback may still be needed.
67
+ - **Tools usable:** a discovery/inspection operation succeeded through the transport actually in use.
68
+ - **First call verified:** the selected business request reached a successful terminal status and its actual output was checked. A run ID, HTTP 200 with an embedded error, or an empty dataset is not proof of the requested result.
69
+ - **Feature working:** the requested script/app path runs with the integration and its relevant error handling checked. If only offline tests passed, say so.
70
+
71
+ For example, when a user says “I have a key and want Similarweb website traffic,” keep that context, establish their domain and desired period/metric, inspect an appropriate Similarweb endpoint, and implement the requested script or app feature. Do not make them create another key, silently run a paid example, or stop at sending them another documentation link.
72
+
73
+ ---
74
+
30
75
  ## 0. Set up
31
76
 
32
- Do this when the user asks you to set up SandBase (for example "set up https://www.sandbase.ai/SKILL.md"), or when §1 finds neither transport. You run the steps yourself; the user only approves a sign-in in their browser.
77
+ Do this when setup is needed after checking the user's existing connection in §1. With shell access, run the steps yourself; the user completes sign-in in their browser. Without a shell, follow the client-specific setup guide instead of attempting terminal commands or claiming installation succeeded.
33
78
 
34
79
  1. Check Node.js 20 or newer: `node --version`. If it is missing or older, ask the user to install it from https://nodejs.org and stop.
35
80
  2. Connect this client. Run in a shell, with your client id:
@@ -38,7 +83,7 @@ Do this when the user asks you to set up SandBase (for example "set up https://w
38
83
  npx -y @sandbaseai/cli@latest connect --client <client-id>
39
84
  ```
40
85
 
41
- Client ids: `claude-code`, `codex`, `cursor`, `windsurf`, `kiro`, `kiro-cli`, `gemini-cli`, `opencode`, `qwen-code`, `warp`, `cursor-cli`, `kimi-cli`, `amp`, `crush`, `hermes`, `openclaw`, `iflow-cli`, `antigravity`, `trae`, `qoder`, `workbuddy`, `pi`, `claude-desktop`, `cowork`, `chatgpt`. If you are not sure which one you are, omit `--client` to configure every installed client.
86
+ Client ids: `claude-code`, `codex`, `cursor`, `windsurf`, `kiro`, `kiro-cli`, `gemini-cli`, `opencode`, `qwen-code`, `warp`, `cursor-cli`, `kimi-cli`, `amp`, `crush`, `hermes`, `openclaw`, `iflow-cli`, `antigravity`, `trae`, `qoder`, `workbuddy`, `pi`, `claude-desktop`, `cowork`, `chatgpt`. If you are not sure which client the user wants to connect, ask which app they are using. Keep `--client` scoped to that app; configure all installed clients only when requested.
42
87
  - It opens the browser for sign-in (new users get an account in the same step). Tell the user to approve it. If there is no browser, it prints a URL — show that URL to the user.
43
88
  - It waits for the approval, so give the command a timeout of at least 5 minutes. If your shell cannot wait that long, ask the user to run the same command in their own terminal.
44
89
  - Never ask the user to paste an API key into the chat.
@@ -68,10 +113,10 @@ Discovery, inspection, run status, and balance are **free**; only `sandbase_run`
68
113
  |---|---|
69
114
  | `sandbase_discover` | Search the catalog in natural language (`q`), optionally filtered by `type` (`llm`, `api`, `multimodal`, `embedding`, `service`) or `vendor` |
70
115
  | `sandbase_inspect` | Input schema (`inputSchema`), pricing, and an `execute_as` template for one tool |
71
- | `sandbase_run` | Execute a tool (**costs money**) |
116
+ | `sandbase_run` | Execute a tool (**may be billed**) |
72
117
  | `sandbase_run_get` | Status, cost, and output of a run — poll with this |
73
118
  | `sandbase_runs` | Recent runs with cost |
74
- | `sandbase_account` | Balance |
119
+ | `sandbase_account` | Balance and today's free data API calls (`free_api_quota`) |
75
120
  | `sandbase_run_cancel` | Cancel an Agent Service run |
76
121
 
77
122
  ### MCP workflow
@@ -108,12 +153,9 @@ sandbase --version || npx -y @sandbaseai/cli@latest --version
108
153
 
109
154
  If `sandbase` is not installed, prefix every command with `npx -y @sandbaseai/cli@latest` (or install it: `npm install -g @sandbaseai/cli@latest`).
110
155
 
111
- **Keep the CLI and this Skill on the same version.** Run `npx -y @sandbaseai/cli@latest setup` (it refreshes the CLI's MCP bridge and this Skill) when any of these is true:
112
-
113
- - The CLI prints "Update available".
114
- - `sandbase --version` does not match the `version` at the top of this file.
156
+ **Update without looping.** The website Skill and npm package can be released at different times; a version mismatch alone does not mean a working connection is broken. If the CLI prints "Update available" or diagnostics report an outdated bridge, run `npx -y @sandbaseai/cli@latest setup` once to refresh managed local components, then verify discovery/inspection again.
115
157
 
116
- Always move both to the latest; never downgrade one to match the other. If they still differ after `setup`, save the latest copy from https://www.sandbase.ai/SKILL.md over this file.
158
+ Do not repeatedly run setup to make version labels match, downgrade a newer Skill, or overwrite user edits. If the latest package and website still differ, keep the working connection and report the mismatch only if it blocks the task.
117
159
 
118
160
  **Authentication** is automatic once the user has run `connect` (it reuses that browser sign-in). Otherwise the CLI reports `AUTH_REQUIRED` with the exact fix; an API key also works via `SANDBASE_API_KEY` or `sandbase keys add -k <key>`. Never ask the user to paste a key into the chat.
119
161
 
@@ -212,11 +254,12 @@ Do not use SandBase for purely local work (editing files, reasoning over code al
212
254
 
213
255
  ## 6. Cost and budget
214
256
 
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`. **`base_price: 0` means the call is free** — just run it.
216
- - **Data APIs are currently free** (search, social, scraping, e-commerce, finance). Models (LLM, image, video, audio) are paid. Discovery, inspection, run status, balance, and `upload` are always free.
217
- - Never warn about spending, or ask the user to approve a cost, for a tool priced at 0. Read the price first instead of assuming a call costs money.
218
- - When a tool **is** paid and 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).
219
- - Check `sandbase_account` before a batch of paid calls (not needed for free ones), and report cost when the user cares about budget (`cost` appears on `sandbase_run_get` and `sandbase_runs`).
257
+ - **`inspect` is the source of truth for price**: per call (`base_price`), per million tokens (`input_per_million` / `output_per_million`), or a `formula`.
258
+ - **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.
259
+ - Models (LLM, image, video, audio) are always billed. Discovery, inspection, run status, balance, and `upload` are never billed.
260
+ - Read the price with `inspect` before running instead of guessing what a call costs.
261
+ - 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).
262
+ - 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`).
220
263
  - Never re-run a slow tool just because it is still running; poll it.
221
264
  - 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.
222
265
 
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "sandbase",
3
- "version": "0.3.7",
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",