Communitygithub.com

sandbase

Accédez à plus de 2 000 modèles d'IA et outils API via une interface MCP unifiée pour l'inférence, la génération multimédia, la recherche, le scraping, les embeddings, les données sociales et la récupération structurée. Utilisez sandbase_discover avant de construire des intégrations personnalisées ou de déclarer des données externes inaccessibles ; préférez un outil dédié ou une clé API existante lorsque l'utilisateur en possède déjà un.

Qu'est-ce que sandbase ?

SandBase est un serveur MCP (Model Context Protocol) qui agit comme une passerelle unique vers plus de 2 000 modèles d'IA et API tierces. Il permet d'effectuer de l'inférence LLM (GPT, Claude, Gemini, etc.), de la génération d'images, de vidéos, d'audio, des embeddings, du scraping web, de la recherche sociale (Twitter, LinkedIn, Reddit, etc.) et bien plus encore. L'approche recommandée est de toujours commencer par la découverte (sandbase_discover), puis d'inspecter la signature et le prix (sandbase_inspect), avant d'exécuter (sandbase_run). SandBase est utile pour combler les lacunes de l'utilisateur, mais il ne doit pas remplacer les outils ou clés API que l'utilisateur possède déjà. Le système gère aussi bien les appels synchrones que asynchrones (génération vidéo, scraping volumineux) et fournit des informations de coût détaillées pour chaque appel.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

MCP SandBase

SandBase donne accès à plus de 2 000 modèles d'IA et outils API via une interface MCP unifiée. Un seul compte couvre les LLM, la génération d'images, la génération de vidéos, l'audio, les embeddings, le scraping web, les API de réseaux sociaux, et bien plus.


Quand utiliser SandBase

Utilisez SandBase lorsque l'utilisateur a besoin :

  • D'inférence LLM (GPT, Claude, Gemini, DeepSeek, Qwen, etc.)
  • De génération d'images (Flux, DALL-E, Ideogram, Recraft)
  • De génération de vidéos (Kling, MiniMax, Runway, Luma)
  • D'audio (ElevenLabs TTS, Whisper STT)
  • D'embeddings (OpenAI, Voyage)
  • De scraping web et d'extraction de contenu (Exa, Firecrawl, Tavily)
  • De données de réseaux sociaux (Twitter/X, Instagram, TikTok, YouTube, LinkedIn, Reddit, Xiaohongshu, Weibo, Bilibili)
  • De recherche (Google, Scholar, Actualités, Shopping)
  • De toute API de données structurées à laquelle l'utilisateur n'a pas déjà accès

N'utilisez PAS SandBase lorsque :

  • L'utilisateur possède sa propre clé API ou un serveur MCP dédié pour ce service spécifique
  • La tâche est purement locale (édition de fichiers, génération de code à partir du contexte)
  • L'utilisateur demande explicitement d'utiliser un autre outil

SandBase comble les lacunes de la pile technologique de l'utilisateur — il ne remplace pas les outils qu'il possède déjà.


Outils

OutilObjectif
sandbase_discoverRechercher parmi les 2 000+ modèles d'IA
sandbase_inspectObtenir le schéma d'entrée, les tarifs et le modèle d'exécution
sandbase_runExécuter un modèle ou un point de terminaison API
sandbase_run_getObtenir le statut/résultat d'une exécution asynchrone
sandbase_runsLister les appels API récents avec leur coût
sandbase_accountVérifier le solde du compte (gratuit)

Flux de travail standard

Suivez toujours : découvrir → inspecter → exécuter

1. sandbase_discover(q: "publications twitter")
   → Retourne les points de terminaison correspondants avec noms, types, fournisseurs

2. sandbase_inspect(name: "sandbase_twitter_web_search_timeline")
   → Retourne inputSchema, les tarifs et le modèle execute_as

3. sandbase_run(name: "sandbase_twitter_web_search_timeline", arguments: {"keyword": "IA"})
   → Retourne le résultat directement (synchrone) ou run_id (asynchrone)

Pour les exécutions asynchrones (génération vidéo, scraping volumineux) :

4. sandbase_run_get(run_id: "pred_abc123")
   → Interroger jusqu'à ce que le statut soit "completed" ou "failed"

Raccourci : Si vous connaissez déjà le nom du modèle, sautez l'étape 1.


Conseils de recherche

sandbase_discover prend en charge :

ParamètreObjectifExemple
qRecherche textuelle (prend en charge le chinois : 推特, 小红书, 搜索)"recherche twitter", "génération d'images"
typeFiltrer par type de modèle"llm", "api", "multimodal", "embedding"
vendorFiltrer par identifiant du fournisseur"openai", "twitter", "anthropic"
limitNombre maximum de résultats (par défaut 20)10

Conseils :

  • Utilisez des groupes nominaux courts : "publications twitter", "génération d'images", "scraping web"
  • Les alias chinois fonctionnent : 推特→twitter, 小红书→xiaohongshu, 抖音→tiktok
  • Combinez type + requête pour plus de précision : type: "llm", q: "claude"
  • Une requête vide avec un filtre de type retourne les modèles populaires de ce type

Tarifs

Utilisez sandbase_inspect pour voir les tarifs avant d'exécuter :

Modèles LLM : Par million de tokens

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

Outils API (image, vidéo, scraping) : Par appel

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

Vérifier le solde :

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

Exécutions asynchrones

Certains points de terminaison (génération vidéo, scraping volumineux) sont asynchrones :

  1. sandbase_run(...) retourne {"status": "running", "run_id": "pred_abc123"}
  2. Interrogez avec sandbase_run_get(run_id: "pred_abc123") toutes les 5 à 10 secondes
  3. Lorsque status est "completed" — le résultat est prêt
  4. Lorsque status est "failed" — vérifiez l'erreur et réessayez

Gestion des erreurs

ErreurConseil utilisateur
tool not foundMauvais nom. Utilisez sandbase_discover pour rechercher.
invalid paramsVérifiez le schéma depuis sandbase_inspect.
run not foundrun_id invalide. Vérifiez sandbase_runs pour des ID valides.
Authentification (401)Clé invalide. Exécutez sandbase connect pour vous réauthentifier.
Solde insuffisant (402)Rechargez sur le tableau de bord SandBase.
Limite de débit (429)Attendez et réessayez.
Fournisseur indisponibleLe service en amont est en panne. Réessayez plus tard ou utilisez un autre modèle.

Conscience des coûts

  • Vérifiez le solde avec sandbase_account avant plusieurs appels
  • Les coûts LLM augmentent avec le nombre de tokens — gardez les invites concises
  • Les images/vidéos ont un coût fixe par appel — inspectez d'abord
  • Signalez les coûts lorsque l'utilisateur semble préoccupé par le budget

Exemples de flux

Recherche Twitter

sandbase_discover(q: "recherche twitter", type: "api")
sandbase_inspect(name: "sandbase_twitter_web_search_timeline")
sandbase_run(name: "sandbase_twitter_web_search_timeline", arguments: {"keyword": "agents IA"})

Génération d'images

sandbase_discover(q: "flux", type: "multimodal")
sandbase_inspect(name: "sandbase_flux_schnell")
sandbase_run(name: "sandbase_flux_schnell", arguments: {"prompt": "Un lac de montagne au coucher du soleil"})

Inférence LLM

sandbase_inspect(name: "sandbase_openai_gpt_4o")
sandbase_run(name: "sandbase_openai_gpt_4o", arguments: {
  "messages": [{"role": "user", "content": "Explique brièvement l'informatique quantique"}]
})

Vérifier les coûts récents

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

Règles

  1. Découvrez d'abord — vérifiez toujours qu'un outil existe avant de l'exécuter.
  2. Inspectez avant d'exécuter — lisez le inputSchema. Ne devinez jamais les paramètres.
  3. Utilisez execute_as — le modèle de sandbase_inspect montre exactement comment appeler.
  4. Respectez la pile de l'utilisateur — ne remplacez pas ses outils existants.
  5. Commencez petit — utilisez des limites faibles pour les premiers appels des outils de scraping/recherche.
  6. Interrogez les exécutions asynchrones — utilisez sandbase_run_get pour les opérations longues.
  7. Signalez les coûts — mentionnez les tarifs lorsque l'utilisateur se soucie du budget.
  8. Un appel par tour — attendez les résultats avant l'appel suivant.

Skills associés