### Install Captcha Tools Go Package

Source: https://github.com/matthew17-21/captcha-tools/blob/main/captchatools-go/README.md

Use 'go get' to install the Captcha Tools Go package. To update to the latest version, use the '-u' flag.

```go
go get github.com/Matthew17-21/Captcha-Tools/captchatools-go
```

```go
go get -u github.com/Matthew17-21/Captcha-Tools/captchatools-go
```

--------------------------------

### Error Handling Example

Source: https://github.com/matthew17-21/captcha-tools/blob/main/captchatools-go/README.md

Demonstrates how to initialize a captcha harvester and handle potential errors, including specific captcha tool errors.

```go
package main

import (
	"fmt"

	captchatools "github.com/Matthew17-21/Captcha-Tools/captchatools-go"
)

func main() {
	solver, err := captchatools.NewHarvester(captchatools.CapmonsterSite, &captchatools.Config{
		Api_key:     "ENTER YOUR API KEY HERE",
		Sitekey:     "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
		CaptchaURL:  "https://www.google.com/recaptcha/api2/demo",
		CaptchaType: captchatools.V2Captcha,
	})
	if err != nil {
		...
	}
	answer, err := solver.GetToken()
	if err != nil {
		switch err {
		case captchatools.ErrBanned:
			...
		case captchatools.ErrAddionalDataMissing:
			...
		}
	}
}
```

--------------------------------

### Install Captcha Tools

Source: https://github.com/matthew17-21/captcha-tools/blob/main/README.md

Install the Captcha Tools library using pip.

```python
pip3 install captchatools
```

--------------------------------

### Solve Captcha with Additional Data

Source: https://github.com/matthew17-21/captcha-tools/blob/main/captchatools-go/README.md

Example demonstrating how to solve a captcha with additional data, including proxy and user agent. This is useful for bypassing certain restrictions.

```go
package main

import (
	"fmt"

	captchatools "github.com/Matthew17-21/Captcha-Tools/captchatools-go"
)

func addtional_data() {
	solver, err := captchatools.NewHarvester(captchatools.CapmonsterSite, &captchatools.Config{
		Api_key:     "ENTER YOUR API KEY HERE",
		Sitekey:     "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
		CaptchaURL:  "https://www.google.com/recaptcha/api2/demo",
		CaptchaType: captchatools.V2Captcha,
	})
	if err != nil {
		panic(err)
	}

	// The following data is OPTIONAL and is not required to solve captchas
	proxy, err := captchatools.NewProxy("IP:PORT:USER:PASS")
	answer, err := solver.GetToken(&captchatools.AdditionalData{
		B64Img:    "BASE64_ENCODED_IMAGE",
		Proxy:     proxy,
		ProxyType: "http",
		UserAgent: "SOME_USER_AGENT",
	})
	if err != nil {
		switch err {
		case captchatools.ErrBanned:
		case captchatools.ErrAddionalDataMissing:
		}
	}

	fmt.Println("Captcha ID:", answer.Id())
	fmt.Println("Captcha token:", answer.Token)

	// ........Use captcha token......
	answer.Report(true) // report good
	// or
	answer.Report(false) // report bad / request refund

}

```

--------------------------------

### Solve Captcha with Additional Data

Source: https://github.com/matthew17-21/captcha-tools/blob/main/README.md

This example shows how to pass additional parameters like proxy and user agent when solving a captcha. This can be useful for mimicking real user behavior.

```python
from captchatools import new_harvester

def main():
    harvester = new_harvester(
        api_key="CHANGE THIS", 
        solving_site="capsolver",
        captcha_type="v2",
        sitekey="6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
        captcha_url="https://www.google.com/recaptcha/api2/demo"
    )
    
    token = harvester.get_token(
        proxy="ip:port:user:pass", 
        proxy_type="http", 
        user_agent="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/108.0.0.0 Safari/537.36"
    )
```

--------------------------------

### Solve V3 Captcha with Anticaptcha

Source: https://github.com/matthew17-21/captcha-tools/blob/main/captchatools-go/README.md

Example for solving a V3 Captcha using Anticaptcha. Includes optional action and minimum score parameters. Reports the result of the captcha solving.

```go
func v3Example() {
	solver, err := captchatools.NewHarvester(captchatools.AnticaptchaSite, &captchatools.Config{
		Api_key:     "ENTER YOUR API KEY HERE",
		Sitekey:     "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
		CaptchaURL:  "..........",
		CaptchaType: captchatools.V3Captcha,
		Action:      "submit",
		MinScore:    0.9,
	})
	if err != nil {
		panic(err)
	}
	answer, err := solver.GetToken()
	if err != nil {
		switch err {
		case captchatools.ErrBanned:
		case captchatools.ErrAddionalDataMissing:
		}
	}

	fmt.Println("Captcha ID:", answer.Id())
	fmt.Println("Captcha token:", answer.Token)

	// ........Use captcha token......
	answer.Report(true) // report good
	// or
	answer.Report(false) // report bad / request refund

}

```

--------------------------------

### Solve Image Captcha with Capmonster

Source: https://github.com/matthew17-21/captcha-tools/blob/main/captchatools-go/README.md

Example for solving an image captcha using Capmonster. Requires the captcha image to be base64 encoded. Reports the result of the captcha solving.

```go
package main

import (
	"fmt"

	captchatools "github.com/Matthew17-21/Captcha-Tools/captchatools-go"
)

func image_captcha() {
	solver, err := captchatools.NewHarvester(captchatools.CapmonsterSite, &captchatools.Config{
		Api_key:     "ENTER YOUR API KEY HERE",
		CaptchaType: captchatools.ImageCaptcha,
	})
	if err != nil {
		panic(err)
	}

	answer, err := solver.GetToken(&captchatools.AdditionalData{
		B64Img: "BASE64_ENCODED_IMAGE",
	})
	if err != nil {
		switch err {
		case captchatools.ErrBanned:
		case captchatools.ErrAddionalDataMissing:
		}
	}

	fmt.Println("Captcha ID:", answer.Id())
	fmt.Println("Captcha token:", answer.Token)

	// ........Use captcha token......
	answer.Report(true) // report good
	// or
	answer.Report(false) // report bad / request refund

}

```

--------------------------------

### Solve reCAPTCHA v3

Source: https://github.com/matthew17-21/captcha-tools/blob/main/README.md

This example demonstrates solving a reCAPTCHA v3. It requires an API key, solving site, captcha type, sitekey, captcha URL, and optionally an action and minimum score.

```python
from captchatools import new_harvester

def main():
    harvester = new_harvester(
    
        api_key="CHANGE THIS", 
        solving_site="capsolver",
        
        captcha_type="v3",
        sitekey="6LcR_okUAAAAAPYrPe-HK_0RULO1aZM15ENyM-Mf",
        captcha_url="https://antcpt.com/score_detector/",
        action="homepage",
        min_score=0.7
    )
    token = harvester.get_token()
```

--------------------------------

### Basic Captcha Solving with Captcha Tools Go

Source: https://github.com/matthew17-21/captcha-tools/blob/main/captchatools-go/README.md

Demonstrates basic usage of the Captcha Tools Go package to solve a reCAPTCHA v2. It shows how to initialize the solver, retrieve a captcha token, and report the answer.

```go
package main

import (
	"fmt"

	captchatools "github.com/Matthew17-21/Captcha-Tools/captchatools-go"
)

func main() {
	solver, err := captchatools.NewHarvester(captchatools.CapmonsterSite, &captchatools.Config{
		Api_key:     "ENTER YOUR API KEY HERE",
		Sitekey:     "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
		CaptchaURL:  "https://www.google.com/recaptcha/api2/demo",
		CaptchaType: captchatools.V2Captcha,
	})
	if err != nil {
		...
	}
	answer, err := solver.GetToken()
	if err != nil {
		switch err {
		case captchatools.ErrBanned:
			...
		case captchatools.ErrAddionalDataMissing:
			...
		}
	}

	fmt.Println("Captcha ID:", answer.Id())
	fmt.Println("Captcha token:", answer.Token)

	// ........Use captcha token......
	answer.Report(true) // report good
	// or
	answer.Report(false) // report bad / request refund
}
```

--------------------------------

### Basic Usage with Site ID

Source: https://github.com/matthew17-21/captcha-tools/blob/main/README.md

Initialize the harvester using a site ID for the solving service and retrieve a captcha token. This method is an alternative to using the site name.

```python
from captchatools import new_harvester
solver = new_harvester(solving_site=1, api_key="YOUR API KEY", sitekey="6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-", captcha_url="https://www.google.com/recaptcha/api2/demo")
captcha_answer = solver.get_token()
```

--------------------------------

### Basic Usage with Capmonster

Source: https://github.com/matthew17-21/captcha-tools/blob/main/README.md

Initialize the harvester for Capmonster and retrieve a captcha token. Ensure you have the correct API key, sitekey, and captcha URL.

```python
import captchatools
solver = captchatools.new_harvester(solving_site="capmonster", api_key="YOUR API KEY", sitekey="6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-", captcha_url="https://www.google.com/recaptcha/api2/demo")
captcha_answer = solver.get_token()
```

--------------------------------

### Solve V2 Captcha with Capmonster

Source: https://github.com/matthew17-21/captcha-tools/blob/main/captchatools-go/README.md

Basic usage for solving a V2 Captcha using Capmonster. Requires API key, sitekey, URL, and captcha type. Reports the result of the captcha solving.

```go
package main

import (
	"fmt"

	captchatools "github.com/Matthew17-21/Captcha-Tools/captchatools-go"
)

func main() {
	solver, err := captchatools.NewHarvester(captchatools.CapmonsterSite, &captchatools.Config{
		Api_key:     "ENTER YOUR API KEY HERE",
		Sitekey:     "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
		CaptchaURL:  "https://www.google.com/recaptcha/api2/demo",
		CaptchaType: captchatools.V2Captcha,
	})
	if err != nil {
		...
	}
	answer, err := solver.GetToken()
	if err != nil {
		switch err {
		case captchatools.ErrBanned:
			...
		case captchatools.ErrAddionalDataMissing:
			...
		}
	}

	fmt.Println("Captcha ID:", answer.Id())
	fmt.Println("Captcha token:", answer.Token)

	// ........Use captcha token......
	answer.Report(true) // report good
	// or
	answer.Report(false) // report bad / request refund
}

```

--------------------------------

### Handle NoHarvesterException in Python

Source: https://github.com/matthew17-21/captcha-tools/blob/main/README.md

Use this snippet to catch and handle the `NoHarvesterException` when initializing a new captcha harvester. Ensure you have imported the necessary modules from `captchatools`.

```python
from captchatools import new_harvester, exceptions as captchaExceptions

def main():
    try:
        harvester = new_harvester()
        token = harvester.get_token()
    except captchaExceptions.NoHarvesterException:
        print("I need to set my captcha harvester!")
```

--------------------------------

### Update Captcha Tools

Source: https://github.com/matthew17-21/captcha-tools/blob/main/README.md

Update the Captcha Tools library to the latest version using pip.

```python
pip3 install -U captchatools
```

--------------------------------

### Solve reCAPTCHA v2

Source: https://github.com/matthew17-21/captcha-tools/blob/main/README.md

Use this snippet to solve a reCAPTCHA v2 challenge. Ensure you replace 'CHANGE THIS' with your actual API key and provide the correct sitekey and captcha_url.

```python
from captchatools import new_harvester

def main():
    harvester = new_harvester(
        api_key="CHANGE THIS", 
        solving_site="capsolver",
        captcha_type="v2",
        sitekey="6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
        captcha_url="https://www.google.com/recaptcha/api2/demo"
    )
    answer = harvester.get_token()
```

--------------------------------

### Solve Image Captcha

Source: https://github.com/matthew17-21/captcha-tools/blob/main/README.md

Solve an image captcha by providing the base64 encoded image. This snippet requires an API key and the solving site configuration.

```python
from captchatools import new_harvester

def main():
    harvester = new_harvester(
        api_key="CHANGE THIS", 
        solving_site="capsolver",
        captcha_type="image",
    )
    token = harvester.get_token(b64_img="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")
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.