tiktok-captcha-solver 0.0.1__tar.gz

tiktok_captcha_solver-0.0.1/PKG-INFO

@@ -0,0 +1,62 @@
+Metadata-Version: 2.1
+Name: tiktok-captcha-solver
+Version: 0.0.1
+Summary: This package integrates with Selenium to solve any TikTok captcha in one line of code.
+Author-email: Toughdata LLC <greg@toughdata.net>
+Project-URL: Homepage, https://www.sadcaptcha.com
+Project-URL: Source, https://github.com/gbiz123/tiktok-captcha-solver/
+Keywords: tiktok,captcha,solver,selenium,rotate,puzzle,3d
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: selenium
+Requires-Dist: webdriver-manager
+Requires-Dist: pydantic
+Requires-Dist: requests
+Requires-Dist: pytest
+Requires-Dist: undetected_chromedriver
+
+# TikTok Captcha Solver API
+This project is the [SadCaptcha TikTok Captcha Solver](https://www.sadcaptcha.com?ref=ghclientrepo) API client.
+The purpose is to make integrating SadCaptcha into your selenium app as simple as one line of code.
+
+## Requirements
+- Python >= 3.10
+- Selenium properly installed and in `PATH`
+
+## Installation
+This project will be available as a `pip` package soon. 
+For now, just clone the repo and build it using the following commands:
+```
+git clone https://github.com/gbiz123/tiktok-captcha-solver
+cd tiktok-captcha-solver
+pip install -e .
+```
+
+## Usage
+Import the package, set up the SadCaptcha class, and call it whenever you need.
+
+```py
+from sadcaptcha import SadCaptcha
+import undetected_chromedriver as uc
+
+driver = uc.Chrome(headless=False)
+api_key = "YOUR_API_KEY_HERE"
+sadcaptcha = SadCaptcha(driver, api_key)
+
+# Selenium code that causes a TikTok captcha...
+
+sadcaptcha.solve_captcha_if_present()
+```
+
+That's it!
+
+## Contact
+- Homepage: https://www.sadcaptcha.com/
+- Email: info@toughdata.net
+- Telegram @toughdata

tiktok_captcha_solver-0.0.1/README.md

@@ -0,0 +1,39 @@
+# TikTok Captcha Solver API
+This project is the [SadCaptcha TikTok Captcha Solver](https://www.sadcaptcha.com?ref=ghclientrepo) API client.
+The purpose is to make integrating SadCaptcha into your selenium app as simple as one line of code.
+
+## Requirements
+- Python >= 3.10
+- Selenium properly installed and in `PATH`
+
+## Installation
+This project will be available as a `pip` package soon. 
+For now, just clone the repo and build it using the following commands:
+```
+git clone https://github.com/gbiz123/tiktok-captcha-solver
+cd tiktok-captcha-solver
+pip install -e .
+```
+
+## Usage
+Import the package, set up the SadCaptcha class, and call it whenever you need.
+
+```py
+from sadcaptcha import SadCaptcha
+import undetected_chromedriver as uc
+
+driver = uc.Chrome(headless=False)
+api_key = "YOUR_API_KEY_HERE"
+sadcaptcha = SadCaptcha(driver, api_key)
+
+# Selenium code that causes a TikTok captcha...
+
+sadcaptcha.solve_captcha_if_present()
+```
+
+That's it!
+
+## Contact
+- Homepage: https://www.sadcaptcha.com/
+- Email: info@toughdata.net
+- Telegram @toughdata

tiktok_captcha_solver-0.0.1/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"  # If not defined, then legacy behavior can happen.
+
+[project]
+name = "tiktok-captcha-solver"
+version = "0.0.1"
+
+description = "This package integrates with Selenium to solve any TikTok captcha in one line of code."
+readme = "README.md"
+requires-python = ">=3.10"
+
+keywords = ["tiktok", "captcha", "solver", "selenium", "rotate", "puzzle", "3d"]
+
+authors = [
+  {name = "Toughdata LLC", email = "greg@toughdata.net" }
+]
+
+classifiers = [
+  "Intended Audience :: Developers",
+  "Topic :: Software Development :: Build Tools",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3 :: Only",
+]
+
+dependencies = [
+  "selenium",
+  "webdriver-manager",
+  "pydantic",
+  "requests",
+  "pytest",
+  "undetected_chromedriver"
+]
+
+[project.urls]
+"Homepage" = "https://www.sadcaptcha.com"
+"Source" = "https://github.com/gbiz123/tiktok-captcha-solver/"

tiktok_captcha_solver-0.0.1/setup.cfg

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

tiktok_captcha_solver-0.0.1/tiktok_captcha_solver/api.py

@@ -0,0 +1,44 @@
+import requests
+import logging
+
+from .models import ShapesCaptchaResponse, RotateCaptchaResponse, PuzzleCaptchaResponse
+
+class ApiClient:
+
+    _PUZZLE_URL: str
+    _ROTATE_URL: str
+    _SHAPES_URL: str
+
+    def __init__(self, api_key: str) -> None:
+        self._PUZZLE_URL = "https://www.sadcaptcha.com/api/v1/puzzle?licenseKey=" + api_key
+        self._ROTATE_URL = "https://www.sadcaptcha.com/api/v1/rotate?licenseKey=" + api_key
+        self._SHAPES_URL = "https://www.sadcaptcha.com/api/v1/shapes?licenseKey=" + api_key
+
+    def rotate(self, outer_b46: str, inner_b64: str) -> RotateCaptchaResponse:
+        data = {
+            "outerImageB64": outer_b46,
+            "innerImageB64": inner_b64
+        }        
+        resp = requests.post(self._ROTATE_URL, json=data)
+        result = resp.json()
+        return RotateCaptchaResponse(angle=result.get("angle"))
+
+    def puzzle(self, puzzle_b64: str, piece_b64: str) -> PuzzleCaptchaResponse:
+        data = {
+            "puzzleImageB64": puzzle_b64,
+            "pieceImageB64": piece_b64
+        }        
+        resp = requests.post(self._PUZZLE_URL, json=data)
+        result = resp.json()
+        return PuzzleCaptchaResponse(slide_x_proportion=result.get("slideXProportion"))
+
+    def shapes(self, image_b64: str) -> ShapesCaptchaResponse:
+        data = { "imageB64": image_b64 }        
+        resp = requests.post(self._SHAPES_URL, json=data)
+        result = resp.json()
+        return ShapesCaptchaResponse(
+            point_one_proportion_x=result.get("pointOneProportionX"),
+            point_one_proportion_y=result.get("pointOneProportionY"),
+            point_two_proportion_x=result.get("pointTwoProportionX"),
+            point_two_proportion_y=result.get("pointTwoProportionX")
+        )

tiktok_captcha_solver-0.0.1/tiktok_captcha_solver/downloader.py

@@ -0,0 +1,7 @@
+import requests
+import base64
+
+def download_image_b64(url: str) -> str:
+    """Download an image from URL and return as base64 encoded string"""
+    r = requests.get(url)
+    return base64.b64encode(r.content).decode()

tiktok_captcha_solver-0.0.1/tiktok_captcha_solver/models.py

@@ -0,0 +1,13 @@
+from pydantic import BaseModel
+
+class ShapesCaptchaResponse(BaseModel):
+    point_one_proportion_x: float
+    point_one_proportion_y: float
+    point_two_proportion_x: float
+    point_two_proportion_y: float
+
+class RotateCaptchaResponse(BaseModel):
+    angle: int
+
+class PuzzleCaptchaResponse(BaseModel):
+    slide_x_proportion: float

tiktok_captcha_solver-0.0.1/tiktok_captcha_solver/sadcaptcha.py

@@ -0,0 +1,183 @@
+"""This class handles the captcha solving"""
+
+import time
+from typing import Literal
+from selenium.webdriver import ActionChains, Chrome
+from selenium.webdriver.common.by import By
+from selenium.webdriver.remote.webelement import WebElement
+from undetected_chromedriver import logging
+
+from .api import ApiClient
+from .downloader import download_image_b64
+
+class SadCaptcha:
+
+    client: ApiClient
+    chromedriver: Chrome
+
+    def __init__(self, chromedriver: Chrome, sadcaptcha_api_key: str) -> None:
+        self.chromedriver = chromedriver
+        self.client = ApiClient(sadcaptcha_api_key)
+
+    def solve_captcha_if_present(self, captcha_detect_timeout: int = 15, retries: int = 3) -> None:
+        """Solves any captcha that is present, if one is detected
+
+        Args:
+            captcha_detect_timeout: return if no captcha is detected in this many seconds
+            retries: number of times to retry captcha
+        """
+        if not self.captcha_is_present(captcha_detect_timeout):
+            return
+        match self.identify_captcha():
+            case "puzzle": 
+                self.solve_puzzle(retries)
+            case "rotate": 
+                self.solve_rotate(retries)
+            case "shapes": 
+                self.solve_shapes(retries)
+
+    def captcha_is_present(self, timeout: int = 15) -> bool:
+        for _ in range(timeout):
+            if len(self.chromedriver.find_elements(By.CSS_SELECTOR, "div#captcha_container")) > 0:
+                return True
+        return False
+
+    def identify_captcha(self) -> Literal["puzzle", "shapes", "rotate"]:
+        rotate_selector = "[data-testid=whirl-inner-img]"
+        puzzle_selector = "img.captcha_verify_img_slide"
+        shapes_selector = "#verify-points"
+        for _ in range(15):
+            if len(self.chromedriver.find_elements(By.CSS_SELECTOR, puzzle_selector)) > 0:
+                return "puzzle"
+            elif len(self.chromedriver.find_elements(By.CSS_SELECTOR, rotate_selector)) > 0:
+                return "rotate"
+            elif len(self.chromedriver.find_elements(By.CSS_SELECTOR, shapes_selector)) > 0:
+                return "shapes"
+            else:
+                time.sleep(2)
+        raise ValueError("Neither puzzle, shapes, or rotate captcha was present.")
+
+    def solve_shapes(self, retries: int = 3) -> None:
+        for _ in range(retries):
+            image = download_image_b64(self._get_shapes_image_url())
+            solution = self.client.shapes(image)
+            image_element = self.chromedriver.find_element(By.CSS_SELECTOR, "#captcha-verify-image")
+            self._click_proportional(image_element, solution.point_one_proportion_x, solution.point_one_proportion_y)
+            self._click_proportional(image_element, solution.point_two_proportion_y, solution.point_two_proportion_y)
+            self.chromedriver.find_element(By.CSS_SELECTOR, ".verify-captcha-submit-button").click()
+            if self._check_captcha_success():
+                return
+
+    def solve_rotate(self, retries: int = 3) -> None:
+        for _ in range(retries):
+            outer = download_image_b64(self._get_rotate_outer_image_url())
+            inner = download_image_b64(self._get_rotate_inner_image_url())
+            solution = self.client.rotate(outer, inner)
+            distance = self._compute_rotate_slide_distance(solution.angle)
+            self._drag_element(".secsdk-captcha-drag-icon", distance, 0)
+            if self._check_captcha_success():
+                return
+
+    def solve_puzzle(self, retries: int = 3) -> None:
+        for _ in range(retries):
+            puzzle = download_image_b64(self._get_puzzle_image_url())
+            piece = download_image_b64(self._get_piece_image_url())
+            solution = self.client.puzzle(puzzle, piece)
+            distance = self._compute_puzzle_slide_distance(solution.slide_x_proportion)
+            self._drag_element(".secsdk-captcha-drag-icon", distance, 0)
+            if self._check_captcha_success():
+                return
+
+    def _compute_rotate_slide_distance(self, angle: int) -> int:
+        slide_length = self._get_slide_length()
+        icon_length = self._get_slide_icon_length()
+        return int(((slide_length - icon_length) * angle) / 360)
+
+    def _compute_puzzle_slide_distance(self, proportion_x: float) -> int:
+        e = self.chromedriver.find_element(By.CSS_SELECTOR, "#captcha-verify-image")
+        return int(proportion_x * e.size["width"])
+
+    def _get_slide_length(self) -> int:
+        e = self.chromedriver.find_element(By.CSS_SELECTOR, ".captcha_verify_slide--slidebar")
+        return e.size['width']
+
+    def _get_slide_icon_length(self) -> int:
+        e = self.chromedriver.find_element(By.CSS_SELECTOR, ".secsdk-captcha-drag-icon")
+        return e.size['width']
+
+    def _get_rotate_inner_image_url(self) -> str:
+        e = self.chromedriver.find_element(By.CSS_SELECTOR, "[data-testid=whirl-inner-img]")
+        url = e.get_attribute("src")
+        if not url:
+            raise ValueError("Inner image URL was None")
+        return url
+
+    def _get_rotate_outer_image_url(self) -> str:
+        e = self.chromedriver.find_element(By.CSS_SELECTOR, "[data-testid=whirl-outer-img]")
+        url = e.get_attribute("src")
+        if not url:
+            raise ValueError("Outer image URL was None")
+        return url
+
+    def _get_puzzle_image_url(self) -> str:
+        e = self.chromedriver.find_element(By.CSS_SELECTOR, "#captcha-verify-image")
+        url = e.get_attribute("src")
+        if not url:
+            raise ValueError("Puzzle image URL was None")
+        return url
+
+    def _get_piece_image_url(self) -> str:
+        e = self.chromedriver.find_element(By.CSS_SELECTOR, ".captcha_verify_img_slide")
+        url = e.get_attribute("src")
+        if not url:
+            raise ValueError("Piece image URL was None")
+        return url
+
+    def _get_shapes_image_url(self) -> str:
+        e = self.chromedriver.find_element(By.CSS_SELECTOR, "#captcha-verify-image")
+        url = e.get_attribute("src")
+        if not url:
+            raise ValueError("Shapes image URL was None")
+        return url
+
+    def _check_captcha_success(self) -> bool:
+        success_xpath = "//*[contains(text(), 'Verification complete')]"
+        for _ in range(20):
+            if self.chromedriver.find_elements(By.XPATH, success_xpath):
+                return True
+            time.sleep(1)
+        return False
+
+    def _click_proportional(
+            self,
+            element: WebElement,
+            proportion_x: float,
+            proportion_y: float
+        ) -> None:
+        """Click an element inside its bounding box at a point defined by the proportions of x and y
+        to the width and height of the entire element
+
+        Args:
+            element: WebElement to click inside
+            proportion_x: float from 0 to 1 defining the proportion x location to click 
+            proportion_y: float from 0 to 1 defining the proportion y location to click 
+        """
+        offset_x = (proportion_x * element.size["width"])
+        offset_y = (proportion_y * element.size["height"]) 
+        ActionChains(self.chromedriver) \
+            .move_to_element_with_offset(element, offset_x, offset_y) \
+            .click() \
+            .perform()
+        time.sleep(1.337)
+
+    def _drag_element(self, css_selector: str, x: int, y: int) -> None:
+        e = self.chromedriver.find_element(By.CSS_SELECTOR, css_selector)
+        actions = ActionChains(self.chromedriver, duration=500)
+        actions.click_and_hold(e)
+        actions.move_by_offset(x - 15, 0)
+        time.sleep(0.001)
+        for _ in range(0, 15):
+            actions.move_by_offset(1, 0)
+            time.sleep(0.1)
+        actions.release().perform()
+

tiktok_captcha_solver-0.0.1/tiktok_captcha_solver/tests/test_api.py

@@ -0,0 +1,28 @@
+import os
+import logging
+
+from ..downloader import download_image_b64
+from ..api import ApiClient
+from tiktok_captcha_solver.models import PuzzleCaptchaResponse, RotateCaptchaResponse, ShapesCaptchaResponse
+
+api_client = ApiClient(os.environ["API_KEY"])
+
+def test_rotate(caplog):
+    caplog.set_level(logging.DEBUG)
+    inner = download_image_b64("https://raw.githubusercontent.com/gbiz123/sadcaptcha-code-examples/master/images/inner_tt.png")
+    outer = download_image_b64("https://raw.githubusercontent.com/gbiz123/sadcaptcha-code-examples/master/images/outer_tt.png")
+    res = api_client.rotate(outer, inner)
+    assert isinstance(res, RotateCaptchaResponse)
+
+
+def test_puzzle():
+    piece = download_image_b64("https://raw.githubusercontent.com/gbiz123/sadcaptcha-code-examples/master/images/piece.png")
+    puzzle = download_image_b64("https://raw.githubusercontent.com/gbiz123/sadcaptcha-code-examples/master/images/puzzle.jpg")
+    res = api_client.puzzle(puzzle, piece)
+    assert isinstance(res, PuzzleCaptchaResponse)
+
+
+def test_shapes():
+    image = download_image_b64("https://raw.githubusercontent.com/gbiz123/sadcaptcha-code-examples/master/images/tiktok3d.png")
+    res = api_client.shapes(image)
+    assert isinstance(res, ShapesCaptchaResponse)

tiktok_captcha_solver-0.0.1/tiktok_captcha_solver/tests/test_downloader.py

@@ -0,0 +1,8 @@
+from ..downloader import download_image_b64
+
+
+def test_download_image_b64():
+    result = download_image_b64("https://fastly.picsum.photos/id/237/536/354.jpg")
+    assert len(result) > 1
+
+

tiktok_captcha_solver-0.0.1/tiktok_captcha_solver/tests/test_sadcaptcha.py

@@ -0,0 +1,47 @@
+import time
+import os
+
+from webdriver_manager.chrome import ChromeDriverManager
+from selenium import webdriver
+from selenium.webdriver.common.by import By
+import undetected_chromedriver as uc
+
+from ..sadcaptcha import SadCaptcha
+
+options = webdriver.ChromeOptions()
+options.add_argument('--no-sandbox')
+options.add_argument('--disable-infobars')
+options.add_argument('--disable-gpu')
+options.add_argument('--disable-dev-shm-usage')
+options.add_argument('--disable-blink-features=AutomationControlled')
+options.add_experimental_option('excludeSwitches', ['enable-automation'])
+options.add_experimental_option('useAutomationExtension', False)
+options.add_argument("start-maximized")
+options.add_argument(
+    "--user-agent=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/110.0.0.0 Safari/537.36")
+options.add_argument("--accept-lang=en-US,en;q=0.5")
+options.add_argument("--dom-automation=disabled")
+
+
+
+def make_driver() -> uc.Chrome:
+    return uc.Chrome(service=ChromeDriverManager().install(), headless=False, use_subprocess=False)
+
+
+def open_tiktkok_login(driver: uc.Chrome) -> None:
+    driver.get("https://www.tiktok.com/login/phone-or-email/email")
+    time.sleep(10)
+    write_username = driver.find_element(By.XPATH, '//input[contains(@name,"username")]');
+    write_username.send_keys("greg@toughdata.net");
+    time.sleep(2);
+    write_password = driver.find_element(By.XPATH, '//input[contains(@type,"password")]');
+    write_password.send_keys("th.etoughapi1!");
+    time.sleep(2)
+    login_btn = driver.find_element(By.XPATH, '//button[contains(@data-e2e,"login-button")]').click();
+    time.sleep(8)
+
+def test_solve_captcha():
+    driver = make_driver()
+    open_tiktkok_login(driver)
+    sadcaptcha = SadCaptcha(driver, os.environ["API_KEY"])
+    sadcaptcha.solve_captcha_if_present()

tiktok_captcha_solver-0.0.1/tiktok_captcha_solver.egg-info/PKG-INFO

@@ -0,0 +1,62 @@
+Metadata-Version: 2.1
+Name: tiktok-captcha-solver
+Version: 0.0.1
+Summary: This package integrates with Selenium to solve any TikTok captcha in one line of code.
+Author-email: Toughdata LLC <greg@toughdata.net>
+Project-URL: Homepage, https://www.sadcaptcha.com
+Project-URL: Source, https://github.com/gbiz123/tiktok-captcha-solver/
+Keywords: tiktok,captcha,solver,selenium,rotate,puzzle,3d
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: selenium
+Requires-Dist: webdriver-manager
+Requires-Dist: pydantic
+Requires-Dist: requests
+Requires-Dist: pytest
+Requires-Dist: undetected_chromedriver
+
+# TikTok Captcha Solver API
+This project is the [SadCaptcha TikTok Captcha Solver](https://www.sadcaptcha.com?ref=ghclientrepo) API client.
+The purpose is to make integrating SadCaptcha into your selenium app as simple as one line of code.
+
+## Requirements
+- Python >= 3.10
+- Selenium properly installed and in `PATH`
+
+## Installation
+This project will be available as a `pip` package soon. 
+For now, just clone the repo and build it using the following commands:
+```
+git clone https://github.com/gbiz123/tiktok-captcha-solver
+cd tiktok-captcha-solver
+pip install -e .
+```
+
+## Usage
+Import the package, set up the SadCaptcha class, and call it whenever you need.
+
+```py
+from sadcaptcha import SadCaptcha
+import undetected_chromedriver as uc
+
+driver = uc.Chrome(headless=False)
+api_key = "YOUR_API_KEY_HERE"
+sadcaptcha = SadCaptcha(driver, api_key)
+
+# Selenium code that causes a TikTok captcha...
+
+sadcaptcha.solve_captcha_if_present()
+```
+
+That's it!
+
+## Contact
+- Homepage: https://www.sadcaptcha.com/
+- Email: info@toughdata.net
+- Telegram @toughdata

tiktok_captcha_solver-0.0.1/tiktok_captcha_solver.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+README.md
+pyproject.toml
+tiktok_captcha_solver/__init__.py
+tiktok_captcha_solver/api.py
+tiktok_captcha_solver/downloader.py
+tiktok_captcha_solver/models.py
+tiktok_captcha_solver/sadcaptcha.py
+tiktok_captcha_solver.egg-info/PKG-INFO
+tiktok_captcha_solver.egg-info/SOURCES.txt
+tiktok_captcha_solver.egg-info/dependency_links.txt
+tiktok_captcha_solver.egg-info/requires.txt
+tiktok_captcha_solver.egg-info/top_level.txt
+tiktok_captcha_solver/tests/__init__.py
+tiktok_captcha_solver/tests/test_api.py
+tiktok_captcha_solver/tests/test_downloader.py
+tiktok_captcha_solver/tests/test_sadcaptcha.py

tiktok_captcha_solver-0.0.1/tiktok_captcha_solver.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

tiktok_captcha_solver-0.0.1/tiktok_captcha_solver.egg-info/requires.txt

@@ -0,0 +1,6 @@
+selenium
+webdriver-manager
+pydantic
+requests
+pytest
+undetected_chromedriver

tiktok_captcha_solver-0.0.1/tiktok_captcha_solver.egg-info/top_level.txt

@@ -0,0 +1 @@
+tiktok_captcha_solver