Automatic Yandex SmartCaptcha Solver with 2captcha

Automated script for solving Yandex coordinate captchas using Puppeteer and 2captcha service.

🚀 Features

• ✅ Automatic captcha image interception (main image + instructions)
• ✅ Submission for recognition to 2captcha service
• ✅ Automatic clicks on received coordinates
• ✅ Works with captcha iframe
• ✅ Captcha solution confirmation

📋 Requirements

• Node.js 16+
• npm or yarn
• 2captcha.com API key

🛠 Installation

1. Clone the repository

git clone <repository-url>
cd yandex-captcha-solver

2. Install dependencies

npm install puppeteer 2captcha-ts dotenv

3. Create .env file

API_KEY=your_2captcha_api_key_here

4. Get API key
   • Register at 2captcha.com
   • Get your API key from user dashboard
   • Add it to .env file

🎯 Usage

npm start

or

node index.js

🔧 How it works

1. Captcha image interception

Script automatically intercepts requests to smartcaptcha.yandexcloud.net and saves:

• img.png - main captcha image
• task.png - instruction image

2. Submit for recognition

Images are sent to 2captcha with coordinates type:

const anser = await solver.coordinates({
  body: imageBase64,
  imginstructions: taskBase64,
})

3. Getting coordinates

2captcha returns an array of coordinates for clicks:

[
  { x: '254', y: '99' },
  { x: '173', y: '126' },
  { x: '273', y: '35' },
  { x: '74', y: '131' }
]

4. Automatic clicks

Script clicks on each coordinate inside captcha iframe:

• Finds iframe with captcha
• Calculates absolute coordinates on page
• Executes clicks with pauses between them
• Confirms the solution

⚙️ Configuration

Browser window size

const browser = await puppeteer.launch({
    headless: false,
    defaultViewport: { width: 1280, height: 920 },
    args: ['--window-size=1280,920']
});

Pause between clicks

await delay(500); // 500ms between clicks

Element selectors

• Captcha iframe: 'iframe[data-testid="advanced-iframe"]'
• Image: '.AdvancedCaptcha-ImageWrapper img'
• Confirm button: '.CaptchaButton-ProgressWrapper'

📁 Project structure

yandex-captcha-solver/
├── index.js           # Main script
├── temp/              # Folder with saved images
│   ├── img.png        # Main captcha image
│   └── task.png       # Captcha instructions
├── .env               # Environment variables
├── package.json       # Project dependencies
└── README.md         # Documentation

🎮 Main functions

clickAllCoordinates(page, iframeSelector, imageSelector, coordinates)

Executes clicks on all received coordinates with pauses between them.

clickInIframeRelativeToElement(page, iframeSelector, imageSelector, offsetX, offsetY)

Executes one click at relative coordinates inside iframe.

getBase64(fileName)

Reads image from temp folder and converts to base64.

📝 Usage example

// 1. Image interception happens automatically
// 2. Getting coordinates from 2captcha
const coordinates = await solver.coordinates({
  body: imageBase64,
  imginstructions: taskBase64,
});

// 3. Clicks on all coordinates
await clickAllCoordinates(
  page, 
  'iframe[data-testid="advanced-iframe"]', 
  '.AdvancedCaptcha-ImageWrapper img', 
  coordinates.data
);

// 4. Solution confirmation
await clickInIframeRelativeToElement(
  page, 
  'iframe[data-testid="advanced-iframe"]', 
  '.CaptchaButton-ProgressWrapper', 
  5, 5
);

⚠️ Important notes

1. Coordinates from 2captcha come relative to captcha image
2. Script automatically calculates absolute coordinates on page
3. Make sure to wait for complete iframe loading before clicking
4. Use real API key from 2captcha for it to work

🔍 Debugging

• Images are saved to temp/ folder
• Coordinates are displayed in console
• Browser runs in visible mode (headless: false)
• All clicks are logged with coordinates

💰 Cost

• Solving one coordinate captcha: ~$0.003
• 1000 captchas: ~$3

📄 License

This project was created for educational purposes only. Use responsibly and in accordance with website terms of service.