Repo-wide example repairs and QA

Author: bshahin

articles/abstract-captcha-solver-provider-agnostic/kotlin/solve.kt

@@ -92,8 +92,7 @@ fun main() {
         println("    Copy .env.example to .env and add your real API key.")
         exitProcess(1)
     }
-
-    // Submit — TODO: Change method and add CAPTCHA-specific parameters
+    // Submit
     println("[*] Submitting reCAPTCHA v2 task...")
     val enc = java.nio.charset.StandardCharsets.UTF_8.name()
     val submitParams = "key=${URLEncoder.encode(apiKey, enc)}&method=userrecaptcha&googlekey=${URLEncoder.encode(googlekey, enc)}&pageurl=${URLEncoder.encode(pageurl, enc)}&json=1"

articles/abstract-captcha-solver-provider-agnostic/php/solve.php

@@ -17,292 +17,8 @@
 define('RESULT_URL', 'https://ocr.captchaai.com/res.php');
 
 $apiKey = $_ENV['CAPTCHAAI_API_KEY'] ?? '';
-$googlekey = <?php
-/**
- * Solve reCAPTCHA v2 using the CaptchaAI API.
- *
- * Usage:
- *   composer install
- *   cp ../.env.example ../.env   # then edit with your credentials
- *   php solve.php
- */
-
-require __DIR__ . '/vendor/autoload.php';
-
-$dotenv = Dotenv\Dotenv::createImmutable(dirname(__DIR__));
-$dotenv->load();
-
-define('SUBMIT_URL', 'https://ocr.captchaai.com/in.php');
-define('RESULT_URL', 'https://ocr.captchaai.com/res.php');
-
-$apiKey = $_ENV['CAPTCHAAI_API_KEY'] ?? '';
-// TODO: Add CAPTCHA-specific environment variables here
-$pollInterval = (int)($_ENV['POLL_INTERVAL'] ?? 5);
-$maxTimeout = (int)($_ENV['MAX_TIMEOUT'] ?? 120);
-
-$authErrors = ['ERROR_WRONG_USER_KEY', 'ERROR_KEY_DOES_NOT_EXIST', 'IP_BANNED'];
-$balanceErrors = ['ERROR_ZERO_BALANCE'];
-$inputErrors = ['ERROR_PAGEURL', 'ERROR_WRONG_GOOGLEKEY', 'ERROR_BAD_PARAMETERS', 'ERROR_BAD_TOKEN_OR_PAGEURL'];
-$transientErrors = ['ERROR_SERVER_ERROR', 'ERROR_INTERNAL_SERVER_ERROR'];
-$solveErrors = ['ERROR_CAPTCHA_UNSOLVABLE'];
-
-// --- Validate configuration ---
-if (empty($apiKey) || $apiKey === 'YOUR_API_KEY') {
-    echo "[!] ERROR: CAPTCHAAI_API_KEY is not set.\n";
-    echo "    Copy .env.example to .env and add your real API key.\n";
-    exit(1);
-}
-
-// --- Submit task ---
-echo "[*] Submitting reCAPTCHA v2 task...\n";
-$submitParams = http_build_query([
-    'key' => $apiKey,
-    'method' => 'userrecaptcha',
-    'googlekey' => $googlekey,
-    'pageurl' => $pageurl,
-    'json' => '1',
-]);
-
-$submitResponse = @file_get_contents(SUBMIT_URL . '?' . $submitParams);
-if ($submitResponse === false) {
-    echo "[!] Network error during submission.\n";
-    exit(1);
-}
-
-$submitData = json_decode($submitResponse, true);
-if (($submitData['status'] ?? 0) !== 1) {
-    $error = $submitData['request'] ?? 'UNKNOWN_ERROR';
-    if (in_array($error, $authErrors)) {
-        echo "[!] Authentication error: $error\n";
-        echo "    Check your API key at https://captchaai.com/dashboard\n";
-    } elseif (in_array($error, $balanceErrors)) {
-        echo "[!] Balance error: $error\n";
-        echo "    Top up your account at https://captchaai.com\n";
-    } elseif (in_array($error, $inputErrors)) {
-        echo "[!] Input error: $error\n";
-        echo "    Verify your sitekey and page URL are correct.\n";
-    } else {
-        echo "[!] Submission failed: $error\n";
-    }
-    exit(1);
-}
-
-$taskId = $submitData['request'];
-echo "[+] Task submitted. ID: $taskId\n";
-
-// --- Poll for result ---
-echo "[*] Waiting 15s before first poll...\n";
-sleep(15);
-
-$elapsed = 15;
-$attempt = 0;
-$backoff = $pollInterval;
-
-while ($elapsed < $maxTimeout) {
-    $attempt++;
-    echo "[*] Polling for result (attempt $attempt)...\n";
-
-    $resultParams = http_build_query([
-        'key' => $apiKey,
-        'action' => 'get',
-        'id' => $taskId,
-        'json' => '1',
-    ]);
-
-    $resultResponse = @file_get_contents(RESULT_URL . '?' . $resultParams);
-    if ($resultResponse === false) {
-        echo "[!] Network error during polling.\n";
-        sleep($backoff);
-        $elapsed += $backoff;
-        $backoff = min($backoff * 2, 30);
-        continue;
-    }
-
-    $resultData = json_decode($resultResponse, true);
-
-    if (($resultData['status'] ?? 0) === 1) {
-        $token = $resultData['request'];
-        echo "[+] Solved! Token: " . substr($token, 0, 50) . "...\n";
-        echo "[+] Full token length: " . strlen($token) . " characters\n";
-        echo "\n";
-        echo "Next step: inject this token into the target page's\n";
-        echo "g-recaptcha-response hidden field and submit the form.\n";
-        exit(0);
-    }
-
-    $error = $resultData['request'] ?? '';
-    if ($error === 'CAPCHA_NOT_READY') {
-        echo "[*] Not ready yet, waiting {$pollInterval}s...\n";
-        sleep($pollInterval);
-        $elapsed += $pollInterval;
-        $backoff = $pollInterval;
-        continue;
-    }
-
-    if (in_array($error, $transientErrors)) {
-        echo "[!] Transient error: $error, retrying in {$backoff}s...\n";
-        sleep($backoff);
-        $elapsed += $backoff;
-        $backoff = min($backoff * 2, 30);
-        continue;
-    }
-
-    if (in_array($error, $solveErrors)) {
-        echo "[!] Solve error: $error\n";
-        echo "    The CAPTCHA could not be solved. Verify parameters and retry.\n";
-        exit(1);
-    }
-
-    echo "[!] Unexpected error: $error\n";
-    exit(1);
-}
-
-echo "[!] Timeout: no solution received within {$maxTimeout} seconds.\n";
-exit(1);
-ENV['CAPTCHA_GOOGLEKEY'] ?? '';
-$pageurl = <?php
-/**
- * Solve reCAPTCHA v2 using the CaptchaAI API.
- *
- * Usage:
- *   composer install
- *   cp ../.env.example ../.env   # then edit with your credentials
- *   php solve.php
- */
-
-require __DIR__ . '/vendor/autoload.php';
-
-$dotenv = Dotenv\Dotenv::createImmutable(dirname(__DIR__));
-$dotenv->load();
-
-define('SUBMIT_URL', 'https://ocr.captchaai.com/in.php');
-define('RESULT_URL', 'https://ocr.captchaai.com/res.php');
-
-$apiKey = $_ENV['CAPTCHAAI_API_KEY'] ?? '';
-// TODO: Add CAPTCHA-specific environment variables here
-$pollInterval = (int)($_ENV['POLL_INTERVAL'] ?? 5);
-$maxTimeout = (int)($_ENV['MAX_TIMEOUT'] ?? 120);
-
-$authErrors = ['ERROR_WRONG_USER_KEY', 'ERROR_KEY_DOES_NOT_EXIST', 'IP_BANNED'];
-$balanceErrors = ['ERROR_ZERO_BALANCE'];
-$inputErrors = ['ERROR_PAGEURL', 'ERROR_WRONG_GOOGLEKEY', 'ERROR_BAD_PARAMETERS', 'ERROR_BAD_TOKEN_OR_PAGEURL'];
-$transientErrors = ['ERROR_SERVER_ERROR', 'ERROR_INTERNAL_SERVER_ERROR'];
-$solveErrors = ['ERROR_CAPTCHA_UNSOLVABLE'];
-
-// --- Validate configuration ---
-if (empty($apiKey) || $apiKey === 'YOUR_API_KEY') {
-    echo "[!] ERROR: CAPTCHAAI_API_KEY is not set.\n";
-    echo "    Copy .env.example to .env and add your real API key.\n";
-    exit(1);
-}
-
-// --- Submit task ---
-echo "[*] Submitting reCAPTCHA v2 task...\n";
-$submitParams = http_build_query([
-    'key' => $apiKey,
-    'method' => 'userrecaptcha',
-    'googlekey' => $googlekey,
-    'pageurl' => $pageurl,
-    'json' => '1',
-]);
-
-$submitResponse = @file_get_contents(SUBMIT_URL . '?' . $submitParams);
-if ($submitResponse === false) {
-    echo "[!] Network error during submission.\n";
-    exit(1);
-}
-
-$submitData = json_decode($submitResponse, true);
-if (($submitData['status'] ?? 0) !== 1) {
-    $error = $submitData['request'] ?? 'UNKNOWN_ERROR';
-    if (in_array($error, $authErrors)) {
-        echo "[!] Authentication error: $error\n";
-        echo "    Check your API key at https://captchaai.com/dashboard\n";
-    } elseif (in_array($error, $balanceErrors)) {
-        echo "[!] Balance error: $error\n";
-        echo "    Top up your account at https://captchaai.com\n";
-    } elseif (in_array($error, $inputErrors)) {
-        echo "[!] Input error: $error\n";
-        echo "    Verify your sitekey and page URL are correct.\n";
-    } else {
-        echo "[!] Submission failed: $error\n";
-    }
-    exit(1);
-}
-
-$taskId = $submitData['request'];
-echo "[+] Task submitted. ID: $taskId\n";
-
-// --- Poll for result ---
-echo "[*] Waiting 15s before first poll...\n";
-sleep(15);
-
-$elapsed = 15;
-$attempt = 0;
-$backoff = $pollInterval;
-
-while ($elapsed < $maxTimeout) {
-    $attempt++;
-    echo "[*] Polling for result (attempt $attempt)...\n";
-
-    $resultParams = http_build_query([
-        'key' => $apiKey,
-        'action' => 'get',
-        'id' => $taskId,
-        'json' => '1',
-    ]);
-
-    $resultResponse = @file_get_contents(RESULT_URL . '?' . $resultParams);
-    if ($resultResponse === false) {
-        echo "[!] Network error during polling.\n";
-        sleep($backoff);
-        $elapsed += $backoff;
-        $backoff = min($backoff * 2, 30);
-        continue;
-    }
-
-    $resultData = json_decode($resultResponse, true);
-
-    if (($resultData['status'] ?? 0) === 1) {
-        $token = $resultData['request'];
-        echo "[+] Solved! Token: " . substr($token, 0, 50) . "...\n";
-        echo "[+] Full token length: " . strlen($token) . " characters\n";
-        echo "\n";
-        echo "Next step: inject this token into the target page's\n";
-        echo "g-recaptcha-response hidden field and submit the form.\n";
-        exit(0);
-    }
-
-    $error = $resultData['request'] ?? '';
-    if ($error === 'CAPCHA_NOT_READY') {
-        echo "[*] Not ready yet, waiting {$pollInterval}s...\n";
-        sleep($pollInterval);
-        $elapsed += $pollInterval;
-        $backoff = $pollInterval;
-        continue;
-    }
-
-    if (in_array($error, $transientErrors)) {
-        echo "[!] Transient error: $error, retrying in {$backoff}s...\n";
-        sleep($backoff);
-        $elapsed += $backoff;
-        $backoff = min($backoff * 2, 30);
-        continue;
-    }
-
-    if (in_array($error, $solveErrors)) {
-        echo "[!] Solve error: $error\n";
-        echo "    The CAPTCHA could not be solved. Verify parameters and retry.\n";
-        exit(1);
-    }
-
-    echo "[!] Unexpected error: $error\n";
-    exit(1);
-}
-
-echo "[!] Timeout: no solution received within {$maxTimeout} seconds.\n";
-exit(1);
-ENV['CAPTCHA_PAGEURL'] ?? '';
+$googlekey = $_ENV['CAPTCHA_GOOGLEKEY'] ?? '';
+$pageurl = $_ENV['CAPTCHA_PAGEURL'] ?? '';
 $pollInterval = (int)($_ENV['POLL_INTERVAL'] ?? 5);
 $maxTimeout = (int)($_ENV['MAX_TIMEOUT'] ?? 120);
 

articles/abstract-captcha-solver-provider-agnostic/rust/src/main.rs

@@ -73,6 +73,7 @@ fn main() {
     }
 
     // Submit
+    println!("[*] Submitting reCAPTCHA v2 task...");
     let submit_url = format!(
         "https://ocr.captchaai.com/in.php?key={}&method=userrecaptcha&googlekey={}&pageurl={}&json=1",
         urlencoding::encode(&api_key), urlencoding::encode(&googlekey), urlencoding::encode(&pageurl)
@@ -165,4 +166,4 @@ fn main() {
 
     println!("[!] Timeout: no solution received within {} seconds.", max_timeout);
     std::process::exit(1);
-}
+}

articles/academic-research-scraping-captcha-solving/kotlin/solve.kt

@@ -92,8 +92,7 @@ fun main() {
         println("    Copy .env.example to .env and add your real API key.")
         exitProcess(1)
     }
-
-    // Submit — TODO: Change method and add CAPTCHA-specific parameters
+    // Submit
     println("[*] Submitting reCAPTCHA v2 task...")
     val enc = java.nio.charset.StandardCharsets.UTF_8.name()
     val submitParams = "key=${URLEncoder.encode(apiKey, enc)}&method=userrecaptcha&googlekey=${URLEncoder.encode(googlekey, enc)}&pageurl=${URLEncoder.encode(pageurl, enc)}&json=1"