docs: add a README for Spanish Chinese Russian

dzmitry-duboyski · Feb 25, 2023 · 8df3606 · 8df3606
1 parent b40dd08
commit 8df3606
Show file tree

Hide file tree

Showing 3 changed files with 766 additions and 0 deletions.
diff --git a/README.es.md b/README.es.md
@@ -0,0 +1,256 @@
+[English](README.md) | <u><b>[Spanish](README.es.md)</b></u> | [中国语文科](README.zh.md) | [Русский](README.ru.md)
+<p align="center">
+  <img src="https://user-images.githubusercontent.com/38065632/217352869-1f156919-1ab9-4ea2-9bbb-f4a8dcf2a9e1.jpg">
+</p>
+
+![](https://img.shields.io/npm/v/2captcha-ts)
+![](https://img.shields.io/npm/l/2captcha-ts)
+![](https://img.shields.io/github/last-commit/dzmitry-duboyski/2captcha-ts)
+
+
+## Descripción
+Shell para API [2captcha](https://2captcha.com/?from=16653706) Servicio. Este shell soporta la solución de los siguientes tipos de captcha: reCAPTCHA V2, reCAPTCHA V3, hCaptcha, Arkose Labs FunCaptcha, image captcha, Geetest, Geetest V4, Yandex Smart Captcha, Lemin captcha, Amazon WAF, Cloudflare Turnstile.
+
+[2captcha](https://2captcha.com/?from=16653706) es un Servicio que le permite resolver muchos tipos diferentes de captcha.
+Esta biblioteca sirve como un contenedor para la API del Servicio 2captcha para proporcionar a NodeJS una funcionalidad simple basada en `promise`.
+
+## Tipos de captcha admitidos:
+- ✅ google-recaptcha (reCAPTCHA v2 / reCAPTCHA v3)
+- ✅ hCaptcha
+- ✅ Arkose Labs FunCaptcha
+- ✅ base64 image captchas
+- ✅ Geetest
+- ✅ Geetest v4
+- ✅ Yandex Smart Captcha
+- ✅ Lemin Cropped Captcha
+- ✅ Cloudflare Turnstile
+- ✅ Amazon WAF Captcha
+- ⬜ Capy Puzzle
+- ⬜ Click Captcha
+
+## Instalar
+
+```sh
+npm install 2captcha-ts
+```
+```sh
+yarn add 2captcha-ts
+```
+
+## Ejemplos de uso
+
+
+### reCAPTCHA:
+```js
+const Captcha = require("2captcha-ts")
+// Nueva instancia de "solucionador" con su clave API
+const solver = new Captcha.Solver("<Your 2captcha api key>")
+
+// Solución reCAPTCHA, en la página de demostración que contiene reCAPTCHA V2
+solver.recaptcha({
+  pageurl: 'https://2captcha.com/demo/recaptcha-v2',
+  googlekey: '6LfD3PIbAAAAAJs_eEHvoOl75_83eXSqpPSRFJ_u'
+})
+.then((res) => {
+  console.log(res);
+})
+.catch((err) => {
+  console.log(err);
+})
+```
+
+### hCaptcha:
+```js
+const Captcha = require("2captcha-ts")
+const solver = new Captcha.Solver("<Your 2captcha api key>")
+
+solver.hcaptcha({
+  pageurl: "https://2captcha.com/demo/hcaptcha?difficulty=moderate",
+  sitekey: "b76cd927-d266-4cfb-a328-3b03ae07ded6"
+})
+.then((res) => {
+  console.log(res);
+})
+.catch((err) => {
+  console.log(err);
+})
+```
+
+### Arkose Labs FunCaptcha:
+```js
+const Captcha = require("2captcha-ts")
+const solver = new Captcha.Solver("<Your 2captcha api key>")
+
+solver.funCaptcha({
+  pageurl: "https://funcaptcha.com/tile-game-lite-mode/fc/api/nojs/?pkey=804380F4-6844-FFA1-ED4E-5877CA1F1EA4&lang=en",
+  publickey: "804380F4-6844-FFA1-ED4E-5877CA1F1EA4"
+})
+.then((res) => {
+  console.log(res);
+})
+.catch((err) => {
+  console.log(err);
+})
+```
+
+### Image captcha:
+```js
+const Captcha = require("2captcha-ts")
+const fs = require("fs")
+const solver = new Captcha.Solver("<Your 2captcha api key>")
+
+// Obtenemos el contenido del archivo en formato base64
+const imageBase64 = fs.readFileSync("./tests/media/imageCaptcha_6e584.png", "base64")
+
+solver.imageCaptcha(imageBase64, { numeric: 4, min_len: 5, max_len: 5 })
+.then((res) => {
+  console.log(res);
+})
+.catch((err) => {
+  console.log(err);
+})
+```
+
+
+### GeeTest Captcha:
+```js
+const Captcha = require("2captcha-ts")
+const solver = new Captcha.Solver("<Your 2captcha api key>")
+
+// El valor de 'challenge' es dinámico
+// Lea más sobre 'challenge' en la página https://2captcha.com/p/geetest
+solver.geetest({ 
+  pageurl: 'https://2captcha.com/demo/geetest',
+  gt: '81388ea1fc187e0c335c0a8907ff2625',
+  challenge: '<you need to get a new challenge value each time>'
+})
+.then((res) => {
+  console.log(res);
+})
+.catch((err) => {
+  console.log(err);
+})
+```
+
+### GeeTest V4 Captcha:
+```js
+const Captcha = require("2captcha-ts")
+const solver = new Captcha.Solver("<Your 2captcha api key>")
+
+solver.geetestV4({
+  pageurl: 'https://2captcha.com/demo/geetest-v4',
+  captcha_id: 'e392e1d7fd421dc63325744d5a2b9c73'
+})
+.then((res) => {
+  console.log(res);
+})
+.catch((err) => {
+  console.log(err);
+})
+```
+
+### Yandex Smart Captcha:
+```js
+const Captcha = require("2captcha-ts")
+const solver = new Captcha.Solver("<Your 2captcha api key>")
+
+solver.yandexSmart({ 
+  pageurl: "https://captcha-api.yandex.ru/demo",
+  sitekey: "FEXfAbHQsToo97VidNVk3j4dC74nGW1DgdxjtNB9"
+ })
+.then((res) => {
+  console.log(res);
+})
+.catch((err) => {
+  console.log(err);
+})
+```
+
+### Lemin captcha:
+```js
+const Captcha = require("2captcha-ts")
+const solver = new Captcha.Solver("<Your 2captcha api key>")
+
+solver.lemin({
+  pageurl:'https://dashboard.leminnow.com/auth/login', 
+  captcha_id: 'CROPPED_099216d_34698cb7b8574265925f493cbcb3df4d',
+  div_id: 'lemin-cropped-captcha',
+  api_server: 'https://api.leminnow.com/captcha/v1/cropped'
+})
+.then((res) => {
+  console.log(res);
+})
+.catch((err) => {
+  console.log(err);
+})
+```
+
+### Cloudflare Turnstile:
+```js
+const Captcha = require("2captcha-ts")
+const solver = new Captcha.Solver("<Your 2captcha api key>")
+
+solver.cloudflareTurnstile({
+    pageurl: "https://app.nodecraft.com/login",
+    sitekey: "0x4AAAAAAAAkg0s3VIOD10y4"    
+})
+.then((res) => {
+    console.log(res);
+})
+.catch((err) => {
+    console.log(err);
+})
+```
+
+### Amazon WAF Captcha (AWS WAF):
+```js
+const Captcha = require("2captcha-ts")
+const solver = new Captcha.Solver("<Your 2captcha api key>")
+
+// INFO: El valor 'context' es dinámico.  Necesita obtener un valor nuevo de 'context' cada vez.
+solver.amazonWaf({
+  pageurl: "https://non-existent-example.execute-api.us-east-1.amazonaws.com/latest",
+  sitekey: "AQIDAHjcYu/GjX+QlghicBgQ/7bFaQZ+m5FKCMDnO+vTbNg96AHMDLodoefdvyOnsHMRt...",
+  context: "9BUgmlm48F92WUoqv97a49ZuEJJ50TCk9MVr3C7WMtQ0X6flVbufM4n8mjFLmbLVAPgaQ...",
+  iv: "CgAHbCe2GgAAAAAj",
+})
+.then((res) => {
+  console.log(res);
+})
+.catch((err) => {
+  console.log(err);
+})
+```
+
+### Proxy:
+```js
+const Captcha = require("2captcha-ts")
+const solver = new Captcha.Solver("<Your 2captcha api key>")
+
+solver.recaptcha({
+  pageurl: 'https://2captcha.com/demo/recaptcha-v2',
+  googlekey: '6LfD3PIbAAAAAJs_eEHvoOl75_83eXSqpPSRFJ_u',
+  proxy: "login:[email protected]", // Configuración del servidor proxy que está utilizando
+  proxytype: "HTTP" // Tipo de proxy utilizado: `HTTP`, `HTTPS`, `SOCKS4`, `SOCKS5`.
+})
+.then((res) => {
+  console.log(res)
+})
+.catch((err) => {
+  console.error(err.message)
+})
+```
+---
+
+## Artículos útiles
+* [Cómo resolver el captcha Geetest v4](https://2captcha.com/ru/blog/geetest-v4-obkhod?from=16653706)
+* [Solución automática reCAPTCHA V3-instrucciones para desarrolladores y clientes](https://2captcha.com/en/blog/avtomaticheskoe-reshenie-recaptcha-v3?from=16653706)
+* <a href="./docs/hcaptcha.md">Buscar el valor de `sitekey` para hCaptcha</a>
+
+---
+## Ejemplos de uso con código fuente y descripción
+* [Solución de captcha GeeTest usando Puppeteer](https://github.com/dzmitry-duboyski/GeeTest-demo)
+
+---
+
+Este proyecto es una bifurcación [de este paquete](https://www.npmjs.com/package/2captcha ). En esta versión del paquete, se agregó soporte para nuevos tipos de captcha y se cambió la forma de pasar los parámetros de captcha. Los parámetros de captcha ahora se pasan como un objeto ({parámetro: valor}). Así como otros cambios cosméticos.  Puede Leer más sobre los cambios realizados [aquí](https://github.com/dzmitry-duboyski/2captcha-ts/releases).