返回 MCP 目录
public公开dns本地运行

oxylabs-mcp

Oxylabs MCP服务器为AI助手提供网页数据抓取服务,支持动态渲染、结构化提取和反封锁功能。

article

README

🚀 MCP 服务器 - Oxylabs 抓取器

MCP 服务器 - Oxylabs 抓取器提供了基于 Oxylabs 的网页抓取和解封功能,能帮助用户轻松实现通用网站抓取和访问难以访问的网站。

🚀 快速开始

本项目需要先进行安装,安装完成后即可运行使用。

📦 安装指南

克隆仓库

git clone <git:url>

安装依赖项

进入 mcp-server-oxylabs 目录:

cd mcp-server-oxylabs

# 创建虚拟环境并激活
uv venv

source .venv/bin/activate  # MacOS/Linux
# 或者
.venv/Scripts/activate  # Windows

# 安装依赖项
uv sync

💻 使用示例

基础用法

运行项目:

make run

然后访问 MCP 检查器控制台 http://localhost:5173。你可能需要在检查器中添加环境变量 OXYLABS_USERNAMEOXYLABS_PASSWORD

📚 详细文档

此服务器提供两个主要功能:

  1. oxylabs_scraper:使用 Oxylabs 网页抓取 API 进行通用网站抓取
  2. oxylabs_web_unblocker:使用 Oxylabs 网页解封器访问难以访问的网站

网页抓取 API 支持 JavaScript 渲染、解析结构化数据和清理为 Markdown 格式的 HTML。网页解封器 提供 JavaScript 渲染和清理后的 HTML,但不返回解析数据。

📄 许可证

此项目根据 MIT 许可证 发布。

🌟 关于 Oxylabs

Oxylabs 成立于 2015 年,是一家领先的网络情报收集平台,由最高业务、道德和合规标准驱动,帮助全球企业利用数据驱动的洞察力实现增长。

即贴即用配置

MCP 客户端配置生成器

选择客户端,补齐所需环境变量,再复制根据当前 MCP 公开配置生成的完整文件

terminal
环境变量lock填写内容仅保留在当前浏览器标签页,不会上传或保存
Claude Desktop
{
  "mcpServers": {
    "oxylabs_scraper_uvx": {
      "command": "uvx",
      "args": [
        "oxylabs-mcp"
      ],
      "env": {
        "OXYLABS_USERNAME": "OXYLABS_USERNAME",
        "OXYLABS_PASSWORD": "OXYLABS_PASSWORD"
      }
    }
  }
}
建议保存到claude_desktop_config.json
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端