Decodo MCP Server

官方

让 AI 代理动态抓取和解析网页内容，包括受地域限制的网站

分类: 开发工具第 158 / 438
Stars: ★ 37 热门
传输方式: stdio（本地进程）
运行环境: Node.js 18+ · 远程托管（无需本地环境）
凭据: 需要 API Key / 凭据
最近提交: 6 天前
工具数: 30

57FMRS · C

官方维护的 MCP 服务器，将 Decodo 的商业网页抓取 API 封装为 30 个工具，覆盖 SERP、电商、社媒和 AI 搜索，支持模块化工具集与地理位置控制，适合需要生产级实时网页数据的 AI 代理项目，但依赖第三方云服务和令牌认证。

最强项 · 文档质量 16/20 最弱项 · 可靠性 7/20

可靠性

7/20

安全与权限

12/20

维护活跃度

9/20

文档质量

16/20

安装易用性

13/20

查看各项评分依据

可靠性 7/20: 仓库提供的材料仅有 server.json 清单和 README，没有任何可核查的 CI 工作流文件或测试代码可用于验证 MCP 初始化/工具列表握手是否可复现。README 中列出了 25 个以上工具（scrape_as_markdown、google_search、amazon_* 等），但清单本身只声明了一个 npm 包和 stdio 传输方式，无法从静态材料确认这些工具的实际行为与声明是否一致，也看不到错误处理、超时或依赖故障时的可控性说明。按静态校准规则，没有可验证的执行证据（真实 CI + 已提交测试）不得给出高于 12 的分数，因此只能基于'声明合理但未经验证'给予中低分。
安全与权限 12/20: 凭据通过环境变量 SCRAPER_API_TOKEN 或 Authorization: Basic 头传递，README 中的示例均为占位符（如 <basic_auth_token>），未发现真实密钥泄露，不触发红线。服务器的核心功能（抓取任意网站、绕过地理限制、店铺/社媒抓取、代理 IP 池）意味着大量出站网络请求会经由 Decodo 的第三方基础设施（125M+ IP、195+ 地点），这一数据流向在文档中有一定披露，但没有关于最小权限范围、请求日志留存、第三方数据处理政策的进一步说明。工具集（toolsets）机制允许按需限制启用的工具，是一个积极的最小暴露面设计，但默认状态下（不指定 toolsets）会注册全部工具，缺乏默认最小权限。抓取/截图类操作总体是只读性质，未见不可逆的危险默认操作，因此不构成红线，但披露和权限控制仍不完整。
维护活跃度 9/20: 仓库层面的许可证字段标记为 unknown，而 README 中却声明代码基于 MIT 许可证，并链接到另一个仓库（Decodo/Decodo）的 LICENSE 文件而非本仓库自身的许可证文件，这是一处文档与仓库元数据之间的不一致，反映出治理信息不完整。当前版本号为 1.2.3，暗示存在一定的迭代发布节奏，34 星、3 个未解决 issue、未被归档，说明项目并非完全废弃，但缺乏可见的发布记录、变更日志、安全响应渠道或维护者身份的进一步证据，无法判断问题响应速度或长期维护承诺。
文档质量 16/20: README 内容详实，涵盖了功能概览、快速开始、Claude Desktop/Cursor/Windsurf 的具体配置示例、本地构建运行步骤、工具集划分表、完整工具列表及示例提示语、参数说明表，以及地理限制绕过和 token 截断等使用场景示例，文档分层清晰、示例充分。但也存在不足：未说明各工具对应的费用/配额消耗细节（仅提到免费额度 2K 次请求）、缺少针对 API 报错、限流、认证失败等场景的系统性故障排查章节，且许可证声明与仓库实际元数据矛盾，构成隐藏假设，因此未达满分。
安装易用性 13/20: 文档为托管模式（URL + Basic Auth）和本地模式（npx 或手动 clone/build）都提供了具体配置示例，覆盖 Claude Desktop、Cursor、Windsurf 三个主流客户端，步骤描述较为清晰。但本地运行方式需要手动 clone、npm install、npm run build 并自行拼接绝对路径填入配置文件，属于人工操作、容错性较低的安装路径；同时静态校准规则要求在缺乏 CI 与测试证据时安装易用性分数不得超过 15，故在'步骤清晰'与'手动且脆弱'之间打了折扣。

静态评测 · 未实际运行收录于 2026-09-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

需要为 LLM/RAG 提供实时网页数据的开发者
构建电商情报、社媒监控或价格聚合工具的团队
不想自建代理与反爬基础设施的 AI 代理项目

不适合谁

不愿依赖第三方付费抓取服务或云端托管的用户
仅需本地文件或内部数据访问的场景
无法接受将目标 URL 和提示词发送给 Decodo 服务端的隐私敏感场景

所需权限

需要 Decodo Web Scraping API 的 Basic 认证令牌（SCRAPER_API_TOKEN）
通过 npx 从 npm 下载并运行 @decodo/mcp-server 包
需访问网络以调用 Decodo 托管抓取服务

风险与副作用

所有抓取目标 URL 和提示词会经第三方（Decodo）服务端处理
免费额度用尽后产生 API 使用费用
抓取目标网站可能违反其服务条款，需自行确认合规性
依赖外部 npm 包和托管 API，存在供应链与可用性风险

安装接入

准备工作

运行环境：Node.js 18+ · 远程托管（无需本地环境）

SCRAPER_API_TOKEN 必填密钥 Web Scraping API的Basic认证token，在dashboard.decodo.com注册后从控制台获取。

其他可选配置项（1 个）

TOOLSETS 可选可选，逗号分隔的工具集列表（web、search、ecommerce、social_media、ai），用于只注册所需工具；不设置则注册全部工具。

在 dashboard.decodo.com 注册免费账户（最高 2000 次免费请求）并获取 Web Scraping API 的 Basic 认证令牌。
安装 Node.js 18+。
在 Claude Desktop 的 claude_desktop_config. 中添加：command 为 npx，args 为 ["-y","@decodo/mcp-server"]，环境变量 SCRAPER_API_TOKEN 设为令牌，TOOLSETS 可选 web,ai 等工具集。
保存并重启客户端。也可使用托管端点 https://mcp.decodo.com/mcp，在请求头中携带 Basic 授权令牌。

claude_desktop_config.json

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

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

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

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add Decodo -e 'SCRAPER_API_TOKEN=<basic_auth_token>' -e TOOLSETS=web,ai -- npx -y @decodo/mcp-server

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

配置完成后，在客户端中询问“Scrape the titles of the top 5 articles from Hacker News”，应能在几秒内返回结构化的标题列表；若出现认证错误，请检查dashboard中的token。

常见排障

出现认证错误时，检查仪表板中的令牌是否正确配置为 Basic 授权
确认已安装 Node.js 18 或更高版本
确认 MCP 客户端配置保存后已重启
若上下文窗口溢出，可在提示词中要求返回更少 token 或完整内容
受地域限制时可指定 geo 参数更换出口 IP 国家

试试这样问

连接成功后，可以直接对 AI 助手这样说：

从美国IP地址抓取peacock.com并告诉我定价。
抓取Google搜索中“无线键盘”的结果并告诉我排名第一的商品。
获取YouTube视频dFu9aKJoqGg的元数据。
让Perplexity介绍一下最新的Web开发趋势。

工具能力 30

scrape_as_markdown 只读

抓取任意目标 URL，以 Markdown 格式返回结果。

screenshot 只读

对任意网页截图并返回 PNG 图片。

google_search 只读

抓取 Google 搜索结果并返回解析后的数据。

google_ads 只读

抓取 Google Ads 搜索结果。

google_lens 只读

抓取 Google Lens 图片搜索结果。

google_ai_mode 只读

抓取 Google AI 模式（AI 搜索）结果。

google_travel_hotels 只读

抓取 Google Travel 酒店搜索结果。

amazon_search 只读

抓取 Amazon 搜索结果并返回解析数据。

展开其余 22 个工具

amazon_product 只读

抓取 Amazon 商品页面。

amazon_pricing 只读

抓取 Amazon 商品价格信息。

amazon_sellers 只读

抓取 Amazon 卖家信息。

amazon_bestsellers 只读

抓取 Amazon 畅销榜列表。

walmart_search 只读

抓取 Walmart 搜索结果并返回解析数据。

walmart_product 只读

抓取 Walmart 商品页面。

target_search 只读

抓取 Target 搜索结果并返回解析数据。

target_product 只读

抓取 Target 商品页面。

tiktok_post 只读

抓取 TikTok 帖子 URL 的结构化数据（互动、文案、话题标签等）。

tiktok_shop_search 只读

抓取 TikTok Shop 搜索结果并返回解析数据。

tiktok_shop_product 只读

抓取 TikTok Shop 商品页面。

tiktok_shop_url 只读

按 URL 抓取 TikTok Shop 页面。

youtube_metadata 只读

抓取 YouTube 视频元数据。

youtube_channel 只读

抓取 YouTube 频道视频。

youtube_subtitles 只读

抓取 YouTube 视频字幕。

youtube_search 只读

搜索 YouTube 视频。

reddit_post 只读

抓取指定的 Reddit 帖子。

reddit_subreddit 只读

抓取 Reddit 子版块的结果。

reddit_user 只读

抓取 Reddit 用户资料及其帖子/评论。

bing_search 只读

抓取 Bing 搜索结果。

chatgpt 只读

搜索并与 ChatGPT 交互，获取 AI 生成的回复。

perplexity 只读

搜索并与 Perplexity 交互，获取 AI 生成的回复。

使用场景

AI 代理实时网页抓取，突破静态训练数据限制

为 RAG 管道拉取实时 Google、Bing 和 AI 搜索结果

跨电商平台追踪商品价格、列表和卖家

从 Reddit、TikTok、YouTube 采集社交媒体数据

构建实时价格与库存聚合工具

访问受地域限制的内容

支持客户端

Claude Desktop

Cursor

Windsurf

Claude Code部分支持

依据项目文档列出，未经本站实测。

详细介绍

Decodo MCP 服务器是面向 AI 代理的网页抓取层，将兼容 MCP 的客户端连接到 Decodo 的 Web Scraping API。它支持抓取网站、搜索引擎、电商平台和社交媒体，提供 Markdown、JSON 和截图等结构化输出，内置 JavaScript 渲染和反爬处理，依托 125M+ 住宅 IP、195+ 地区的基础设施。工具按 web、search、ecommerce、social_media、ai 五个工具集模块化组织，可通过 toolsets 参数按需启用。