SandBase

@sandbaseai/cli

为你的 AI Agent 赋予超能力。一行命令即可接入 2,000 多种 AI 模型和 API。每天可免费调用数据 API 100 次，之后从同一余额按次付费。

English | 中文 | 日本語 | 한국어 | Español | Français | Deutsch | Português

---

你的 AI 编码助手很聪明，却被困在一个盒子里。它无法搜索网页、查看社交媒体、生成图像或获取实时数据——除非你亲自接入每个 API。

SandBase 改变了这一切。 一条命令即可通过 Model Context Protocol 将你的 Agent 连接到 2,000 多种 AI 模型和 API。无需管理 API 密钥，也没有繁琐的配置。

如果你想直接通过 HTTP 构建，而不是使用 MCP，请从 SandBase API 快速入门 开始， 或将统一的 LLM、图像和视频 API 与专用模型网关进行比较。

安装

将以下内容粘贴到你的 Agent 中，剩下的交给它处理：

set up https://www.sandbase.ai/SKILL.md

它会读取 SandBase Skill、自行运行 connect，并请你批准一次浏览器登录。你也可以选择自行操作：

npx -y @sandbaseai/cli@latest connect

或者在 macOS 或 Linux 上安装官方 Homebrew formula：

brew install sandbaseai/tap/sandbaseai-cli
sandbase connect

请参阅 Homebrew 发布公告和 macOS/Linux CI 证据。

批准一次浏览器授权后，每个受支持的客户端都可以通过本地 MCP 桥接器发现、 检查并运行可用的 SandBase 模型和 API。之后请启动新会话，以便加载 sandbase_* 工具。

每个 GitHub 版本都会在 tarball 旁发布自己的 SHA-256 值，因此你可以固定 并验证确切的构建版本，而不是追踪 latest：

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

想在登录或更改配置前检查兼容性？客户端目录是只读命令——不会写入任何内容，也无需账户：

npx -y @sandbaseai/cli@latest catalog --json

_{对空的隔离配置文件进行的只读目录审计和有限范围的 doctor 检查。}

Homebrew 用户可以运行同样的只读检查：sandbase catalog --json。

费用

	价格
数据 API——搜索、社交、抓取、电商、金融	每个组织每天可免费调用 100 次，之后按次付费（价格由 sandbase inspect 显示）
发现、检查、运行状态、余额、文件上传	免费
模型——LLM、图像、视频、音频	按次或按百万 token 付费

sandbase inspect <tool> 始终会在你运行任何内容前显示当前价格； 符合每日免费额度条件的数据 API 也会显示 pricing.free_quota。这 100 次 免费调用由符合条件的数据 API 共享，并于 00:00 UTC 重置；之后 按次计费。sandbase balance --json 会以 free_api_quota 显示今日剩余的免费 调用次数。价格可能会变动，因此请以实时响应为准，不要依赖本文件中的示例。

访问 SandBase CLI 官方项目页面查看简要概览。 如需了解客户端检测、MCP 工具和回滚的安全指南，请阅读 25 个客户端的 SandBase CLI 设置指南。 AI Agent 和自动安装程序可以使用简明的 llms-install.md说明。

SandBase 开源技术栈

• SandBase Harness — 可自托管的 Agent 运行时，支持持久会话、沙箱隔离、审批、审计和回放。
• SandBase Agent Skills — 88 个可安装的 Skill，适用于研究、社交智能、营销和业务工作流。
• SandBase for Codex — 官方 Codex 插件，包含 SandBase MCP 桥接和引导式 Agent Skill；其必需的 HOL 安全扫描已在 main 上通过。

在官方 MCP Registry中查找经过身份验证的远程桥接服务， 阅读其Registry 社区展示帖，或通过 中国独立开发者、 Awesome MCP、 Glama、 TensorBlock MCP Index、 MCPRepository、 VaultPlane、 AIMCP、 MCP Server Hub、 MCP Server Spot，或 Awesome AI API Proxy找到它。 外部维护者已将 SandBase 纳入 Awesome Codex CLI、 Awesome Agent Skills和 Awesome MCP Server。 Hermes 集成也独立列入了 Hermes Atlas生态目录，并作为测试版列入 Awesome Hermes Agent。 可从以下平台安装已验证的 sandbase Agent Skill from skills.sh、 SkillsCat 上的 sandbaseai/cli/sandbase 条目、 skills.re 上的 sandbaseai/cli/sandbase 条目、 vSkill 上评分为 93/100 的已验证 SandBase 条目、 Skillstore 上经过安全审计的 SandBase 条目，或 Agent Skill Hub 上带版本的 sandbaseai/sandbase 快照。

---

可验证的 Agent 工作流

连接后，请让你的 Agent 按照相同的可检查顺序使用搜索、数据 API、大模型、图像生成、视频生成及目录中的其他功能：

1. 使用 sandbase_discover 按任务或功能查找候选项。
2. 使用 sandbase_inspect 查看当前输入架构、定价和执行要求。
3. 在调用 sandbase_run 之前，确认选定的端点和参数。数据 API 每个组织每天（UTC）提供 100 次免费调用，之后按次计费，和模型一样；付费运行前，请确认 sandbase_inspect 显示的费用。
4. 对于异步任务，使用返回的 run_id 调用 sandbase_run_get，而不是创建重复运行。
5. 使用 sandbase_runs 查看近期运行状态和记录的费用。
6. 使用 sandbase_account 查看当前账户余额。

例如，可以先发起一项不计费的发现请求：

查找适用于方形产品插图的图像模型。比较两个最佳候选项所需的输入和当前定价。暂时不要运行任何一个模型。

发现和检查永不收费，因此 Agent 始终可以先浏览目录，再决定是否调用。

查看实时响应后，请明确批准你想要运行的端点和输入。目录条目、架构、定价、延迟和可用性都可能变化，因此请使用当前会话中的工具响应，而不是静态示例。

请参阅完整的 Claude Code 和 Codex 演练指南或中文工作流指南。如需查看实时目录示例，请阅读 GitHub 连接器的发现与检查实测记录。

---

包含内容

类别	工具	可执行操作
网页搜索	Google、Exa、Tavily、Scholar	实时研究任何主题
社交媒体	Twitter/X、YouTube、Reddit、Instagram、TikTok、小红书、微博、Bilibili	监控趋势、获取帖子、分析内容
抓取	Firecrawl、Exa Content	从任何公开网页提取数据
AI 模型	GPT-4o、Claude、Gemini、DeepSeek、Qwen、Llama	无需管理密钥即可运行任何模型
图像生成	Flux、DALL-E、Ideogram、Recraft	创建徽标、插图、样机
视频生成	Kling、MiniMax、Runway、Luma	生成短片和动画
音频	ElevenLabs、Whisper	文本转语音、转录
电子商务	Taobao、Amazon	商品研究、价格比较
金融	股票数据、公司信息	市场研究与分析

---

支持的客户端（25 个目标）

适用于所有主流 AI 编码工具：

自动配置	手动设置
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

无需登录或更改任何文件，即可预览完整的兼容性目录：

npx -y @sandbaseai/cli@latest catalog --json

# Connect all detected clients at once
npx -y @sandbaseai/cli@latest connect

# Or target one specific client
npx -y @sandbaseai/cli@latest connect --client cursor

OpenClaw 快速入门

直接以 OpenClaw 为目标，然后让 CLI 读取托管的 MCP 服务和 SandBase Skill，再开始使用：

npx -y @sandbaseai/cli@latest connect --client openclaw
npx -y @sandbaseai/cli@latest doctor --client openclaw

当 doctor 报告凭据、MCP 桥接和 Skill 均已配置后，重启 OpenClaw，并提出一个需要使用 SandBase 的自然语言请求。如果 OpenClaw 已有一个名为 sandbase 的非 SandBase MCP 服务，安装程序会保留它，不会覆盖。之后如需移除托管的 MCP 条目和本地凭据：

npx -y @sandbaseai/cli@latest unregister --client openclaw

OpenClaw 目前没有受支持的 Skill 移除命令，因此 unregister 会报告这一限制，并保留已验证的 SandBase Skill。

Hermes 快速入门

SandBase 可以在一次授权流程中安装其托管的 Hermes Skill 和本地 MCP 条目：

npx -y @sandbaseai/cli@latest connect --client hermes
npx -y @sandbaseai/cli@latest doctor --client hermes

doctor 会验证归 SandBase 管理的本地凭证、MCP 条目和 Skill。重启 Hermes，在新的客户端会话中确认原生发现，然后使用 SandBase Skill 或 MCP 工具。现有的非 SandBase MCP 条目 sandbase 不会受到影响。若只移除由 SandBase 管理的 Hermes 配置、Skill 和本地凭证，同时保留供其他客户端使用的共享桥接：

npx -y @sandbaseai/cli@latest unregister --client hermes

该集成还被独立收录于 Hermes Atlas 和 Awesome Hermes Agent。

---

工作原理

┌─────────────────┐         ┌───────────────┐         ┌────────────────────┐
│   Your Agent    │  MCP    │  Local Bridge │  HTTPS  │    SandBase API     │
│  (Cursor, etc.) │────────▶│  (on-demand)  │────────▶│ 2,000+ models/APIs │
│                 │◀────────│               │◀────────│                    │
└─────────────────┘         └───────────────┘         └────────────────────┘

1. 运行 connect → CLI 打开浏览器进行身份验证 → 你批准
2. API 密钥保存在本地（文件权限为 0600）
3. 为你的客户端配置 MCP 桥接
4. Agent 按需调用工具。无需守护进程，也无需后台进程。

---

命令

CLI 命令

sandbase connect [--client <name>]    # Authorize + configure
sandbase setup                        # After upgrading: refresh the local bridge + Skill, test connectivity
sandbase doctor [--client <name>]     # Local checks plus one real round trip to SandBase
sandbase unregister [--client <name>] # Remove configuration
sandbase catalog --json               # List all supported clients

Agent 命令（Shell 传输，与 MCP 工具功能相同）

没有 MCP 或 MCP 会话出现故障的 Agent，可通过 Shell 使用同一目录。凭证会由 connect 自动提供（也可使用 SANDBASE_API_KEY / sandbase keys add -k <key>）。

sandbase discover -q "twitter posts"                       # search; -t api|llm|multimodal|embedding|service
sandbase inspect sandbase_twitter_web_search_timeline       # fields, price, ready-to-run command
sandbase run sandbase_twitter_web_search_timeline -i '{"keyword":"AI agents"}'
sandbase run <video_tool> -i '{"prompt":"..."}' -w -o result.json   # wait with backoff, save output to disk
sandbase runs get -r <run_id> -w -o result.json            # resume a long run instead of re-running it
sandbase upload ./photo.png                                # local image/audio/video -> public URL for tools that take a URL
sandbase runs list | sandbase balance

-j 会输出 JSON；错误格式为 {"error":{"code","message","hint"}}，其中 hint 包含下一步操作。退出代码：0 表示成功或仍在运行，1 表示失败（包括运行失败），2 表示用法错误。

同步工具（大模型、大多数数据 API）会直接返回结果；异步工具（图像、视频、音频任务）会返回运行 ID——使用 -w 等待，或稍后通过 sandbase runs get -r <run_id> 获取。如果无法连接 api.sandbase.ai，桥接会继续显示 SandBase 工具并提供可执行的错误信息，而不是移除服务。

MCP 工具（连接后可供你的 Agent 使用）

工具	用途
sandbase_discover	搜索全部 2,000 多个可用 AI 模型和 API——免费
sandbase_inspect	获取输入架构、当前价格和可直接运行的模板——免费
sandbase_run	执行模型或 API 端点——符合条件的数据 API：每个组织每天 100 次免费调用，之后按次付费；模型：按次付费
sandbase_run_get	轮询异步运行的状态或结果（如视频生成）——免费
sandbase_runs	列出近期运行记录及其费用——免费
sandbase_account	查看账户余额和当天的数据 API 免费调用次数（free_api_quota）——免费
sandbase_run_cancel	取消 Agent Service 运行——免费

推荐工作流：

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

---

安全性

• URL 或 CLI 参数中不包含密钥——使用带 PKCE 的 OAuth 设备流
• 限制文件权限——凭证以 0600 权限存储
• 按所有权更新——保留现有的 JSONC 注释和用户管理的 MCP 条目
• 精确回滚——发生故障或执行 unregister 时，只移除由 SandBase 管理的配置
• 随时撤销——在 SandBase Dashboard 中一键撤销

---

开始使用

npx -y @sandbaseai/cli@latest connect

然后让你的 Agent 执行一件以前做不到的事。

创建账户 →——每个组织每天都可免费调用数据 API 100 次。

如果 SandBase 帮你节省了设置时间，为仓库点星——这有助于更多 Agent 用户发现这个项目。

---

链接

• SandBase 平台
• 文档
• CLI 设置指南
• CLI 深入介绍：English · 中文
• 六工具实用工作流：English · 中文
• npm 软件包
• 官方 Codex 插件
• 控制台

社区

• 提问或分享你的作品
• 报告可复现的错误
• 提出集成或改进建议
• 为 SandBase CLI 做贡献

社区整理的收录列表：

• 官方注册表社区展示
• VaultPlane MCP 目录
• 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

许可证

Apache-2.0