🚀 无头浏览器 MCP 服务器
无头浏览器 MCP 服务器功能强大，允许 AI 代理直接获取网页内容并执行 Google 搜索，无需任何 API 密钥。它基于现代网络标准构建，专为与 AI 平台无缝集成而设计。
✨ 主要特性
- 无需 API 密钥：采用高级的无头浏览器方法直接抓取内容。
- 智能 Google 搜索：
- 提取结构化搜索结果。
- 支持网页和新闻结果。
- 可配置的结果数量（1 - 100）。
- 完整搜索结果内容获取。
- 自动重试和错误处理。
- 通用内容抓取：
- 支持任何网页或 API 端点。
- 多种输出格式（HTML、JSON、文本、Markdown）。
- 自动内容类型检测。
- 响应大小限制和超时保护。
- 速率限制保护。
- 格式转换：
- 清洁 HTML 转换为 Markdown。
- 整洁打印的 JSON 响应。
- 结构化 HTML 输出。
- 带有适当格式的纯文本。
📦 安装指南
通过 Smithery
# 对于 Claude
npx -y @smithery/cli install @TheSethRose/fetch-browser --client claude
# 对于 Cursor
npx -y @smithery/cli install @TheSethRose/fetch-browser --client cursor
# 对于 TypeScript
npx -y @smithery/cli install @TheSethRose/fetch-browser --client typescript
手动安装
# 克隆仓库
git clone https://github.com/TheSethRose/fetch-browser.git
cd fetch-browser
# 安装依赖项
npm install
# 构建项目
npm run build
# 启动服务器
npm start
💻 使用示例
基础用法
1. Google 搜索工具（google_search）
执行 Google 搜索并获取结果的完整内容：
{
query: "你的搜索查询",
responseType: "markdown", // 或 "json", "html", "text"
maxResults: 10, // 1-100 个结果
topic: "web" // 或 "news"
}
2. URL 抓取工具（fetch_url）
从任意 URL 抓取内容：
{
url: "https://example.com",
responseType: "markdown", // 或 "json", "html", "text"
timeout: 30000 // 可选，以毫秒为单位
}
高级用法
在实际使用中，你可以根据不同的业务场景，灵活组合和调整上述工具的参数，以满足多样化的需求。例如，在进行大量数据抓取时，可以合理设置 maxResults 和 timeout 参数，避免因请求过于频繁或超时导致的错误。
📚 详细文档
响应格式
Markdown 格式
## [页面标题](https://example.com)
这是一段示例文本。
JSON 格式
{
"title": "示例页面",
"content": "这是 JSON 格式的示例内容。"
}
HTML 格式
html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>示例页面title>
head>
<body>
<h1>示例标题h1>
<p>这是 HTML 格式的示例内容。p>
body>
html>
文本格式
示例文本内容
错误处理
- 超时错误：当请求未在指定时间内完成时触发。
- 网络错误：由于连接问题导致的错误。
- 解析错误：无法解析返回的内容。
安全特性
- 速率限制：防止短时间内过多请求。
- IP 白名单：仅允许特定 IP 地址访问服务。
- 日志记录：记录所有请求和响应，便于调试和监控。
项目维护者
- Seth Rose
- 网站: srose.dev
- 简历: linkedin.com/in/sethroose
📄 许可证
本项目基于 MIT License 开源：
MIT License
版权 (c) 2024 Seth Rose
特此许可任何个人或组织使用、复制、修改、合并、发布、分发、再许可和/或销售本软件及其文档，以及制造、具有或分销该软件的副本，但需包含以下声明：本授权声明和版权声明。
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
如需详细信息，请参考 LICENSE 文件。