DeepSFetch

English | Português

DeepSFetch 开发套件

⭐ 如果这些 n8n 工作流、SDK 或 MCP 工具为你节省了时间，请在 GitHub 上为此仓库点个 Star！ 这有助于其他自动化开发者发现这套工具。

完整手册：33 篇分步指南 — API、MCP、SDK、CLI、采集、监控、文件、集成与账单。

为 AI Agent 和自动化采集网页内容，并明确设置额度上限。

面向 托管版 DeepSFetch API 的开源 JavaScript 和 Python 客户端、命令行工具及 n8n 集成代码。从一个公开的 HTML 页面开始，检查结果，然后逐步扩展。

此仓库包含客户端工具，不包含采集引擎和托管服务。运行示例需要 DeepSFetch 账户和 API 密钥；采集会消耗工作区额度。请参阅当前套餐。

即用型 n8n 工作流与社区节点

在 n8n 中自动提取结构化 HTML 内容，明确设置额度上限、幂等键，并在将数据发送到提醒、电子表格或 AI/RAG 流水线之前验证字段。

即用模板	用途	提取与交付内容	设置与下载
价格监控	按计划跟踪产品价格变化	经过验证的 name、price 和 currency（JSON-LD / CSS），并与基准值比较	配置并下载 JSON · n8n 指南
产品目录	从列表页提取最多 100 个条目	结构化条目数组，并逐条验证字段（不支持分页）	配置并下载 JSON · n8n 指南
AI / RAG 文档	将整洁的文档导入向量存储或大模型	源元数据、稳定的文档 ID、内容哈希（用于检测变更）和文本块	配置并下载 JSON · n8n 指南

安装 n8n 社区节点（n8n-nodes-deepsfetch）

对于可自托管的 n8n，可通过 UI（Settings → Community Nodes → Install → n8n-nodes-deepsfetch）安装，或手动将其安装到社区节点文件夹中：

npm install n8n-nodes-deepsfetch

（使用 n8n Cloud？你可以直接从引导式设置下载标准的 HTTP Request 工作流模板，无需安装社区节点。）

📸 查看 n8n 节点配置与经过验证的 JSON 输出截图

1. 开始采集（使用 Start Collection 操作，并选择有效负载和语言）：

2. 经过验证的输出与价格比较（使用 Compare price 步骤，并返回结构化 JSON 结果）：

获取第一个结果

需要 Node.js 22+。在 API keys 中创建密钥。从仓库根目录开始，为当前终端会话设置密钥，然后运行无需依赖的示例：

PowerShell：

$env:DEEPSFETCH_API_KEY = 'YOUR_DEEPSFETCH_API_KEY'
node examples/scrape.mjs https://example.com

macOS / Linux：

export DEEPSFETCH_API_KEY='YOUR_DEEPSFETCH_API_KEY'
node examples/scrape.mjs https://example.com

此示例提交一次仅使用 HTTP 的采集任务，最多消耗 3 个 DeepSFetch 额度，并禁用浏览器回退，然后轮询同一任务。任务完成后会以 JSON 格式打印结果。此上限不代表采集免费或一定成功。依赖 JavaScript 的页面需要使用其他配置。有关失败处理和恢复任务，请参阅入门指南。

选择你的集成

工具	安装或指南	包含内容
JavaScript SDK	npm install @deepsfetch/sdk	API v2 客户端和任务轮询
CLI	npm install -g @deepsfetch/cli	用于采集、任务和估算的命令
Python SDK	python -m pip install ./packages/deepsfetch-sdk-python	从源代码安装；PyPI 版本尚未发布
MCP	远程连接指南	托管 MCP 端点的配置
n8n	npm install n8n-nodes-deepsfetch · 指南	以 npm 发布的社区节点源代码

这里不包含远程 MCP 服务的实现。n8n 尚未验证此节点。远程 MCP 已列入官方注册表。此代码库并未声称提供原生合作关系或可自托管的采集引擎。

CLI 快速入门

安装 CLI 并设置上方的环境变量后：

deepsfetch scrape --file examples/scrape-request.json --wait

CLI 会将幂等键写入 stderr。如果提交结果未知，请使用 --idempotency-key THE_SAME_KEY 重试相同请求。获取任务 ID 后，请使用 deepsfetch job JOB_ID --wait，而不是再次提交采集任务。

开源工具和托管服务

功能	此代码库中	托管版 DeepSFetch
JavaScript SDK、Python SDK、CLI	源代码和测试	连接到 API v2
n8n 社区节点	以 JavaScript 分发的源代码	调用采集集成端点
MCP	连接指南	远程服务
采集引擎、浏览器基础设施	不包含	由 DeepSFetch 管理
账户、点数、账单和控制面板	不包含	由 DeepSFetch 管理

本地开发

npm install --ignore-scripts
npm test
npm run check

在代码库根目录运行 Python 测试：

python -m pip install ./packages/deepsfetch-sdk-python
python -m unittest discover -s packages/deepsfetch-sdk-python/tests

测试使用 fixtures 和本地 HTTP 服务器；不会提交付费采集任务。请参阅贡献指南、安全说明和路线图。

资源

• API 文档
• Playground
• n8n 设置指南
• 支持

本代码库中的工具适用 MIT 许可证。使用托管服务须遵守其自身条款和点数限制。

试用并分享反馈

阅读首次采集教程，运行运行状况冒烟测试，并分享你的首次运行体验。

经过身份验证的 Firecrawl 对比包含结果、局限性和可复现代码。已发布的 DEV 教程介绍了注册、首次采集和 MCP。另请参阅 Smithery 列表，并在 MCP 指南中查看说明和限制。