CapSkip 浏览器扩展指南
了解如何安装和配置 CapSkip 浏览器扩展以自动识别验证码。
CapSkip 浏览器扩展会将你的浏览器连接到运行在你的电脑或服务器上的 CapSkip 验证码识别工具 应用,并自动识别受支持的验证码。
当出现验证码时,扩展会通过配置的 服务器 IP 和 端口将请求发送给 CapSkip。CapSkip 在本地识别并返回结果,扩展会自动将其应用到页面上。
支持的验证码类型: 图片验证码、reCAPTCHA v2、reCAPTCHA v2 Invisible、reCAPTCHA v3、Cloudflare Turnstile、hCaptcha、Amazon WAF、GeeTest v3、GeeTest v4、ALTCHA、CaptchaFox、Capy Puzzle、Friendly Captcha、DataDome、MTCaptcha 和 Yandex SmartCaptcha.
- 从 Chrome 网上应用店或 Firefox 附加组件商店安装扩展。
- 打开扩展弹窗,输入 CapSkip 应用的服务器 IP 和端口。如果 CapSkip 运行在同一台电脑上,请使用 localhost 和 8080。
- 查看 API 密钥下方的状态行。当它变为绿色并显示“CapSkip 应用已连接”时,受支持的验证码就会被自动识别。
- 图片验证码在每个网站上还需要多做一步: 将图片与其答案字段关联.
安装
将扩展添加到浏览器,然后把它连接到你电脑或服务器上的 CapSkip 应用。
Chrome 及基于 Chromium 的浏览器:在以下商店安装 CapSkip: Chrome 应用商店 ,然后点击 添加到 Chrome.
Brave、Edge、Opera 和 Vivaldi 都能运行 Chrome 扩展,因此可以从同一个商店安装。
Firefox:在以下商店安装 CapSkip: Firefox 附加组件商店 ,然后点击 添加到 Firefox.
固定扩展:在工具栏中打开浏览器的扩展菜单并固定 CapSkip,这样只需点击一下就能打开弹窗。
然后打开弹窗,将其连接到 CapSkip 应用,详见 扩展弹窗.
扩展弹窗
点击浏览器工具栏中的 CapSkip 图标。右侧是弹窗的各个部分,左侧说明它们的作用。
语言 可将扩展界面切换为英语、中文、西班牙语、俄语或波斯语。 主题:“自动”跟随你的操作系统,“浅色”和“深色”则保持固定。
开 / 关 用于开启或关闭识别。关闭时,扩展不会向 CapSkip 发送任何内容。弹窗和设置页面共用这三个控件。
服务器 IP: localhost ,适用于 CapSkip 在同一台电脑上运行的情况,点击按钮即可自动填入。如果在 VPS 上运行,请输入服务器的公网 IP 地址。
端口:CapSkip 中设置的端口, 8080 为默认值。
仅当 API 密钥校验 在 CapSkip 应用中开启时才需要填写,否则请留空。 开始免费试用,即卡片顶部的链接,在你还没有授权时会打开免费试用。
绿色:就绪。 红色:该 IP 和端口上没有任何响应,请检查 CapSkip 是否正在运行。 黄色:有程序作出了响应,但检查未通过,通常是因为 API 密钥被拒绝。
每次打开弹窗以及每次修改后都会进行检查。点击指示灯可重新检查。
每种验证码类型各有一个开关,计数器显示已开启的数量。最常用的六种类型排在最前面,其余十种位于 更多类型中,弹窗会记住它是展开还是收起。
在页面上选择 将图片验证码与其答案字段关联,详见 图片验证码设置. Token 将 reCAPTCHA v2 令牌传给页面, 点击 通过点击图片来完成图片挑战。
每种类型的说明见 验证码类型.
扫描你正在查看的标签页(包括其中所有框架),并列出找到的每个验证码: 已启用 (CapSkip 会识别它)、 已停用 (受支持,但开关已关闭)或 不支持,例如 Arkose Labs (FunCaptcha)。
复制 会将任务参数复制为 JSON,可用于 CapSkip API 或提交给技术支持。如果页面无法扫描,请重新加载标签页后再试。
0x4AAAAAAA…https://example.com/login显示 CapSkip 在此浏览器中今天或最近 7 天的表现:已识别的验证码数量、成功尝试所占的比例和平均识别时间,下方每种验证码类型各占一行。
统计数据只保存在此浏览器中。 活动记录是设置中的一个页面,列出所有最近的识别记录,并可在此清除统计数据。
手动解决:验证码会一直等待,直到你在页面上点击 Solve with CapSkip 按钮,而且该按钮会始终显示。
域名黑名单:开关开启时,CapSkip 在这些网站上不会工作。 example.com 也包括其所有子域名;带斜杠的条目(例如 example.com/login)只会屏蔽地址中包含该内容的页面。
更多设置 会打开下文介绍的完整设置页面。
图片验证码设置
图片验证码需要在每个网站上设置一次:告诉 CapSkip 哪张图片是验证码,以及答案应填到哪里。
在页面上选择 (推荐):打开网站,打开弹窗,然后点击 在页面上选择 (位于图像验证码旁边)。页面上会出现 CapSkip 横幅。
点击验证码。移动鼠标时元素会高亮显示,横幅中会显示你所选内容的预览。
然后点击用于填写答案的输入框。横幅会确认关联,此后每次访问时答案都会自动填入。
该方法在禁用右键菜单的网站上也能使用。对已关联的验证码再次关联时,会更新原有关联,而不会新增一个。
右键菜单:右键点击验证码图片并选择 标记为 CAPTCHA 来源,然后右键点击答案字段并选择 在此插入验证码答案.
两种方式都会创建相同的已保存绑定,可在以下位置查看: 已保存的绑定.
就绪:显示 Solve with CapSkip。开启手动解决时,点击它即可开始识别。
识别:圆环旋转,计时器开始计时。 已识别:变为绿色,并显示所用时间。 错误:用几个字说明出了什么问题。悬停可查看错误代码,点击可重试。
固定在右下角时,它平时显示为一个小圆形锁图标,鼠标悬停或有消息需要提示时会展开。
| 错误消息 | 该怎么做 |
|---|---|
| 连接失败 | 扩展无法连接到 CapSkip。请检查应用是否正在运行,以及 IP 和端口是否一致。 |
| 请先设置 CapSkip | 尚未设置服务器地址。请在“服务器与 API 密钥”中填写。 |
| API 密钥无效 | CapSkip 拒绝了该密钥。请从 CapSkip 应用中重新复制。 |
| 余额不足 | 该 API 密钥已没有剩余的识别次数。请在 CapSkip 应用的 API 密钥设置中提高或重置其限额。 |
| 您的 IP 已被封禁 | 该 API 密钥仅限一台设备使用,且已在另一个 IP 地址上使用,或者网站封禁了你的 IP 地址。 |
| 此验证码无法解决 | 识别器已放弃此验证码。请刷新页面以获取新的验证码。 |
| 验证码已过期,请刷新页面 | 验证码在被使用前已超时。 |
| 解决失败 | 其他任何错误。将鼠标悬停在按钮上即可看到错误代码。 |
设置页面
扩展的所有选项都集中在一个带侧边栏的页面中:连接、求解和更多。下面逐一重现各个部分,并附上说明。
服务器 与 API 密钥
CapSkip 的运行位置。扩展会把每个验证码发送到这里。
与弹窗中的地址相同,每个字段下方都有提示。
在此页面上密钥是隐藏的,点击眼睛按钮即可显示。
请求该地址上的 CapSkip 作出响应,并用通俗的话告诉你结果。第四种结果 不是 CapSkip,表示该 IP 和端口上运行的是其他程序。
http://localhost:8080。浏览网页时请保持 CapSkip 运行。验证码类型
十六种验证码类型,每种都有独立开关。已启用的类型会被自动检测并解决。
与弹窗中的开关相同。开启后,每张卡片都会显示 开 · 手动.
一次性开启或关闭所有类型。
图片中的文字。每个网站需要进行一次关联,详见 图片验证码设置.
Google 的复选框和图片挑战。 Token 返回验证令牌, 点击 像真人一样完成图片挑战。
在提交表单或点击按钮时自动触发。
在后台为访客评分,并返回页面所需的令牌。
Cloudflare 的验证挑战。对于不断显示新挑战的网站,请参见 高级.
Amazon WAF(AWS WAF)在受保护网站前显示的验证码。
较新的 GeeTest 版本,包括滑块、图标和九宫格拼图。无论显示哪种拼图,CapSkip 都会返回页面所校验的结果。
包括滑块和设备检查。仅支持 Chrome,通过你浏览器自身的 IP 识别。 DataDome 需要 Windows 版 Chrome 或 IP 已被 DataDome 封禁 (显示在按钮上)表示需要更换浏览器或 IP。
MTCaptcha 是登录和注册表单上显示的文字验证码。CapSkip 返回表单提交所需的已验证令牌。低干扰模式的组件会先有几秒钟时间自行通过验证。
Yandex 的复选框、其隐形版本,以及复选框之后出现的所有图片挑战。CapSkip 返回表单提交的令牌。
表单自动化
在识别前后运行的可选辅助功能。
等待设定的延迟后提交表单。如果某条 AutoSubmit 规则 与页面匹配,则改为执行该规则。
适用于不刷新页面就加载新图片验证码的页面,例如答错之后。
在设定范围内于字符之间停顿,输入第一个字符前先等待,并可先清空字段。有些网站只接受像真人一样输入的答案。
设为 0 即关闭重试。重试无法解决的错误(例如 API 密钥无效)永远不会重试。
固定在页面上 是默认选项。 已隐藏 不显示按钮并自动识别;但如果开启了手动解决,按钮仍会显示在右下角,因为这是开始识别的唯一方式。
网站与规则
适用于特定网站的所有设置。
域名黑名单
这里的黑名单与 弹窗中的相同,只是空间更大。计数显示你有多少个条目,你可以通过两种视图编辑它们:
列表:一次添加一个条目,并通过条目旁边的叉号将其移除。
纯文本:一次编辑整个列表,每行一个条目。无法匹配任何网站的行会在输入框下方标出。
条目的工作方式与弹窗中相同: example.com 也涵盖其子域名,而包含斜杠的条目,例如 example.com/login,只会屏蔽地址中包含该文本的页面。该列表仅在开关开启时生效。
AutoSubmit 规则
此部分让你定义验证码识别后应运行的自定义操作。
默认情况下, AutoSubmit 功能会自动提交包含验证码答案字段的表单。但是,某些网站在验证码识别后需要额外步骤,例如点击特定按钮或触发另一操作。在这些情况下,你可以在此创建自定义规则。
capskip.com/demodocument › querySelector("button[type=submit]") › click()编辑删除创建新规则
创建新规则 会在卡片内打开规则编辑器。填写 URL 模式和操作序列,然后点击 保存,或点击 取消 放弃。如果模式不是有效的正则表达式,或没有填写任何操作,编辑器会在保存前提示你。
已保存的规则会列在卡片中,并显示其模式和一段简短易读的操作摘要,例如 document › querySelector("#submit-button") › click()。使用 编辑 可修改规则,使用 删除 可将其移除。
{"type":"source","value":"document"}
{"type":"method","value":"querySelector","args":["#submit-button"]}
{"type":"method","value":"click"}URL 模式
定义规则应生效的网站。URL 模式是一个正则表达式,例如 ^https://example\.com/login。扩展只会在地址与其匹配的页面上运行该规则,并以第一条匹配的规则为准。
https://example.com/login 和 https://example.com/login?next=/,而不是 https://shop.example.com/login.操作序列
“操作序列”字段定义了扩展在验证码识别后应执行的步骤。每个操作代表扩展执行的一条命令,用于与页面上的元素交互。
操作以单独的 JSON 对象编写,每行一个,并按其出现的顺序从上到下执行。
每个 action 都包含一个 type 和一个 value,某些 action 可能会使用 args 包含额外的参数。
字段上方的“插入”按钮可为你添加三种最常用的操作: document, querySelector 和 click。请修改插入行中的选择器,使其与你页面上的按钮相匹配。
基本结构:每个操作都遵循所示格式,多个操作分行书写。
在此示例中,扩展将:
从页面文档开始
找到与选择器匹配的元素
#submit-button点击所选元素
由于操作按顺序运行,行的顺序很重要。
{"type":"ACTION_TYPE","value":"ACTION_VALUE","args":[...]}{"type":"source","value":"document"}
{"type":"method","value":"querySelector","args":["#submit-button"]}
{"type":"method","value":"click"}常用操作
1. source:定义查找元素的起始上下文。
2. method: querySelector:使用 CSS 选择器选择元素。本例会查找以下 ID 的元素: submit-button.
3. method: click:在当前选中的元素上触发点击,模拟点击上一步所选的元素。
{"type":"source","value":"document"}{"type":"method","value":"querySelector","args":["#submit-button"]}{"type":"method","value":"click"}已保存的绑定
已保存的绑定是 网站与规则 页面上的最后一张卡片,用于存储在指定网站上哪个元素是图片验证码、哪个输入框接收答案。 在页面上选择 和右键菜单选项会创建这些绑定。
每一行都会显示网站和页面路径、验证码预览以及关联的答案字段。标记为 未链接字段 或 未链接验证码 的绑定只完成了一半设置,而 无预览 表示没有保存验证码的图片。
删除任何错误或过时的绑定,然后在实际页面上重新设置。列表下方的提示说明了添加绑定的两种方式。
/captcha-demo/text-captcha//signup活动记录
此浏览器中最近 200 次识别。
CapSkip 处理过的验证码,最新的在前:类型、网站、 已识别 或 失败、所用时长以及发生时间。失败的行还会显示错误信息。
清除记录 会清空列表并重置弹窗中的识别统计,几秒内可撤销。该记录只保存在此浏览器中,绝不会包含在备份中。
capskip.comcapskip.comcapskip.com高级设置
针对特殊站点的额外功能。
除非网站在第一个 Turnstile 解决后又显示新的 Turnstile,否则请保持关闭。
代理
通过你自己的代理解决验证码。
开启或关闭代理,不会删除地址。开启时,侧边栏的“代理”旁会显示 开 。关闭时,CapSkip 会沿用应用的代理设置,详见 设置指南.
代理类型:HTTP、HTTPS、SOCKS5 或 SOCKS5H(SOCKS5H 在代理端解析网站地址)。
代理地址: IP:PORT,或点击 login:password@IP:PORT (用于登录认证)。
DataDome 是唯一通过你自己的 IP 地址识别的类型。
备份与恢复
在浏览器之间迁移你的设置。
将设置迁移到其他浏览器或电脑的最快方式。请妥善保管该文件:其中包含你的 API 密钥。
替换任何内容前都会先询问。只接受由 CapSkip 扩展导出的文件。
