如何在 Relevance AI 中通过 CapSolver 集成解决 reCAPTCHA v2

博客

web scraping

博客

web scraping

如何在 Relevance AI 中通过 CapSolver 集成解决 reCAPTCHA v2

Ethan Collins

Pattern Recognition Specialist

03-Feb-2026

Relevance AI 是一个用于构建自动化真实业务工作流的AI代理平台，例如潜在客户生成、数据提取、表单提交和CRM增强。

在实际应用中，这些代理通常需要与受验证码保护的网站进行交互。这就是自动化通常会失败的地方——需要人工干预，工作流无法扩展。

CapSolver 通过允许 Relevance AI 工具以编程方式解决验证码挑战，并将所需的令牌作为自动化流程的一部分提交，从而解决这个问题。

在本指南中，我们将逐步介绍如何构建一个 Relevance AI 工具，以解决 reCAPTCHA v2 并将令牌提交到受保护的表单——而无需依赖浏览器自动化。

什么是 Relevance AI？

Relevance AI 是一个用于构建和部署自动化业务任务的AI代理平台。通过其强大的工具构建器，团队可以使用 JavaScript、Python 或 API 调用创建自定义自动化工具——无需复杂的基础设施。

关键功能

功能	描述
工具构建器	使用 JavaScript、Python 或 API 步骤创建自定义工具
AI 代理	具有 2000 多种集成的自主代理
无代码/低代码	在无需深入编程知识的情况下构建强大的自动化
秘密管理	安全存储 API 密钥和凭证
多代理系统	协作处理工作流的代理团队

什么是 CapSolver？

CapSolver 是一个领先的验证码解决服务，提供人工智能驱动的解决方案来绕过各种验证码挑战。支持多种验证码类型和快速响应时间，CapSolver 可无缝集成到自动化工作流中。

支持的验证码类型

为什么将 CapSolver 与 Relevance AI 集成？

在构建与受保护网站交互的 Relevance AI 代理时，验证码挑战会阻止您的自动化。以下是此集成的重要性：

完整的表单自动化：在一个工具中解决验证码并提交表单
无需浏览器：通过 API 调用工作——无需 Selenium、Playwright 或浏览器自动化
可扩展操作：大规模处理验证码保护的工作流
成本效益高：仅支付成功解决的验证码费用
高成功率：reCAPTCHA v2 的行业领先准确性

设置指南

步骤 1：获取 CapSolver API 密钥

在 capsolver.com 注册
使用优惠码 RELEVANCEAI 在每次充值时获得 6% 的额外奖励

从仪表板复制您的 API 密钥（以 CAP- 开头）

步骤 2：将 API 密钥添加到 Relevance AI

登录 Relevance AI
进入设置（齿轮图标）→ 查找 API 密钥 部分
添加新秘密：
- 名称：capsolver_api_key（或您喜欢的任何名称）
- 值：您的 CapSolver API 密钥
保存秘密

步骤 3：创建新工具

转到左侧边栏的工具
点击 创建工具
为您的工具命名："解决 reCAPTCHA v2"
添加简短描述

创建 reCAPTCHA v2 解决工具

添加输入参数

点击文本以添加两个文本输入：

输入 1:

名称: website_url
描述: 包含验证码的页面的 URL
必需: 是

输入 2:

名称: website_key
描述: reCAPTCHA 网站密钥（40 个字符）
必需: 是

添加 JavaScript 步骤

在步骤部分点击 JavaScript，并粘贴以下代码：

javascript 复制代码

const CAPSOLVER_API_KEY = '{{secrets.capsolver_api_key}}';

async function solveRecaptchaV2(websiteUrl, websiteKey) {
    // 步骤 1：创建验证码解决任务
    const createRes = await fetch('https://api.capsolver.com/createTask', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({
            clientKey: CAPSOLVER_API_KEY,
            task: {
                type: 'ReCaptchaV2TaskProxyLess',
                websiteURL: websiteUrl,
                websiteKey: websiteKey
            }
        })
    });

    const createData = await createRes.json();

    if (createData.errorId !== 0) {
        return {
            success: false,
            error: createData.errorDescription,
            token: null
        };
    }

    const taskId = createData.taskId;

    // 步骤 2：轮询解决方案（每 2 秒检查一次）
    for (let i = 0; i < 60; i++) {
        await new Promise(function(resolve) { setTimeout(resolve, 2000); });

        const pollRes = await fetch('https://api.capsolver.com/getTaskResult', {
            method: 'POST',
            headers: { 'Content-Type': 'application/json' },
            body: JSON.stringify({
                clientKey: CAPSOLVER_API_KEY,
                taskId: taskId
            })
        });

        const pollData = await pollRes.json();

        if (pollData.status === 'ready') {
            return {
                success: true,
                token: pollData.solution.gRecaptchaResponse,
                error: null
            };
        }

        if (pollData.status === 'failed') {
            return {
                success: false,
                error: pollData.errorDescription,
                token: null
            };
        }
    }

    return {
        success: false,
        error: '等待解决方案超时',
        token: null
    };
}

return await solveRecaptchaV2(params.website_url, params.website_key);

注意: 如果您的实际秘密名称不同，请将 {{secrets.capsolver_api_key}} 替换为您的实际秘密名称（例如 {{secrets.chains_cap}}）。

测试工具

使用 Google reCAPTCHA 演示页面进行测试：

website_url: https://www.google.com/recaptcha/api2/demo
website_key: 6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-

点击 运行工具 并等待 10-30 秒。您应该看到：

json 复制代码

{
  "success": true,
  "token": "03AGdBq24PBCbwiDRaS_MJ7Z...",
  "error": null
}

完整示例：解决并提交表单

这是一个更高级的工具，它解决验证码并将其提交以进行验证：

javascript 复制代码

const CAPSOLVER_API_KEY = '{{secrets.capsolver_api_key}}';

async function solveAndSubmit(websiteUrl, websiteKey) {
    // 步骤 1：创建验证码解决任务
    const createRes = await fetch('https://api.capsolver.com/createTask', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({
            clientKey: CAPSOLVER_API_KEY,
            task: {
                type: 'ReCaptchaV2TaskProxyLess',
                websiteURL: websiteUrl,
                websiteKey: websiteKey
            }
        })
    });

    const createData = await createRes.json();
    if (createData.errorId !== 0) {
        return { success: false, step: 'create', error: createData.errorDescription };
    }

    const taskId = createData.taskId;
    let token = null;

    // 步骤 2：轮询解决方案
    for (let i = 0; i < 60; i++) {
        await new Promise(function(resolve) { setTimeout(resolve, 2000); });

        const pollRes = await fetch('https://api.capsolver.com/getTaskResult', {
            method: 'POST',
            headers: { 'Content-Type': 'application/json' },
            body: JSON.stringify({
                clientKey: CAPSOLVER_API_KEY,
                taskId: taskId
            })
        });

        const pollData = await pollRes.json();

        if (pollData.status === 'ready') {
            token = pollData.solution.gRecaptchaResponse;
            break;
        }
        if (pollData.status === 'failed') {
            return { success: false, step: 'poll', error: pollData.errorDescription };
        }
    }

    if (!token) {
        return { success: false, step: 'timeout', error: '超时' };
    }

    // 步骤 3：通过 POST 请求提交表单
    const submitRes = await fetch(websiteUrl, {
        method: 'POST',
        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
        body: 'g-recaptcha-response=' + token
    });

    const html = await submitRes.text();
    const verified = html.includes('Success') || html.includes('verificado');

    return {
        success: verified,
        token_length: token.length,
        message: verified ? '验证码成功验证！' : '检查响应',
        response_preview: html.substring(0, 300)
    };
}

return await solveAndSubmit(params.website_url, params.website_key);

此工具：

✅ 解决 reCAPTCHA v2
✅ 通过 POST 请求提交令牌
✅ 返回验证状态

最佳实践

1. 错误处理

在每一步都检查错误：

javascript 复制代码

if (createData.errorId !== 0) {
    return { success: false, error: createData.errorDescription };
}

2. 检查余额

创建一个单独的工具来监控您的 CapSolver 余额：

javascript 复制代码

const CAPSOLVER_API_KEY = '{{secrets.capsolver_api_key}}';

async function checkBalance() {
    const response = await fetch('https://api.capsolver.com/getBalance', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({ clientKey: CAPSOLVER_API_KEY })
    });

    const data = await response.json();

    return {
        balance: data.balance,
        formatted: '$' + data.balance.toFixed(4)
    };
}

return await checkBalance();

3. 超时配置

默认的 60 次尝试 × 2 秒 = 2 分钟超时。如需调整：

javascript 复制代码

// 为更快的超时（30 秒）
for (let i = 0; i < 15; i++) {
    await new Promise(function(resolve) { setTimeout(resolve, 2000); });
    // ...
}

结论

将 CapSolver 与 Relevance AI 集成可以实现强大的自动化工作流，能够处理受验证码保护的表单。主要优势包括：

无需浏览器自动化 - 仅通过纯 API 调用工作
快速可靠 - CapSolver 的人工智能在几秒内解决验证码
易于实现 - 仅需在 Relevance AI 的工具构建器中使用 JavaScript
可扩展 - 无需考虑基础设施即可处理多个请求

通过将 Relevance AI 的代理功能与 CapSolver 的验证码解决能力结合，您可以构建完整的自动化工作流，即使是最受保护的表单也能处理。

准备好开始了吗？ 注册 CapSolver 并使用优惠码 RELEVANCE 在首次充值时获得额外 6% 的奖励！

常见问题

什么是 Relevance AI？

Relevance AI 是一个用于构建自动化业务任务的 AI 代理平台。它提供一个工具构建器，您可以使用 JavaScript、Python 或 API 调用创建自定义自动化工具。

Relevance AI 是否进行浏览器自动化？

不。Relevance AI 通过 API 调用工作，而不是浏览器自动化。它无法打开浏览器、点击按钮或向页面注入 JavaScript。然而，它可以通过 HTTP POST 提交带有验证码令牌的目标表单。

CapSolver 如何与 Relevance AI 集成？

您在 Relevance AI 中创建一个 JavaScript 工具，调用 CapSolver API。该工具将验证码详细信息发送到 CapSolver，接收解决后的令牌，然后通过 HTTP POST 将该令牌提交到目标表单。

CapSolver 可以解决哪些类型的验证码？

CapSolver 支持 reCAPTCHA v2、reCAPTCHA v3、Cloudflare Turnstile、AWS WAF 等多种类型。

CapSolver 的费用是多少？

CapSolver 提供具有竞争力的按解决计费的价格。访问 capsolver.com 查看当前价格。

如何找到 reCAPTCHA 网站密钥？

在页面的 HTML 中查找 reCAPTCHA 元素的 data-sitekey 属性。它是一个以 6L 开头的 40 个字符的字符串。查看此指南了解更多详情

解决验证码需要多长时间？

通常需要 10-30 秒来解决 reCAPTCHA v2。该工具每 2 秒轮询一次，直到解决方案就绪。

合规声明：本博客提供的信息仅供参考。CapSolver 致力于遵守所有适用的法律和法规。严禁以非法、欺诈或滥用活动使用 CapSolver 网络，任何此类行为将受到调查。我们的验证码解决方案在确保 100% 合规的同时，帮助解决公共数据爬取过程中的验证码难题。我们鼓励负责任地使用我们的服务。如需更多信息，请访问我们的服务条款和隐私政策。