Fetch Browser

Fetch Browser是一个强大的无头浏览器MCP服务器，专为AI代理设计，无需API密钥即可获取网页内容和执行Google搜索。支持多种内容格式转换和智能错误处理。

浏览器自动化开发者工具 .TypeScript

评分 : 2.5分

下载量 : 103

更新时间 : 2025-04-28

什么是Fetch Browser?

Fetch Browser 是一个功能强大的MCP服务器，它允许AI代理通过无头浏览器直接抓取网页内容并执行Google搜索，无需任何API密钥。

如何使用Fetch Browser?

通过简单的命令行工具，您可以轻松地对网页进行抓取或搜索Google。只需提供URL或搜索关键词即可获取所需内容。

适用场景

适用于需要快速抓取网页内容、执行Google搜索以及处理多种数据格式的场景。

主要功能

无需API密钥使用现代无头浏览器技术，直接访问网页内容。

智能Google搜索提取Google搜索结果的结构化数据，支持新闻和网络搜索，可自定义结果数量。

通用内容抓取支持任何网页或API端点的抓取，并支持多种输出格式（HTML、JSON、Text、Markdown）。

格式转换将HTML转换为Markdown，美化JSON输出，生成结构化的HTML和纯文本。

安全特性响应大小限制、请求超时保护、速率限制保护和详细的错误处理。

优势与局限性

优势

无需API密钥即可运行

支持多种输出格式

自动重试机制和错误处理

灵活的搜索引擎集成

局限性

可能受到目标网站的反爬虫策略影响

某些高级功能需要较高的系统资源

如何使用

安装Fetch Browser

通过Smithery CLI或手动克隆代码仓库来安装Fetch Browser。

启动服务器

完成安装后，运行命令启动服务器。

执行命令

使用提供的工具如`fetch_url`或`google_search`来抓取网页或搜索Google。

使用案例

案例1: 抓取网页内容抓取某个网站的内容并将其转换为Markdown格式。

案例2: Google搜索搜索关于人工智能的相关信息并提取前10条结果。

常见问题

Fetch Browser 是否需要API密钥？

如何更改搜索结果的数量？

🚀 无头浏览器 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 格式

<!DOCTYPE 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 文件。