跳到正文
MCP · npx · pip

浏览器 MCP 服务器,拥有真实的身份

把 Clearcote 加入你的 MCP 客户端配置,模型就有了一个浏览器,可以通过 20 个工具在其中阅读、点击和输入。身份只需在环境变量中设置一次,所以工具列表保持精简,智能体工作期间指纹也始终一致。

无需密钥即可运行开源版构建。加上免费的 GitHub 密钥,就能用上最新构建。

加入你的客户端配置

{
  "mcpServers": {
    "clearcote": {
      "command": "npx",
      "args": ["-y", "clearcote-mcp"],
      "env": {
        "CLEARCOTE_FINGERPRINT": "acct-1",
        "CLEARCOTE_TIMEZONE": "America/New_York",
        "CLEARCOTE_ACCEPT_LANGUAGE": "en-US"
      }
    }
  }
}

亮点

20 个工具

navigate、read_page、page_elements、click、fill_field 和 screenshot_page,另有等待、按键、标签页、cookie、PDF 和已保存会话等工具。

身份不写在提示词里

种子、平台、品牌、语言和时区都通过 CLEARCOTE_* 环境变量设置。模型完全不必去琢磨指纹。

你已经在用的客户端

Claude Desktop、Cursor 和 Cline 的配置格式相同。从 PyPI 安装,然后直接运行,或通过 npx 启动器运行。

没有自动化开关

服务器启动浏览器时不带 Playwright 的自动化开关,所以 navigator.webdriver 保持为 false,而引擎会把常见的 CDP 副作用挡在页面之外。

通往原始 CDP 的出口

get_cdp_endpoint 返回浏览器的 CDP URL,脚本可以接手智能体正在使用的同一个会话。

最新构建,一个变量搞定

加上 CLEARCOTE_LICENSE_KEY,即可运行最新的授权版构建,而不是开源版构建。

MCP 服务器如何工作

服务器启动一个 Clearcote 浏览器,并在自身运行期间一直保留它。每次工具调用都作用于这个共享的浏览器:模型以文本或 markdown 形式读取页面,列出可见的链接、按钮和输入框(能给出 CSS 选择器的都附上),再用这些选择器进行操作,所以它很少需要自己写选择器。

身份在服务器启动时就已固定。身份画像的基础项(种子、平台、品牌、语言、时区、代理和 geoip)都是 CLEARCOTE_* 变量,所以一个服务器条目就是一个身份,没有任何工具能在任务进行到一半时修改它。其余的指纹参数,请直接使用 SDK。

让模型掌控 Clearcote 有两种方式。这个服务器把模型放在浏览器之外,通过调用工具来操作。浏览器内置智能体则运行在浏览器进程内部,与你选择的兼容 OpenAI 的端点通信。

最常用的工具

工具作用
read_page以文本或 markdown 形式读取实时页面
page_elements列出最多 200 个可见的链接、按钮和输入框,能给出 CSS 选择器的都附上
click点击一个元素
fill_field在输入框或文本区域中输入
screenshot_page整页 PNG 截图,保存到服务器的写入目录
navigate在当前标签页中加载 URL,并返回最终的 URL 和标题
save_profile把 cookie 和存储保存到一个命名文件,以便稍后恢复 cookie
get_cdp_endpoint返回供原始客户端使用的 CDP URL

此外还有 get_page_html、press_key、wait_for、evaluate_js、current_page、get_cookies、list_tabs、new_tab、close_tab、load_profile、get_egress_info 和 save_page_pdf(仅限无头模式)。

典型用途

用真实浏览器做研究

让模型阅读需要 JavaScript 才能渲染的页面,而不是只抓取纯文本。

日常网页杂务

注册、设置页面和控制台,这些原本需要你手动一路点下去的操作。

借助助手调试

让 Cursor 在你的预发布站点上复现一个 bug,并为每一步截图。

自动化原型开发

先和模型一起把流程走一遍,再拿到 CDP 端点,把它写成脚本。

Clearcote 专为隐私保护、测试、研究和合法自动化而打造。你须对自己的使用方式负责,并遵守所访问网站的条款。

哪些套餐包含此功能

MCP 服务器在所有套餐中都免费。除非找到许可证密钥(CLEARCOTE_LICENSE_KEY,或由 clearcote login 保存的密钥),否则它运行开源版构建;免费的 GitHub 密钥可以运行最新构建,同一时间一个浏览器。

对比套餐

常见问题

它支持哪些 MCP 客户端?

从配置文件启动 MCP 服务器的客户端都可以。上面展示的是 Claude Desktop,Cursor 和 Cline 的配置格式与之相同。

模型能控制指纹吗?

不能。身份在服务器启动时由环境变量决定,没有任何工具能修改它。这样身份画像在整个会话中保持一致,工具列表也更精简。

需要 Node 还是 Python?

无论哪种方式,都需要 Python 3.10 或更高版本:npm 包只是同一个 Python 服务器的启动器。按照上面的安装代码块用 pip 安装,并把 mcp 锁定在 2.0 以下(clearcote-mcp 0.1.0 无法在 mcp 2.x 上运行),然后把 clearcote-mcp 或 npx -y clearcote-mcp 作为命令。

它和浏览器内置智能体有什么区别?

MCP 服务器让外部模型(你聊天客户端里的那个)通过工具驱动浏览器。浏览器内置智能体则运行在浏览器内部,调用你配置的模型端点。两者驱动的是同一个引擎。

脚本能接管智能体的会话吗?

可以。get_cdp_endpoint 会返回智能体正在使用的浏览器的 CDP URL,Playwright 或 Puppeteer 可以连接上去。

在文档中深入了解

相关功能

试用 Clearcote

可直接接入 Playwright 与 Puppeteer,一直到 TLS 握手都保持一致,并提供开源构建作为起点。

通过 GitHub 可免费使用一个浏览器。无需信用卡。