Fetch Browser

一个强大的无头浏览器MCP服务器，使AI代理能够获取网页内容并执行Google搜索，而无需任何API密钥。基于现代网络标准构建，并设计为与AI平台无缝集成。

功能

• 无需API密钥：使用高级无头浏览器方法直接获取内容

• 智能Google搜索：

  • 从Google搜索中提取结构化结果
  • 支持网页和新闻结果
  • 可配置的结果数量（1-100）
  • 完整地获取搜索结果的内容
  • 自动重试和错误处理

• 通用内容获取：

  • 支持任何网页或API端点
  • 多种输出格式（HTML、JSON、文本、Markdown）
  • 自动检测内容类型
  • 响应大小限制和超时保护
  • 防止请求频率过高

• 格式转换：

  • 清洁的HTML到Markdown转换
  • 格式良好的JSON响应
  • 结构化的HTML输出
  • 带有适当格式的纯文本

工具

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          // 可选，以毫秒为单位
}

安装

通过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

开发

# 监控模式自动重建
npm run watch

# 使用检查器运行
npm run inspector

# 调试模式
npm run debug

# 调试模式带监控
npm run debug:watch

响应格式

1. Markdown格式

## [页面标题](https://example.com)

转换为干净的Markdown内容，包括：
- 列表
- **粗体文本**
- *斜体文本*
- [链接](https://example.com)

2. JSON格式

{
  "url": "https://example.com",
  "content": "提取的内容...",
  "error": null
}

3. HTML格式

<div class="search-result">
  <h2><a href="https://example.com">页面标题</a></h2>
  <div class="content">
    原始HTML内容
  </div>
</div>

4. 文本格式

### https://example.com

保留格式的纯文本内容
==========

错误处理

• 自动重试并带有指数退避
• 防止请求频率过高
• 超时处理
• 详细的错误消息
• 单独跟踪每个结果的错误

安全特性

• 响应大小限制
• 请求超时
• 防止请求频率过高
• 不需要API密钥或秘密
• 正确的错误处理

致谢

由Seth Rose创建：

• 网站：https://www.sethrose.dev
• 𝕏 (推特)：https://x.com/TheSethRose
• 🦋 (Bluesky)：https://bsky.app/profile/sethrose.dev

许可证

MIT许可证 - 查看LICENSE以获取详细信息