反检测隐身5 credits

stealth_mode

采用先进的反检测技术绕过机器人检测系统，包括指纹随机化、人类行为模拟和隐身浏览器配置。

使用场景

受保护的电商网站

从受 Cloudflare、DataDome 或 PerimeterX 保护的网站抓取产品数据

社交媒体平台

从具备复杂机器人检测的平台提取公开数据

金融数据网站

从受保护的来源获取市场数据、股票价格和金融信息

受限速的 API

通过指纹轮换绕过激进的速率限制

地理屏蔽的内容

借助住宅代理支持访问受地区限制的内容

高安全性测试

使用先进的规避技术测试您自己的反机器人系统

Endpoint

POST/api/v1/tools/stealth_mode

Auth Required

Free 计划 1 req/s

5 credits

Parameters

Name	Type	Required	Default	Description
operation	string	Optional	configure	要执行的隐身操作：scrape、configure、enable、disable、create_context、create_page、get_stats 或 cleanup。`scrape` 是一次调用完成的路径——它创建隐身上下文、导航到 `url`、返回请求的 `formats`，然后拆除上下文，全部计入一次计费调用。create_context → create_page → cleanup 序列仍然保留，供需要复用同一上下文的多步骤工作使用。 Example: create_context
stealthConfig	object	Optional	-	详细的隐身选项。键：level（basic \| medium \| advanced，默认 medium）、randomizeFingerprint、hideWebDriver、blockWebRTC、spoofTimezone、randomizeHeaders、useRandomUserAgent、simulateHumanBehavior（均为布尔值，默认 true）、customUserAgent、customViewport（{ width 800-1920, height 600-1080 }）、locale（默认 "en-US"）和 timezone。 Example: {"level": "advanced", "blockWebRTC": true}
engine	string	Optional	playwright	浏览器引擎："playwright"（默认）或 "camoufox"（基于 Firefox，反检测能力更强；仅在后端已安装时可用）。 Example: camoufox
contextId	string	Optional	-	由 create_context 调用返回的浏览器上下文 ID。将其传给 create_page，以在该隐身上下文中打开页面。 Example: ctx_ab12cd34ef56
urlToTest	string	Optional	-	使用 create_page 创建页面时要导航到的 URL。 Example: https://protected-site.com
url	string	Optional	-	要抓取的 URL。`operation: "scrape"` 必填；其他操作会忽略它，改用 `urlToTest`。 Example: https://protected-site.com/product/42
formats	array	Optional	["markdown"]	`operation: "scrape"` 返回的格式：`markdown`、`html`、`text`、`links`、`metadata` 或 `screenshot`。截图以 `crawlforge://screenshot/{id}` 资源 URI 的形式返回，而不是内联 base64；此 REST 端点会原样透传该 URI 而不解析它，因此目前 `screenshot` 只能通过能够读取该资源的 CrawlForge MCP 服务器使用。 Example: ["markdown", "links"]
wait_for	number	Optional	-	页面加载后的额外等待时间，单位毫秒（0-30000）。用于在 DOMContentLoaded 之后才渲染的内容；隐身运行本身已包含类人延迟，因此请从较小的值开始。 Example: 2000
verbose	boolean	Optional	false	返回 create_context 生成的完整指纹，而不是摘要。在排查目标为何仍能检测到浏览器时很有用。 Example: false
respect_robots	boolean	Optional	true	遵守目标站点的 robots.txt。省略该参数时按合规默认值（`true`）执行：robots.txt 对 `CrawlForge` 禁止的 URL 会在启动任何浏览器之前被拒绝，此端点不会为此扣费，每一次导航也会同样检查。即使隐身浏览器使用随机化的 User-Agent，该规则仍按 `CrawlForge` 产品令牌匹配，因此站点所有者的 `User-agent: CrawlForge` 指令同样约束隐身流量。仅在您与目标站点另有约定时才设为 `false`——此时响应会带上一条 `warnings`，并且该覆盖会记录到您的 API key 上。 Example: true

各操作及其费用

5 credits 对应浏览器工作；事务性操作每次 1 credit。因此一次调用完成的 scrape 为 5 credits，而 create_context → create_page → cleanup 这条路线需要 11 credits。

scrape — 5 credits

一次调用完成：创建隐身上下文、导航到 url、返回请求的 formats 以及页面标题和最终 URL，然后拆除上下文。请从这里开始。

create_context — 5 credits

打开一个可复用的隐身上下文并返回其 contextId。当多个页面需要共享同一指纹和 cookie 存储时使用。

create_page — 5 credits

在已有的 contextId 内导航到 urlToTest。调用返回时页面会关闭，上下文保留。

configure / enable / disable — 1 credit

校验隐身配置，或为后续调用开启和关闭隐身。其中不发生浏览行为，因此按事务性操作计费。

get_stats — 1 credit

读取后端上下文与页面的实时计数器。不涉及浏览。

cleanup — 1 credit

拆除后端上所有打开的上下文。不涉及浏览，因此释放您打开的资源绝不会按浏览器费率收费。

隐身模式不做的事

隐身模式使用随机化的浏览器指纹渲染 JavaScript。它不解决 CAPTCHA、不伪造挑战令牌，也不会绕过登录或付费墙，更不能用于规避专门针对 CrawlForge 的封锁。robots.txt 在每一次导航时仍然生效，并按 CrawlForge 产品令牌匹配。如果目标仍然拒绝，正确的做法是使用有文档的 API 或取得站点所有者的许可，而不是调高隐身级别。

引擎选择

stealth_mode 支持两种底层浏览器引擎。请根据目标网站的检测难度进行选择。

Playwright（默认）

经过实战检验的 Chromium 自动化方案，配有隐身插件。最适合：大多数网站、快速执行、广泛的调试工具。资源占用更轻。

Camoufox

基于 Firefox 的分支，针对反机器人规避进行了加固。最适合：激进的机器人检测（Cloudflare Turnstile、DataDome、PerimeterX 强力模式）。内存占用更高；启动稍慢。

引擎示例

terminalBash

curl -X POST https://crawlforge.dev/api/v1/tools/stealth_mode \
  -H "X-API-Key: cf_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "operation": "create_context",
    "engine": "camoufox",
    "stealthConfig": {
      "level": "advanced"
    }
  }'

隐身级别

Basic（最快）

最适合机器人检测程度极低的网站。包括 User-Agent 随机化、基础请求头处理、cookie 处理，约 1-2 秒延迟。

Medium（推荐）

在隐身性与性能之间取得平衡。包括完整指纹随机化、Canvas/WebGL 指纹遮蔽、时区与语言伪装、类人滚动与移动，约 3-5 秒延迟。

Advanced（最慢）

为重度保护的网站提供最高隐身性。包含所有 medium 功能，外加：WebDriver 检测规避、先进的 TLS 指纹、鼠标移动模拟、随机点击模式，约 8-12 秒延迟。

请求示例

terminalBash

# 1. Create a stealth browser context
curl -X POST https://crawlforge.dev/api/v1/tools/stealth_mode \
  -H "X-API-Key: cf_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "operation": "create_context",
    "engine": "playwright",
    "stealthConfig": {
      "level": "advanced",
      "randomizeFingerprint": true,
      "blockWebRTC": true
    }
  }'

# 2. Open a page in that context (use the contextId from step 1)
curl -X POST https://crawlforge.dev/api/v1/tools/stealth_mode \
  -H "X-API-Key: cf_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "operation": "create_page",
    "contextId": "ctx_ab12cd34ef56",
    "urlToTest": "https://protected-site.com"
  }'

响应示例

200 OK1,200ms

{
  "success": true,
  "data": {
    "operation": "create_context",
    "contextId": "ctx_ab12cd34ef56",
    "engine": "playwright",
    "stealthConfig": {
      "level": "advanced",
      "randomizeFingerprint": true,
      "hideWebDriver": true,
      "blockWebRTC": true,
      "spoofTimezone": true,
      "locale": "en-US"
    },
    "message": "Stealth context created"
  },
  "credits_used": 5,
  "credits_remaining": 995,
  "processing_time": 1200
}

Field Descriptions

data.contextId将其传给 create_page，以在此隐身上下文中打开页面

data.operation已执行的隐身操作

data.stealthConfig应用于该上下文的已解析隐身配置

credits_used浏览器工作（scrape、create_context、create_page）消耗 5 credits；事务性操作消耗 1 credit

processing_time启动隐身上下文的耗时（毫秒）

错误处理

浏览器运行时未配置（503 TOOL_NOT_AVAILABLE）

隐身模式需要浏览器运行时。当托管执行后端未配置时，调用会立即返回 503，且不扣除 credits。

超出速率限制（429 Too Many Requests）

您已超出所属方案的速率限制。请稍候，或升级方案以获得更高上限。

无效操作（400 Bad Request）

操作必须为以下之一：scrape、configure、enable、disable、create_context、create_page、get_stats 或 cleanup。

执行后端超时（504 MCP_UPSTREAM_TIMEOUT）

目标站点未能在执行后端的时间预算内加载完成。防护严密的站点是常见原因。失败不计费。

被 robots.txt 阻止（502 TOOL_ERROR）

目标站点的 robots.txt 对 CrawlForge 禁止了该 URL，因此没有启动任何浏览器，也没有产生任何费用。若您与目标站点另有约定，可设置 respect_robots: false 予以覆盖——该覆盖会记录到您的 API key 上。该覆盖不适用于列入 CrawlForge 永久排除名单的主机——无论 respect_robots 取何值，这类主机一律被拒绝。

专业提示： 请先从 "medium" 隐身级别开始。仅对屏蔽 medium 级别的网站使用 "advanced"。在多次 create_page 调用中重用同一个上下文以摊薄初始化开销——在进行批量操作时请据此做好规划。

Credit 费用

5 credits

每次浏览器操作 5 credits

5 credits 对应浏览器工作——scrape、create_context 或 create_page——与隐身级别无关。configure、enable、disable、get_stats 和 cleanup 这些事务性操作不进行浏览，每次仅 1 credit，因此一次调用完成的 scrape 全程只需 5 credits。

包含内容：

指纹随机化（所有级别）

人类行为模拟

反检测技术

WebDriver 检测规避（medium 及以上）

Canvas/WebGL 遮蔽（medium 及以上）

先进的 TLS 指纹（advanced）

套餐推荐：

Free 套餐： 1,000 个一次性试用 credits = 200 次隐身请求

Hobby 套餐： 5,000 credits = 1,000 次隐身请求（$19/mo）

Professional 套餐： 50,000 credits = 10,000 次隐身请求（$99/mo）

stealth_mode

采用先进的反检测技术绕过机器人检测系统，包括指纹随机化、人类行为模拟和隐身浏览器配置。

使用场景

受保护的电商网站

从受 Cloudflare、DataDome 或 PerimeterX 保护的网站抓取产品数据

社交媒体平台

从具备复杂机器人检测的平台提取公开数据

金融数据网站

从受保护的来源获取市场数据、股票价格和金融信息

受限速的 API

通过指纹轮换绕过激进的速率限制

地理屏蔽的内容

借助住宅代理支持访问受地区限制的内容

高安全性测试

使用先进的规避技术测试您自己的反机器人系统

Endpoint

POST/api/v1/tools/stealth_mode

Auth Required

Free 计划 1 req/s

5 credits

Parameters

Name	Type	Required	Default	Description
operation	string	Optional	configure	要执行的隐身操作：scrape、configure、enable、disable、create_context、create_page、get_stats 或 cleanup。`scrape` 是一次调用完成的路径——它创建隐身上下文、导航到 `url`、返回请求的 `formats`，然后拆除上下文，全部计入一次计费调用。create_context → create_page → cleanup 序列仍然保留，供需要复用同一上下文的多步骤工作使用。 Example: create_context
stealthConfig	object	Optional	-	详细的隐身选项。键：level（basic \| medium \| advanced，默认 medium）、randomizeFingerprint、hideWebDriver、blockWebRTC、spoofTimezone、randomizeHeaders、useRandomUserAgent、simulateHumanBehavior（均为布尔值，默认 true）、customUserAgent、customViewport（{ width 800-1920, height 600-1080 }）、locale（默认 "en-US"）和 timezone。 Example: {"level": "advanced", "blockWebRTC": true}
engine	string	Optional	playwright	浏览器引擎："playwright"（默认）或 "camoufox"（基于 Firefox，反检测能力更强；仅在后端已安装时可用）。 Example: camoufox
contextId	string	Optional	-	由 create_context 调用返回的浏览器上下文 ID。将其传给 create_page，以在该隐身上下文中打开页面。 Example: ctx_ab12cd34ef56
urlToTest	string	Optional	-	使用 create_page 创建页面时要导航到的 URL。 Example: https://protected-site.com
url	string	Optional	-	要抓取的 URL。`operation: "scrape"` 必填；其他操作会忽略它，改用 `urlToTest`。 Example: https://protected-site.com/product/42
formats	array	Optional	["markdown"]	`operation: "scrape"` 返回的格式：`markdown`、`html`、`text`、`links`、`metadata` 或 `screenshot`。截图以 `crawlforge://screenshot/{id}` 资源 URI 的形式返回，而不是内联 base64；此 REST 端点会原样透传该 URI 而不解析它，因此目前 `screenshot` 只能通过能够读取该资源的 CrawlForge MCP 服务器使用。 Example: ["markdown", "links"]
wait_for	number	Optional	-	页面加载后的额外等待时间，单位毫秒（0-30000）。用于在 DOMContentLoaded 之后才渲染的内容；隐身运行本身已包含类人延迟，因此请从较小的值开始。 Example: 2000
verbose	boolean	Optional	false	返回 create_context 生成的完整指纹，而不是摘要。在排查目标为何仍能检测到浏览器时很有用。 Example: false
respect_robots	boolean	Optional	true	遵守目标站点的 robots.txt。省略该参数时按合规默认值（`true`）执行：robots.txt 对 `CrawlForge` 禁止的 URL 会在启动任何浏览器之前被拒绝，此端点不会为此扣费，每一次导航也会同样检查。即使隐身浏览器使用随机化的 User-Agent，该规则仍按 `CrawlForge` 产品令牌匹配，因此站点所有者的 `User-agent: CrawlForge` 指令同样约束隐身流量。仅在您与目标站点另有约定时才设为 `false`——此时响应会带上一条 `warnings`，并且该覆盖会记录到您的 API key 上。 Example: true

各操作及其费用

5 credits 对应浏览器工作；事务性操作每次 1 credit。因此一次调用完成的 scrape 为 5 credits，而 create_context → create_page → cleanup 这条路线需要 11 credits。

scrape — 5 credits

一次调用完成：创建隐身上下文、导航到 url、返回请求的 formats 以及页面标题和最终 URL，然后拆除上下文。请从这里开始。

create_context — 5 credits

打开一个可复用的隐身上下文并返回其 contextId。当多个页面需要共享同一指纹和 cookie 存储时使用。

create_page — 5 credits

在已有的 contextId 内导航到 urlToTest。调用返回时页面会关闭，上下文保留。

configure / enable / disable — 1 credit

校验隐身配置，或为后续调用开启和关闭隐身。其中不发生浏览行为，因此按事务性操作计费。

get_stats — 1 credit

读取后端上下文与页面的实时计数器。不涉及浏览。

cleanup — 1 credit

拆除后端上所有打开的上下文。不涉及浏览，因此释放您打开的资源绝不会按浏览器费率收费。

隐身模式不做的事

引擎选择

stealth_mode 支持两种底层浏览器引擎。请根据目标网站的检测难度进行选择。

Playwright（默认）

经过实战检验的 Chromium 自动化方案，配有隐身插件。最适合：大多数网站、快速执行、广泛的调试工具。资源占用更轻。

Camoufox

引擎示例

terminalBash

curl -X POST https://crawlforge.dev/api/v1/tools/stealth_mode \
  -H "X-API-Key: cf_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "operation": "create_context",
    "engine": "camoufox",
    "stealthConfig": {
      "level": "advanced"
    }
  }'

隐身级别

Basic（最快）

最适合机器人检测程度极低的网站。包括 User-Agent 随机化、基础请求头处理、cookie 处理，约 1-2 秒延迟。

Medium（推荐）

在隐身性与性能之间取得平衡。包括完整指纹随机化、Canvas/WebGL 指纹遮蔽、时区与语言伪装、类人滚动与移动，约 3-5 秒延迟。

Advanced（最慢）

为重度保护的网站提供最高隐身性。包含所有 medium 功能，外加：WebDriver 检测规避、先进的 TLS 指纹、鼠标移动模拟、随机点击模式，约 8-12 秒延迟。

请求示例

terminalBash

# 1. Create a stealth browser context
curl -X POST https://crawlforge.dev/api/v1/tools/stealth_mode \
  -H "X-API-Key: cf_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "operation": "create_context",
    "engine": "playwright",
    "stealthConfig": {
      "level": "advanced",
      "randomizeFingerprint": true,
      "blockWebRTC": true
    }
  }'

# 2. Open a page in that context (use the contextId from step 1)
curl -X POST https://crawlforge.dev/api/v1/tools/stealth_mode \
  -H "X-API-Key: cf_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "operation": "create_page",
    "contextId": "ctx_ab12cd34ef56",
    "urlToTest": "https://protected-site.com"
  }'

响应示例

200 OK1,200ms

{
  "success": true,
  "data": {
    "operation": "create_context",
    "contextId": "ctx_ab12cd34ef56",
    "engine": "playwright",
    "stealthConfig": {
      "level": "advanced",
      "randomizeFingerprint": true,
      "hideWebDriver": true,
      "blockWebRTC": true,
      "spoofTimezone": true,
      "locale": "en-US"
    },
    "message": "Stealth context created"
  },
  "credits_used": 5,
  "credits_remaining": 995,
  "processing_time": 1200
}

Field Descriptions

data.contextId将其传给 create_page，以在此隐身上下文中打开页面

data.operation已执行的隐身操作

data.stealthConfig应用于该上下文的已解析隐身配置

credits_used浏览器工作（scrape、create_context、create_page）消耗 5 credits；事务性操作消耗 1 credit

processing_time启动隐身上下文的耗时（毫秒）

错误处理

浏览器运行时未配置（503 TOOL_NOT_AVAILABLE）

隐身模式需要浏览器运行时。当托管执行后端未配置时，调用会立即返回 503，且不扣除 credits。

超出速率限制（429 Too Many Requests）

您已超出所属方案的速率限制。请稍候，或升级方案以获得更高上限。

无效操作（400 Bad Request）

操作必须为以下之一：scrape、configure、enable、disable、create_context、create_page、get_stats 或 cleanup。

执行后端超时（504 MCP_UPSTREAM_TIMEOUT）

目标站点未能在执行后端的时间预算内加载完成。防护严密的站点是常见原因。失败不计费。

被 robots.txt 阻止（502 TOOL_ERROR）

Credit 费用

5 credits

每次浏览器操作 5 credits

包含内容：

指纹随机化（所有级别）

人类行为模拟

反检测技术

WebDriver 检测规避（medium 及以上）

Canvas/WebGL 遮蔽（medium 及以上）

先进的 TLS 指纹（advanced）

套餐推荐：

Free 套餐： 1,000 个一次性试用 credits = 200 次隐身请求

Hobby 套餐： 5,000 credits = 1,000 次隐身请求（$19/mo）

Professional 套餐： 50,000 credits = 10,000 次隐身请求（$99/mo）

stealth_mode

使用场景

Endpoint

Parameters

各操作及其费用

隐身模式不做的事

引擎选择

引擎示例

隐身级别

请求示例

响应示例

错误处理

Credit 费用

相关工具

stealth_mode

使用场景

Endpoint

Parameters

各操作及其费用

隐身模式不做的事

引擎选择

引擎示例

隐身级别

请求示例

响应示例

错误处理

Credit 费用

相关工具