Decodo

Decodo MCP Server

使用 MCP（Model Context Protocol）将 LLM 和 AI 智能体连接到实时网络数据。Decodo MCP Server 可让你直接通过 Claude、Cursor 和 Windsurf 等 AI 工具抓取网站、搜索引擎、电商平台和社交媒体数据，无需从头构建抓取基础设施。

• 以 JSON、Markdown 和屏幕截图形式输出结构化数据
• 服务端 JavaScript 渲染和反机器人处理
• 覆盖 195+ 个地区的 1.25 亿+ IP

什么是 Decodo MCP server？

Decodo MCP Server 是面向 AI 智能体的网络抓取层。它将兼容 MCP 的客户端连接到 Decodo 的 Web Scraping API，从而支持：

• 面向 LLM 的网页抓取
• 用于 RAG 的实时数据检索
• AI 智能体浏览和研究
• 从动态网站提取结构化数据

你无需维护代理、解析器和重试逻辑，只需一个集成点，即可可靠地访问网络数据。

为什么使用 MCP 进行网页抓取？

Model Context Protocol（MCP）是连接 AI 智能体与外部工具和数据源的新兴标准。使用 MCP：

• 智能体可以动态调用工具
• 集成方式保持标准化
• 工作流可在不同环境中扩展

Decodo MCP Server 通过这一标准，为你的智能体提供可靠、可用于生产环境的网络访问能力。

主要功能

无需基础设施，即可为 AI 智能体抓取网页。 抓取任何网站，包括 JavaScript 密集型页面，无需处理代理轮换、CAPTCHA 验证或反机器人系统。

适用于 LLM 工作流的结构化输出。 提供 Markdown（适用于 LLM）、JSON（适用于结构化管道）和屏幕截图（提供视觉上下文），专为 RAG 管道、AI 研究智能体和自动化流程打造。

内置对热门目标的支持。 提供开箱即用的工具，支持 Google 和 Bing（SERP）、Amazon、Walmart 和 Target（电商）、TikTok 和 YouTube（社交媒体），以及 ChatGPT 和 Perplexity（AI 搜索）。

全球代理基础设施。 拥有 1.15 亿+住宅 IP、覆盖 195+ 个地理位置，即使面对防护最严密的目标，成功率也高达 99.99%。

模块化 MCP 工具集。 仅启用所需工具：web、search、ecommerce、social_media、 ai，让工具选择更简洁，提升智能体性能。

快速实现价值。 从 API 密钥到首次抓取只需几分钟，无需繁琐设置。

使用场景

当你需要为 AI 智能体抓取网页、大规模提取结构化数据、可靠访问动态网站、获取用于 RAG 的实时数据，或寻找从头构建抓取基础设施的替代方案时，可以使用 Decodo MCP Server。常见场景包括：

• AI 驱动的网页抓取 – 让 LLM 能够收集最新数据，而不是依赖静态训练数据。
• 使用实时数据进行 RAG – 将 Google、Bing 和 AI 搜索的实时结果引入检索管道。
• 电商情报 – 跨市场追踪商品价格、商品信息和卖家，同时避免被屏蔽。
• 社交媒体数据收集 – 收集 TikTok 和 YouTube 上的帖子、频道和互动数据。
• 旅行和价格聚合 – 构建可跨网站收集实时价格和库存情况的工具。

快速入门

1. 创建免费账户，访问 dashboard.decodo.com – 可免费使用多达 10K 次请求，无需信用卡。
2. 获取 API 密钥。 从 dashboard 中的 Web Data API 订阅复制 Web Data API 密钥。旧版套餐使用基本身份验证令牌，同样可用（参见身份验证）。
3. 下载 Node.js 18+，访问 https://nodejs.org.
4. 获取 MCP 客户端，例如 Claude Desktop、Cursor、Windsurf 或其他兼容 MCP 的工具。
5. 在 AI 客户端中配置 MCP server（参见下方的配置示例）。

连接到 Decodo 的 MCP server

打开你偏好的 MCP 客户端并添加以下配置（参见 Claude Code、Cursor、Windsurf 的示例）：

{
  "mcpServers": {
    "Decodo": {
      "url": "https://mcp.decodo.com/mcp",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }
  }
}

身份验证

本地服务器会从 SCRAPER_API_TOKEN 读取任一凭据，并自动判断收到的是哪一种。

Claude Desktop

1. 打开 Claude Desktop → Settings → Developer → Edit Config。
2. 添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "Decodo": {
      "command": "npx",
      "args": ["-y", "@decodo/mcp-server"],
      "env": {
        "SCRAPER_API_TOKEN": "<api_key>",
        "TOOLSETS": "web,ai"
      }
    }
  }
}

3. 保存并重启 Claude Desktop。

Cursor

1. 打开 Settings → MCP。
2. 点击 Add a new global MCP server（打开 mcp.json）。
3. 添加与上方相同的配置。
4. 保存 — 查看 Decodo 旁边是否显示绿色状态指示灯。

Windsurf

1. 打开 Settings → Windsurf Settings。
2. 滚动到 Cascade → Add custom server +（打开 mcp_config.json）。
3. 添加与上方相同的配置。
4. 保存并重启 Windsurf。

测试设置

连接后，在客户端中尝试以下提示：

▎“抓取 Hacker News 上排名前 5 的文章标题”

几秒钟内，你应该会收到结构化列表。如果看到身份验证错误，请在 dashboard 上仔细检查 API 密钥。

本地开发

仅当你想修改服务器代码时才需要。

git clone https://github.com/Decodo/mcp-server

cd mcp-server
npm install
npm run build

cd build/
pwd

/Users/your.user/projects/mcp-server/build/index.js

{
  "mcpServers": {
    "decodo-mcp": {
      "command": "node",
      "args": ["/Users/your.user/projects/mcp-server/build/index.js"],
      "env": {
        "SCRAPER_API_TOKEN": "<api_key>"
      }
    }
  }
}

工具集

工具按工具集组织。你能使用哪些工具集取决于连接方式。

Claude（官方连接器）

Claude 连接器目录中的 Decodo 连接器仅包含 Web Data API 工具：

任意 MCP 客户端

你可以通过 toolsets 查询参数传入逗号分隔的列表，选择性启用特定工具集：

    "Decodo MCP Server": {
      "url": "https://mcp.decodo.com/mcp?toolsets=web,ai",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }

如果未指定工具集，则会注册所有工具。

工具

服务器提供以下工具：

参数

以下参数根据用户提示推断：

示例

抓取受地理位置限制的内容

向 AI 代理输入以下提示：

Scrape peacock.com from a German IP address and tell me the pricing.

此提示会说明 peacock.com 受到地理位置限制。要绕过地理限制：

Scrape peacock.com from a US IP address and tell me the pricing.

限制响应令牌数量

如果代理的上下文窗口较小，抓取返回的内容会自动截断，以避免上下文溢出。你可以在提示中增加返回的令牌数量：

Scrape hacker news, return 50k tokens.

如果你的智能体有较大的上下文窗口，请让它返回 full content：

Scrape hacker news, return full content.

与 Decodo 智能体技能搭配使用

此服务器为你的智能体提供抓取 工具。 Decodo/agent-skills 会教它何时使用这些工具、 使用哪种接口，以及如何调用它们——这样智能体就能自行选择合适的工具和 参数，而不是靠猜测。

这些技能可通过 decodo CLI、此托管 MCP 服务器和原始 HTTP API 进行调用；如果没有可用的 shell， 则会自动回退到 MCP 服务器。将两者搭配使用，可在同一套配置中为智能体提供 执行层（此服务器）和决策层（这些技能）。

快速开始（Claude Code）：

/plugin marketplace add Decodo/agent-skills
/plugin install decodo@decodo-skills

有关手动安装和其他智能体（Cursor、Codex、Gemini CLI、Windsurf）的说明，请参阅 智能体技能 README。

相关仓库

Web Scraping API、 Decodo 智能体技能、 Decodo OpenClaw 技能

立即试用

只需点击几下，即可将 Decodo MCP Server 接入你的 AI 工作流，为 AI 智能体提供来自任意网站的 实时数据。

免费开始 | 文档 | Discord

许可证

所有代码均根据 MIT License 发布。