ruby-2captcha 1.1.4 → 1.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b17960788d337b014b4337b32068a6ded3315e92fd649c28c0df2b0ba8d2cf09
-  data.tar.gz: 8b4b808a9d0b1696758bd21a8fe6b8cdeb584f1244416e3d86df83595c4003db
+  metadata.gz: f3cf34c705f05cac002afa61dbfe4ded7b7e1f07a579fa0d2e98c52ec1972ebc
+  data.tar.gz: 7aeb0c18eb4f7136278ef3ab528312eced958cd4ef1ebd2ee33a44296e4ed416
 SHA512:
-  metadata.gz: c288e20b91dd6b780f0acbc9f9bcf66428954b37d88505ce54330f88e320e775fe6eeccf8ebb621637376d409f0c5a702cb2d5a9d45a3e63ce612ea0a038d2a6
-  data.tar.gz: 7304970593279b972e1b85b22b430b7f271d9f0cc85afca244b4b24024bcf4607db17bd0701086b0035d30b7076631aa43de6e06215746e293304feaacd70187
+  metadata.gz: c092dcb03fc11e1de8aff2a41b7b1b8908ee19e66dd643d8aaf4dd12cdab9d920e68a60b6f63c55e6ea9271b93f8b9d54aa3ea1d0991e8f11ae9cbad48d1b813
+  data.tar.gz: 7c42d06519aa623dcf5652d036bc85864f1df0725d913c3c7be2d3be2f7b8502367ed802ccba7f3908a3f2bf711840a50e36a54c53b4a35df0b9699cb008fc4b

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    ruby-2captcha (1.0.2)
+    ruby-2captcha (1.1.5)
 
 GEM
   remote: https://rubygems.org/
@@ -20,7 +20,7 @@ GEM
     rainbow (3.1.1)
     rake (13.0.6)
     regexp_parser (2.8.0)
-    rexml (3.2.5)
+    rexml (3.3.9)
     rspec (3.12.0)
       rspec-core (~> 3.12.0)
       rspec-expectations (~> 3.12.0)
@@ -34,7 +34,7 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.12.0)
     rspec-support (3.12.0)
-    rubocop (1.51.0)
+    rubocop (1.50.2)
       json (~> 2.3)
       parallel (~> 1.10)
       parser (>= 3.2.0.0)
@@ -51,7 +51,7 @@ GEM
     time (0.2.2)
       date
     unicode-display_width (2.4.2)
-    uri (0.12.1)
+    uri (0.13.0)
 
 PLATFORMS
   ruby
@@ -64,4 +64,4 @@ DEPENDENCIES
   ruby-2captcha!
 
 BUNDLED WITH
-   2.4.12
+   2.4.22

data/README.md

@@ -1,41 +1,60 @@
-# Ruby 2Captcha API Client
-
-This is the easiest way to quickly integrate 2Captcha into your code and automate solving of any type of captcha.
-
-A Ruby client for the 2Captcha API.
-
--  [Installation](#installation)
-- [Configuration](#configuration)
-    - [Client instance options](#client-instance-options)
-- [Solve captcha](#solve-captcha)
-  - [Normal Captcha](#normal-captcha)
-  - [Text](#text-captcha)
-  - [reCAPTCHA v2](#recaptcha-v2)
-  - [reCAPTCHA v3](#recaptcha-v3)
-  - [reCAPTCHA Enterprise](#recaptcha-enterprise)
-  - [GeeTest](#geetest)
-  - [hCaptcha](#hcaptcha)
-  - [KeyCaptcha](#keycaptcha)
-  - [Capy](#capy)
-  - [Grid](#grid)
-  - [Canvas](#canvas)
-  - [ClickCaptcha](#clickcaptcha)
-  - [Rotate](#rotate)
-  - [AmazonWAF](#amazon-waf)
-  - [CloudflareTurnstile](#cloudflare-turnstile)
-  - [Lemin Cropped Captcha](#lemin-cropped-captcha)
-  - [GeeTest V4](#geetest-v4)
-  - [Audio](#audio)
-  - [Yandex](#yandex)
-  - [CyberSiARA](#cybersiara)
-  - [DataDome](#datadome)
-  - [MTCaptcha](#mtcaptcha)
-  - [Friendly captcha](#friendly-captcha)
-- [Other methods](#other-methods)
-  - [send / get_result](#send--get_result)
-  - [balance](#balance)
-  - [report](#report)
-  - [Error handling](#error-handling)
+<a href="https://github.com/2captcha/2captcha-python"><img src="https://github.com/user-attachments/assets/37e1d860-033b-4cf3-a158-468fc6b4debc" width="82" height="30"></a>
+<a href="https://github.com/2captcha/2captcha-javascript"><img src="https://github.com/user-attachments/assets/4d3b4541-34b2-4ed2-a687-d694ce67e5a6" width="36" height="30"></a>
+<a href="https://github.com/2captcha/2captcha-go"><img src="https://github.com/user-attachments/assets/ab22182e-6cb2-41fa-91f4-d5e89c6d7c6f" width="63" height="30"></a>
+<a href="https://github.com/2captcha/2captcha-ruby"><img src="https://github.com/user-attachments/assets/1c3b6dc2-9acd-44fe-927d-31de3427639f" width="75" height="30"></a>
+<a href="https://github.com/2captcha/2captcha-cpp"><img src="https://github.com/user-attachments/assets/36de8512-acfd-44fb-bb1f-b7c793a3f926" width="45" height="30"></a>
+<a href="https://github.com/2captcha/2captcha-php"><img src="https://github.com/user-attachments/assets/e8797843-3f61-4fa9-a155-ab0b21fb3858" width="52" height="30"></a>
+<a href="https://github.com/2captcha/2captcha-java"><img src="https://github.com/user-attachments/assets/a3d923f6-4fec-4c07-ac50-e20da6370911" width="50" height="30"></a>
+<a href="https://github.com/2captcha/2captcha-csharp"><img src="https://github.com/user-attachments/assets/f4d449de-780b-49ed-bb0a-b70c82ec4b32" width="38" height="30"></a>
+
+# Ruby 2Captcha API Client (captcha solver)
+
+This is the easiest way to quickly integrate [2Captcha] into your code and automate solving of any type of captcha.
+Examples of API requests for different captcha types are available on the [Ruby captcha solver](https://2captcha.com/lang/ruby) page.
+
+- [Ruby 2Captcha API Client (captcha solver)](#ruby-2captcha-api-client-captcha-solver)
+    - [Installation](#installation)
+    - [Configuration](#configuration)
+        - [Client instance options](#client-instance-options)
+    - [Solve captcha](#solve-captcha)
+      - [Captcha options](#captcha-options)
+      - [Normal Captcha](#normal-captcha)
+      - [Text Captcha](#text-captcha)
+      - [reCAPTCHA v2](#recaptcha-v2)
+      - [reCAPTCHA v3](#recaptcha-v3)
+      - [reCAPTCHA Enterprise](#recaptcha-enterprise)
+      - [FunCaptcha](#funcaptcha)
+      - [GeeTest](#geetest)
+      - [GeeTest V4](#geetest-v4)
+      - [KeyCaptcha](#keycaptcha)
+      - [Capy](#capy)
+      - [Grid](#grid)
+      - [Canvas](#canvas)
+      - [ClickCaptcha](#clickcaptcha)
+      - [Rotate](#rotate)
+      - [Amazon WAF](#amazon-waf)
+      - [Cloudflare Turnstile](#cloudflare-turnstile)
+      - [Lemin Cropped Captcha](#lemin-cropped-captcha)
+      - [Audio Captcha](#audio-captcha)
+      - [Yandex](#yandex)
+      - [CyberSiARA](#cybersiara)
+      - [DataDome](#datadome)
+      - [MTCaptcha](#mtcaptcha)
+      - [Friendly captcha](#friendly-captcha)
+      - [Cutcaptcha](#cutcaptcha)
+      - [Tencent](#tencent)
+      - [atbCAPTCHA](#atbcaptcha)
+    - [Other methods](#other-methods)
+      - [send / get_result](#send--get_result)
+      - [balance](#balance)
+      - [report](#report)
+    - [Proxies](#proxies)
+    - [Error handling](#error-handling)
+    - [Examples](#examples)
+- [Get in touch](#get-in-touch)
+- [Join the team 👪](#join-the-team-)
+- [License](#license)
+  - [Graphics and Trademarks](#graphics-and-trademarks)
 
 ## Installation
 Add this line to your application's Gemfile:
@@ -72,15 +91,17 @@ client.api_key = "YOUR_API_KEY"
 
 ### Client instance options
 
-|Option|Default value|Description|
-|---|---|---|
-|soft_id|-|your software ID obtained after publishing in [2captcha sofware catalog]|
-|callback|-|URL of your web-sever that receives the captcha recognition result. The URl should be first registered in [pingback settings] of your account|
-|default_timeout|120|Timeout in seconds for all captcha types except reCAPTCHA. Defines how long the module tries to get the answer from `res.php` API endpoint|
-|polling_interval|10|Interval in seconds between requests to `res.php` API endpoint, setting values less than 5 seconds is not recommended|
+|Option          |Default value|Description                                                             |
+|----------------|-------------|------------------------------------------------------------------------|
+|soft_id         |4584            |your software ID obtained after publishing in [2captcha sofware catalog]|
+|callback        |-            |URL of your web-sever that receives the captcha recognition result. The URl should be first registered in [pingback settings] of your account|
+|default_timeout |120          |Timeout in seconds for all captcha types except reCAPTCHA. Defines how long the module tries to get the answer from `res.php` API endpoint|
+|polling_interval|10           |Interval in seconds between requests to `res.php` API endpoint, setting values less than 5 seconds is not recommended|
 
->  **IMPORTANT:** once `callback` is defined for `Client` instance, all methods return only the captcha ID and DO NOT poll the API to get the result. The result will be sent to the callback URL.
-To get the answer manually use [get_result method](#send--getresult)
+>  [!IMPORTANT]
+> Once `callback` is defined for `Client` instance, all methods return only the captcha ID and DO NOT poll the API to get the result. The result will be sent to the callback URL.
+
+To get the answer manually use [get_result method](#send--get_result)
 
 ## Solve captcha
 When you submit any image-based captcha use can provide additional options to help 2captcha workers to solve it properly.
@@ -88,20 +109,23 @@ When you submit any image-based captcha use can provide additional options to he
 ### Captcha options
 | Option        | Default Value | Description                                                                                        |
 | ------------- | ------------- | -------------------------------------------------------------------------------------------------- |
-| numeric       | 0             | Defines if captcha contains numeric or other symbols [see more info in the API docs][post options] |
-| min_len     | 0             | minimal answer lenght                                                                              |
-| max_len     | 0             | maximum answer length                                                                              |
+| numeric       | 0             | Defines if captcha contains numeric or other symbols [see more info in the API docs][normal_post] |
+| min_len       | 0             | minimal answer lenght                                                                              |
+| max_len       | 0             | maximum answer length                                                                              |
 | phrase        | 0             | defines if the answer contains multiple words or not                                               |
-| case_sensitive | 0             | defines if the answer is case sensitive                                                            |
+| case_sensitive| 0             | defines if the answer is case sensitive                                                            |
 | calc          | 0             | defines captcha requires calculation                                                               |
 | lang          | -             | defines the captcha language, see the [list of supported languages]                                |
-| hint_image       | -             | an image with hint shown to workers with the captcha, translated into instructionsimg API parameter                                               |
-| hint_text      | -             | hint or task text shown to workers with the captcha                                                |
+| hint_image    | -             | an image with hint shown to workers with the captcha, translated into instructionsimg API parameter                                               |
+| hint_text     | -             | hint or task text shown to workers with the captcha                                                |
 
 Below you can find basic examples for every captcha type, check out the code below.
 
 
 ### Normal Captcha
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#solving_normal_captcha)</sup>
+
 To bypass a normal captcha (distorted text on image) use the following method. This method also can be used to recognize any text on the image.
 ```ruby
 result = client.normal({ image: 'path/to/captcha.jpg'})
@@ -112,6 +136,9 @@ result = client.normal({
 ```
 
 ### Text Captcha
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#solving_text_captcha)</sup>
+
 This method can be used to bypass a captcha that requires to answer a question provided in clear text.
 ```ruby
 result = client.text({
@@ -121,6 +148,9 @@ result = client.text({
 ```
 
 ### reCAPTCHA v2
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#solving_recaptchav2_new)</sup>
+
 Use this method to solve reCAPTCHA V2 and obtain a token to bypass the protection.
 ```ruby
 result = client.recaptcha_v2({
@@ -131,6 +161,9 @@ result = client.recaptcha_v2({
 ```
 
 ### reCAPTCHA v3
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#solving_recaptchav3)</sup>
+
 This method provides reCAPTCHA V3 solver and returns a token.
 ```ruby
 result = client.recaptcha_v3({
@@ -143,6 +176,9 @@ result = client.recaptcha_v3({
 ```
 
 ### reCAPTCHA Enterprise
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#recaptcha-enterprise)</sup>
+
 reCAPTCHA Enterprise can be used as reCAPTCHA V2 and reCAPTCHA V3. Below is a usage example for both versions.
 
 ```ruby
@@ -165,6 +201,9 @@ result = client.recaptcha_v3({
 ```
 
 ### FunCaptcha
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#solving_funcaptcha_new)</sup>
+
 FunCaptcha (Arkoselabs) solving method. Returns a token.
 
 ```ruby
@@ -175,6 +214,9 @@ result = client.funcaptcha({
 ```
 
 ### GeeTest
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#solving_geetest)</sup>
+
 Method to solve GeeTest puzzle captcha. Returns a set of tokens as JSON.
 ```ruby
 result = client.geetest({
@@ -185,16 +227,22 @@ result = client.geetest({
 })
 ```
 
-### hCaptcha
-Use this method to solve hCaptcha challenge. Returns a token to bypass captcha.
+### GeeTest v4
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#geetest-v4)</sup>
+
+Use this method to solve GeeTest v4. Returns the response in JSON.
 ```ruby
-result = client.hcaptcha({
-  sitekey: '10000000-ffff-ffff-ffff-000000000001',
+result = client.geetest_v4({
+  captcha_id: 'e392e1d7fd421dc63325744d5a2b9c73',
   pageurl: 'https://www.site.com/page/'
 })
 ```
 
 ### KeyCaptcha
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#solving_keycaptcha)</sup>
+
 Token-based method to solve KeyCaptcha.
 ```ruby
 result = client.keycaptcha({
@@ -207,6 +255,9 @@ result = client.keycaptcha({
 ```
 
 ### Capy
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#solving_capy)</sup>
+
 Token-based method to bypass Capy puzzle captcha.
 ```ruby
 result = client.capy({
@@ -217,20 +268,26 @@ result = client.capy({
 ```
 
 ### Grid
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#grid)</sup>
+
 Grid method is originally called Old reCAPTCHA V2 method. The method can be used to bypass any type of captcha where you can apply a grid on image and need to click specific grid boxes. Returns numbers of boxes.
 ```ruby
 result = client.grid({
   image: 'path/to/captcha.jpg',
-  rows: 3,
-  cols: 3,
+  recaptcharows: 3,
+  recaptchacols: 3,
   previous_id: 0,
   lang: 'en',
-  hint_image: 'path/to/hint.jpg',
-  hint_text: 'Select all images with an Orange'
+  imginstructions: 'path/to/hint.jpg',
+  textinstructions: 'Select all images with an Orange'
 })
 ```
 
 ### Canvas
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#canvas)</sup>
+
 Canvas method can be used when you need to draw a line around an object on image. Returns a set of points' coordinates to draw a polygon.
 ```ruby
 result = client.canvas({
@@ -243,6 +300,9 @@ result = client.canvas({
 ```
 
 ### ClickCaptcha
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#coordinates)</sup>
+
 ClickCaptcha method returns coordinates of points on captcha image. Can be used if you need to click on particular points on the image.
 ```ruby
 result = client.coordinates({
@@ -254,6 +314,9 @@ result = client.coordinates({
 ```
 
 ### Rotate
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#solving_rotatecaptcha)</sup>
+
 This method can be used to solve a captcha that asks to rotate an object. Mostly used to bypass FunCaptcha. Returns the rotation angle.
 ```ruby
 result = client.rotate({
@@ -266,7 +329,10 @@ result = client.rotate({
 ```
 
 ### Lemin Cropped Captcha
-Use this method to solve hCaptcha challenge. Returns JSON with answer containing the following values: answer, challenge_id.
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#lemin)</sup>
+
+Use this method to solve Lemin challenge. Returns JSON with answer containing the following values: answer, challenge_id.
 ```ruby
 result = client.lemin({
   captcha_id: 'CROPPED_1abcd2f_a1234b567c890d12ef3a456bc78d901d',
@@ -277,6 +343,9 @@ result = client.lemin({
 ```
 
 ### Cloudflare Turnstile
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#turnstile)</sup>
+
 Use this method to solve Cloudflare Turnstile. Returns JSON with the token and User-Agent.
 ```ruby
 result = client.turnstile({
@@ -291,6 +360,9 @@ result = client.turnstile({
 ```
 
 ### Amazon WAF
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#amazon-waf)</sup>
+
 Use this method to solve Amazon WAF Captcha also known as AWS WAF Captcha is a part of Intelligent threat mitigation for Amazon AWS. Returns JSON with the token.
 ```ruby
 result = client.amazon_waf({
@@ -303,20 +375,15 @@ result = client.amazon_waf({
 })
 ```
 
-### GeeTest v4
-Use this method to solve GeeTest v4. Returns the response in JSON.
-```ruby
-result = client.geetest_v4({
-  captcha_id: 'e392e1d7fd421dc63325744d5a2b9c73',
-  pageurl: 'https://www.site.com/page/'
-})
-```
+### Audio Captcha
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#audio)</sup>
 
-### Audio
-This method can be used to solve a audio captcha
+Use the following method to bypass an audio captcha (mp3 formats only). 
+You must provide the language as `lang = 'en'`. Supported languages are "en", "ru", "de", "el", "pt", "fr".
 ```ruby
 result = client.audio({
-  audio: 'path/to/audio.jpg',
+  audio: 'path/to/audio.mp3',
   lang: "en"
 })
 ```
@@ -331,6 +398,9 @@ result = client.yandex({
 ```
 
 ### CyberSiARA
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#cybersiara)</sup>
+
 Use this method to solve CyberSiARA and obtain a token to bypass the protection.
 ```ruby
 result = client.cyber_siara({
@@ -340,8 +410,15 @@ result = client.cyber_siara({
 ```
 
 ### DataDome
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#datadome)</sup>
+
 Use this method to solve DataDome and obtain a token to bypass the protection.
-To solve the DataDome captcha, you must use a proxy.
+
+
+> [!IMPORTANT]
+> To solve the DataDome captcha, you must use a proxy. It is recommended to use [residential proxies].
+
 ```ruby
 result = client.data_dome({
   pageurl: "https://test.com",
@@ -352,6 +429,9 @@ result = client.data_dome({
 ```
 
 ### MTCaptcha
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#mtcaptcha)</sup>
+
 Use this method to solve MTCaptcha and obtain a token to bypass the protection.
 ```ruby
 result = client.mt_captcha({
@@ -361,14 +441,59 @@ result = client.mt_captcha({
 ```
 
 ### Friendly captcha
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#friendly-captcha)</sup>
+
 Use this method to solve Friendly captcha and obtain a token to bypass the protection.
+
+> [!IMPORTANT]
+> To successfully use the received token, the captcha widget must not be loaded on the page. To do this, you need to abort request to `/friendlycaptcha/...module.min.js` on the page. When the captcha widget is already loaded on the page, there is a high probability that the received token will not work.
+
 ```ruby
-result = client.friendly_captcha({
+result = client.friendly({
   pageurl: "https://example.com",
   sitekey: "2FZFEVS1FZCGQ9"
 })
 ```
 
+### Cutcaptcha
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#cutcaptcha)</sup>
+
+Use this method to solve Cutcaptcha and obtain a token to bypass the protection.
+```ruby
+result = client.cutcaptcha({
+  misery_key: "a1488b66da00bf332a1488993a5443c79047e752",
+  api_key: "SAb83IIB",
+  pageurl: "https://example.cc/foo/bar.html"
+})
+```
+
+### Tencent
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#tencent)</sup>
+
+Token-based method for automated solving of Tencent captcha.
+```ruby
+result = client.tencent({
+  app_id: "197326679",
+  pageurl: "https://mysite.com/page/with/tencent"
+})
+```
+
+### atbCAPTCHA
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#atb-captcha)</sup>
+
+Token-based method for automated solving of atbCAPTCHA.
+```ruby
+result = client.atb_captcha({
+  app_id: "197326679",
+  api_server: "api.atb_captcha.com",
+  pageurl: "https://mysite.com/page/with/atb_captcha"
+})
+```
+
 ## Other methods
 
 ### send / get_result
@@ -395,6 +520,9 @@ result = client.get_result(captcha_id)
 ```
 
 ### balance
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#additional-methods)</sup>
+
 Use this method to get your account's balance
 
 ```ruby
@@ -402,13 +530,32 @@ balance = client.get_balance
 ```
 
 ### report
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#complain)</sup>
+
 Use this method to report good or bad captcha answer.
 ```ruby
 client.report(captcha_id, True) # captcha solved correctly
 client.report(captcha_id, False) # captcha solved incorrectly
 ```
+## Proxies
+
+You can pass your proxy as an additional argument for methods: recaptcha, funcaptcha, geetest, geetest v4, keycaptcha, capy puzzle, lemin, turnstile, amazon waf, Cutcaptcha, Friendly captcha, MTCaptcha, DataDome, CyberSiARA and etc. The proxy will be forwarded to the API to solve the captcha.
+
+We have our own proxies that we can offer you. [Buy residential proxies] for avoid restrictions and blocks. [Quick start].
+
+Example solving reCAPTCHA V2 using proxy:
+```ruby
+result = client.recaptcha_v2({
+  googlekey: '6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
+  pageurl: 'https://mysite.com/page/with/recaptcha_v2',
+  invisible: 1,
+  proxytype: "https",
+  proxy: "proxyuser:strongPassword@123.123.123.123:3128"
+})
+```
 
-### Error handling
+## Error handling
 In case of an error, the captcha solver throws an exception. It's important to properly handle these cases. We recommend using `begin rescue` to handle exceptions.
 ```ruby
   begin
@@ -427,3 +574,37 @@ In case of an error, the captcha solver throws an exception. It's important to p
     puts(e)
   end
 ```
+
+## Examples
+
+Examples of solving all supported captcha types are located in the [examples] directory.
+
+## Get in touch
+
+<a href="mailto:support@2captcha.com"><img src="https://github.com/user-attachments/assets/539df209-7c85-4fa5-84b4-fc22ab93fac7" width="80" height="30"></a>
+<a href="https://2captcha.com/support/tickets/new"><img src="https://github.com/user-attachments/assets/be044db5-2e67-46c6-8c81-04b78bd99650" width="81" height="30"></a>
+
+## Join the team 👪
+
+There are many ways to contribute, of which development is only one! Find your next job. Open positions: AI experts, scrapers, developers, technical support, and much more! 😍
+
+<a href="mailto:job@2captcha.com"><img src="https://github.com/user-attachments/assets/36d23ef5-7866-4841-8e17-261cc8a4e033" width="80" height="30"></a>
+
+## License
+
+The code in this repository is licensed under the MIT License. See the [LICENSE](./LICENSE) file for more details.
+
+### Graphics and Trademarks
+
+The graphics and trademarks included in this repository are not covered by the MIT License. Please contact <a href="mailto:support@2captcha.com">support</a> for permissions regarding the use of these materials.
+
+<!-- Shared links -->
+[2Captcha]: https://2captcha.com/
+[2captcha sofware catalog]: https://2captcha.com/software
+[pingback settings]: https://2captcha.com/setting/pingback
+[normal_post]: https://2captcha.com/2captcha-api#normal_post
+[list of supported languages]: https://2captcha.com/2captcha-api#language
+[Buy residential proxies]: https://2captcha.com/proxy/residential-proxies
+[Quick start]: https://2captcha.com/proxy?openAddTrafficModal=true
+[examples]: ./examples/
+[residential proxies]: https://2captcha.com/proxy/residential-proxies