# @decodo/mcp-server 中文文档

规范地址：https://npmcn.com/package/%40decodo/mcp-server/

版本：1\.7\.0
npm 元数据更新时间：2026-10-29T09:00:59.662Z
中文译文更新时间：2026-11-12T02:59:45.741Z
软件包许可：ISC

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40decodo/mcp-server
原文对照：https://npmcn.com/package/%40decodo/mcp-server/?lang=original
项目主页：https://github.com/Decodo/mcp-server#readme
源码仓库：https://github.com/Decodo/mcp-server

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：390 kB，226 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：7 个
- 首次发布：2025-09-22T10:34:51.160Z
- 最新版本发布：2026-10-29T09:00:59.269Z
- 近 30 天下载量：3157（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：20（近 12 个月 16 个）

## 中文简介

Decodo MCP 服务器

## 安装

```sh
npm install @decodo/mcp-server
```

也可以使用：`pnpm add @decodo/mcp-server`、`yarn add @decodo/mcp-server`、`bun add @decodo/mcp-server`

## README

# Decodo MCP 服务器

[![](https://dcbadge.limes.pink/api/server/https://discord.gg/Ja8dqKgvbZ)](https://discord.gg/Ja8dqKgvbZ) [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=Decodo&config=eyJ1cmwiOiJodHRwczovL21jcC5kZWNvZG8uY29tL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciA8YXBpX2tleT4ifX0%3D)

[![Decodo: one-click web access for your AI agents](https://raw.githubusercontent.com/Decodo/mcp-server/main/assets/banner.png)](https://dashboard.decodo.com/integrations?utm_source=github&utm_medium=social&utm_campaign=mcp_server)

连接 LLMs 和 AI 代理以使用 MCP(模式上下文协议) 进行活化的网络数据. 德科多MCP 服务器让你刮去网站、搜索引擎、eCommerce平台和社交媒体 Claude、Cursor和Windsurf等AI工具,都不需要建造废品基础设施 从零开始.

-   JSON、Markdown和截图中的结构化产出
-   服务器侧 JavaScript 渲染和反机器人处理
-   195个以上地点的125M+执行伙伴

## Decodo MCP 服务器是什么?

Decodo MCP服务器是AI代理的网络刮取层. 它连接 MCP 兼容客户端 Decodo的 Web scrating API, 启用 :

-   用于 LLMS 的网络刮取
-   RAG实时数据检索
-   AI 代理浏览和研究
-   从动态网站提取结构化数据

与其保持代理、解析和重试逻辑,不如获得一个单一的集成点,用于 可靠的网络数据访问.

## 为什么要使用MCP来刮去网络??

模式背景协议(MCP)是将AI代理与外部工具连接起来的新兴标准 数据来源。 使用 MCP :

-   代理可以动态调用工具
-   一体化保持标准化
-   跨环境的工作流量

德科多MCP 服务器通过此标准为您的代理提供可靠,生产准备的网络访问.

## 主要特点

**对人工智能特工进行网络刮刮,不需要任何基础设施.** 搜索任何网站,包括 JavaScript-havy页面,不处理代理旋转,CAPTCHA解析,或反机器人系统.

**LLM工作流程的结构化产出.** Markdown(LLM准备),JSON(用于结构化管道),以及 截图(用于视觉上下文),为RAG管道所建,AI研究代理,和自动化流.

**搭建支持群众目标.** 为Google和Bing(SERPs),亚马逊, 沃尔玛,以及目标(eCommerce)、TikTok和YouTube(社会媒体)和ChatGPT和 困惑(AI搜索).

**全球代理基础设施.** 115M+住宅IP,195+地理定位,成功率99.99% 即使是最受保护的目标 也要达到标准.

**模块MCP工具.** 只启用您需要的 : `web`, (中文(简体) ), `search`, (中文(简体) ), `ecommerce`, (中文(简体) ), `social_media`, (中文(简体) ), `ai` 更清洁的工具选择和更好的代理性能.

**快速的时间去价值.** 从API密钥到几分钟后第一次刮出,没有设置高架.

## 使用大小写

在 AI 代理器需要网络刮取时, 请使用 Decodo MCP 服务器, 结构化数据提取 规模、对动态网站的可靠访问、RAG的实时数据、或建筑物的替代 从零开始拆除基础设施。 常见情况:

-   **AI 驱动的网络刮去** - 使地方政府能够收集新数据,而不是依赖 静态训练数据.
-   **有实时数据的RAG** - 将实时Google、Bing和AI搜索结果放入检索 输油管.
-   **电子商务情报** - 追踪产品价格、上市和市场销售商 没有被封锁.
-   **社交媒体数据收集** - 从TikTok收集帖子、渠道和参与数据 (原始内容存档于2019-10-11). and YouTube.
-   **旅费和价格合计** - 建立各种工具,收集现场定价和提供情况 网站.

## 快开始

1.  **创建自由账户** 时间 [仪表板.decodo.com](https://dashboard.decodo.com/) - 最多10K 免费申请,不需要信用卡.
2.  **拿你的API钥匙.** 从您的 Web Data API 订阅中复制您的 Web Data API 密钥 [仪表板](https://dashboard.decodo.com/web-data/playground). 老年计划有基本 认证令牌,它同样有效(参见 [认证](https://npmcn.com/package/%40decodo/mcp-server/#readme-authentication)) (中文(简体) ).
3.  **下载节点.js 18+** 从 [https://nodejs.org (英语)](https://nodejs.org/)。 。 。 .
4.  **获取 MCP 客户端** 如克洛德桌面,光标,Windsurf等MCP相容工具.
5.  **配置 MCP 服务器** 在您的 AI 客户端中(见下文配置示例).

## 正在连接到 [Decodo 的 MCP 服务器](https://mcp.decodo.com/mcp)

打开您首选的 MCP 客户端并添加以下配置(参见 Claude Code, 克所克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克

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

### 认证

| 证书 | 何处取来 | 主机服务器头 | 本地服务器环境 |
| --- | --- | --- | --- |
| **API 密钥** (建议) | 网页数据 API 订阅 [仪表板](https://dashboard.decodo.com/web-data/playground) | `Authorization: Bearer <api_key>` | `SCRAPER_API_TOKEN=<api_key>` |
| **基本认证符** (老人计划) | 在仪表盘上浏览 API 页面 | `Authorization: Basic <basic_auth_token>` | `SCRAPER_API_TOKEN=<basic_auth_token>` |

本地服务器从 `SCRAPER_API_TOKEN` 并找出它得到了哪一个.

### 克劳德桌面

1.  打开 Claude 桌面 设置 开发者 编辑配置 .
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 桌面 .

### 光标

1.  打开设置 MCP.
2.  点击添加一个新的全局MCP服务器(打开mcp.json).
3.  添加与上图相同的配置.
4.  保存 —— 在德科多旁边寻找一个绿色状态指示器.

### 风起浪起

1.  打开设置 → Windsurf 设置 .
2.  滚动到 Cascade → 添加自定义服务器 + (opens mcp config.json).
3.  添加与上图相同的配置.
4.  保存并重新启动 Windsurf .

## 测试您的设置

连接后, 请在客户端中尝试此提示 :

▎"从"黑客新闻"上翻出"前五篇"标题"

你应该在几秒钟内得到一份结构化的清单。 如果您看到认证错误, 请重复检查您的 盘子上的API密钥.

## 地方发展

只需您想要更改服务器代码 .

从此仓库构建和运行服务器

### 先决条件

-   节点.js 18.0+
-   MCP客户端 - 流行选择 [克劳德桌面](https://claude.ai/download) 财务报告和审定财务报表 [光标](https://www.cursor.com/)

### 分步指南

1.  克隆此寄存器 :

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

2.  在终端中运行以下命令:

```
cd mcp-server
npm install
npm run build
```

3.  注意你的建筑位置:

```
cd build/
pwd
```

添加中 `index.js` 到此目录的末尾, 您的构建文件位置应该看起来像 这个:

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

4.  用服务器信息更新您的 MCP 客户端 :

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

## 工具集

工具被组织成工具。 你得到的是什么取决于你如何联系.

### 克洛德 (官方连接器)

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

| 工具集 | 工具 |
| --- | --- |
| `web` | `scrape_as_markdown`, (中文(简体) ), `screenshot`, (中文(简体) ), `map`, (中文(简体) ), `crawl_start`, (中文(简体) ), `crawl_status`, (中文(简体) ), `crawl_results`, (中文(简体) ), `crawl_cancel` |
| `search` | `search` |

### 任何 MCP 客户端

您可以通过 : `toolsets` 查询参数 :

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

未指定工具时, 所有工具都会注册 .

| 工具集 | 工具 |
| --- | --- |
| `web` | `scrape_as_markdown`, (中文(简体) ), `screenshot`, (中文(简体) ), `map`, (中文(简体) ), `crawl_start`, (中文(简体) ), `crawl_status`, (中文(简体) ), `crawl_results`, (中文(简体) ), `crawl_cancel` |
| `search` | `search`, (中文(简体) ), `google_search`, (中文(简体) ), `google_ads`, (中文(简体) ), `google_lens`, (中文(简体) ), `google_travel_hotels`, (中文(简体) ), `bing_search` |
| `ecommerce` | `amazon_search`, (中文(简体) ), `amazon_product`, (中文(简体) ), `amazon_pricing`, (中文(简体) ), `amazon_sellers`, (中文(简体) ), `amazon_bestsellers`, (中文(简体) ), `walmart_search`, (中文(简体) ), `walmart_product`, (中文(简体) ), `target_search`, (中文(简体) ), `target_product`, (中文(简体) ), `tiktok_shop_search`, (中文(简体) ), `tiktok_shop_product`, (中文(简体) ), `tiktok_shop_url` |
| `social_media` | `tiktok_post`, (中文(简体) ), `youtube_metadata`, (中文(简体) ), `youtube_channel`, (中文(简体) ), `youtube_subtitles`, (中文(简体) ), `youtube_search` |
| `ai` | `chatgpt`, (中文(简体) ), `perplexity`, (中文(简体) ), `google_ai_mode` |

## 工具

服务器曝光以下工具:

| 工具 | 说明 | 示例提示 |
| --- | --- | --- |
| `scrape_as_markdown` | 搜索任何目标 URL, 期望通过快取给出一个 URL 。 返回结果为Markdown. | Scrape peacock.com 从一个美国IP地址告诉我定价. |
| `screenshot` | 抓取任何网页的截图,并将它作为 PNG 图像返回 . | 从一个美国IP地址取出github.com的截图. |
| `map` | 在网站上列出URL而不获取其内容。 只有 API 密钥 . | 地圖docs.decodo.com并列出/scraping-api下各頁. |
| `crawl_start` | 开始爬行一个网站,然后不等待地返回爬行ID. 只有 API 密钥 . | 爬行前10页decodo.com/blog. |
| `crawl_status` | 报告一个爬行的进展:页被发现,完成并失败. 只有 API 密钥 . | 我的爬行完成了吗? |
| `crawl_results` | 返回所爬行的页面为Markdown,一次有光标几个. 只有 API 密钥 . | 让我看看我找到的页子. |
| `crawl_cancel` | 停止运行的爬行; 已爬行的页面仍然可以读取 。 只有 API 密钥 . | 取消我的爬行. |
| `search` | 搜索网页并返回排序结果。 只有 API 密钥 . | 为 MCP 服务器托管选项搜索网络 . |
| `google_search` | Scrapes Google 搜索给定查询,并返回解析的结果. | Scrape Google搜索出鞋子 告诉我最高位置. |
| `google_ads` | 扫描谷歌 广告搜索结果. | 扫描谷歌 广告为笔记本电脑 并给我看顶级广告. |
| `google_lens` | Scrapes Google Lens 图像搜索结果. | 搜索 Google 的图像 : [https://example.com/image.jpg 页面存档备份,存于互联网档案馆](https://example.com/image.jpg) |
| `google_ai_mode` | Scrapes Google AI Mode (Search with AI) 结果. | 问GoogleAI模式:前三只狗是什么品种?? |
| `google_travel_hotels` | Scrapes Google 旅行酒店搜索结果. | 搜索Google旅行酒店巴黎酒店. |
| `amazon_search` | Scrapes Amazon 搜索一个给定的查询,然后返回解析的结果 . | Scrape Amazon搜索无线键盘. |
| `amazon_product` | 斯克雷斯亚马逊产品页面. | Scrape Amazon产品 B09H74FXNW 并给我看细节. |
| `amazon_pricing` | Scrapes Amazon产品定价信息. | 获得亚马逊产品B09H74FXNW的定价. |
| `amazon_sellers` | Scrapes Amazon Seller资讯. | 获取有关亚马逊销售商A1R0Z7FJGTKESH的信息. |
| `amazon_bestsellers` | 斯克雷斯·亚马逊畅销书列表. | 给我看亚马逊电子产品畅销书. |
| `walmart_search` | Scrapes Walmart 搜索给定查询, 并返回解析结果 . | 寻找营房. |
| `walmart_product` | Scrapes 沃尔玛产品页面. | Scrape 沃尔玛产品 15296401808. |
| `target_search` | Scrapes 目标搜索给定查询,然后返回解析结果 . | 搜索厨房电器. |
| `target_product` | 斯克雷斯目标产品页面. | Scrape目标产品92186007. |
| `tiktok_post` | 为结构化数据(如接触、标题、标签等)打出 TikTok 贴出 URL. | 校对:Soup |
| `tiktok_shop_search` | Scrapes TikTok Shop 搜索给定的查询, 并返回解析的结果 . | Scrape TikTok商店搜索电话箱. |
| `tiktok_shop_product` | Scrapes TikTok商店产品页面. | Scrape TikTok Shop产品 1731541214379741272. |
| `tiktok_shop_url` | 由 URL 编辑的 Scrapes TikTok Shop 页面 . | 刷新 TikTok 商店 URL : [https://www.tiktok.com/shop/s?q=HEAD 电话](https://www.tiktok.com/shop/s?q=HEADPHONES) |
| `youtube_metadata` | Scrapes YouTube视频元数据. | 为YouTube视频dFu9aKJoqGg获取元数据. |
| `youtube_channel` | Scrapes YouTube频道视频. | Scrape YouTube频道@decodo official. |
| `youtube_subtitles` | 斯克雷斯·YouTube视频字幕. | 获得YouTube视频L8zSWbQN-v8的字幕. |
| `youtube_search` | 搜取YouTube视频. | 搜取YouTube"如何关心花栗鼠". |
| `bing_search` | 斯克林斯·宾搜索结果. | 搜索Bing的笔记本电脑评论. |
| `chatgpt` | 向 ChatGPT 发送单一的提示并返回其答案( 无对话历史) . | 请 ChatGPT 以简单术语解释量子计算. |
| `perplexity` | 向 Perflexity 发送单一的提示并返回其答案(没有对话历史). | 想知道网络开发的最新趋势是什么. |

## 参数

从用户提示中推断出以下参数:

| 参数 | 说明 |
| --- | --- |
| `jsRender` | Renders在无头浏览器中瞄准URL. |
| `geo` | 设置请求的起源国. |
| `locale` | 设置请求的地址. |
| `tokenLimit` | 要返回的最大字符数( 默认为 4500) 。 如果上下文窗口很小, 则有用 . |
| `prompt` | 提示发送到 AI 工具( Q)`chatgpt`, (中文(简体) ), `perplexity`) (中文(简体) ). |
| `search` | 激活 ChatGPT 的网页搜索功能(`chatgpt` 页:1. |
| `xhr` | 当属实时,在所支持的刮出结果中包含XHR或获取响应(如:. `tiktok_post`) (中文(简体) ). |
| `deviceType` | 要模拟的设备类型( E)`desktop`, (中文(简体) ), `mobile`, (中文(简体) ), `tablet`) (中文(简体) ). 解析的目标更严格:亚马逊工具只使用桌面,所以省略,以及 `bing_search`编号 :`google_ai_mode` 接受 `desktop` 财务报告和审定财务报表 `mobile` 只有这个. |
| `domain` | 用于请求的领域(例如, `amazon.com`, (中文(简体) ), `amazon.co.uk`, (中文(简体) ), `bing.com`) (中文(简体) ). |
| `pageFrom` | 开始页码用于页码 . |
| `deliveryZip` | 交付地点的ZIP代码(目标,沃尔玛). |
| `storeId` | 为本地库存存储ID(Walmart). |
| `country` | TikTok商店申请的国家. |
| `limit` | 要返回的最大结果数量(例如YouTube频道视频). |
| `language_code` | 字幕语言代码( 如 , `en`, (中文(简体) ), `es`) (中文(简体) ). |

## 实例

### 拼接地理限制内容

向您的 AI 代理查询以下提示 :

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

这个提示会说孔雀.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`](https://github.com/Decodo/agent-skills) 教书 **何时** 要达到 他们, **哪个** 表面用于,和 **怎么样** 所以代理商选对工具 参数本身而不是猜测.

技能路线跨越 `decodo` CLI,它托管了 MCP 服务器, 和原始的 HTTP API, 并坠入 在没有 shell 时自动返回 MCP 服务器。 给两个配对给你的经纪人 执行层(这个服务器)和决定层(这个技能)都是在一个单一的设置中.

**快开始** (语法:

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

见 [代理技能检索](https://github.com/Decodo/agent-skills#readme) 手动安装和 其他代理(Cursor, Codex,双子座CLI,Windsurf).

## 相关寄存器

[网络搜索 API](https://github.com/Decodo/Web-Scraping-API), (中文(简体) ), [德科多代理技能](https://github.com/Decodo/agent-skills), (中文(简体) ), [德科多 OpenClaw 技能](https://github.com/Decodo/decodo-openclaw-skill)

## 试试看

插接代科多 MCP 服务器只需点击几下即可进入您的AI工作流程,并为您的AI代理提供设备 任何网站的实时数据.

[免费开始](https://dashboard.decodo.com/) | [文档](https://help.decodo.com/docs/introduction) | [解析器](https://discord.gg/Ja8dqKgvbZ)

## 许可证

所有代码都在 [MIT 许可证](https://github.com/Decodo/Decodo/blob/master/LICENSE)。 。 。 .

## 常见问题

### @decodo/mcp-server 是什么？

Decodo MCP 服务器

### 如何安装 @decodo/mcp-server？

在项目目录运行 npm install @decodo/mcp-server，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 decodo-mcp，可以用 npx decodo-mcp 直接运行。

### @decodo/mcp-server 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/decodo\_\_mcp-server 是否存在。

### @decodo/mcp-server 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @decodo/mcp-server 可以商用吗？

@decodo/mcp-server 使用 ISC 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @decodo/mcp-server 的下载量有多少？

根据 npm 官方下载统计，@decodo/mcp-server 在 2026/10/12 – 2026/11/10 这 30 天内被下载 3,157 次，日均约 105 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @decodo/mcp-server 还在维护吗？

最新版本 1\.7\.0 发布于 2026/10/29（13 天前）；至今共发布 20 个版本，其中过去 12 个月发布了 16 个；首次发布于 2025/09/22。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。