Обхід капчі на Go

Вирішуйте капчі з Go модулем онлайн.

Пакет Go скриптів для простої інтеграції з API сервісу розв'язання капчі 2Captcha для обходу reCAPTCHA, Arkose captcha, Geetest та розв'язання будь-яких інших капч

Швидкий старт

Встановлення

Пакет скриптів можна встановити за допомогою інсталятора пакетів або вручну

GitHub

Щоб встановити клієнт API, використовуйте цю команду:

go get -u github.com/2captcha/2captcha-go

Приклади коду, а також бібліотеки та модулі для інтеграції з нашим API ви можете знайти в репозиторії на GitHub.

Конфігурація

Опис усіх потрібних параметрів для конфігурування встановленого пакета

Примірник класу Client можна створити так:

client := api2captcha.NewClient('YOUR_API_KEY')

Також у вас є можливість настроювати деякі опції створеного екземпляра:

client.SoftId = 123
client.Callback = "https://your.site/result-receiver"
client.DefaultTimeout = 120
client.RecaptchaTimeout = 600
client.PollingInterval = 100

Опції екземпляра Client

Опція	Значення за замовчуванням	Опис
softId	-	ваш ID програмного забезпечення, отриманий після публікації в каталог програм 2Captcha
callback	-	URL вашого веб-сервера, який отримує результат розпізнавання капчі. URL повинен бути спочатку зареєстрований у налаштуваннях pingback вашого облікового запису
defaultTimeout	120	Таймаут опитування за секунди для всіх типів капчі, крім reCAPTCHA. Визначає, як довго модуль намагається отримати відповідь кінцевої точки API `res.php`
recaptchaTimeout	600	Таймаут опитування reCAPTCHA за секунди. Визначає, як довго модуль намагається отримати відповідь кінцевої точки API `res.php`
pollingInterval	10	Інтервал у секундах між запитами до кінцевої точки API `res.php`, встановлення значень менше 5 секунд не рекомендується

ВАЖЛИВО: як тільки callback визначено для одного екземпляра класу Client, всі інші методи повертають тільки ID капчі та НЕ опитують API для отримання результату. Результат буде надіслано на Callback URL. Щоб отримати відповідь вручну, використовуйте метод getResult

Рішення капчі

Коли ви відправляєте будь-яку графічну капчу, ви можете передавати додаткові параметри, які допоможуть працівникам 2Captcha вирішити її швидко та правильно.

Опції капчі

Опція	Значення за замовчуванням	Опис
numeric	0	визначає, чи містить капча числові або інші символи, докладніше див. у документації API
minLength	0	мінімальна довжина відповіді
maxLength	0	максимальна довжина відповіді
phrase	0	визначає, чи містить відповідь кілька слів чи ні
caseSensitive	0	визначає, чи чутлива відповідь до регістру
calc	0	визначає капчу, яка потребує розрахунку
lang	-	визначає мову капчі, дивіться список мов, що підтримуються
hintImg	-	зображення з підказкою, показане працівникам за допомогою капчі
hintText	-	підказка або текст завдання, що показується працівникам за допомогою капчі

Базовий приклад

У наведеному нижче прикладі наведено базовий приклад виклику розв'язувача з обробкою помилок.

cap := api2captcha.Normal{
   File: "/path/to/normal.jpg",
}

code, err := client.Solve(cap.ToRequest())
if err != nil {
  if err == api2captcha.ErrTimeout {
    log.Fatal("Timeout");
  } else if err == api2captcha.ErrApi {
    log.Fatal("API error");
  } else if err == api2captcha.ErrNetwork {
    log.Fatal("Network error");
  } else {
    log.Fatal(err);
  }
}
fmt.Println("code "+code)

Щоб обійти звичайну капчу (перекручений текст на зображенні), використовуйте наступний метод. Цей метод можна також використовувати для розпізнавання будь-якого тексту на зображенні.

cap := api2captcha.Normal{
    File: "/path/to/normal.jpg",
    Numeric: 4,
    MinLen: 4,
    MaxLen: 20,
    Phrase: true,
    CaseSensitive: true,
    Lang: "en",
    HintImgFile: "/path/to/hint.jpg",
    HintText: "Type red symbols",
 }

Цей метод можна використовувати для обходу капчі, яка вимагає відповіді на запитання у вигляді відкритого тексту

cap := api2captcha.Text{
    Text: "If tomorrow is Saturday, what day is today?",
    Lang: "en",
 }

Використовуйте цей метод для вирішення reCAPTCHA V2 та отримання токена для обходу захисту

cap := api2captcha.ReCaptcha{
    SiteKey: "6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-",
    Url: "https://mysite.com/page/with/recaptcha",
    Invisible: true,
    Action: "verify",
 }
 req := cap.ToRequest()
 req.SetProxy("HTTPS", "login:password@IP_address:PORT")
 code, err := client.solve(req)

Цей метод дозволяє обходити reCAPTCHA V3 та повертає токен

cap := api2captcha.ReCaptcha{
    SiteKey: "6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-",
    Url: "https://mysite.com/page/with/recaptcha",
    Version: "v3",
    Action: "verify",
    Score: 0.3,
 }
 req := cap.ToRequest()
 req.SetProxy("HTTPS", "login:password@IP_address:PORT")
 code, err := client.solve(req)

Метод вирішення FunCaptcha (Аркоселабс). Повертає токен для обходу капчі

cap := api2captcha.FunCaptcha{
    SiteKey: "69A21A01-CC7B-B9C6-0F9A-E7FA06677FFC",
    Url: "https://mysite.com/page/with/funcaptcha",
    Surl: "https://client-api.arkoselabs.com",
    UserAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.61 Safari/537.36",
    Data: map[string]string{"anyKey":"anyValue"},   
 }
 req := cap.ToRequest()
 req.SetProxy("HTTPS", "login:password@IP_address:PORT")
 code, err := client.solve(req)

Метод вирішення капчі головоломки GeeTest. Повертає набір токенів у форматі JSON

cap := api2captcha.GeeTest{
    GT: "f2ae6cadcf7886856696502e1d55e00c",
    ApiServer: "api-na.geetest.com",
    Challenge: "12345678abc90123d45678ef90123a456b",
    Url: "https://mysite.com/captcha.html",
 }
 req := cap.ToRequest()
 req.SetProxy("HTTPS", "login:password@IP_address:PORT")
 code, err := client.solve(req)

Метод вирішення KeyCaptcha на основі токенів

cap := api2captcha.KeyCaptcha{
    UserId: 10,
    SessionId: "493e52c37c10c2bcdf4a00cbc9ccd1e8",
    WebServerSign: "9006dc725760858e4c0715b835472f22",
    WebServerSign2: "9006dc725760858e4c0715b835472f22",
    Url: "https://www.keycaptcha.ru/demo-magnetic/",   
 }
 req := cap.ToRequest()
 req.SetProxy("HTTPS", "login:password@IP_address:PORT")
 code, err := client.solve(req)

Токен-оснований спосіб обходу капчі Capy puzzle

cap := api2captcha.Capy{
    SiteKey: "PUZZLE_Abc1dEFghIJKLM2no34P56q7rStu8v",
    Url: "https://www.mysite.com/captcha/",   
 }
 req := cap.ToRequest()
 req.SetProxy("HTTPS", "login:password@IP_address:PORT")
 code, err := client.solve(req)

Цей метод спочатку називався Old reCAPTCHA V2. Його можна використовувати для обходу будь-якого типу капчі, коли ви можете застосувати сітку до зображення і потрібно клацнути певні поля сітки. Повертає кількість осередків сітки

cap := api2captcha.Grid{
    File: "path/to/captcha.jpg",
    Rows: 3,
    Cols: 3,
    PreviousId: 0,
    CanSkip: false,
    Lang: "en",
    HintImageFile: "path/to/hint.jpg",
    HintText: "Select all images with an Orange",
}

Метод Canvas можна використовувати, коли потрібно намалювати лінію навколо об'єкта на зображенні. Повертає набір координат точок для малювання багатокутника.

cap := api2captcha.Canvas{
    File: "path/to/captcha.jpg",
    PreviousId: 0,
    CanSkip: false,
    Lang: "en",
    HintImageFile: "path/to/hint.jpg",
    HintText: "Draw around apple",
}

Метод ClickCaptcha повертає координати точок на зображенні капчі. Може використовуватися, якщо потрібно клацнути певні точки на зображенні.

cap := api2captcha.Coordinates{
    File: "path/to/captcha.jpg",
    Lang: "en",
    HintImageFile: "path/to/hint.jpg",
    HintText: "Connect the dots",
}

Цей спосіб можна використовуватиме рішення капчі, яка просить повернути об'єкт. В основному використовується для обходу FunCaptcha. Повертає значення кута повороту.

cap := api2captcha.Rotate{
    File: "path/to/captcha.jpg",
    Angle: 40,
    Lang: "en",
    HintImageFile: "path/to/hint.jpg",
    HintText: "Put the images in the correct way",
}

Інші методи

Додаткові допустимі методи, що застосовуються в процесі роботи основних скриптів.

send / getResult

Цей метод можна використовувати для ручної передачі капчі та отримання відповідей.

id, err := client.Send(cap.ToRequest())
if err != nil {
   log.Fatal(err);
}

time.Sleep(10 * time.Second)

code, err := client.GetResult(id)
if err != nil {
   log.Fatal(err);
}

if code == nil {
   log.Fatal("Not ready")
}

fmt.Println("code "+*code)

balance

Використовуйте цей метод, щоб отримати баланс свого облікового запису.

balance, err := client.GetBalance()
if err != nil {
   log.Fatal(err);
}

report

Використовуйте цей метод, щоб повідомити про правильне або неправильне рішення капчі.

err := client.Report(id, true) // solved correctly
err := client.Report(id, false) // solved incorrectly

Обхід капчі на Go

Встановлення

GitHub

Конфігурація

Рішення капчі

Базовий приклад

Інші методи

send / getResult

balance

report

Інші мови для інтеграції з API сервісу

Пакет PHP для інтеграції з сервісом API

Пакет Python для інтеграції з сервісом API

Пакет Java для інтеграції з сервісом API

Пакет C# для інтеграції з сервісом API

Пакет Ruby для інтеграції з сервісом API

Пакет JavaScript для інтеграції з сервісом API