如何快速上手NopeCHA Python：5分钟实现验证码自动识别

【免费下载链接】nopecha-python Automated CAPTCHA solver for Python. 项目地址: https://gitcode.com/gh_mirrors/no/nopecha-python

NopeCHA Python是一款功能强大的验证码自动识别工具，能帮助开发者轻松解决各类验证码问题。本文将为你提供一个简单快速的入门指南，让你在5分钟内就能实现验证码的自动识别，提升开发效率。

快速安装NopeCHA Python的方法

要开始使用NopeCHA Python，首先需要进行安装。安装过程非常简单，只需在命令行中执行以下命令：

python3 -m pip install nopecha

这条命令会从PyPI上下载并安装最新版本的NopeCHA Python包。安装完成后，你就可以在自己的Python项目中导入并使用NopeCHA了。

准备工作：获取API密钥

在使用NopeCHA Python之前，你需要先获取一个API密钥。你可以通过访问NopeCHA官方网站来注册并获取API密钥。获取到密钥后，记得妥善保存，在后续的代码中会用到。

同步识别验证码的简单示例

下面是一个使用requests库进行同步验证码识别的简单示例：

from nopecha.api.requests import RequestsAPIClient

# 初始化API客户端，传入你的API密钥
api = RequestsAPIClient("YOUR_API_KEY")

# 调用solve_hcaptcha方法识别验证码
solution = api.solve_hcaptcha("b4c45857-0e23-48e6-9017-e28fff99ffb2", "https://nopecha.com/demo/hcaptcha#easy")

# 输出识别结果
print("token is", solution["data"])

在这个示例中，我们首先从nopecha.api.requests模块导入RequestsAPIClient类。然后创建一个API客户端实例，传入我们的API密钥。接着调用solve_hcaptcha方法，传入验证码的sitekey和对应的URL，即可完成验证码的识别。最后打印出识别得到的token。

异步识别验证码的实现方式

如果你需要在异步环境中使用NopeCHA Python，可以使用httpx库的异步版本。以下是一个异步识别验证码的示例：

from nopecha.api.httpx import AsyncHTTPXAPIClient
import asyncio

async def main():
    # 初始化异步API客户端
    api = AsyncHTTPXAPIClient("YOUR_API_KEY")
    
    # 异步调用solve_hcaptcha方法
    solution = await api.solve_hcaptcha("b4c45857-0e23-48e6-9017-e28fff99ffb2", "https://nopecha.com/demo/hcaptcha#easy")
    
    # 输出识别结果
    print("token is", solution["data"])

# 运行异步函数
asyncio.run(main())

这个示例与同步示例类似，不同之处在于我们导入了AsyncHTTPXAPIClient类，并在异步函数中使用await关键字来调用验证码识别方法。

扩展构建器的使用方法

NopeCHA Python还提供了扩展构建器功能，可以帮助你构建浏览器扩展。以下是一个简单的示例：

from nopecha.extension import build_chromium

# 构建Chromium扩展
output = build_chromium({
    "key": "YOUR_API_KEY",
})

# 可以将输出路径用于浏览器扩展加载
print("Extension built at:", output)

通过build_chromium函数，你可以轻松构建适用于Chromium浏览器的扩展，只需传入API密钥即可。你还可以指定输出目录，如：

from pathlib import Path

output = build_chromium({
    "key": "YOUR_API_KEY",
}, Path("extension"))

从v1版本迁移的注意事项

如果你之前使用的是NopeCHA Python v1版本，迁移到新版本时需要注意以下几点：

1. 安装你想要使用的HTTP库（requests、aiohttp、httpx），或者使用内置的urllib（不推荐）。

2. 将nopecha.api_key的设置方式替换为创建客户端实例，例如：

# v1版本的方式
import nopecha
nopecha.api_key = "YOUR_API_KEY"

# 新版本的方式
from nopecha.api.requests import RequestsAPIClient
client = RequestsAPIClient("YOUR_API_KEY")

3. 将nopecha.Token.solve()、nopecha.Recognition.solve()和nopecha.Balance.get()等方法替换为客户端实例的相应方法，例如：

# v1版本的方式
clicks = nopecha.Recognition.solve(...)
token = nopecha.Token.solve(...)
balance = nopecha.Balance.get()

# 新版本的方式
clicks = client.recognize_hcaptcha(...)
token = client.solve_hcaptcha(...)
balance = client.status()

通过以上简单的步骤，你就可以快速上手NopeCHA Python，实现验证码的自动识别。无论是同步还是异步环境，NopeCHA Python都能为你提供高效、可靠的验证码解决方案。如果你想了解更多详细信息，可以查看项目中的源代码文件，如src/nopecha/api/_base.py等，里面包含了更多的功能实现和使用方法。

【免费下载链接】nopecha-python Automated CAPTCHA solver for Python. 项目地址: https://gitcode.com/gh_mirrors/no/nopecha-python