SandBase
Ponte CLI open-source e MCP local que conecta agentes de IA a mais de 2.000 modelos de IA através de uma única conta.
Documentação
@sandbaseai/cli
Dê superpoderes ao seu agente de IA. Um comando. Mais de 2.000 modelos de IA e APIs.
English | 中文 | 日本語 | 한국어 | Español | Français | Deutsch | Português
Seu assistente de codificação com IA é inteligente, mas está preso em uma caixa. Ele não pode pesquisar na web, verificar redes sociais, gerar imagens ou acessar dados em tempo real — a menos que você conecte cada API manualmente.
O SandBase muda isso. Um comando conecta seu agente a mais de 2.000 modelos de IA e APIs através do Model Context Protocol. Sem chaves de API para gerenciar. Sem dores de cabeça com configuração.
Construindo diretamente sobre HTTP em vez de MCP? Comece com o início rápido da API SandBase ou compare a API unificada de LLM, imagem e vídeo com gateways de modelos especializados.
npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
Ou instale a fórmula oficial do Homebrew no macOS ou Linux:
brew install sandbaseai/tap/sandbaseai-cli
sandbase connect
Veja o anúncio de lançamento do Homebrew e evidências de CI para macOS/Linux.
Para uma instalação reproduzível, verifique o arquivo de release imutável antes de
executá-lo. O SHA-256 para sandbaseai-cli-0.1.17.tgz é
1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa.
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
Aprove a autorização do navegador uma vez; cada cliente suportado pode então descobrir, inspecionar e executar os modelos e APIs disponíveis do SandBase através da ponte MCP local.
Quer inspecionar a compatibilidade antes de entrar ou alterar a configuração? O
release v0.1.17 do GitHub
atual inclui um catálogo verificado de 25 clientes:
npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json
Evidências capturadas do release imutável v0.1.17: uma auditoria de catálogo somente leitura e uma verificação limitada do doctor contra um perfil isolado vazio.
Usuários do Homebrew podem executar a mesma verificação somente leitura com sandbase catalog --json.
A tag latest do npm atualmente serve a v0.1.14 enquanto a publicação confiável sem token está
sendo habilitada. O tarball do release do GitHub é construído a partir da tag imutável v0.1.17;
seu SHA-256 é publicado com o release.
Visite a página oficial do projeto SandBase CLI para uma visão geral compacta.
Para um passo a passo focado em segurança de detecção de clientes, ferramentas MCP e rollback,
leia o guia de configuração do SandBase CLI para 25 clientes.
Agentes de IA e instaladores automatizados podem usar as instruções concisas
llms-install.md.
Stack Open-Source do SandBase
- SandBase Harness — runtime de agente auto-hospedado com sessões persistentes, isolamento de sandbox, aprovações, auditoria e replay.
- SandBase Agent Skills — 88 Skills instaláveis para pesquisa, inteligência social, marketing e fluxos de trabalho de negócios.
- SandBase for Codex — plugin oficial do Codex que empacota a ponte MCP do SandBase e a Agent Skill guiada; sua verificação de segurança HOL obrigatória passa em
main.
Descubra a ponte remota autenticada no Registro MCP oficial,
leia seu showcase da comunidade do Registro, ou encontre-o através de
Chinese Independent Developer,
Awesome MCP,
Glama,
TensorBlock MCP Index,
MCPRepository,
VaultPlane,
AIMCP,
MCP Server Hub,
MCP Server Spot, ou do
Awesome AI API Proxy.
Mantenedores externos mesclaram o SandBase em
Awesome Codex CLI,
Awesome Agent Skills, e
Awesome MCP Server.
A integração Hermes está listada independentemente no
catálogo de ecossistema Hermes Atlas e como beta em
Awesome Hermes Agent.
Instale sua
Agent Skill sandbase verificada do skills.sh,
a listagem sandbaseai/cli/sandbase no SkillsCat,
a listagem sandbaseai/cli/sandbase no skills.re,
a listagem SandBase verificada 93/100 no vSkill,
a listagem SandBase auditada por segurança no Skillstore,
ou o snapshot sandbaseai/sandbase versionado no Agent Skill Hub.
Um Fluxo de Trabalho de Agente Verificável
Após conectar, peça ao seu agente para seguir a mesma sequência inspecionável para busca, APIs de dados, modelos de linguagem, geração de imagens, geração de vídeo e outras capacidades do catálogo:
- Use
sandbase_discoverpara encontrar candidatos por tarefa ou capacidade. - Use
sandbase_inspectpara ler o esquema de entrada atual, preços e requisitos de execução. - Confirme o endpoint selecionado, parâmetros e custo possível antes de chamar
sandbase_run. - Para trabalho assíncrono, use
sandbase_run_getcom orun_idretornado em vez de criar uma execução duplicada. - Use
sandbase_runspara revisar o status de execuções recentes e o custo registrado. - Use
sandbase_accountpara verificar o saldo atual da conta.
Por exemplo, comece com uma solicitação de descoberta não cobrável:
Encontre modelos de imagem adequados para uma ilustração quadrada de produto. Compare as entradas necessárias e os preços atuais dos dois melhores candidatos. Não execute nenhum dos modelos ainda.
Após revisar a resposta ao vivo, aprove explicitamente o endpoint e as entradas que deseja executar. Entradas de catálogo, esquemas, preços, latência e disponibilidade podem mudar, então use a resposta da ferramenta da sessão atual em vez de um exemplo estático.
Veja o passo a passo completo do Claude Code e Codex ou o guia de fluxo de trabalho em chinês. Para um exemplo ao vivo do catálogo, leia a nota de dogfooding de descobrir e inspecionar o conector GitHub.
O Que Está Incluído
| Categoria | Ferramentas | O Que Você Pode Fazer |
|---|---|---|
| Busca na Web | Google, Exa, Tavily, Scholar | Pesquise qualquer coisa em tempo real |
| Redes Sociais | Twitter/X, YouTube, Reddit, Instagram, TikTok, Xiaohongshu, Weibo, Bilibili | Monitore tendências, puxe posts, analise conteúdo |
| Scraping | Firecrawl, Exa Content | Extraia dados de qualquer página web pública |
| Modelos de IA | GPT-4o, Claude, Gemini, DeepSeek, Qwen, Llama | Execute qualquer modelo sem gerenciar chaves |
| Geração de Imagem | Flux, DALL-E, Ideogram, Recraft | Crie logotipos, ilustrações, mockups |
| Geração de Vídeo | Kling, MiniMax, Runway, Luma | Gere clipes curtos e animações |
| Áudio | ElevenLabs, Whisper | Texto para fala, transcrição |
| E-commerce | Taobao, Amazon | Pesquisa de produtos, comparação de preços |
| Finanças | Dados de ações, informações de empresas | Pesquisa e análise de mercado |
Clientes Suportados (25 Alvos)
Funciona com todas as principais ferramentas de codificação com IA:
| Auto-configurado | Configuração manual |
|---|---|
| Cursor, Cursor CLI | ChatGPT |
| Claude Code | Claude Desktop |
| Codex | |
| Kiro IDE, Kiro CLI | |
| Windsurf | |
| Gemini CLI | |
| Amp | |
| Warp | |
| OpenCode, Qwen Code, Kimi CLI | |
| Hermes, OpenClaw |
Pré-visualize o catálogo completo de compatibilidade sem entrar ou alterar nenhum arquivo:
npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json
# 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
# 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
Início rápido do OpenClaw
Aponte diretamente para o OpenClaw e peça ao CLI para ler de volta o servidor MCP gerenciado e a Skill do SandBase antes de confiar neles:
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
Depois que doctor relatar a credencial, a ponte MCP e a Skill como configuradas,
reinicie o OpenClaw e faça uma solicitação em linguagem natural que precise do SandBase. Se
o OpenClaw já tiver um servidor MCP não-SandBase chamado sandbase, o instalador
o deixa intacto em vez de sobrescrevê-lo. Para remover a entrada MCP gerenciada
e a credencial local depois:
npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz unregister --client openclaw
O OpenClaw atualmente não expõe um comando suportado de remoção de Skill, então unregister
relata essa limitação e deixa a Skill verificada do SandBase instalada.
Início rápido do Hermes
O SandBase pode instalar tanto sua Skill Hermes gerenciada quanto a entrada MCP local em uma única transação de autorização:
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
doctor verifica a credencial local de propriedade, a entrada MCP e a Skill. Reinicie
o Hermes para confirmar a descoberta nativa em uma nova sessão de cliente e, em seguida, use a
Skill do SandBase ou as ferramentas MCP. Uma entrada MCP pré-existente não-SandBase chamada
sandbase é deixada intacta. Para remover apenas a configuração gerenciada do Hermes,
a Skill e a credencial local, mantendo a ponte compartilhada para outros clientes:
npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz unregister --client hermes
A integração é listada independentemente por Hermes Atlas e Awesome Hermes Agent.
Como Funciona
┌─────────────────┐ ┌───────────────┐ ┌────────────────────┐
│ Your Agent │ MCP │ Local Bridge │ HTTPS │ SandBase API │
│ (Cursor, etc.) │────────▶│ (on-demand) │────────▶│ 2,000+ models/APIs │
│ │◀────────│ │◀────────│ │
└─────────────────┘ └───────────────┘ └────────────────────┘
- Execute
connect→ o CLI abre a autenticação no navegador → você aprova - Chave da API salva localmente (permissões de arquivo
0600) - Ponte MCP configurada para seu cliente
- O agente chama as ferramentas sob demanda. Sem daemon. Sem processo em segundo plano.
Comandos
Comandos do CLI
sandbase connect [--client <name>] # Authorize + configure
sandbase doctor [--client <name>] # Health check
sandbase unregister [--client <name>] # Remove configuration
sandbase catalog --json # List all supported clients
Ferramentas MCP (disponíveis para seu agente após conectar)
| Ferramenta | Propósito |
|---|---|
sandbase_discover | Pesquise todos os mais de 2.000 modelos de IA e APIs disponíveis |
sandbase_inspect | Obtenha esquema de entrada, preços e modelo pronto para uso |
sandbase_run | Execute um modelo ou endpoint de API |
sandbase_run_get | Consulte o status/resultado de uma execução assíncrona (geração de vídeo, etc.) |
sandbase_runs | Liste suas chamadas de API recentes com detalhamento de custo |
sandbase_account | Verifique o saldo da conta (grátis, sem custo) |
Fluxo de trabalho recomendado:
discover → inspect → run
1. sandbase_discover(q: "twitter search") → find current candidates
2. sandbase_inspect(name: discovered_name) → get schema and pricing
3. sandbase_run(name: discovered_name, input: {...}) → run after confirmation
Segurança
- Zero segredos em URLs ou argumentos do CLI — fluxo de dispositivo OAuth com PKCE
- Permissões de arquivo restritas — Credenciais armazenadas com
0600 - Atualizações cientes de propriedade — Comentários JSONC existentes e entradas MCP gerenciadas pelo usuário são preservados
- Rollback exato — Em falha ou
unregister, apenas a configuração de propriedade do SandBase é removida - Revogue a qualquer momento — Um clique no SandBase Dashboard
Comece Agora
npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
Depois, peça ao seu agente para fazer algo que ele não podia antes.
Se o SandBase economizar seu tempo de configuração, dê uma estrela no repositório — isso ajuda mais usuários de agentes a descobrirem o projeto.
Links
- SandBase Platform
- Documentação
- Guia de configuração do CLI
- Mergulho profundo no CLI: English · 中文
- Fluxo de trabalho prático com seis ferramentas: English · 中文
- Pacote npm
- Plugin oficial do Codex
- Dashboard
Comunidade
- Faça uma pergunta ou compartilhe o que você construiu
- Reporte um bug reproduzível
- Proponha uma integração ou melhoria
- Contribua para o SandBase CLI
Listagens selecionadas pela comunidade:
- Vitrine da comunidade do Registro Oficial
- Diretório MCP do VaultPlane
- Diretório AIMCP
- Awesome MCP
- Awesome AI API Proxy
- Awesome Gemini CLI
- Hermes Atlas
- Awesome Hermes Agent
- Awesome AI Tools
- Awesome MCP Server
- Awesome Agent Cortex
- Awesome AI Agent Tools
- Awesome Codex CLI
Licença
Apache-2.0

