与 OpenCode 配合使用

关于 OpenCode

OpenCode 是一款终端 AI 编码代理（形态类似于 Claude Code 或 Aider），原生支持 Model Context Protocol - 既支持本地 stdio 服务器，也支持远程 HTTP 服务器，远程模式还提供 OAuth 和 bearer-auth 辅助工具。Crawlbase MCP 服务器属于本地 stdio 服务器，因此下方的本地配置代码块就是您需要的。

安装 OpenCode

如果您已经运行了 OpenCode，请跳过此部分。否则，标准安装方式如下：

# macOS / Linux / WSL - one-liner installer
curl -fsSL https://opencode.ai/install | bash

# Or via npm / Homebrew / paru - see opencode.ai for details

配置文件

OpenCode 从 JSON 配置文件中读取 MCP 服务器设置，该文件与其他设置放在一起。选择适合您的作用域 - 全局表示您用 OpenCode 打开的每个项目都能看到 Crawlbase 工具；按项目则表示仅包含该文件的仓库可用。

配置

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "crawlbase": {
      "type": "local",
      "command": ["npx", "-y", "@crawlbase/mcp@latest"],
      "enabled": true,
      "environment": {
        "CRAWLBASE_TOKEN": "YOUR_TOKEN",
        "CRAWLBASE_JS_TOKEN": "YOUR_JS_TOKEN"
      }
    }
  }
}

请注意 OpenCode 特有的键名：mcp（而非 mcpServers）、type: "local"（而非 "stdio"）、command 为字符串数组，以及 environment（而非 env）。npm 上的 Crawlbase MCP 包与所有其他客户端使用的是同一个 - 仅外层配置 schema 不同。

保存文件并重启 OpenCode。Crawlbase 工具会作为标准 MCP 工具呈现，代理可在对话中途自动调用；您无需在提示词中按名字明确提及它们。

在对话中使用

进入 OpenCode 会话，然后提出需要实时网络上下文的请求。代理会自行决定何时调用 Crawlbase 工具 - 您无需显式触发。

Pull the latest TanStack Query docs from
https://tanstack.com/query/latest and refactor our hooks
in src/hooks/useUser.ts to match the v5 API.

效果良好的使用模式

• 实时文档查询：「阅读最新的库文档并更新我们的用法」 - 比模型训练截止日期之前的内容更可靠。
• 竞品分析："看看 competitor 在其公开网站上是如何实现 feature 的，然后在我们的代码库中提出等价方案。"
• 构建时抓取：在代理任务内进行一次性数据获取 - 适用于数据过于临时或过于针对特定目标、不适合放入代码库的场景。