rcap-client 1.0.1__tar.gz

rcap_client-1.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mahdi-marjani
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

rcap_client-1.0.1/PKG-INFO

@@ -0,0 +1,57 @@
+Metadata-Version: 2.4
+Name: rcap-client
+Version: 1.0.1
+Summary: rcap client for solving reCAPTCHA challenges.
+Author-email: Mahdi Marjani <mahdi.marjani.dev@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/mahdi-marjani/rcap-client
+Project-URL: Documentation, https://github.com/mahdi-marjani/rcap-client
+Project-URL: Repository, https://github.com/mahdi-marjani/rcap-client.git
+Project-URL: Issues, https://github.com/mahdi-marjani/rcap-client/issues
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=2.2.6
+Requires-Dist: Pillow>=12.1.0
+Requires-Dist: Requests>=2.32.5
+Requires-Dist: selenium>=4.39.0
+Requires-Dist: webdriver_manager>=4.0.2
+Dynamic: license-file
+
+# rcap-client
+
+rcap client for solving reCAPTCHA using Selenium and rcap server. 
+
+## Installation
+
+Install via pip:
+
+```
+pip install rcap-client
+```
+
+## Usage
+
+Here's an example of how to use it:
+
+```python
+from selenium import webdriver
+from selenium.webdriver.firefox.service import Service
+from webdriver_manager.firefox import GeckoDriverManager
+from rcap_client.solver import RecaptchaSolver
+
+driver = webdriver.Firefox(service=Service(GeckoDriverManager().install()))
+driver.get("https://www.google.com/recaptcha/api2/demo")
+
+solver = RecaptchaSolver(driver)
+solver.solve()  # Done!
+
+print("reCAPTCHA solved!")
+input("Press Enter to quit...")
+driver.quit()
+```
+
+## Details
+
+- Uses Selenium for browser interaction.
+- Relies on a local API (localhost:8000) for image detection.

rcap_client-1.0.1/README.md

@@ -0,0 +1,37 @@
+# rcap-client
+
+rcap client for solving reCAPTCHA using Selenium and rcap server. 
+
+## Installation
+
+Install via pip:
+
+```
+pip install rcap-client
+```
+
+## Usage
+
+Here's an example of how to use it:
+
+```python
+from selenium import webdriver
+from selenium.webdriver.firefox.service import Service
+from webdriver_manager.firefox import GeckoDriverManager
+from rcap_client.solver import RecaptchaSolver
+
+driver = webdriver.Firefox(service=Service(GeckoDriverManager().install()))
+driver.get("https://www.google.com/recaptcha/api2/demo")
+
+solver = RecaptchaSolver(driver)
+solver.solve()  # Done!
+
+print("reCAPTCHA solved!")
+input("Press Enter to quit...")
+driver.quit()
+```
+
+## Details
+
+- Uses Selenium for browser interaction.
+- Relies on a local API (localhost:8000) for image detection.

rcap_client-1.0.1/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "rcap-client"
+version = "1.0.1"
+description = "rcap client for solving reCAPTCHA challenges."
+authors = [{name = "Mahdi Marjani", email = "mahdi.marjani.dev@gmail.com"}]
+license = "MIT"
+readme = "README.md"
+requires-python = ">=3.8"
+dependencies = [
+    "numpy>=2.2.6",
+    "Pillow>=12.1.0",
+    "Requests>=2.32.5",
+    "selenium>=4.39.0",
+    "webdriver_manager>=4.0.2",
+]
+
+[tool.setuptools]
+packages = ["rcap_client"]
+
+[project.urls]
+Homepage = "https://github.com/mahdi-marjani/rcap-client"
+Documentation = "https://github.com/mahdi-marjani/rcap-client"
+Repository = "https://github.com/mahdi-marjani/rcap-client.git"
+Issues = "https://github.com/mahdi-marjani/rcap-client/issues"

rcap_client-1.0.1/rcap_client/api.py

@@ -0,0 +1,32 @@
+import io
+import base64
+import requests
+from PIL import Image
+
+SERVER_URL = "http://localhost:8000"
+
+
+def get_models():
+    res = requests.get(f"{SERVER_URL}/models")
+    res.raise_for_status()
+    return res.json()["models"]
+
+
+def detect_cells(image_array, grid, target_text):
+    image = Image.fromarray(image_array)
+    buffer = io.BytesIO()
+    image.save(buffer, format="PNG")
+
+    image_b64 = base64.b64encode(buffer.getvalue()).decode()
+
+    res = requests.post(
+        f"{SERVER_URL}/detect",
+        json={
+            "image": image_b64,
+            "grid": grid,           # "3x3" or "4x4"
+            "target": target_text,
+        },
+        timeout=60,
+    )
+    res.raise_for_status()
+    return res.json()["cells"]

rcap_client-1.0.1/rcap_client/example.py

@@ -0,0 +1,15 @@
+from .solver import RecaptchaSolver
+from selenium import webdriver
+from selenium.webdriver.firefox.service import Service
+from webdriver_manager.firefox import GeckoDriverManager
+
+
+if __name__ == "__main__":
+    driver = webdriver.Firefox(service=Service(GeckoDriverManager().install()))
+    driver.get("https://google.com/recaptcha/api2/demo")
+
+    solver = RecaptchaSolver(driver)
+    solver.solve()
+    
+    print("reCAPTCHA solved!")
+    driver.quit()

rcap_client-1.0.1/rcap_client/solver.py

@@ -0,0 +1,299 @@
+from selenium.webdriver.common.by import By
+from selenium.webdriver.support.ui import WebDriverWait
+from selenium.webdriver.support import expected_conditions as EC
+
+from .utils import (
+    switch_to_recaptcha_frame,
+    get_all_image_urls,
+    get_image_array,
+    get_new_dynamic_image_urls,
+    paste_image_on_main,
+)
+
+from .api import get_models, detect_cells
+
+
+class BaseRecaptchaSolver:
+    def __init__(self, driver):
+        self.driver = driver
+
+    # =========================
+    # Abstract methods (override in subclasses)
+    # =========================
+    
+    def is_model_available(self, target_text):
+        pass
+
+    def detect(self, image_array, grid, target_text):
+        pass
+
+    # =========================
+    # Public API
+    # =========================
+
+    def solve(self):
+        self._click_checkbox()
+        self._solve_challenge()
+
+    # =========================
+    # High-level flow
+    # =========================
+
+    def _solve_challenge(self):
+        while True:
+            try:
+                solved = self._wait_until_challenge_ready_or_solved()
+                if solved:
+                    self._finalize()
+                    break
+
+                captcha_type, target_text, answers, main_image_array = self._analyze_challenge()
+
+                if captcha_type is None:
+                    self._reload()
+                    continue
+
+                if captcha_type == "dynamic":
+                    self._solve_dynamic(target_text, answers, main_image_array)
+                else:
+                    self._click_answers(answers)
+
+                if self._verify():
+                    self._finalize()
+                    break
+
+            except Exception as e:
+                print(e)
+                self._recover_from_error()
+
+    # =========================
+    # Initial checkbox
+    # =========================
+
+    def _click_checkbox(self):
+        switch_to_recaptcha_frame(self.driver, '//iframe[@title="reCAPTCHA"]')
+        WebDriverWait(self.driver, 10).until(
+            EC.element_to_be_clickable(
+                (By.XPATH, '//div[@class="recaptcha-checkbox-border"]')
+            )
+        ).click()
+        self._switch_to_challenge_frame()
+
+    # =========================
+    # Challenge state handling
+    # =========================
+
+    def _wait_until_challenge_ready_or_solved(self):
+        for _ in range(200):
+            try:
+                self._switch_to_challenge_frame()
+                WebDriverWait(self.driver, 0.1).until(
+                    EC.element_to_be_clickable((By.ID, "recaptcha-reload-button"))
+                )
+                return False
+            except Exception:
+                if self._is_checkbox_checked():
+                    return True
+        return False
+
+    def _analyze_challenge(self):
+        self._switch_to_challenge_frame()
+
+        reload_btn = WebDriverWait(self.driver, 10).until(
+            EC.element_to_be_clickable((By.ID, "recaptcha-reload-button"))
+        )
+        title_wrapper = WebDriverWait(self.driver, 10).until(
+            EC.presence_of_element_located((By.ID, "rc-imageselect"))
+        )
+
+        target_text = title_wrapper.find_element(By.XPATH, ".//strong").text
+
+        if not self.is_model_available(target_text):
+            return None, None, None, None
+
+        if "squares" in title_wrapper.text:
+            return self._handle_4x4(target_text)
+
+        if "none" in title_wrapper.text:
+            return self._handle_dynamic_3x3(target_text)
+
+        return self._handle_static_3x3(target_text)
+
+    # =========================
+    # CAPTCHA type handlers
+    # =========================
+
+    def _handle_4x4(self, target_text):
+        img_urls = get_all_image_urls(self.driver)
+        main_image_array = get_image_array(img_urls[0])
+
+        answers = self.detect(main_image_array, "4x4", target_text)
+        if 1 <= len(answers) < 16:
+            return "squares", target_text, answers, main_image_array
+
+        return None, None, None, None
+
+    def _handle_dynamic_3x3(self, target_text):
+        img_urls = get_all_image_urls(self.driver)
+        if len(set(img_urls)) != 1:
+            return None, None, None
+
+        main_image_array = get_image_array(img_urls[0])
+        answers = self.detect(main_image_array, "3x3", target_text)
+
+        if len(answers) > 2:
+            return "dynamic", target_text, answers, main_image_array
+
+        return None, None, None, None
+
+    def _handle_static_3x3(self, target_text):
+        img_urls = get_all_image_urls(self.driver)
+        main_image_array = get_image_array(img_urls[0])
+
+        answers = self.detect(main_image_array, "3x3", target_text)
+        if len(answers) > 2:
+            return "selection", target_text, answers, main_image_array
+
+        return None, None, None, None
+
+    # =========================
+    # Solvers
+    # =========================
+
+    def _solve_dynamic(self, target_text, answers, main_image_array):
+        self._click_answers(answers)
+
+        while True:
+            old_urls = get_all_image_urls(self.driver)
+            is_new, new_urls = self._wait_for_new_dynamic_images(
+                answers, old_urls
+            )
+
+            new_images_array = self._download_dynamic_images(answers, new_urls)
+            main_image_array = self._merge_dynamic_images(answers, main_image_array, new_images_array)
+
+            answers = self.detect(main_image_array, "3x3", target_text)
+            if not answers:
+                break
+
+            self._click_answers(answers)
+
+    # =========================
+    # Actions
+    # =========================
+
+    def _click_answers(self, answers):
+        for answer in answers:
+            WebDriverWait(self.driver, 10).until(
+                EC.element_to_be_clickable(
+                    (
+                        By.XPATH,
+                        f'(//div[@id="rc-imageselect-target"]//td)[{answer}]',
+                    )
+                )
+            ).click()
+
+    def _verify(self):
+        verify = WebDriverWait(self.driver, 10).until(
+            EC.element_to_be_clickable((By.ID, "recaptcha-verify-button"))
+        )
+        verify.click()
+
+        for _ in range(200):
+            try:
+                self._switch_to_challenge_frame()
+                WebDriverWait(self.driver, 0.1).until(
+                    EC.presence_of_element_located(
+                        (
+                            By.XPATH,
+                            '//button[@id="recaptcha-verify-button" and not(contains(@class, "rc-button-default-disabled"))]',
+                        )
+                    )
+                )
+                return False
+            except Exception:
+                if self._is_checkbox_checked():
+                    return True
+
+        return False
+
+    # =========================
+    # Dynamic helpers
+    # =========================
+
+    def _wait_for_new_dynamic_images(self, answers, old_urls):
+        while True:
+            is_new, new_urls = get_new_dynamic_image_urls(
+                answers, old_urls, self.driver
+            )
+            if is_new:
+                return is_new, new_urls
+
+    def _download_dynamic_images(self, answers, img_urls):
+        new_images_array = {}
+        for answer in answers:
+            idx = answer - 1
+            new_images_array[answer] = get_image_array(img_urls[idx])
+        
+        return new_images_array
+
+    def _merge_dynamic_images(self, answers, main_image_array, new_images_array):
+        while True:
+            try:
+                for answer in answers:
+                    new_image_array = new_images_array[answer]
+                    main_image_array = paste_image_on_main(main_image_array, new_image_array, answer)
+                return main_image_array
+            except Exception:
+                continue
+
+    # =========================
+    # Frame / state utils
+    # =========================
+
+    def _switch_to_challenge_frame(self):
+        switch_to_recaptcha_frame(
+            self.driver,
+            '//iframe[contains(@title, "challenge") and contains(@title, "recaptcha")]',
+        )
+
+    def _is_checkbox_checked(self):
+        switch_to_recaptcha_frame(self.driver, '//iframe[@title="reCAPTCHA"]')
+        return (
+            WebDriverWait(self.driver, 10)
+            .until(
+                EC.presence_of_element_located(
+                    (By.XPATH, '//span[@id="recaptcha-anchor"]')
+                )
+            )
+            .get_attribute("aria-checked")
+            == "true"
+        )
+
+    def _reload(self):
+        self._switch_to_challenge_frame()
+        WebDriverWait(self.driver, 10).until(
+            EC.element_to_be_clickable((By.ID, "recaptcha-reload-button"))
+        ).click()
+
+    def _recover_from_error(self):
+        try:
+            self._click_checkbox()
+        except Exception:
+            pass
+
+    def _finalize(self):
+        self.driver.switch_to.default_content()
+
+
+class RecaptchaSolver(BaseRecaptchaSolver):
+    def __init__(self, driver):
+        super().__init__(driver)
+        self.available_models = get_models()
+
+    def is_model_available(self, target_text):
+        target_text = target_text.lower()
+        return any(model in target_text for model in self.available_models)
+
+    def detect(self, image_array, grid, target_text):
+        return detect_cells(image_array, grid, target_text)

rcap_client-1.0.1/rcap_client/utils.py

@@ -0,0 +1,102 @@
+import io
+import requests
+import numpy as np
+from PIL import Image
+from selenium.webdriver.common.by import By
+from selenium.webdriver.support.ui import WebDriverWait
+from selenium.webdriver.support import expected_conditions as EC
+
+
+def switch_to_recaptcha_frame(driver, frame_xpath):
+    """Switch to the reCAPTCHA frame."""
+    driver.switch_to.default_content()
+    frame = WebDriverWait(driver, 10).until(
+        EC.presence_of_element_located((By.XPATH, frame_xpath))
+    )
+    driver.switch_to.frame(frame)
+
+
+def get_image_array(url):
+    """Download an image from URL and return it as a numpy array."""
+    response = requests.get(url)
+    if response.status_code == 200:
+        image = Image.open(io.BytesIO(response.content))
+        return np.array(image)
+    else:
+        raise ValueError(f"Failed to download image from {url}")
+
+
+def paste_image_on_main(main_img, new_img, position):
+    """Paste a new image onto the main one at a position.
+
+    Positions map to a 3x3 grid like this:
+    +---+---+---+
+    | 1 | 2 | 3 |
+    +---+---+---+
+    | 4 | 5 | 6 |
+    +---+---+---+
+    | 7 | 8 | 9 |
+    +---+---+---+
+    """
+    main = np.copy(main_img)
+
+    section_map = {
+        1: (0, 0),
+        2: (0, 1),
+        3: (0, 2),
+        4: (1, 0),
+        5: (1, 1),
+        6: (1, 2),
+        7: (2, 0),
+        8: (2, 1),
+        9: (2, 2),
+    }
+    
+    row, col = section_map[position]
+    height, width = main.shape[0] // 3, main.shape[1] // 3
+    
+    start_row = row * height
+    start_col = col * width
+    
+    main[start_row : start_row + height, start_col : start_col + width] = new_img
+    
+    return main
+
+
+def get_all_image_urls(driver):
+    """Get all image URLs from the CAPTCHA grid."""
+    images = WebDriverWait(driver, 10).until(
+        EC.presence_of_all_elements_located(
+            (By.XPATH, '//div[@id="rc-imageselect-target"]//img')
+        )
+    )
+    return [img.get_attribute("src") for img in images]
+
+
+def get_new_dynamic_image_urls(answers, old_urls, driver):
+    """Check for new dynamic CAPTCHA images and return if changed."""
+    images = WebDriverWait(driver, 10).until(
+        EC.presence_of_all_elements_located(
+            (By.XPATH, '//div[@id="rc-imageselect-target"]//img')
+        )
+    )
+    new_urls = []
+
+    for img in images:
+        try:
+            new_urls.append(img.get_attribute("src"))
+        except:
+            is_new = False
+            return is_new, new_urls
+
+    same_count = 0
+    for answer in answers:
+        if new_urls[answer - 1] == old_urls[answer - 1]:
+            same_count += 1
+
+    if same_count > 0:
+        is_new = False
+        return is_new, new_urls
+    else:
+        is_new = True
+        return is_new, new_urls

rcap_client-1.0.1/rcap_client.egg-info/PKG-INFO

@@ -0,0 +1,57 @@
+Metadata-Version: 2.4
+Name: rcap-client
+Version: 1.0.1
+Summary: rcap client for solving reCAPTCHA challenges.
+Author-email: Mahdi Marjani <mahdi.marjani.dev@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/mahdi-marjani/rcap-client
+Project-URL: Documentation, https://github.com/mahdi-marjani/rcap-client
+Project-URL: Repository, https://github.com/mahdi-marjani/rcap-client.git
+Project-URL: Issues, https://github.com/mahdi-marjani/rcap-client/issues
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=2.2.6
+Requires-Dist: Pillow>=12.1.0
+Requires-Dist: Requests>=2.32.5
+Requires-Dist: selenium>=4.39.0
+Requires-Dist: webdriver_manager>=4.0.2
+Dynamic: license-file
+
+# rcap-client
+
+rcap client for solving reCAPTCHA using Selenium and rcap server. 
+
+## Installation
+
+Install via pip:
+
+```
+pip install rcap-client
+```
+
+## Usage
+
+Here's an example of how to use it:
+
+```python
+from selenium import webdriver
+from selenium.webdriver.firefox.service import Service
+from webdriver_manager.firefox import GeckoDriverManager
+from rcap_client.solver import RecaptchaSolver
+
+driver = webdriver.Firefox(service=Service(GeckoDriverManager().install()))
+driver.get("https://www.google.com/recaptcha/api2/demo")
+
+solver = RecaptchaSolver(driver)
+solver.solve()  # Done!
+
+print("reCAPTCHA solved!")
+input("Press Enter to quit...")
+driver.quit()
+```
+
+## Details
+
+- Uses Selenium for browser interaction.
+- Relies on a local API (localhost:8000) for image detection.

rcap_client-1.0.1/rcap_client.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+README.md
+pyproject.toml
+rcap_client/__init__.py
+rcap_client/api.py
+rcap_client/example.py
+rcap_client/solver.py
+rcap_client/utils.py
+rcap_client.egg-info/PKG-INFO
+rcap_client.egg-info/SOURCES.txt
+rcap_client.egg-info/dependency_links.txt
+rcap_client.egg-info/requires.txt
+rcap_client.egg-info/top_level.txt

rcap_client-1.0.1/rcap_client.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

rcap_client-1.0.1/rcap_client.egg-info/requires.txt

@@ -0,0 +1,5 @@
+numpy>=2.2.6
+Pillow>=12.1.0
+Requests>=2.32.5
+selenium>=4.39.0
+webdriver_manager>=4.0.2

rcap_client-1.0.1/rcap_client.egg-info/top_level.txt

@@ -0,0 +1 @@
+rcap_client

rcap_client-1.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+