# n8n-nodes-mrscraper 中文文档 规范地址：https://npmcn.com/package/n8n-nodes-mrscraper/ 版本：4\.0\.0 npm 元数据更新时间：2026-11-04T05:58:52.115Z 中文译文更新时间：2026-11-04T06:11:02.949Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/n8n-nodes-mrscraper 原文对照：https://npmcn.com/package/n8n-nodes-mrscraper/?lang=original 项目主页：https://docs.mrscraper.com/docs/integrations/n8n 源码仓库：https://github.com/mrscraper-com/n8n-nodes-mrscraper ## 关键信息（来自 npm 元数据） - 包体积（解压后）：330 kB，68 个文件 - TypeScript 类型：未声明 - Node.js 要求：\>=22 - 运行依赖：0 个 - peer 依赖：n8n-workflow \* - 首次发布：2025-12-17T23:12:15.757Z - 最新版本发布：2026-11-04T05:58:51.787Z - 已发布版本数：14（近 12 个月 14 个） ## 中文简介 MrScraper的n8n社区节点包 ## 安装 ```sh npm install n8n-nodes-mrscraper ``` 也可以使用：`pnpm add n8n-nodes-mrscraper`、`yarn add n8n-nodes-mrscraper`、`bun add n8n-nodes-mrscraper` ## README # n8n-nodes-mrscraper ![MrScraper](https://npmcn.com/package/n8n-nodes-mrscraper/mrscraper.jpeg) 使用 [MrScraper](https://mrscraper.com/) 在您的n8n工作流中创建和运行人工智能或手动抓取，提取结构化内容，发现url，搜索web和检索结果。 这个包裹是 [N8n团体节点](https://docs.n8n.io/integrations/community-nodes/) 为人工智能驱动的MrScraper网页抓取平台。 ## 版本4.0.0 4.0.0版本围绕六个基于任务的资源重新组织节点，并删除重复的操作。 - 新 **发现**， **提取**， **结果**， **刮刀创造**, **刮板运行** 资源名 - 一个 **刮板运行** 单个和批量运行的人工智能和手动刮刀界面 - 用于基于提示、列表和网站抓取抓取的专用创建流 - 基于提示和清单提取的预期JSON输出模式 - Web搜索输入：查询、国家和结果数量 - 流线型的渲染页面控件，具有可选择的标记和屏幕截图，可选择的屏幕截图模式，选择器等待，主页导航和分组高级浏览器选项 - 呈现的HTML请求现在一致地使用MrScraper API `POST` 方法 - 通用、清单、地图和手动抓取器的更多运行选项 版本4.0.0更改了资源和操作选择。检查 [迁移指南](https://npmcn.com/package/n8n-nodes-mrscraper/#readme-migrating-from-2x) 在激活现有工作流之前。 ## 目录表 - [安装](https://npmcn.com/package/n8n-nodes-mrscraper/#readme-installation) - [凭证](https://npmcn.com/package/n8n-nodes-mrscraper/#readme-credentials) - [资源及运作](https://npmcn.com/package/n8n-nodes-mrscraper/#readme-resources-and-operations) - [账户](https://npmcn.com/package/n8n-nodes-mrscraper/#readme-account) - [发现](https://npmcn.com/package/n8n-nodes-mrscraper/#readme-discovery) - [提取](https://npmcn.com/package/n8n-nodes-mrscraper/#readme-extraction) - [结果](https://npmcn.com/package/n8n-nodes-mrscraper/#readme-results) - [刮刀创造](https://npmcn.com/package/n8n-nodes-mrscraper/#readme-scraper-creation) - [刮板运行](https://npmcn.com/package/n8n-nodes-mrscraper/#readme-scraper-runs) - [用法示例](https://npmcn.com/package/n8n-nodes-mrscraper/#readme-usage-examples) - [从2.x迁移](https://npmcn.com/package/n8n-nodes-mrscraper/#readme-migrating-from-2x) - [兼容性](https://npmcn.com/package/n8n-nodes-mrscraper/#readme-compatibility) - [合规和法律风险](https://npmcn.com/package/n8n-nodes-mrscraper/#readme-compliance-and-legal-risk) - [资源](https://npmcn.com/package/n8n-nodes-mrscraper/#readme-resources) ## 安装 安装 `n8n-nodes-mrscraper` 从 **设置>社区节点** 在上帝。其他安装方法请参考 [N8n团体节点安装指南](https://docs.n8n.io/integrations/community-nodes/installation/)。 ## 凭证 节点需要 **MrScraper API** 证书。 1. 登录到 [MrScraper应用](https://app.mrscraper.com/)。 2. 从您的帐户创建或复制一个API令牌。 3. 在n8n中创建一个 **MrScraper API** 凭据并输入令牌 **API令牌**。 4. 在MrScraper节点中选择凭据。 保持令牌的私密性。不要将其直接放在工作流字段中，也不要将其提交到源代码管理中。 ## 资源及运作 版本4.0.0公开了6种资源。选择一个资源，然后选择它的一个操作。 ### 账户 - **获取帐户信息** -获取帐户详细信息，令牌使用情况和令牌限制。 ### 发现 - **抓取网站网址** —从起始URL发现链接。设置抓取深度、计算的页面、结果限制和可选的管道分隔包括或排除正则表达式。 - **网络搜索** —使用查询，国家（默认） `us`)，以及结果的数量(默认值 `10`）. WebSearch是一个搜索网络以获取实时结果的工具，包括相关网站的url、标题、描述和基于给定查询的相关问题。 ### 提取 - **按提示提取页面** -使用自然语言提示符和可选的预期JSON输出模式从一个页面提取数据。支持超级或廉价模式和可选的代理国家。 - **提取列表和分页内容** -使用提示、可选项目模式、页面限制和代理国家提取重复列表数据。 - **提取结构化数据** -对文章、论坛帖子、酒店、职位发布、帖子、产品、物业、餐厅、社交媒体简介或旅游/景点内容使用预设提取模式。 - **获取已呈现的HTML** -使用MrScraper隐形浏览器加载一个带有渲染JavaScript页面的页面。默认情况下返回HTML；降价和截图是可选择的。截图可以覆盖整个页面，也可以只覆盖顶部。主字段配置重试、超时、地理位置和代理国家，而 **高级选项** 包含令牌上限、CSS选择器等待、生命周期等待条件、资源阻塞、主页导航、cookie和Super模式。 ### 结果 - **得到结果** -获取页面大小和创建日期排序顺序的scraper ID的分页结果。 - **获取最新结果** -获取刮板ID的最新N结果。 - **获取结果详情** —根据结果ID获取一个完整的结果。 ### 刮刀创造 - **创建基于提示的刮板** -从URL，提示符，可选的预期JSON模式，模式和代理国家创建通用AI scraper。 - **创建清单刮板** -从URL，提示，可选项目模式，最大页数和代理国家创建列表AI刮板。 - **创建网站抓取工具** -创建一个地图AI刮板与爬行深度，最大页面，结果限制，可选的URL包括或排除模式。 创建的scraper可以在您的MrScraper帐户中使用，并且可以使用 **刮板运行**。 ### 刮板运行 - **运行现有刮板** -运行一个URL与现有的人工智能或手动刮板。 - **批量运行现有刮板** -运行多个url与现有的AI或手动刮板。 对于单个AI运行，选择代理类型： - **一般** -基于提示的页面提取，具有可选的HTML， Markdown，截图，cookie， JavaScript渲染，选择器等待和主页访问设置。 - **清单** -列表和分页提取，页面和超时限制加上可选的流和渲染设置。 - **地图** -网站URL发现与抓取限制和URL过滤模式。 手动运行支持浏览器、代理、cookie、分页器、记录、输出、超时和令牌上限选项。批处理运行接受url作为JSON数组或逗号/换行符分隔的列表。 ## 用法示例 ### 在网上搜索 1. 选择 **发现b>网络搜索**。 2. 选择已保存的文件 **MrScraper API** 证书。 3. 输入 **搜索查询**例如： `best hotels in New York`。 4. 集 **国家** (默认 `us`), **结果数量** (默认 `10`)，然后运行该节点。 节点发送 `POST https://api.mrscraper.com/` 与 `action: "websearch"`， `query`， `country`, `numResults`。中保存的凭据进行身份验证 `x-api-token` 头。 ### 使用JSON形状提取数据 1. 选择 **提取>提取页面提示**。 2. 输入页面URL。 3. 输入提示符，例如 `Extract the product name, price, availability, and image URL`。 4. 可选地输入预期的输出模式： ```json { "name": "string", "price": "number", "inStock": "boolean", "imageUrl": "string" } ``` 5. 选择 **超级** 为更强的刮擦能力或 **便宜的** 对于保护较弱的站点，则运行该节点。 ### 获取已呈现的页面 1. 选择 **提取>提取渲染HTML** 并输入目标URL。 2. 离开 **返回的HTML** Enabled或enable **返回减价** 如果还需要Markdown输出。 3. 要捕获映像，请启用 **截图**，然后选择 **全** 或 **前** 下 **截图模式**。 4. 使用 **高级选项** 当页面需要CSS选择器等待、不同的生命周期事件、资源阻塞控件、主页导航、返回的cookie、Super模式或自定义令牌上限时。 该操作默认为300秒超时，重试三次， `us` 地理位置和代理国家，启用HTML输出，禁用Markdown和截图输出。 **等到** 支持 **加载的DOM内容**， **负载**, **网络空闲**。 ### 批量运行现有的刮板 1. 选择 **刮刀运行>批量运行现有刮刀**。 2. 选择 **人工智能** 或 **手册** 并输入刮板ID。 3. 以JSON数组的形式输入url： ```json ["https://example.com/page-1", "https://example.com/page-2"] ``` 您还可以使用逗号分隔或换行分隔的url。 ### 检索完成的结果 使用 **Results >获取最新结果** 与刮刀ID，或使用 **获取结果详情** 当您已经有一个结果ID时。 ## 从2.x迁移 升级后，打开每个现有的MrScraper节点并重新选择其资源和操作。最常见的映射是： | 2.x选择 | 4.0.0选择 | | --- | --- | | 代理>总代理 | 创建刮刀>创建基于提示的刮刀 | | 代理>上市代理 | 创建Scraper >创建列表Scraper | | Agent >地图代理 | 创建抓取器>创建网站抓取器 | | 批量操作>批量抓取url | 刮刀运行>批量运行现有刮刀 | | 重新运行Scraper >手动或AI代理操作 | Scraper运行>运行现有的Scraper，然后选择Scraper和代理类型 | | 获得结果b>获得更多 | 结果b>获取结果 | | 获取结果>获取最新结果 | Results >获取最新结果 | | 获取结果>获取详细信息 | Results >获取结果详细信息 | | 抓取>提示，上市，或结构化操作 | 提取>匹配提取操作 | | SERP >遗留搜索操作 | 发现b>网络搜索 | | Web Unblocker > Fetch渲染HTML | 提取>提取渲染HTML | 还要回顾这些字段的变化： - **网络搜索** 取代遗留的搜索操作(`syncSerp`）. 重新选择 **发现b>网络搜索** 在现有的搜索节点中进行配置 `query`， `country`, `numResults`;区域、语言、页面、响应格式和JavaScript呈现不再是搜索输入。 - 现在可以共享单个和批处理重播 **刮板运行**． 选择 **人工智能** 或 **手册** 明确。 - AI单次运行在选择General、Listing或Map之后会暴露特定于代理的字段。 - 批处理url可以是JSON数组字符串或逗号/换行符分隔的列表。 - 基于提示符的操作和清单操作可以将预期的JSON模式附加到提取提示符中。 - **获取已呈现的HTML** 现在使用屏幕截图切换，后面跟着 **全** 或 **前** 模式;默认情况下，屏幕截图和Markdown是禁用的。 - 浏览器呈现始终是启用的，并且不再是用户可配置的字段。 - 令牌上限，资源阻塞，生命周期等待，cookie和超级模式现在 **高级选项**，它还添加了CSS选择器等待和可选的主页导航。 在生产环境中启用迁移的工作流之前，测试它们。 ## 兼容性 - `n8n-nodes-mrscraper` 版本: **4.0.0** - node . js: **22或以上** - 此项目使用的包管理器： **npm** ## 合规和法律风险 > \[!警告) 抓取受登录保护的页面会带来严重的法律和合规风险。许多网站在其服务条款中禁止自动访问。仅抓取您有权访问的内容，查看目标网站的条款和适用法律，并对如何使用此节点承担责任。 ## 资源 - [MrScraper](https://mrscraper.com/) - [MrScraper应用](https://app.mrscraper.com/) - [MrScraper API文档](https://docs.mrscraper.com/docs/getting-started/overview) - [MrScraper程序指南](https://docs.mrscraper.com/docs/guides/programmatically) - [scraper先生没有整合](https://n8n.io/integrations/mrscraper/) - [N8n社区节点文档](https://docs.n8n.io/integrations/community-nodes/) - [更新日志](https://npmcn.com/package/n8n-nodes-mrscraper/CHANGELOG.md) ## 许可证 这个包是在MIT许可下发布的。 ## 常见问题 ### n8n-nodes-mrscraper 是什么？ MrScraper的n8n社区节点包 ### 如何安装 n8n-nodes-mrscraper？ 在项目目录运行 npm install n8n-nodes-mrscraper，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：n8n-workflow（\*）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。 ### n8n-nodes-mrscraper 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/n8n-nodes-mrscraper 是否存在。 ### n8n-nodes-mrscraper 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### n8n-nodes-mrscraper 可以商用吗？ n8n-nodes-mrscraper 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### n8n-nodes-mrscraper 还在维护吗？ 最新版本 4\.0\.0 发布于 2026/11/04（今天）；至今共发布 14 个版本，其中过去 12 个月发布了 14 个；首次发布于 2025/12/18。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。