黑色星期五充值赠礼·充值 $50 起送 $10 · 充值 $100 起送 $25·11月30日截止充值 →

一条命令为 Claude Code 接入联网搜索与无头浏览器

仅需一条终端命令即可为 Claude Code 添加远程 MCP 服务器,使用单一预付费 API 密钥实现实时联网搜索、网页抓取与浏览器截图。

2026年11月14日 · 阅读约 2 分钟

一条终端命令即可为 Claude Code 解锁 claude code web search 与无头浏览器支持:注册 Lovely Router MCP 服务器。仅需一个远程 Model Context Protocol(MCP)端点,配合单一预付费 API 密钥,即可覆盖实时网络搜索、Markdown 页面抓取与整页渲染。你无需在本地安装繁琐的浏览器二进制文件,也不必单独维护多套搜索平台的 API Key。

Shell
claude mcp add lovelyrouter \
  --transport http \
  https://api.lovelyrouter.com/mcp \
  --header "Authorization: Bearer $LOVELYROUTER_API_KEY"

完成配置后,Claude Code 便可在终端会话中实时检索最新网页、阅读训练截止日期之后发布的官方文档、爬取多页面站点,并直接对渲染后的网页进行截图。

为什么内置网络工具在实际任务中屡屡碰壁#

Claude Code 原生自带 WebSearch 和 WebFetch,详见 Claude Code Python Agent SDK 参考文档。在托管环境中,Claude 平台 Web Search 工具允许模型在搜索结果进入上下文窗口之前进行预过滤。对于排查公开报错信息或阅读静态博客,这些默认功能尚能胜任;但在面对以下三项常见工程任务时,它们往往力不从心。

自定义端点与更新的模型往往无法直接使用默认工具。Claude Code Agent SDK 文档指出,除非显式指定,否则部分内置工具默认仅对 Claude Opus 4.7、Claude Sonnet 4.6、Claude Haiku 4.5 及更早的模型生效。一旦将 Claude Code 路由至自定义 Base URL,或切换到像 claude-sonnet-5.5 或 claude-opus-5.5 这样的新模型 ID,原生搜索便可能不会挂载到会话中。

静态 HTTP 请求无法获取 JavaScript 渲染的界面或视觉布局。如果你让编程 Agent 查看竞品定价切换按钮的实际渲染效果,或检查客户端单页应用(SPA),原始 HTML 抓取返回的往往只是一个空壳。claude code mcp browser 类工具解决了这一难题:它将页面渲染与截图任务交由云端浏览器 Worker 处理,而不是将臃肿杂乱的原始 DOM 树硬塞进推理模型的上下文窗口。

本地浏览器 MCP 服务器依赖过重。在开发机或 CI 容器中运行无头 Chromium 极度消耗内存,容易触发目标网站的防爬虫风控,还会迫使主推理模型陷入底层的点击与导航死循环。将搜索、抓取以及 浏览器 Agent 任务卸载至远程工具服务器后,本地环境即可保持轻量清爽,Token 消耗也更加透明可控。

添加 MCP 服务器,用一个 Key 统管模型与工具#

将 Lovely Router 连接到 Claude Code 有两种方式:将其 MCP 工具挂载到你现有的配置中,或者将 Claude 推理模型与 MCP 数据工具统一通过同一个预付费 API 密钥进行路由。一个 Key 意味着无论是 Claude、GPT、Gemini 的 Token 消耗,还是网络工具的按次调用费用,都从同一份账户余额中扣除。

在注册 MCP 服务器之前,先导出 API 密钥并将 Claude Code 指向 Lovely Router 的 Anthropic 兼容端点:

Shell
# 1. Point Claude Code at Lovely Router for model inference
export ANTHROPIC_BASE_URL="https://api.lovelyrouter.com"
export ANTHROPIC_API_KEY="lr_live_your_api_key_here"

# 2. Register the remote MCP server for web search and browser tools
claude mcp add lovelyrouter \
  --transport http \
  https://api.lovelyrouter.com/mcp \
  --header "Authorization: Bearer $ANTHROPIC_API_KEY"

# 3. Verify the tools are registered
claude mcp list

运行 claude --model claude-sonnet-5.5 启动会话,Agent 即可在本地文件系统和 bash 工具旁边看到远程 Agent 数据工具。你不需要编写任何包装脚本或手动定义工具 Schema。当 Prompt 需要外部数据时,Claude Code 会自动调用 MCP 服务器暴露的各项工具:

  • web-search:执行自然语言网络检索,返回结构化的 URL 与摘要,单次搜索 $0.00090。
  • google-search:当需要精确的 SERP 排序或特定域名的高级搜索指令查询时,抓取完整的 Google 结果页面,每页 $0.0013。
  • web-fetch:读取单个网页并将其主要内容转换为干净的 Markdown,每页 $0.00090。
  • website-crawl:将多页面的文档站点或子域名完整爬取并转为 Markdown,每页 $0.01 另加每次运行 $0.01。
  • website-screenshot:在真实浏览器中渲染目标网页并截取屏幕快照,每张截图 $0.0027。

如果想在 Claude Code 之外测试工具,或在 Agent 编写的 Python 脚本中调用该端点,只需使用相同的 Key 请求 REST API:

Python
import os
import requests

API_KEY = os.environ["ANTHROPIC_API_KEY"]
headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
}

# Run a web search and capture a browser screenshot of the top result
search_resp = requests.post(
    "https://api.lovelyrouter.com/v1/tools/web-search",
    headers=headers,
    json={"query": "Stripe Webhook signature verification v2026"},
    timeout=30,
)
top_url = search_resp.json()["results"][0]["url"]

screenshot_resp = requests.post(
    "https://api.lovelyrouter.com/v1/tools/website-screenshot",
    headers=headers,
    json={"url": top_url},
    timeout=60,
)
print("Rendered screenshot URL:", screenshot_resp.json()["screenshot_url"])

完成过去 Claude Code 无法搞定的复杂任务#

以一个在纯离线终端中注定失败的任务为例:将计费集成迁移到最新发布的 SDK,并验证线上测试环境的结账页面是否仍能正常渲染各地区的支付方式。

如果没有联网搜索和浏览器支持,Claude Code 只能根据过时的训练数据猜测 SDK 方法名、臆造已被弃用的 Webhook 请求头,并且根本无法查看 staging 环境的实际页面。但在挂载了 MCP 服务器后,只需一条 Prompt 即可完成:

Text
claude -p "Search for the latest webhook verification changes in our payment provider's docs, crawl their migration guide to markdown, update src/webhooks.ts, and take a screenshot of our staging checkout page plus two competitor checkout pages to verify the layout."

在编写代码前,Claude Code 会将任务拆解为四个工具步骤:

  1. 信息检索(web-search):Agent 执行 4 次针对性搜索,找到最新的更新日志、Webhook 签名规范以及两个用于参考的线上结账页面。
  2. 文档深度阅读(website-crawl):Agent 无需逐页抓取 URL,而是直接对包含 8 个页面的迁移指南触发一次爬取任务(website-crawl),将提取出的干净 Markdown 填入上下文。
  3. 单页精准验证(web-fetch):Agent 读取 5 个特定的 GitHub Issue 页面和 API 参考端点,核实时间戳容差等边缘情况。
  4. 视觉检查(website-screenshot):由于 Claude 是多模态模型,Agent 对 3 个线上结账页面 URL 调用 website-screenshot,分析返回的截图以确认支付按钮和费率说明没有发生布局错位,随后修改本地的 TypeScript 文件。

Claude Code 在各轮工具调用间将系统提示词、代码仓库文件树以及爬取的 Markdown 保存在内存中,因此初始爬取之后,Prompt Caching 吸收了绝大部分 Token 成本。任务执行完毕后,在 Claude Code 会话中运行 /cost 即可查看当前代码仓库消耗的精确 Token 数据。

单次迁移与浏览器验证任务的成本分析#

以下是在 claude-sonnet-5.5 上执行上述任务的完整成本拆解。Agent 共处理了 50,000 个未命中缓存的输入 Token(新增的工具输出与 Prompt)、多轮工具交互循环中的 150,000 个缓存输入 Token,以及用于推理与生成代码 Diff 的 8,000 个输出 Token。

项目数量单价费用
Claude Sonnet 5.5 输入 (claude-sonnet-5.5)0.05M tokens$2.00 per 1M$0.10000
Claude Sonnet 5.5 缓存输入 (claude-sonnet-5.5)0.15M tokens$0.10 per 1M$0.01500
Claude Sonnet 5.5 输出 (claude-sonnet-5.5)0.008M tokens$10.00 per 1M$0.08000
网络搜索 (web-search)4 searches$0.00090 per search$0.00360
读取网页 (web-fetch)5 pages$0.00090 per page$0.00450
网站爬取为 Markdown (website-crawl pages)8 pages$0.01 per page$0.08000
网站爬取为 Markdown (website-crawl run)1 run$0.01 per run$0.01000
网页截图 (website-screenshot)3 screenshots$0.0027 per screenshot$0.00810
总计$0.30120

包含调试、文档爬取与浏览器视觉检查在内的整套流程总花费仅为 $0.30120。其中 LLM Token 费用为 $0.10000 + $0.01500 + $0.08000 = $0.19500。四项网页与浏览器工具的费用合计为 $0.00360 + $0.00450 + $0.08000 + $0.01000 + $0.00810 = $0.10620。如果需要应对更深层次的架构重构,将该工作流切换至 claude-opus-5.5(每 1M 输入 Token $4.00,每 1M 输出 Token $20.00,每 1M 缓存输入 Token $0.20),也仅有 Token 行的费用会变动,MCP 工具费用则完全保持一致。

扩展至 CI 中的自动化夜间巡检#

一旦交互式 MCP 配置调试完毕,即可在 CI 中以无头模式运行 Claude Code(claude -p "..." --output-format json),用于自动化审计外部依赖、监控竞品定价页面变动,或在每晚定期巡检生产环境页面与联系表单的渲染是否正常。

对于高频任务,搭配使用 claude-haiku-5.5 与搜索提取工具,一个月的批量运行总开销可控制在十美元以内。假设一个夜间任务在 30 天内检查 50 个 Google 搜索结果页(google-search)、读取 100 个目标网页(web-fetch)、截取 30 张浏览器屏幕快照(website-screenshot),并从 20 个合作伙伴域名中提取联系方式(website-contacts,每个网站 $0.015 另加每次运行 $0.0015)。整月下来,claude-haiku-5.5 处理 2M 输入 Token、10M 缓存输入 Token 以及 0.5M 输出 Token。

项目数量单价费用
Claude Haiku 5.5 输入 (claude-haiku-5.5)2M tokens$0.10 per 1M$0.20000
Claude Haiku 5.5 缓存输入 (claude-haiku-5.5)10M tokens$0.01 per 1M$0.10000
Claude Haiku 5.5 输出 (claude-haiku-5.5)0.5M tokens$0.50 per 1M$0.25000
Google 搜索 (google-search)50 pages$0.0013 per page$0.06500
读取网页 (web-fetch)100 pages$0.00090 per page$0.09000
网页截图 (website-screenshot)30 screenshots$0.0027 per screenshot$0.08100
获取邮箱与联系人 (website-contacts sites)20 websites$0.015 per website$0.30000
获取邮箱与联系人 (website-contacts runs)20 runs$0.0015 per run$0.03000
总计$1.11600

这套运行 30 天的流水线仅需 $1.11600。每项工具都采用固定的单项或单次运行计费模式,便于提前锁定 CI 预算,即便浏览器陷入死循环也不会无休止地消耗昂贵的推理 Token。

立即配置 Claude Code MCP 工具#

创建预付费 API 密钥,在终端中运行 claude mcp add,并参考完整指南为 Claude Code 赋予联网搜索与浏览器功能。

亲自试试

一个预付费密钥,无需订阅。本文中的每个价格都是你实际支付的价格。

继续阅读

全部文章 →