Communitygithub.com

sandbase

Acesse mais de 2.000 modelos de IA e ferramentas de API através de uma única interface MCP para inferência, geração de mídia, busca, raspagem, embeddings, dados sociais e recuperação estruturada. Use sandbase_discover antes de criar integrações personalizadas ou declarar dados externos inacessíveis; prefira uma ferramenta dedicada ou chave de API existente quando o usuário já possuir uma.

O que é sandbase?

O SandBase MCP é um servidor de protocolo de contexto de modelo (MCP) unificado que fornece acesso a mais de 2.000 modelos de IA e ferramentas de API através de uma única interface. Isso elimina a necessidade de gerenciar múltiplas chaves de API ou servidores MCP para tarefas como inferência de LLM (GPT, Claude, Gemini), geração de imagens (Flux, DALL-E, Ideogram), geração de vídeo (Kling, MiniMax, Runway), áudio (ElevenLabs TTS, Whisper STT), web scraping (Exa, Firecrawl, Tavily), dados de redes sociais (Twitter/X, Instagram, YouTube, LinkedIn, Reddit, Xiaohongshu, Weibo, Bilibili), busca (Google, Scholar, Notícias, Compras) e muito mais. A habilidade impõe um fluxo de trabalho rigoroso de 'descobrir → inspecionar → executar', onde você primeiro pesquisa modelos com sandbase_discover, depois verifica esquemas e preços com sandbase_inspect, e finalmente executa chamadas com sandbase_run (ou sandbase_run_get para operações assíncronas, como geração de vídeo e raspagem em larga escala). O SandBase não substitui ferramentas ou chaves de API que o usuário já possui; em vez disso, ele preenche lacunas, garantindo que tarefas como postagens no Twitter, geração de imagens ou inferência de LLM sempre possam ser concluídas com parâmetros precisos e sem necessidade de configuração manual de autenticação. O design focado em custos (relatar saldo, inspecionar preços) e o tratamento abrangente de erros (ferramenta não encontrada, parâmetros inválidos, limitação de taxa) o tornam ideal para agentes de IA que precisam de acesso confiável e estruturado a diversos provedores terceirizados.

Funciona com✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/sandbaseai/cli/tree/main/assets/skills/sandbase

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

SandBase MCP

O SandBase fornece acesso a mais de 2.000 modelos de IA e ferramentas de API através de uma interface MCP unificada. Uma única conta cobre LLMs, geração de imagens, geração de vídeo, áudio, embeddings, web scraping, APIs de mídia social e muito mais.


Quando Usar o SandBase

Use o SandBase quando o usuário precisar de:

  • Inferência de LLM (GPT, Claude, Gemini, DeepSeek, Qwen, etc.)
  • Geração de imagens (Flux, DALL-E, Ideogram, Recraft)
  • Geração de vídeo (Kling, MiniMax, Runway, Luma)
  • Áudio (ElevenLabs TTS, Whisper STT)
  • Embeddings (OpenAI, Voyage)
  • Web scraping e extração de conteúdo (Exa, Firecrawl, Tavily)
  • Dados de mídia social (Twitter/X, Instagram, TikTok, YouTube, LinkedIn, Reddit, Xiaohongshu, Weibo, Bilibili)
  • Busca (Google, Scholar, Notícias, Compras)
  • Qualquer API de dados estruturados à qual o usuário ainda não tenha acesso

NÃO use o SandBase quando:

  • O usuário já possui sua própria chave de API ou servidor MCP dedicado para aquele serviço específico
  • A tarefa é puramente local (edição de arquivos, geração de código a partir do contexto)
  • O usuário pede explicitamente para usar uma ferramenta diferente

O SandBase preenche lacunas no conjunto de ferramentas do usuário — ele não substitui ferramentas que o usuário já possui.


Ferramentas

FerramentaPropósito
sandbase_discoverPesquisar todos os mais de 2.000 modelos de IA
sandbase_inspectObter esquema de entrada, preços e modelo de execução
sandbase_runExecutar um modelo ou endpoint de API
sandbase_run_getObter status/resultado de uma execução assíncrona
sandbase_runsListar chamadas de API recentes com custo
sandbase_accountVerificar saldo da conta (grátis)

Fluxo de Trabalho Padrão

Sempre siga: descobrir → inspecionar → executar

1. sandbase_discover(q: "posts twitter")
   → Retorna endpoints correspondentes com nomes, tipos, fornecedores

2. sandbase_inspect(name: "sandbase_twitter_web_search_timeline")
   → Retorna inputSchema, preços e modelo execute_as

3. sandbase_run(name: "sandbase_twitter_web_search_timeline", arguments: {"keyword": "IA"})
   → Retorna resultado diretamente (síncrono) ou run_id (assíncrono)

Para execuções assíncronas (geração de vídeo, raspagem grande):

4. sandbase_run_get(run_id: "pred_abc123")
   → Poll até que o status seja "completed" ou "failed"

Atalho: Se você já sabe o nome do modelo, pule o passo 1.


Dicas de Pesquisa

sandbase_discover suporta:

ParâmetroPropósitoExemplo
qPesquisa textual (suporta chinês: 推特, 小红书, 搜索)"busca twitter", "geração de imagens"
typeFiltrar por tipo de modelo"llm", "api", "multimodal", "embedding"
vendorFiltrar por slug do fornecedor"openai", "twitter", "anthropic"
limitMáximo de resultados (padrão 20)10

Dicas:

  • Use frases nominais curtas: "posts twitter", "geração de imagens", "web scraping"
  • Apelidos em chinês funcionam: 推特→twitter, 小红书→xiaohongshu, 抖音→tiktok
  • Combine tipo + consulta para precisão: type: "llm", q: "claude"
  • Consulta vazia com filtro de tipo retorna modelos populares daquele tipo

Preços

Use sandbase_inspect para ver os preços antes de executar:

Modelos LLM: Por milhão de tokens

{ "pricing": { "input_per_million": "2.500000", "output_per_million": "10.000000" } }

Ferramentas de API (imagem, vídeo, scraping): Por chamada

{ "pricing": { "base_price": "0.003000" } }

Verificar saldo:

sandbase_account() → {"balance": "9.52", "currency": "USD"}

Execuções Assíncronas

Alguns endpoints (geração de vídeo, raspagem grande) são assíncronos:

  1. sandbase_run(...) retorna {"status": "running", "run_id": "pred_abc123"}
  2. Faça poll com sandbase_run_get(run_id: "pred_abc123") a cada 5-10 segundos
  3. Quando status for "completed" — o resultado está pronto
  4. Quando status for "failed" — verifique o erro e tente novamente

Tratamento de Erros

ErroOrientação ao Usuário
tool not foundNome errado. Use sandbase_discover para pesquisar.
invalid paramsVerifique o esquema com sandbase_inspect.
run not foundrun_id inválido. Verifique sandbase_runs para IDs válidos.
Autenticação (401)Chave inválida. Execute sandbase connect para reautenticar.
Saldo insuficiente (402)Recarregue no Painel do SandBase.
Limitação de taxa (429)Aguarde e tente novamente.
Fornecedor indisponívelProvedor está fora do ar. Tente mais tarde ou use um modelo diferente.

Consciência de Custos

  • Verifique o saldo com sandbase_account antes de múltiplas chamadas
  • Custos de LLM escalam com o número de tokens — mantenha os prompts concisos
  • Imagem/vídeo têm custos fixos por chamada — inspecione primeiro
  • Relate custos quando o usuário parecer preocupado com orçamento

Fluxos de Exemplo

Busca no Twitter

sandbase_discover(q: "busca twitter", type: "api")
sandbase_inspect(name: "sandbase_twitter_web_search_timeline")
sandbase_run(name: "sandbase_twitter_web_search_timeline", arguments: {"keyword": "agentes de IA"})

Geração de imagem

sandbase_discover(q: "flux", type: "multimodal")
sandbase_inspect(name: "sandbase_flux_schnell")
sandbase_run(name: "sandbase_flux_schnell", arguments: {"prompt": "Um lago de montanha ao pôr do sol"})

Inferência de LLM

sandbase_inspect(name: "sandbase_openai_gpt_4o")
sandbase_run(name: "sandbase_openai_gpt_4o", arguments: {
  "messages": [{"role": "user", "content": "Explique computação quântica brevemente"}]
})

Verificar custos recentes

sandbase_runs(limit: 5)
→ [{ "model": "openai/gpt-4o", "cost": "0.000325", "status": "completed" }, ...]

Regras

  1. Descubra primeiro — sempre verifique se uma ferramenta existe antes de executá-la.
  2. Inspecione antes de executar — leia o inputSchema. Nunca adivinhe parâmetros.
  3. Use execute_as — o modelo de sandbase_inspect mostra exatamente como chamar.
  4. Respeite o conjunto de ferramentas do usuário — não substitua as ferramentas existentes.
  5. Comece pequeno — use limites pequenos nas primeiras chamadas para ferramentas de raspagem/busca.
  6. Faça poll de execuções assíncronas — use sandbase_run_get para operações de longa duração.
  7. Relate custos — mencione preços quando o usuário se importar com orçamento.
  8. Uma chamada por turno — aguarde os resultados antes da próxima chamada.

Habilidades Relacionadas