Decodo MCP Server

Decodo MCP 服务

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

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

什么是 Decodo MCP 服务？

Decodo MCP 服务是面向 AI Agent 的网页抓取层。它将兼容 MCP 的客户端连接到 Decodo 的 Web Scraping API，从而支持：

• 面向大模型的网页抓取
• 为 RAG 实时检索数据
• AI Agent 浏览和研究
• 从动态网站提取结构化数据

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

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

Model Context Protocol（MCP）是连接 AI Agent 与外部工具和数据源的新兴标准。借助 MCP：

• Agent 可以动态调用工具
• 集成方式保持标准化
• 工作流可跨环境扩展

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

主要功能

面向 AI Agent 的网页抓取，无需基础设施。 抓取任意网站，包括大量使用 JavaScript 的页面，无需处理代理轮换、CAPTCHA 验证或反机器人系统。

适用于大模型工作流的结构化输出。 提供 Markdown（适用于大模型）、JSON（适用于结构化流水线）和屏幕截图（提供视觉上下文），专为 RAG 流水线、AI 研究 Agent 和自动化流程打造。

内置支持热门目标网站。 提供现成工具，支持 Google 和 Bing（SERP）、Amazon、Walmart 和 Target（电商）、TikTok 和 YouTube（社交媒体），以及 ChatGPT 和 Perplexity（AI 搜索）。

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

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

快速见效。 从获取 API 密钥到首次抓取只需几分钟，无需繁琐设置。

使用场景

如果你需要面向 AI Agent 的网页抓取、大规模结构化数据提取、可靠访问动态网站、用于 RAG 的实时数据，或希望避免从头构建抓取基础设施，都可以使用 Decodo MCP 服务。常见场景：

• AI 驱动的网页抓取 – 让大模型能够收集最新数据，而非依赖静态训练数据。
• 使用实时数据进行 RAG – 将 Google、Bing 和 AI 搜索的实时结果引入检索流水线。
• 电商情报 – 跨电商平台追踪商品价格、商品信息和卖家，不受封锁影响。
• 社交媒体数据收集 – 从 TikTok 和 YouTube 收集帖子、频道和互动数据。
• 旅行和价格聚合 – 构建可跨网站收集实时价格和可用情况的工具。

快速开始

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

连接到 Decodo 的 MCP 服务

打开你常用的 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 Agent：

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.

限制响应令牌数量

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

Scrape hacker news, return 50k tokens.

如果你的 Agent 的上下文窗口较大，请告诉它返回 full content：

Scrape hacker news, return full content.

与 Decodo Agent 技能搭配使用

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

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

快速开始（Claude Code）：

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

有关手动安装和其他 Agent（Cursor、Codex、Gemini CLI、Windsurf）的信息，请参阅 agent-skills README。

相关仓库

Web Scraping API、 Decodo agent skills、 Decodo OpenClaw skill

立即体验

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

免费开始 | 文档 | Discord

许可证

所有代码均以 MIT License 发布。