Add example templates for various programming languages (Bash, C#, Go, Kotlin, Ruby, Rust) demonstrating CAPTCHA solving using the CaptchaAI API, including environment variable handling and error classification.

Author: bshahin

templates/bash-basic/solve.sh

@@ -0,0 +1,164 @@
+#!/usr/bin/env bash
+# Solve {CAPTCHA_TYPE} using the CaptchaAI API.
+#
+# Usage:
+#   chmod +x solve.sh
+#   ./solve.sh
+#
+# Requires .env file in parent directory with:
+#   CAPTCHAAI_API_KEY and CAPTCHA-specific variables
+#
+# Dependencies: curl, jq
+
+set -euo pipefail
+
+SUBMIT_URL="https://ocr.captchaai.com/in.php"
+RESULT_URL="https://ocr.captchaai.com/res.php"
+
+# Load .env file
+ENV_FILE="$(dirname "$0")/../.env"
+if [[ -f "$ENV_FILE" ]]; then
+    while IFS='=' read -r key value; do
+        key=$(echo "$key" | xargs)
+        [[ -z "$key" || "$key" == \#* ]] && continue
+        value=$(echo "$value" | xargs)
+        export "$key=$value"
+    done < "$ENV_FILE"
+fi
+
+CAPTCHAAI_API_KEY="${CAPTCHAAI_API_KEY:-}"
+# TODO: Add CAPTCHA-specific variables here
+POLL_INTERVAL="${POLL_INTERVAL:-5}"
+MAX_TIMEOUT="${MAX_TIMEOUT:-120}"
+
+AUTH_ERRORS="ERROR_WRONG_USER_KEY ERROR_KEY_DOES_NOT_EXIST IP_BANNED"
+BALANCE_ERRORS="ERROR_ZERO_BALANCE"
+INPUT_ERRORS="ERROR_PAGEURL ERROR_WRONG_GOOGLEKEY ERROR_BAD_PARAMETERS ERROR_BAD_TOKEN_OR_PAGEURL"
+TRANSIENT_ERRORS="ERROR_SERVER_ERROR ERROR_INTERNAL_SERVER_ERROR"
+SOLVE_ERRORS="ERROR_CAPTCHA_UNSOLVABLE"
+PROXY_ERRORS="ERROR_BAD_PROXY ERROR_PROXY_CONNECTION_FAILED"
+
+contains() { [[ " $1 " == *" $2 "* ]]; }
+
+classify_error() {
+    local error="$1"
+    if contains "$AUTH_ERRORS" "$error"; then
+        echo "[!] Authentication error: $error"
+        echo "    Check your API key at https://captchaai.com/dashboard"
+    elif contains "$BALANCE_ERRORS" "$error"; then
+        echo "[!] Balance error: $error"
+        echo "    Top up your account at https://captchaai.com"
+    elif contains "$INPUT_ERRORS" "$error"; then
+        echo "[!] Input error: $error"
+        echo "    Verify your sitekey and page URL are correct."
+    elif contains "$PROXY_ERRORS" "$error"; then
+        echo "[!] Proxy error: $error"
+        echo "    Check your proxy configuration or try a different proxy."
+    else
+        echo "[!] Submission failed: $error"
+    fi
+}
+
+# Validate
+if [[ -z "$CAPTCHAAI_API_KEY" || "$CAPTCHAAI_API_KEY" == "YOUR_API_KEY" ]]; then
+    echo "[!] ERROR: CAPTCHAAI_API_KEY is not set."
+    echo "    Copy .env.example to .env and add your real API key."
+    exit 1
+fi
+
+# Check dependencies
+if ! command -v jq &> /dev/null; then
+    echo "[!] ERROR: jq is required but not installed."
+    echo "    Install it: apt-get install jq / brew install jq / choco install jq"
+    exit 1
+fi
+
+# Submit
+echo "[*] Submitting CAPTCHA task..."
+# TODO: Change method and add CAPTCHA-specific parameters
+SUBMIT_RESPONSE=$(curl -s --max-time 30 \
+    "${SUBMIT_URL}?key=${CAPTCHAAI_API_KEY}&method=userrecaptcha&json=1")
+
+if [[ -z "$SUBMIT_RESPONSE" ]]; then
+    echo "[!] Network error during submission."
+    exit 1
+fi
+
+SUBMIT_STATUS=$(echo "$SUBMIT_RESPONSE" | jq -r '.status // 0')
+SUBMIT_REQUEST=$(echo "$SUBMIT_RESPONSE" | jq -r '.request // "UNKNOWN_ERROR"')
+
+if [[ "$SUBMIT_STATUS" != "1" ]]; then
+    classify_error "$SUBMIT_REQUEST"
+    exit 1
+fi
+
+TASK_ID="$SUBMIT_REQUEST"
+echo "[+] Task submitted. ID: $TASK_ID"
+
+# Poll
+echo "[*] Waiting 15s before first poll..."
+sleep 15
+
+ELAPSED=15
+ATTEMPT=0
+BACKOFF=$POLL_INTERVAL
+
+while [[ $ELAPSED -lt $MAX_TIMEOUT ]]; do
+    ATTEMPT=$((ATTEMPT + 1))
+    echo "[*] Polling for result (attempt $ATTEMPT)..."
+
+    POLL_RESPONSE=$(curl -s --max-time 30 \
+        "${RESULT_URL}?key=${CAPTCHAAI_API_KEY}&action=get&id=${TASK_ID}&json=1" 2>/dev/null || echo "")
+
+    if [[ -z "$POLL_RESPONSE" ]]; then
+        echo "[!] Network error during polling."
+        sleep "$BACKOFF"
+        ELAPSED=$((ELAPSED + BACKOFF))
+        BACKOFF=$((BACKOFF * 2))
+        [[ $BACKOFF -gt 30 ]] && BACKOFF=30
+        continue
+    fi
+
+    POLL_STATUS=$(echo "$POLL_RESPONSE" | jq -r '.status // 0')
+    POLL_REQUEST=$(echo "$POLL_RESPONSE" | jq -r '.request // ""')
+
+    if [[ "$POLL_STATUS" == "1" ]]; then
+        TOKEN="$POLL_REQUEST"
+        TRUNCATED="${TOKEN:0:50}"
+        echo "[+] Solved! Token: ${TRUNCATED}..."
+        echo "[+] Full token length: ${#TOKEN} characters"
+        exit 0
+    fi
+
+    if [[ "$POLL_REQUEST" == "CAPCHA_NOT_READY" ]]; then
+        echo "[*] Not ready yet, waiting ${POLL_INTERVAL}s..."
+        sleep "$POLL_INTERVAL"
+        ELAPSED=$((ELAPSED + POLL_INTERVAL))
+        BACKOFF=$POLL_INTERVAL
+        continue
+    fi
+    if contains "$TRANSIENT_ERRORS" "$POLL_REQUEST"; then
+        echo "[!] Transient error: $POLL_REQUEST, retrying in ${BACKOFF}s..."
+        sleep "$BACKOFF"
+        ELAPSED=$((ELAPSED + BACKOFF))
+        BACKOFF=$((BACKOFF * 2))
+        [[ $BACKOFF -gt 30 ]] && BACKOFF=30
+        continue
+    fi
+    if contains "$SOLVE_ERRORS" "$POLL_REQUEST"; then
+        echo "[!] Solve error: $POLL_REQUEST"
+        echo "    The CAPTCHA could not be solved. Verify parameters and retry."
+        exit 1
+    fi
+    if contains "$PROXY_ERRORS" "$POLL_REQUEST"; then
+        echo "[!] Proxy error: $POLL_REQUEST"
+        echo "    Check your proxy configuration or try a different proxy."
+        exit 1
+    fi
+
+    echo "[!] Unexpected error: $POLL_REQUEST"
+    exit 1
+done
+
+echo "[!] Timeout: no solution received within ${MAX_TIMEOUT} seconds."
+exit 1

templates/csharp-basic/Solve.cs

@@ -0,0 +1,187 @@
+// Solve {CAPTCHA_TYPE} using the CaptchaAI API.
+//
+// Usage:
+//   dotnet run
+//
+// Requires .env file in parent directory with:
+//   CAPTCHAAI_API_KEY and CAPTCHA-specific variables
+
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Net.Http;
+using System.Text.Json;
+using System.Threading.Tasks;
+
+class Solve
+{
+    private const string SubmitUrl = "https://ocr.captchaai.com/in.php";
+    private const string ResultUrl = "https://ocr.captchaai.com/res.php";
+
+    private static readonly HashSet<string> AuthErrors = new()
+        { "ERROR_WRONG_USER_KEY", "ERROR_KEY_DOES_NOT_EXIST", "IP_BANNED" };
+    private static readonly HashSet<string> BalanceErrors = new()
+        { "ERROR_ZERO_BALANCE" };
+    private static readonly HashSet<string> InputErrors = new()
+        { "ERROR_PAGEURL", "ERROR_WRONG_GOOGLEKEY", "ERROR_BAD_PARAMETERS", "ERROR_BAD_TOKEN_OR_PAGEURL" };
+    private static readonly HashSet<string> TransientErrors = new()
+        { "ERROR_SERVER_ERROR", "ERROR_INTERNAL_SERVER_ERROR" };
+    private static readonly HashSet<string> SolveErrors = new()
+        { "ERROR_CAPTCHA_UNSOLVABLE" };
+    private static readonly HashSet<string> ProxyErrors = new()
+        { "ERROR_BAD_PROXY", "ERROR_PROXY_CONNECTION_FAILED" };
+
+    private static readonly HttpClient Client = new() { Timeout = TimeSpan.FromSeconds(30) };
+
+    private readonly string _apiKey;
+    private readonly int _pollInterval;
+    private readonly int _maxTimeout;
+    // TODO: Add CAPTCHA-specific fields
+
+    public Solve(Dictionary<string, string> env)
+    {
+        _apiKey = GetEnv(env, "CAPTCHAAI_API_KEY", "");
+        // TODO: Add CAPTCHA-specific environment variables
+        _pollInterval = int.Parse(GetEnv(env, "POLL_INTERVAL", "5"));
+        _maxTimeout = int.Parse(GetEnv(env, "MAX_TIMEOUT", "120"));
+    }
+
+    private static string GetEnv(Dictionary<string, string> env, string key, string fallback)
+    {
+        if (env.TryGetValue(key, out var val) && !string.IsNullOrEmpty(val)) return val;
+        var sysVal = Environment.GetEnvironmentVariable(key);
+        return !string.IsNullOrEmpty(sysVal) ? sysVal : fallback;
+    }
+
+    private void ValidateConfig()
+    {
+        if (string.IsNullOrEmpty(_apiKey) || _apiKey == "YOUR_API_KEY")
+        {
+            Console.WriteLine("[!] ERROR: CAPTCHAAI_API_KEY is not set.");
+            Console.WriteLine("    Copy .env.example to .env and add your real API key.");
+            Environment.Exit(1);
+        }
+    }
+
+    private async Task<string> SubmitTaskAsync()
+    {
+        Console.WriteLine("[*] Submitting CAPTCHA task...");
+        var query = $"key={Uri.EscapeDataString(_apiKey)}" +
+                    $"&method=userrecaptcha" + // TODO: Change method for your CAPTCHA type
+                    // TODO: Add CAPTCHA-specific parameters
+                    $"&json=1";
+
+        string body;
+        try { body = await Client.GetStringAsync($"{SubmitUrl}?{query}"); }
+        catch (Exception ex)
+        {
+            Console.WriteLine($"[!] Network error during submission: {ex.Message}");
+            Environment.Exit(1); return "";
+        }
+
+        using var doc = JsonDocument.Parse(body);
+        var root = doc.RootElement;
+        var status = root.GetProperty("status").GetInt32();
+        var request = root.GetProperty("request").ToString();
+
+        if (status != 1) { ClassifyError(request); Environment.Exit(1); }
+
+        Console.WriteLine($"[+] Task submitted. ID: {request}");
+        return request;
+    }
+
+    private async Task<string> PollResultAsync(string taskId)
+    {
+        Console.WriteLine("[*] Waiting 15s before first poll...");
+        await Task.Delay(15000);
+
+        var query = $"key={Uri.EscapeDataString(_apiKey)}&action=get&id={Uri.EscapeDataString(taskId)}&json=1";
+        var elapsed = 15; var attempt = 0; var backoff = _pollInterval;
+
+        while (elapsed < _maxTimeout)
+        {
+            attempt++;
+            Console.WriteLine($"[*] Polling for result (attempt {attempt})...");
+
+            string body;
+            try { body = await Client.GetStringAsync($"{ResultUrl}?{query}"); }
+            catch (Exception ex)
+            {
+                Console.WriteLine($"[!] Network error during polling: {ex.Message}");
+                await Task.Delay(backoff * 1000);
+                elapsed += backoff; backoff = Math.Min(backoff * 2, 30); continue;
+            }
+
+            using var doc = JsonDocument.Parse(body);
+            var root = doc.RootElement;
+            var status = root.GetProperty("status").GetInt32();
+            var request = root.GetProperty("request").ToString();
+
+            if (status == 1) return request;
+            if (request == "CAPCHA_NOT_READY")
+            {
+                Console.WriteLine($"[*] Not ready yet, waiting {_pollInterval}s...");
+                await Task.Delay(_pollInterval * 1000);
+                elapsed += _pollInterval; backoff = _pollInterval; continue;
+            }
+            if (TransientErrors.Contains(request))
+            {
+                Console.WriteLine($"[!] Transient error: {request}, retrying in {backoff}s...");
+                await Task.Delay(backoff * 1000);
+                elapsed += backoff; backoff = Math.Min(backoff * 2, 30); continue;
+            }
+            if (SolveErrors.Contains(request))
+            {
+                Console.WriteLine($"[!] Solve error: {request}");
+                Console.WriteLine("    The CAPTCHA could not be solved. Verify parameters and retry.");
+                Environment.Exit(1);
+            }
+            if (ProxyErrors.Contains(request))
+            {
+                Console.WriteLine($"[!] Proxy error: {request}");
+                Console.WriteLine("    Check your proxy configuration or try a different proxy.");
+                Environment.Exit(1);
+            }
+            Console.WriteLine($"[!] Unexpected error: {request}");
+            Environment.Exit(1);
+        }
+
+        Console.WriteLine($"[!] Timeout: no solution received within {_maxTimeout} seconds.");
+        Environment.Exit(1); return "";
+    }
+
+    private static void ClassifyError(string error)
+    {
+        if (AuthErrors.Contains(error)) { Console.WriteLine($"[!] Authentication error: {error}"); Console.WriteLine("    Check your API key at https://captchaai.com/dashboard"); }
+        else if (BalanceErrors.Contains(error)) { Console.WriteLine($"[!] Balance error: {error}"); Console.WriteLine("    Top up your account at https://captchaai.com"); }
+        else if (InputErrors.Contains(error)) { Console.WriteLine($"[!] Input error: {error}"); Console.WriteLine("    Verify your sitekey and page URL are correct."); }
+        else if (ProxyErrors.Contains(error)) { Console.WriteLine($"[!] Proxy error: {error}"); Console.WriteLine("    Check your proxy configuration or try a different proxy."); }
+        else Console.WriteLine($"[!] Submission failed: {error}");
+    }
+
+    private static Dictionary<string, string> LoadEnv(string path)
+    {
+        var env = new Dictionary<string, string>();
+        if (!File.Exists(path)) return env;
+        foreach (var line in File.ReadAllLines(path))
+        {
+            var trimmed = line.Trim();
+            if (string.IsNullOrEmpty(trimmed) || trimmed.StartsWith('#')) continue;
+            var idx = trimmed.IndexOf('=');
+            if (idx > 0) env[trimmed[..idx].Trim()] = trimmed[(idx + 1)..].Trim();
+        }
+        return env;
+    }
+
+    public static async Task Main(string[] args)
+    {
+        var env = LoadEnv(Path.Combine("..", ".env"));
+        var solver = new Solve(env);
+        solver.ValidateConfig();
+        var taskId = await solver.SubmitTaskAsync();
+        var token = await solver.PollResultAsync(taskId);
+        var truncated = token.Length > 50 ? token[..50] : token;
+        Console.WriteLine($"[+] Solved! Token: {truncated}...");
+        Console.WriteLine($"[+] Full token length: {token.Length} characters");
+    }
+}

templates/csharp-basic/Solve.csproj

@@ -0,0 +1,6 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net8.0</TargetFramework>
+  </PropertyGroup>
+</Project>

templates/go-basic/go.mod

@@ -0,0 +1,3 @@
+module captchaai-example
+
+go 1.21