面向 AI 智能体的网页搜索 API

1. 获取密钥

   注册，充值 $5 起，然后在 API 密钥页面创建一个密钥。工具目录本身是公开的，所以在拿到密钥之前，你就可以查看输入结构和价格。

2. 搜索网页

   在 input 中发送查询，并可选地设置 count（1 到 50 条结果）。价格按每次搜索计算，count 不会改变价格。

   cURLPythonNode.js

   Shell

   curl https://lovelyrouter.com/v1/tools/web-search/run \
     -H "Authorization: Bearer $LOVELY_API_KEY" \
     -H "content-type: application/json" \
     -d '{
       "input": {"query": "electric car prices site:reuters.com OR site:bloomberg.com after:2026", "count": 10},
       "max_results": 1
     }'

3. 阅读值得读的页面

   把一个 URL 传给 web-fetch，即可以 Markdown 格式拿到它的标题和正文，不含菜单和广告。

   cURL

   curl https://lovelyrouter.com/v1/tools/web-fetch/run \
     -H "Authorization: Bearer $LOVELY_API_KEY" \
     -H "content-type: application/json" \
     -d '{"input": {"url": "https://en.wikipedia.org/wiki/Web_search_engine"}, "max_results": 1}'

默认情况下，每个请求最多等待运行 60 秒（wait 最高可设为 300）。已完成的运行返回 200，带有 charge_usd 以及 items 中的结果；耗时更长的运行返回 202 和一个用于轮询的路径。两种情况都在运行工具中有说明。

web-search 会识别 query（1 到 128 个字符）中的这些运算符：

google-news 支持 "精确短语"、OR、-word、site: 和 intitle:；google-search 接受的运算符与你在 Google 中输入的一样。

连接 MCP 服务器后，你的智能体就会获得 web_search 和 web_fetch 两个工具，与数据工具目录中的其他工具并列。服务器会告诉智能体：凡是需要查找或阅读的内容都用它们，浏览器智能体只留给需要点击操作的页面。结果以简短的编号列表返回，web_fetch 会把长页面按约 12,000 个字符分段返回，继续阅读免费。

claude mcp add --transport http lovely-tools https://lovelyrouter.com/mcp \
  --header "Authorization: Bearer $LOVELY_API_KEY"

然后在 Claude Code 中提问：“在新闻网站上搜索本周关于固态电池的公告，阅读最相关的三篇文章，总结有哪些变化，并附上链接。” Cursor、Claude Desktop 和其他客户端的配置方法见 MCP 服务器。

web-search 按每次搜索计费，$0.0009，无论你要 1 条还是 50 条结果；没有结果的搜索不收费。web-fetch 按每个页面计费，价格相同；无法读取的页面不收费。Google 搜索按结果页计费，Google 新闻按文章计费，Google 趋势按调用计费，实时价格见上方卡片。

每次运行都会先从你的预付费余额中预留其最高费用，再按实际返回的内容结算，因此运行开始前你就知道它最多花多少钱。失败的运行只为已交付的结果付费。没有订阅；所有工具和模型的价格见价格页。