From b3b8ee3bef96c24427df434f9b915989f09ece34 Mon Sep 17 00:00:00 2001 From: liyb Date: Tue, 13 Oct 2026 00:29:55 +0800 Subject: [PATCH] docs: data APIs are free, drop v0.1.17 pins, lead with the agent one-liner (0.3.7) --- README.de.md | 33 ++++++++---- README.es.md | 33 ++++++++---- README.fr.md | 33 ++++++++---- README.ja.md | 33 ++++++++---- README.ko.md | 33 ++++++++---- README.md | 103 ++++++++++++++++++++++--------------- README.pt-BR.md | 33 ++++++++---- README.zh-CN.md | 58 ++++++++++++--------- SECURITY.md | 8 +-- SUPPORT.md | 2 +- llms-install.md | 16 +++--- package-lock.json | 4 +- package.json | 2 +- server.json | 4 +- skills/sandbase/SKILL.md | 13 +++-- skills/sandbase/skill.json | 2 +- test/agent.test.ts | 2 +- 17 files changed, 263 insertions(+), 149 deletions(-) diff --git a/README.de.md b/README.de.md index 680c57f..997814e 100644 --- a/README.de.md +++ b/README.de.md @@ -25,8 +25,16 @@ Dein KI-Coding-Assistent ist schlau, aber in einer Box gefangen. Er kann nicht i **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. +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: + +``` +set up https://www.sandbase.ai/SKILL.md +``` + +Wenn du es selbst machen willst: + ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect +npx -y @sandbaseai/cli@latest connect ``` 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 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: ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json +npx -y @sandbaseai/cli@latest catalog --json ``` -Der Befehl verwendet das unveränderliche GitHub-Release-Archiv `v0.1.17`. SHA-256-Prüfsumme: -`1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa` - -Das npm-Tag `latest` verweist derzeit noch auf v0.1.14. Verwende bis zur Aktivierung von Trusted Publishing die oben angegebene versionierte GitHub-URL. +Jedes GitHub-Release veröffentlicht seinen eigenen SHA-256, sodass du einen exakten Build pinnen und prüfen kannst. ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client cursor +npx -y @sandbaseai/cli@latest connect +npx -y @sandbaseai/cli@latest connect --client cursor ``` --- +## Preise + +- **Daten-APIs (Suche, Social Media, Scraping, E-Commerce, Finanzen) sind kostenlos.** +- Suchen, Inspizieren, Laufstatus, Guthaben und Datei-Upload sind ebenfalls kostenlos. +- Modelle (LLM, Bild, Video, Audio) werden pro Aufruf oder pro Million Tokens berechnet. + +`sandbase inspect ` zeigt immer den aktuellen Preis; `base_price: 0` heißt kostenlos. Preise können sich ändern — verlasse dich auf die echte Antwort. + ## Befehle ```sh @@ -126,7 +139,7 @@ sandbase catalog --json # Unterstützte Clients auflisten ## Loslegen ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect +npx -y @sandbaseai/cli@latest connect ``` **[Kostenloses Konto erstellen →](https://sandbase.ai)** @@ -136,7 +149,7 @@ Wenn SandBase dir Einrichtungszeit spart, [gib dem Projekt einen Star](https://g ## Praktische Anleitung - [Claude Code und Codex: entdecken, Preis prüfen und ausführen](https://github.com/sandbaseai/cli/discussions/53) -- [Offizielle MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.sandbaseai%2Fcli/versions/0.1.17) +- [Offizielle MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sandbaseai%2Fcli) ## Lizenz diff --git a/README.es.md b/README.es.md index 1190279..0a26128 100644 --- a/README.es.md +++ b/README.es.md @@ -25,8 +25,16 @@ Tu asistente de codificación IA es inteligente, pero está atrapado en una caja **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. +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: + +``` +set up https://www.sandbase.ai/SKILL.md +``` + +Si prefieres hacerlo tú: + ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect +npx -y @sandbaseai/cli@latest connect ``` 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 ¿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: ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json +npx -y @sandbaseai/cli@latest catalog --json ``` -Este comando usa el archivo inmutable de la versión `v0.1.17` en GitHub. SHA-256: -`1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa` - -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. +Cada versión de GitHub publica su propio SHA-256, así que puedes fijar y verificar una compilación exacta. ```sh # Conectar todos los clientes detectados -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect +npx -y @sandbaseai/cli@latest connect # O uno específico -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client cursor +npx -y @sandbaseai/cli@latest connect --client cursor ``` --- +## Precios + +- **Las APIs de datos (búsqueda, redes sociales, scraping, e-commerce, finanzas) son gratuitas.** +- Descubrir, inspeccionar, consultar estado, saldo y subir archivos también es gratis. +- Los modelos (LLM, imagen, vídeo, audio) se pagan por llamada o por millón de tokens. + +`sandbase inspect ` muestra siempre el precio actual; `base_price: 0` significa gratis. Los precios pueden cambiar: confía en la respuesta real. + ## Comandos ```sh @@ -129,7 +142,7 @@ sandbase catalog --json # Listar clientes soportados ## Comenzar ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect +npx -y @sandbaseai/cli@latest connect ``` **[Crear cuenta gratis →](https://sandbase.ai)** @@ -139,7 +152,7 @@ Si SandBase te ahorra tiempo de configuración, [dale una estrella al proyecto]( ## Guía práctica - [Claude Code y Codex: descubre, comprueba el precio y ejecuta modelos o API](https://github.com/sandbaseai/cli/discussions/50) -- [Registro MCP oficial](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.sandbaseai%2Fcli/versions/0.1.17) +- [Registro MCP oficial](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sandbaseai%2Fcli) ## Licencia diff --git a/README.fr.md b/README.fr.md index ea15538..46fac89 100644 --- a/README.fr.md +++ b/README.fr.md @@ -25,8 +25,16 @@ Votre assistant de codage IA est intelligent, mais il est enfermé dans une boî **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. +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 : + +``` +set up https://www.sandbase.ai/SKILL.md +``` + +Pour le faire vous-même : + ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect +npx -y @sandbaseai/cli@latest connect ``` 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 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 : ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json +npx -y @sandbaseai/cli@latest catalog --json ``` -Cette commande utilise l’archive immuable de la version GitHub `v0.1.17`. SHA-256 : -`1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa` - -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. +Chaque version GitHub publie son propre SHA-256 : vous pouvez donc épingler et vérifier une archive exacte. ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client cursor +npx -y @sandbaseai/cli@latest connect +npx -y @sandbaseai/cli@latest connect --client cursor ``` --- +## Tarifs + +- **Les API de données (recherche, réseaux sociaux, scraping, e-commerce, finance) sont gratuites.** +- La découverte, l’inspection, le statut des exécutions, le solde et l’envoi de fichiers sont également gratuits. +- Les modèles (LLM, image, vidéo, audio) sont facturés à l’appel ou au million de tokens. + +`sandbase inspect ` affiche toujours le prix actuel ; `base_price: 0` signifie gratuit. Les prix peuvent changer : fiez-vous à la réponse réelle. + ## Commandes ```sh @@ -126,7 +139,7 @@ sandbase catalog --json # Lister les clients ## Commencer ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect +npx -y @sandbaseai/cli@latest connect ``` **[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 ## Guide pratique - [Claude Code et Codex : découvrir, vérifier le prix, puis exécuter](https://github.com/sandbaseai/cli/discussions/52) -- [Registre MCP officiel](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.sandbaseai%2Fcli/versions/0.1.17) +- [Registre MCP officiel](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sandbaseai%2Fcli) ## Licence diff --git a/README.ja.md b/README.ja.md index 01dfa3e..dddbe7a 100644 --- a/README.ja.md +++ b/README.ja.md @@ -25,8 +25,16 @@ **SandBaseがそれを変えます。** 1コマンドで、[Model Context Protocol](https://modelcontextprotocol.io)を通じてエージェントを2,000以上のAIモデルとAPIに接続。APIキー管理不要。設定の手間なし。 +この 1 行をエージェントに渡すと、Skill を読み込み `connect` まで自分で実行します。ブラウザでの承認だけお願いします： + +``` +set up https://www.sandbase.ai/SKILL.md +``` + +自分で実行する場合： + ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect +npx -y @sandbaseai/cli@latest connect ``` macOS または Linux では、公式 Homebrew Formula も利用できます： @@ -100,20 +108,17 @@ sandbase connect サインインやファイル変更なしで、完全な互換性カタログを確認できます： ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json +npx -y @sandbaseai/cli@latest catalog --json ``` -このコマンドは変更されない GitHub `v0.1.17` リリースアーカイブを使用します。SHA-256： -`1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa` - -npm の `latest` は現在も v0.1.14 のため、Trusted Publishing が有効になるまでは上記のバージョン固定 GitHub URL を使用してください。 +各 GitHub リリースには SHA-256 が併記されており、特定バージョンに固定して検証できます。 ```sh # 検出されたすべてのクライアントを一度に接続 -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect +npx -y @sandbaseai/cli@latest connect # 特定のクライアントを指定 -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client cursor +npx -y @sandbaseai/cli@latest connect --client cursor ``` --- @@ -135,6 +140,14 @@ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cl --- +## 料金 + +- **データ API（検索、ソーシャル、スクレイピング、EC、金融）は無料。** +- discover、inspect、実行ステータス、残高、ファイルアップロードも無料。 +- モデル（LLM、画像、動画、音声）は 1 回ごと、または 100 万トークンごとの課金。 + +`sandbase inspect ` は常に現在の価格を表示します。`base_price: 0` は無料です。価格は変わるため、実際のレスポンスを信頼してください。 + ## コマンド ### CLIコマンド @@ -184,7 +197,7 @@ discover → inspect → run ## 始めよう ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect +npx -y @sandbaseai/cli@latest connect ``` そして、エージェントに今までできなかったことを頼んでみてください。 @@ -200,7 +213,7 @@ SandBase でセットアップ時間を短縮できたら、[リポジトリに - [SandBase プラットフォーム](https://sandbase.ai) - [ドキュメント](https://www.sandbase.ai/docs/) - [Claude Code・Codex向け実践チュートリアル](https://github.com/sandbaseai/cli/discussions/49) -- [公式 MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.sandbaseai%2Fcli/versions/0.1.17) +- [公式 MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sandbaseai%2Fcli) - [npm パッケージ](https://www.npmjs.com/package/@sandbaseai/cli) - [ダッシュボード](https://sandbase.ai/console) diff --git a/README.ko.md b/README.ko.md index 0a21268..7789456 100644 --- a/README.ko.md +++ b/README.ko.md @@ -25,8 +25,16 @@ AI 코딩 어시스턴트는 똑똑하지만 상자 안에 갇혀 있습니다. **SandBase가 이를 바꿉니다.** 한 줄 명령어로 에이전트를 2,000개 이상의 AI 모델과 API에 [MCP](https://modelcontextprotocol.io)를 통해 연결합니다. API 키 관리 불필요. 설정 고민 없음. +이 한 줄을 에이전트에 붙여넣으면 Skill을 읽고 `connect`까지 직접 실행합니다. 브라우저 로그인만 승인해 주세요: + +``` +set up https://www.sandbase.ai/SKILL.md +``` + +직접 실행하려면: + ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect +npx -y @sandbaseai/cli@latest connect ``` macOS 또는 Linux에서는 공식 Homebrew Formula로 설치할 수도 있습니다. @@ -77,24 +85,29 @@ sandbase connect 로그인하거나 로컬 설정을 변경하지 않고 먼저 호환성만 확인하려면 읽기 전용 카탈로그 명령으로 현재 지원되는 25개 클라이언트를 확인하세요: ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json +npx -y @sandbaseai/cli@latest catalog --json ``` -이 명령은 변경되지 않는 GitHub `v0.1.17` 릴리스 아카이브를 사용합니다. SHA-256: -`1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa` - -npm의 `latest` 태그는 아직 v0.1.14이므로 Trusted Publishing이 활성화될 때까지 위의 버전 고정 GitHub URL을 사용하세요. +모든 GitHub 릴리스는 SHA-256을 함께 게시하므로 특정 버전에 고정해 검증할 수 있습니다. ```sh # 감지된 모든 클라이언트 한번에 연결 -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect +npx -y @sandbaseai/cli@latest connect # 특정 클라이언트 지정 -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client cursor +npx -y @sandbaseai/cli@latest connect --client cursor ``` --- +## 가격 + +- **데이터 API(검색, 소셜, 스크래핑, 커머스, 금융)는 무료입니다.** +- discover, inspect, 실행 상태, 잔액, 파일 업로드도 무료입니다. +- 모델(LLM, 이미지, 비디오, 오디오)은 호출당 또는 100만 토큰당 과금됩니다. + +`sandbase inspect `은 현재 가격을 보여 주며 `base_price: 0`은 무료를 뜻합니다. 가격은 변경될 수 있으니 실제 응답을 기준으로 하세요. + ## 명령어 ### CLI 명령어 @@ -131,7 +144,7 @@ sandbase catalog --json # 지원 클라이언트 목록 ## 시작하기 ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect +npx -y @sandbaseai/cli@latest connect ``` **[무료 계정 만들기 →](https://sandbase.ai)** @@ -141,7 +154,7 @@ SandBase로 설정 시간을 절약했다면 [프로젝트에 Star를 남겨 주 ## 실전 가이드 - [Claude Code·Codex: 모델/API 탐색, 가격 확인, 실행](https://github.com/sandbaseai/cli/discussions/51) -- [공식 MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.sandbaseai%2Fcli/versions/0.1.17) +- [공식 MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sandbaseai%2Fcli) ## 라이선스 diff --git a/README.md b/README.md index fd6e87c..0a837a2 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@

@sandbaseai/cli

- Give your AI agent superpowers. One command. 2,000+ AI models and APIs. + Give your AI agent superpowers. One line. 2,000+ AI models and APIs — data APIs are free.

English | 中文 | 日本語 | 한국어 | Español | Français | Deutsch | Português @@ -30,8 +30,18 @@ Building directly over HTTP instead of MCP? Start with the [SandBase API quickst or compare the unified [LLM, image, and video API](https://blog.sandbase.ai/unified-ai-api-llm-image-video-2026/) with specialized model gateways. +## Setup + +Paste this into your agent and let it do the rest: + +``` +set up https://www.sandbase.ai/SKILL.md +``` + +It reads the SandBase Skill, runs `connect` itself, and asks you to approve one browser sign-in. Prefer to drive it yourself: + ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect +npx -y @sandbaseai/cli@latest connect ``` Or install the official Homebrew formula on macOS or Linux: @@ -43,39 +53,46 @@ sandbase connect See the [Homebrew launch announcement and macOS/Linux CI evidence](https://github.com/sandbaseai/cli/discussions/55). -For a reproducible install, verify the immutable release archive before -running it. The SHA-256 for `sandbaseai-cli-0.1.17.tgz` is -`1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa`. +Approve the browser authorization once; each supported client can then discover, +inspect, and run available SandBase models and APIs through the local MCP bridge. +Start a new session afterwards so the `sandbase_*` tools load. + +Every GitHub release publishes its own SHA-256 next to the tarball, so you can pin +and verify an exact build instead of tracking `latest`: ```sh -curl -fL -o sandbaseai-cli-0.1.17.tgz \ - https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz -echo '1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa sandbaseai-cli-0.1.17.tgz' | shasum -a 256 -c - -npx -y ./sandbaseai-cli-0.1.17.tgz connect +V=$(npm view @sandbaseai/cli version) +curl -fL -O "https://github.com/sandbaseai/cli/releases/download/v$V/sandbaseai-cli-$V.tgz" +shasum -a 256 "sandbaseai-cli-$V.tgz" # compare against the checksum on the release page +npx -y "./sandbaseai-cli-$V.tgz" connect ``` -Approve the browser authorization once; each supported client can then discover, -inspect, and run available SandBase models and APIs through the local MCP bridge. - -Want to inspect compatibility before signing in or changing configuration? The current -[`v0.1.17` GitHub release](https://github.com/sandbaseai/cli/releases/tag/v0.1.17) -includes a verified 25-client catalog: +Want to inspect compatibility before signing in or changing configuration? The +client catalog is a read-only command — it writes nothing and needs no account: ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json +npx -y @sandbaseai/cli@latest catalog --json ```

- Read-only SandBase CLI v0.1.17 catalog audit showing 25 client targets - SandBase CLI v0.1.17 doctor failing closed for an empty isolated profile + Read-only SandBase CLI catalog audit showing 25 client targets + SandBase CLI doctor failing closed for an empty isolated profile

-

Evidence captured from the immutable v0.1.17 release: a no-write catalog audit and a bounded doctor check against an empty isolated profile.

+

A no-write catalog audit and a bounded doctor check against an empty isolated profile.

Homebrew users can run the same read-only check with `sandbase catalog --json`. -The npm `latest` tag currently serves v0.1.14 while tokenless trusted publishing is -being enabled. The GitHub release tarball is built from the immutable `v0.1.17` tag; -its SHA-256 is published with the release. +## What It Costs + +| | Price | +|---|---| +| **Data APIs** — search, social, scraping, e-commerce, finance | **Free** | +| Discovery, inspection, run status, balance, file upload | **Free** | +| Models — LLM, image, video, audio | Paid per call or per million tokens | + +`sandbase inspect ` always shows the current price before you run anything; +`base_price: 0` means the call is free. Prices can change, so trust the live +response over any example in this file. Visit the [official SandBase CLI project page](https://sandbaseai.github.io/cli/) for a compact overview. For a security-focused walkthrough of client detection, MCP tools, and rollback, @@ -127,8 +144,8 @@ other catalog capabilities: 1. Use `sandbase_discover` to find candidates by task or capability. 2. Use `sandbase_inspect` to read the current input schema, pricing, and execution requirements. -3. Confirm the selected endpoint, parameters, and possible cost before calling - `sandbase_run`. +3. Confirm the selected endpoint and parameters before calling `sandbase_run`. + Data API calls are free; confirm the cost first when the tool is a model. 4. For asynchronous work, use `sandbase_run_get` with the returned `run_id` instead of creating a duplicate run. 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: > required inputs and current pricing for the best two candidates. Do not run > either model yet. +Discovery and inspection never cost anything, so an agent can always survey the +catalog before it spends. + After reviewing the live response, explicitly approve the endpoint and inputs you want to run. Catalog entries, schemas, pricing, latency, and availability 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: Preview the complete compatibility catalog without signing in or changing any files: ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json +npx -y @sandbaseai/cli@latest catalog --json ``` ```sh # Connect all detected clients at once -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect +npx -y @sandbaseai/cli@latest connect # Or target one specific client -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client cursor +npx -y @sandbaseai/cli@latest connect --client cursor ``` ### OpenClaw quickstart @@ -204,8 +224,8 @@ Target OpenClaw directly, then ask the CLI to read back the managed MCP server and SandBase Skill before you rely on them: ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client openclaw -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz doctor --client openclaw +npx -y @sandbaseai/cli@latest connect --client openclaw +npx -y @sandbaseai/cli@latest doctor --client openclaw ``` 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 and local credential later: ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz unregister --client openclaw +npx -y @sandbaseai/cli@latest unregister --client openclaw ``` 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 authorization transaction: ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client hermes -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz doctor --client hermes +npx -y @sandbaseai/cli@latest connect --client hermes +npx -y @sandbaseai/cli@latest doctor --client hermes ``` `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 Skill, and local credential while retaining the shared bridge for other clients: ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz unregister --client hermes +npx -y @sandbaseai/cli@latest unregister --client hermes ``` The integration is independently listed by @@ -298,12 +318,13 @@ Sync tools (LLMs, most data APIs) return their result directly; async tools (ima | Tool | Purpose | |------|---------| -| `sandbase_discover` | Search all 2,000+ available AI models and APIs | -| `sandbase_inspect` | Get input schema, pricing, and ready-to-use template | -| `sandbase_run` | Execute a model or API endpoint | -| `sandbase_run_get` | Poll status/result of an async run (video gen, etc.) | -| `sandbase_runs` | List your recent API calls with cost breakdown | -| `sandbase_account` | Check account balance (free, no cost) | +| `sandbase_discover` | Search all 2,000+ available AI models and APIs — free | +| `sandbase_inspect` | Get input schema, current price, and a ready-to-run template — free | +| `sandbase_run` | Execute a model or API endpoint — free for data APIs, paid for models | +| `sandbase_run_get` | Poll status/result of an async run (video gen, etc.) — free | +| `sandbase_runs` | List your recent runs with their cost — free | +| `sandbase_account` | Check account balance — free | +| `sandbase_run_cancel` | Cancel an Agent Service run — free | **Recommended workflow:** @@ -332,12 +353,12 @@ discover → inspect → run ## Get Started ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect +npx -y @sandbaseai/cli@latest connect ``` Then ask your agent to do something it couldn't before. -**[Create a free account →](https://sandbase.ai)** +**[Create a free account →](https://sandbase.ai)** — data APIs are free to call. If SandBase saves you setup time, [star the repository](https://github.com/sandbaseai/cli) — it helps more agent users discover the project. diff --git a/README.pt-BR.md b/README.pt-BR.md index f1217c1..9c1a691 100644 --- a/README.pt-BR.md +++ b/README.pt-BR.md @@ -25,8 +25,16 @@ Seu assistente de codificação IA é inteligente, mas está preso em uma caixa. **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. +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: + +``` +set up https://www.sandbase.ai/SKILL.md +``` + +Se preferir fazer você mesmo: + ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect +npx -y @sandbaseai/cli@latest connect ``` 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 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: ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json +npx -y @sandbaseai/cli@latest catalog --json ``` -Esse comando usa o arquivo imutável da versão `v0.1.17` no GitHub. SHA-256: -`1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa` - -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. +Cada release do GitHub publica o próprio SHA-256, então você pode fixar e verificar um build exato. ```sh # Conectar todos os clientes detectados -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect +npx -y @sandbaseai/cli@latest connect # Ou um cliente específico -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client cursor +npx -y @sandbaseai/cli@latest connect --client cursor ``` --- +## Preços + +- **As APIs de dados (busca, redes sociais, scraping, e-commerce, finanças) são gratuitas.** +- Descobrir, inspecionar, status de execução, saldo e upload de arquivos também são gratuitos. +- Modelos (LLM, imagem, vídeo, áudio) são cobrados por chamada ou por milhão de tokens. + +`sandbase inspect ` sempre mostra o preço atual; `base_price: 0` significa gratuito. Preços mudam: confie na resposta real. + ## Comandos ```sh @@ -129,7 +142,7 @@ sandbase catalog --json # Listar clientes suportados ## Começar ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect +npx -y @sandbaseai/cli@latest connect ``` **[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 ## Guia prático - [Claude Code e Codex: descobrir, conferir o preço e executar](https://github.com/sandbaseai/cli/discussions/54) -- [Registro MCP oficial](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.sandbaseai%2Fcli/versions/0.1.17) +- [Registro MCP oficial](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sandbaseai%2Fcli) ## Licença diff --git a/README.zh-CN.md b/README.zh-CN.md index 3dba261..02a9243 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -26,36 +26,40 @@ **SandBase 改变了这一切。** 一行命令，通过 [Model Context Protocol](https://modelcontextprotocol.io) 将你的 Agent 连接到 2,000+ AI 模型与 API。不用管理 API Key，不用折腾配置。 -在 macOS 或 Linux 上使用官方 Homebrew Formula： +把这一行发给你的 agent，它会自己读取 Skill、运行 `connect`，只需你在浏览器里确认一次登录： + +``` +set up https://www.sandbase.ai/SKILL.md +``` + +想自己动手： ```sh -brew install sandbaseai/tap/sandbaseai-cli -sandbase connect +npx -y @sandbaseai/cli@latest connect ``` -或者直接运行不可变的 v0.1.17 发布包： +在 macOS 或 Linux 上使用官方 Homebrew Formula： ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect +brew install sandbaseai/tap/sandbaseai-cli +sandbase connect ``` 想先验证兼容性、暂不登录也不修改本地配置？运行只读目录命令，确认当前版本支持的 25 个客户端： ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json +npx -y @sandbaseai/cli@latest catalog --json ```

- SandBase CLI v0.1.17 只读目录审计显示 25 个客户端目标 - SandBase CLI v0.1.17 doctor 对空白隔离配置按预期安全失败 + SandBase CLI 只读目录审计显示 25 个客户端目标 + SandBase CLI doctor 对空白隔离配置按预期安全失败

-

来自不可变 v0.1.17 发布包的证据：不写配置的目录审计，以及针对空白隔离配置的受限 doctor 检查。

+

证据：不写配置的目录审计，以及针对空白隔离配置的受限 doctor 检查。

-这里使用的是不可变的 GitHub `v0.1.17` 发布包；其 SHA-256 为 -`1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa`。 -目前 npm 的 `latest` 标签仍是 v0.1.14，因此在可信发布启用完成前，请使用上面的版本化 GitHub 地址。 +每个 GitHub 发布版都会随包公布自己的 SHA-256，可据此校验并固定到某个确切版本。 -项目已进入[官方 MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.sandbaseai%2Fcli/versions/0.1.17)，并被[中国独立开发者项目（程序员版）](https://github.com/1c7/chinese-independent-developer/blob/master/pages/README-Programmer-Edition.md#sandbase---github)独立收录。 +项目已进入[官方 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)独立收录。 查看[中文项目页](https://sandbaseai.github.io/cli/zh/)和[中文工作流指南](https://github.com/sandbaseai/cli/discussions/48)。如果 SandBase CLI 对你有帮助，请[给仓库一个 Star](https://github.com/sandbaseai/cli)，让更多开发者发现它。 @@ -124,15 +128,15 @@ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cl 无需登录或修改任何文件，即可预览完整兼容性目录： ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json +npx -y @sandbaseai/cli@latest catalog --json ``` ```sh # 一次连接所有检测到的客户端 -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect +npx -y @sandbaseai/cli@latest connect # 或者指定某个客户端 -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client cursor +npx -y @sandbaseai/cli@latest connect --client cursor ``` ### OpenClaw 快速开始 @@ -140,8 +144,8 @@ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cl 直接指定 OpenClaw，并在使用前让 CLI 回读验证由 SandBase 管理的 MCP 服务与 Skill： ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client openclaw -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz doctor --client openclaw +npx -y @sandbaseai/cli@latest connect --client openclaw +npx -y @sandbaseai/cli@latest doctor --client openclaw ``` 当 `doctor` 确认凭证、MCP bridge 和 Skill 均已配置后，重启 OpenClaw， @@ -150,7 +154,7 @@ SandBase 管理、但同样名为 `sandbase` 的 MCP 服务，安装器会保持 以后若要移除由 SandBase 管理的 MCP 条目和本地凭证： ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz unregister --client openclaw +npx -y @sandbaseai/cli@latest unregister --client openclaw ``` OpenClaw 目前没有受支持的 Skill 移除命令，因此 `unregister` 会明确报告这一限制， @@ -161,8 +165,8 @@ OpenClaw 目前没有受支持的 Skill 移除命令，因此 `unregister` 会 SandBase 可以在同一次授权事务中安装由它管理的 Hermes Skill 和本地 MCP 条目： ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client hermes -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz doctor --client hermes +npx -y @sandbaseai/cli@latest connect --client hermes +npx -y @sandbaseai/cli@latest doctor --client hermes ``` `doctor` 会验证所有权明确的本地凭证、MCP 条目与 Skill。随后重启 Hermes， @@ -172,7 +176,7 @@ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cl 共用的 bridge： ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz unregister --client hermes +npx -y @sandbaseai/cli@latest unregister --client hermes ``` 该集成已被独立收录于 @@ -198,6 +202,14 @@ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cl --- +## 价格 + +- **数据 API（搜索、社交、抓取、电商、金融）免费调用。** +- discover、inspect、运行状态、余额、文件上传均免费。 +- 模型（LLM、图像、视频、音频）按次或按百万 token 计费。 + +`sandbase inspect <工具名>` 会显示当前价格，`base_price: 0` 表示免费。价格可能变动，请以实时返回为准。 + ## 命令 ### CLI 命令 @@ -265,7 +277,7 @@ discover → inspect → run ## 开始使用 ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect +npx -y @sandbaseai/cli@latest connect ``` 然后让你的 Agent 做一些它以前做不到的事。 diff --git a/SECURITY.md b/SECURITY.md index e19dc49..455ffe9 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -4,17 +4,17 @@ SandBase CLI configures MCP clients and stores local credentials, so security an ## Supported versions -Security fixes are provided in the latest verified GitHub release. The npm `latest` tag may temporarily lag while trusted publishing is being enabled. +Security fixes ship in the latest release, published to both npm and GitHub Releases. | Version | Supported | | --- | --- | -| [v0.1.17](https://github.com/sandbaseai/cli/releases/tag/v0.1.17) | Yes | +| [Latest release](https://github.com/sandbaseai/cli/releases/latest) | Yes | | Earlier versions | No | -Install or diagnose the supported release from its immutable artifact: +Install or diagnose the supported release: ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz doctor +npx -y @sandbaseai/cli@latest doctor ``` ## Reporting a vulnerability diff --git a/SUPPORT.md b/SUPPORT.md index c2ffdb8..971e7d2 100644 --- a/SUPPORT.md +++ b/SUPPORT.md @@ -10,7 +10,7 @@ Use the channel that best matches your request: Before requesting help, run: ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz doctor +npx -y @sandbaseai/cli@latest doctor ``` Include the CLI version, client and version, operating system, exact command, and sanitized output. Never post API keys, access tokens, credentials, or private configuration. diff --git a/llms-install.md b/llms-install.md index 4bd1e27..9fbaa4f 100644 --- a/llms-install.md +++ b/llms-install.md @@ -16,7 +16,7 @@ This read-only command prints the 25 supported client targets. It does not open a browser or change local configuration: ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json +npx -y @sandbaseai/cli@latest catalog --json ``` ## Install with Homebrew @@ -29,20 +29,20 @@ sandbase catalog --json sandbase connect --client ``` -The formula installs the immutable v0.1.17 archive and verifies its published +The formula installs the latest release archive and verifies its published SHA-256 before installation. ## Connect a client -Alternatively, run the immutable v0.1.17 GitHub Release directly while npm +Alternatively, run the latest GitHub Release directly while npm `latest` is being updated: ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client +npx -y @sandbaseai/cli@latest connect --client ``` -For an offline/integrity check, the archive's SHA-256 is -`1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa`. +For an offline integrity check, compare the tarball against the SHA-256 published +on its [release page](https://github.com/sandbaseai/cli/releases/latest). Common client IDs include `codex`, `claude-code`, `cursor`, `gemini-cli`, `windsurf`, and `opencode`. To configure every supported client detected on the @@ -56,7 +56,7 @@ permissions and adds only the SandBase-owned MCP entry. ## Verify ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz doctor --client +npx -y @sandbaseai/cli@latest doctor --client ``` 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: ## Remove the managed entry ```sh -npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz unregister --client +npx -y @sandbaseai/cli@latest unregister --client ``` This removes only the SandBase-owned configuration. It leaves unrelated and diff --git a/package-lock.json b/package-lock.json index 859a164..88ad315 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "@sandbaseai/cli", - "version": "0.3.6", + "version": "0.3.7", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "@sandbaseai/cli", - "version": "0.3.6", + "version": "0.3.7", "license": "Apache-2.0", "dependencies": { "jsonc-parser": "3.3.1", diff --git a/package.json b/package.json index 19ffab6..769783e 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@sandbaseai/cli", - "version": "0.3.6", + "version": "0.3.7", "mcpName": "io.github.sandbaseai/cli", "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", "type": "module", diff --git a/server.json b/server.json index 607701e..998adce 100644 --- a/server.json +++ b/server.json @@ -3,7 +3,7 @@ "name": "io.github.sandbaseai/cli", "title": "SandBase", "description": "Connect MCP clients to 2,000+ AI models without managing provider API keys.", - "version": "0.3.6", + "version": "0.3.7", "repository": { "url": "https://github.com/sandbaseai/cli", "source": "github" @@ -26,7 +26,7 @@ { "registryType": "npm", "identifier": "@sandbaseai/cli", - "version": "0.3.6", + "version": "0.3.7", "packageArguments": [ { "type": "positional", diff --git a/skills/sandbase/SKILL.md b/skills/sandbase/SKILL.md index 65d6b94..7fbd078 100644 --- a/skills/sandbase/SKILL.md +++ b/skills/sandbase/SKILL.md @@ -1,6 +1,6 @@ --- name: sandbase -version: 0.3.6 +version: 0.3.7 description: >- Discover better ways to complete tasks. Proactively search SandBase (the sandbase_discover MCP tool, or `sandbase discover` in a shell) before writing a @@ -10,7 +10,8 @@ description: >- data (X/Twitter, TikTok, Douyin, Xiaohongshu, Instagram, YouTube, Reddit, Weibo, Bilibili, LinkedIn); search results; web scraping; product, company, or people data; embeddings; or a specific third-party model. 2,000+ models and - APIs, paid per call from one balance. Exceptions: if the user already has a + APIs: data APIs (search, social, scraping, e-commerce, finance) are free to + call, models are paid per call from one balance. Exceptions: if the user already has a dedicated MCP server, API key, or tool for that specific service, use it; and if your built-in web search or page fetch already gives what the task needs, use that — SandBase fills gaps in the user's stack, it does not replace it. @@ -211,9 +212,11 @@ Do not use SandBase for purely local work (editing files, reasoning over code al ## 6. Cost and budget -- `inspect` shows the price: per call (`base_price`), per million tokens (`input_per_million` / `output_per_million`), or a `formula`. -- Many data endpoints are billed **per result** and 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). -- Check `sandbase_account` before a batch of paid calls, and report cost when the user cares about budget (`cost` appears on `sandbase_run_get` and `sandbase_runs`). +- **`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. +- **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. +- 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. +- 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). +- 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`). - Never re-run a slow tool just because it is still running; poll it. - 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. diff --git a/skills/sandbase/skill.json b/skills/sandbase/skill.json index a106deb..c57e71b 100644 --- a/skills/sandbase/skill.json +++ b/skills/sandbase/skill.json @@ -1,6 +1,6 @@ { "name": "sandbase", - "version": "0.3.6", + "version": "0.3.7", "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.", "author": "SandBase AI", "license": "Apache-2.0", diff --git a/test/agent.test.ts b/test/agent.test.ts index 961da16..e82ef40 100644 --- a/test/agent.test.ts +++ b/test/agent.test.ts @@ -331,7 +331,7 @@ test("setup refreshes the bridge and SandBase-owned Skills but leaves edited Ski const lines: string[] = []; assert.equal(await setup(new FileCredentialStore(env.SANDBASE_HOME!), line => void lines.push(line)), true); assert.match(lines.join("\n"), /bridge: status=updated/); assert.match(lines.join("\n"), /claude-code: skill=updated/); assert.match(lines.join("\n"), /kiro: skill=modified/); - assert.match(await readFile(join(claudeDir, "SKILL.md"), "utf8"), /version: 0\.3\.6/); + assert.match(await readFile(join(claudeDir, "SKILL.md"), "utf8"), /version: 0\.3\.7/); assert.match(await readFile(join(kiroDir, "SKILL.md"), "utf8"), /user edit/); } finally { for (const [key, value] of Object.entries(previous)) { if (value === undefined) delete process.env[key]; else process.env[key] = value; } } });