metabypass 1.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: f0ad3d48024bd85160f515e01c3612488d95bb60c0531d6a5a1755da75001c2a
+  data.tar.gz: 87971080bf27a6f8dbcdeb348fb300a4d896955868d5d47a10a334eb52ee7961
+SHA512:
+  metadata.gz: a55e774b450f99b2b99f14fffdc4974bd70dacaa996c039af34a05532ac983b04ed54b2d550c75764dc4bd061ecb34a53e2834e44e1274f521c792cbd29e448a
+  data.tar.gz: 2a1b25bd7099804c6d0873ecf58e38acbe83d6b79886d104259a6dae6739b647c705bd2ca495a43b979ce2b346f261a00c1e8bda6e731014fa3ff7587ca72b64

data/.gitignore

@@ -0,0 +1,2 @@
+*.gem
+*.token

data/GemFile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+

data/GemFile.lock

@@ -0,0 +1,11 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+
+PLATFORMS
+  x64-mingw-ucrt
+
+DEPENDENCIES
+
+BUNDLED WITH
+   2.4.14

data/README.md

@@ -0,0 +1,141 @@
+# MetaBypass ( AI Captcha Solver )
+## Ruby class to work with [MetaBypass](https://metabypass.tech) services
+
+Free demo (no credit card required) -> https://app.metabypass.tech/application
+
+<br/>
+
+### Features
+
+Solve image captcha , reCaptcha v2 & v3 <br/>
+Auto handler for reCaptcha v2 <br/>
+Simple syntax <br/>
+Error logger <br/>
+
+<br/>
+<br/>
+
+## Install via gem
+
+Go to your project root directory and run this command in terminal:
+
+<br/>
+
+```
+gem install metabypass
+```
+
+<br/>
+<br/>
+
+
+## Usage
+
+<br/>
+
+**Image Captcha** <br />
+ ```ruby
+require 'metabypass'
+
+
+# ---------------------------- CREDENTIALS -----------------------------
+#get your credentials from https://app.metabypass.tech/application
+
+client_id = 'YOUR_CLIENT_ID'
+client_secret = 'YOUR_CLIENT_SECRET'
+email = 'YOUR_EMAIL'
+password = 'YOUR_PASSWORD'
+
+
+# Metabypass instance
+metabypass = Metabypass.new(client_id,client_secret,email,password)
+
+# ----------------------------IMAGE CAPTCHA SAMPLE -----------------------------
+#you can pass base64 encoded image file or path of image file
+img="samples/icaptcha1.jpg"
+#you can pass some optional params too. more details: https://app.metabypass.tech/docs.html?#api_3
+numeric=0; #default
+min_len=0;  #default
+max_len=0;  #default
+image_captcha= metabypass.image_captcha(img,numeric,min_len,max_len)
+puts metabypass.end_result
+ ```
+<br/><br/>
+
+**reCaptcha v2** <br />
+ ```ruby
+require 'metabypass'
+
+
+# ---------------------------- CREDENTIALS -----------------------------
+#get your credentials from https://app.metabypass.tech/application
+
+client_id = 'YOUR_CLIENT_ID'
+client_secret = 'YOUR_CLIENT_SECRET'
+email = 'YOUR_EMAIL'
+password = 'YOUR_PASSWORD'
+
+# Metabypass instance
+metabypass = Metabypass.new(client_id,client_secret,email,password)
+
+# --------------------------- reCAPTCHA V2 SAMPLE -----------------------------
+url="SITE_URL"
+sitekey="SITE_KEY"
+recaptcha_v2= metabypass.recaptcha_v2_handler(url,sitekey)
+puts metabypass.end_result
+ ```
+<br/><br/>
+
+
+**reCaptcha v3** <br />
+```ruby
+require 'metabypass'
+
+
+# ---------------------------- CREDENTIALS -----------------------------
+#get your credentials from https://app.metabypass.tech/application
+
+client_id = 'YOUR_CLIENT_ID'
+client_secret = 'YOUR_CLIENT_SECRET'
+email = 'YOUR_EMAIL'
+password = 'YOUR_PASSWORD'
+
+
+# Metabypass instance
+metabypass = Metabypass.new(client_id,client_secret,email,password)
+
+# --------------------------- reCAPTCHA V3 SAMPLE -----------------------------
+url="SITE_URL"
+sitekey="SITE_KEY"
+recaptcha_v3= metabypass.recaptcha_v3(url,sitekey)
+puts metabypass.end_result
+
+ ```
+<br/><br/>
+
+
+**reCaptcha invisible** <br />
+```ruby
+require 'metabypass'
+
+
+# ---------------------------- CREDENTIALS -----------------------------
+#get your credentials from https://app.metabypass.tech/application
+
+client_id = 'YOUR_CLIENT_ID'
+client_secret = 'YOUR_CLIENT_SECRET'
+email = 'YOUR_EMAIL'
+password = 'YOUR_PASSWORD'
+
+
+# Metabypass instance
+metabypass = Metabypass.new(client_id,client_secret,email,password)
+
+# --------------------------- reCAPTCHA INVISIBLE SAMPLE -----------------------------
+url="SITE_URL"
+sitekey="SITE_KEY"
+recaptcha_invisible= metabypass.recaptcha_invisible(url,sitekey)
+puts metabypass.end_result
+
+ ```
+<br/><br/>

data/lib/auth/auth.rb

@@ -0,0 +1,72 @@
+require_relative __dir__+"/../helpers"
+require 'net/http'
+require 'json'
+
+
+class Auth
+
+  # attr_reader :email, :password, :client_id, :client_secret,
+
+  def initialize(client_id,client_secret,email,password)
+    @client_id = client_id
+    @client_secret = client_secret
+    @password = password
+    @email = email
+    @access_token_file_path = File.join(__dir__, 'metabypass.token')
+    @access_token = retrieve_access_token || generate_access_token
+  end
+
+
+  def generate_access_token
+
+    request_url = 'https://app.metabypass.tech/CaptchaSolver/oauth/token'
+
+    params = {
+      'grant_type' => 'password',
+      'client_id' => @client_id,
+      'client_secret' => @client_secret,
+      'username' => @email,
+      'password' => @password
+    }
+
+    headers = {
+      'Content-Type' => 'application/json',
+      'Accept' => 'application/json'
+    }
+
+    #webservice response
+    response = send_request(request_url, params, 'POST', headers)
+
+    if response.empty?
+      message = 'error! server response is empty'
+
+      #logger
+      logger.error(message)
+      return false
+    end
+
+
+    headers = JSON.parse(response['headers'])
+    body = JSON.parse(response['body'])
+
+    if headers['http_code'] == 200
+      @access_token = body['access_token']
+
+      File.write(@access_token_file_path, body['access_token'])
+      return body['access_token']
+    else
+      message = 'error! unauth'
+      #logger
+      logger.error(message)
+      return false
+    end
+
+  end
+
+  private
+
+  def retrieve_access_token
+    File.read(@access_token_file_path) if File.exist?(@access_token_file_path)
+  end
+
+end

data/lib/helpers.rb

@@ -0,0 +1,53 @@
+require 'net/http'
+require 'uri'
+
+
+def send_request(url, params, method, headers)
+
+  #prepare
+  uri = URI(url)
+  http = Net::HTTP.new(uri.host, uri.port)
+  http.use_ssl = true if uri.scheme == 'https'
+
+  #method types
+  case method
+    when 'GET'
+      uri.query = URI.encode_www_form(params)
+      request = Net::HTTP::Get.new(uri)
+    when 'POST'
+      request = Net::HTTP::Post.new(uri)
+      request.body = params.to_json
+    when 'PUT'
+      request = Net::HTTP::Put.new(uri)
+      request.body = params.to_json
+    when 'DELETE'
+      uri.query = URI.encode_www_form(params)
+      request = Net::HTTP::Delete.new(uri)
+    else
+      return {}
+  end
+
+  headers.each { |key, value| request[key] = value }
+
+  response = http.request(request)
+
+  headers= response.to_hash
+  headers['http_code']=response.code.to_i
+
+  {
+    'headers' =>headers.to_json,
+    'body' => response.body
+  }
+
+end
+
+def is_base64_format?(str)
+
+  # Remove whitespace characters from the string
+  cleaned_str = str.gsub(/\s+/, '')
+
+  # Check if the cleaned string is in the valid base64 format
+  # by matching it against the base64 regular expression pattern
+  base64_pattern = /^[a-zA-Z0-9+\/]+={0,2}$/
+  base64_pattern.match?(cleaned_str)
+end

data/lib/metabypass.rb

@@ -0,0 +1,122 @@
+require_relative __dir__+'/helpers'
+require_relative __dir__+'/auth/auth'
+require_relative __dir__+'/modules/captcha_solver'
+require_relative __dir__+'/modules/recaptcha'
+require 'base64'
+include CaptchaSolver
+include ReCaptcha
+require 'logger'
+
+
+
+
+class Metabypass < Auth
+
+  attr_accessor :end_result, :logger , :logger_file_path
+
+
+  def initialize(client_id,client_secret,email,password)
+    @end_result = nil
+    @logger_file_path='metabypass.log'
+    @logger = Logger.new(@logger_file_path)
+    super(client_id,client_secret,email,password)
+  end
+
+
+  # Image captcha requester
+  def image_captcha(image, numeric = 0, minLen = 0, maxLen = 0)
+
+    @end_result=nil
+
+    # Check if the image is a file or base64
+    if File.exist?(image)
+
+      begin
+
+        context = File.binread(image)
+        base64EncodedFile = Base64.encode64(context).delete("\r\n")
+
+      rescue Errno::ENOENT => e
+        #logger
+        message='file did not read'
+        logger.error(message)
+        false
+      end
+
+    elsif is_base64_format?(image)
+      base64EncodedFile = image
+    else
+      #logger
+      message='invalid image. pass image path or valid base64 of image'
+      logger.error(message)
+      false
+    end
+
+    image_captcha_requester(base64EncodedFile, numeric, minLen, maxLen)
+
+  end
+
+
+  # Simple reCaptcha v2 requester without handling the result
+  def recaptcha_v2(url, siteKey)
+    @end_result=nil
+    # This is just an API caller for developers
+    recaptcha_v2_requester(url, siteKey)
+  end
+
+
+  # reCaptcha v2 requester & result handler
+  def recaptcha_v2_handler(url, siteKey)
+
+    @end_result=nil
+    # Request reCaptcha v2 API
+    recaptcha_response = recaptcha_v2_requester(url, siteKey)
+
+    false unless recaptcha_response
+
+    if recaptcha_response['data']['RecaptchaId'].nil?
+      #logger
+      mwssage='invalid reCaptcha v2 response. RecaptchaId not found in response body. '
+      logger.error(message)
+      message
+      false
+    end
+
+    result=nil
+    # Handle getting the result (max: 100 seconds)
+    puts "to get result wait 10 seconds ... (to disable this message go to metabypass.rb file and comment line #{__LINE__})"
+    10.times do
+
+      # Sleep for 10 seconds to get the result
+      sleep(10)
+
+      # Request get result API
+      result = recaptchav2_get_result_requester(recaptcha_response['data']['RecaptchaId'])
+      # puts result.inspect # Show get result response
+
+      if result['status_code'] == 200
+        break
+      else
+        @end_result = false
+        puts "reCAPTCHA result not ready. Wait 10 seconds again... (to disable this message go to metabypass.rb file and comment line #{__LINE__})"
+      end
+    end
+
+    result
+  end
+
+
+  # reCaptcha v3 requester
+  def recaptcha_v3(url, siteKey)
+    @end_result=nil
+    recaptcha_v3_requester(url, siteKey)
+  end
+
+
+  # reCaptcha invisible requester
+  def recaptcha_invisible(url, siteKey)
+    @end_result=nil
+    re_captcha_invisible_requester(url, siteKey)
+  end
+
+end

data/lib/modules/captcha_solver.rb

@@ -0,0 +1,54 @@
+require_relative __dir__+'/../helpers'
+
+module CaptchaSolver
+
+  def image_captcha_requester(image, numeric = 0, min_len = 0, max_len = 0)
+
+    request_url = 'https://app.metabypass.tech/CaptchaSolver/api/v1/services/captchaSolver'
+
+    params = {
+      'image' => image,
+      'numeric' => numeric,
+      'min_len' => min_len,
+      'max_len' => max_len
+    }
+
+    headers = {
+      'Content-Type' => 'application/json',
+      'Authorization' => 'Bearer ' + @access_token.delete("\r\n"),
+      'Accept' => 'application/json'
+    }
+
+    response = send_request(request_url, params, 'POST', headers)
+
+
+
+    if response.empty?
+      message = 'error! server response is empty'
+      logger.error(message)
+      false
+    end
+
+    response_headers = JSON.parse(response['headers'])
+    response_body = JSON.parse(response['body'])
+
+    if response_headers['http_code'] == 200
+      if response_body['status_code'].to_i == 200
+        @end_result = response_body['data']['result']
+      end
+      response_body
+    elsif response_headers['http_code'] == 401
+      status = generate_access_token
+      if status == false
+        puts 'unauth'
+        exit
+      end
+      image_captcha_requester(image, numeric, min_len, max_len)
+    else
+      message = 'error! image captcha'
+      #logger
+      logger.error(message)
+      false
+    end
+  end
+end

data/lib/modules/recaptcha.rb

@@ -0,0 +1,201 @@
+require_relative __dir__+'/../helpers'
+
+
+module ReCaptcha
+
+  # recaptcha v2 requester
+  def recaptcha_v2_requester(url, siteKey)
+    request_url = "https://app.metabypass.tech/CaptchaSolver/api/v1/services/bypassReCaptcha"
+
+    params = {
+      "url" => url,
+      "version" => 2,
+      "sitekey" => siteKey
+    }
+
+    headers = {
+      'Content-Type' => 'application/json',
+      'Authorization' => 'Bearer ' + @access_token.delete("\r\n"),
+      'Accept' => 'application/json'
+    }
+
+    # send request to metabypass
+    response = send_request(request_url, params, 'POST', headers)
+
+    if response.empty?
+      message = 'error! server response is empty'
+      logger.error(message)
+      false
+    end
+
+    response_headers = JSON.parse(response['headers'])
+    response_body = JSON.parse(response['body'])
+
+    if response_headers['http_code'] == 200
+      response_body
+    elsif response_headers['http_code'] == 401
+      status = generate_access_token
+      if status == false
+        puts 'unauth'
+        logger.error('unauth')
+        exit
+      end
+      recaptcha_v2_requester(url, siteKey)
+    else
+      message = 'error! image captcha'
+      #logger
+      logger.error(message)
+      false
+    end
+  end
+
+  # reCaptcha v3 requester
+  def recaptcha_v3_requester(url, siteKey)
+    request_url = "https://app.metabypass.tech/CaptchaSolver/api/v1/services/bypassReCaptcha"
+
+    params = {
+      "url" => url,
+      "version" => 3,
+      "sitekey" => siteKey
+    }
+
+    headers = {
+      'Content-Type' => 'application/json',
+      'Authorization' => 'Bearer ' + @access_token.delete("\r\n"),
+      'Accept' => 'application/json'
+    }
+
+    # send request to metabypass
+    response = send_request(request_url, params, 'POST', headers)
+
+    if response.empty?
+      message = 'error! server response is empty'
+      #logger
+      logger.error(message)
+      false
+    end
+
+    response_headers = JSON.parse(response['headers'])
+    response_body = JSON.parse(response['body'])
+
+    if response_headers['http_code'] == 200
+      if response_body['status_code'].to_i == 200
+        @end_result = response_body['data']['RecaptchaResponse']
+      end
+      response_body
+    elsif response_headers['http_code'] == 401
+      status = generate_access_token
+      if status == false
+        puts 'unauth'
+        logger.error('unauth')
+        exit
+      end
+      re_captcha_v3_requester(url, siteKey)
+    else
+      message = 'error! image captcha'
+      #logger
+      logger.error(message)
+      false
+    end
+  end
+
+  # reCaptcha v3 requester
+  def re_captcha_invisible_requester(url, siteKey)
+    request_url = "https://app.metabypass.tech/CaptchaSolver/api/v1/services/bypassReCaptcha"
+
+    params = {
+      "url" => url,
+      "version" =>'invisible',
+      "sitekey" => siteKey
+    }
+
+    headers = {
+      'Content-Type' => 'application/json',
+      'Authorization' => 'Bearer ' + @access_token.delete("\r\n"),
+      'Accept' => 'application/json'
+    }
+
+    # send request to metabypass
+    response = send_request(request_url, params, 'POST', headers)
+
+    if response.empty?
+      message = 'error! server response is empty'
+      #logger
+      logger.error(message)
+      false
+    end
+
+    response_headers = JSON.parse(response['headers'])
+    response_body = JSON.parse(response['body'])
+
+    if response_headers['http_code'] == 200
+      if response_body['status_code'].to_i == 200
+        @end_result = response_body['data']['RecaptchaResponse']
+      end
+      response_body
+    elsif response_headers['http_code'] == 401
+      status = generate_access_token
+      if status == false
+        puts 'unauth'
+        logger.error('unauth')
+        exit
+      end
+      re_captcha_v3_requester(url, siteKey)
+    else
+      message = 'error! image captcha'
+      #logger
+      logger.error(message)
+      false
+    end
+  end
+
+  # reCaptcha get result requester
+  def recaptchav2_get_result_requester(recaptcha_id)
+
+    request_url = "https://app.metabypass.tech/CaptchaSolver/api/v1/services/getCaptchaResult"
+
+    params = {
+      "recaptcha_id" => recaptcha_id
+    }
+
+    headers = {
+      'Content-Type' => 'application/json',
+      'Authorization' => 'Bearer ' + @access_token.delete("\r\n"),
+      'Accept' => 'application/json'
+    }
+
+    # send request to metabypass
+    response = send_request(request_url, params, 'GET', headers)
+
+    if response.empty?
+      message = 'error! server response is empty'
+
+      #logger
+      logger.error(message)
+      false
+    end
+
+    response_headers = JSON.parse(response['headers'])
+    response_body = JSON.parse(response['body'])
+
+    if response_headers['http_code'] == 200
+      if response_body['status_code'].to_i == 200
+        @end_result = response_body['data']['RecaptchaResponse']
+      end
+      response_body
+    elsif response_headers['http_code'] == 401
+      status = generate_access_token
+      if status == false
+        puts 'unauth'
+        logger.error('unauth')
+        exit
+      end
+      recaptchav2_get_result_requester(recaptcha_id)
+    else
+      message = 'error! image captcha'
+      #logger
+      logger.error(message)
+      false
+    end
+  end
+end

data/metabypass.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+
+$LOAD_PATH.push File.expand_path("../lib", __FILE__)
+
+Gem::Specification.new do |spec|
+  spec.name        = "metabypass"
+  spec.version     = '1.0.1'
+  spec.platform    = Gem::Platform::RUBY
+  spec.licenses    = ['MIT']
+  spec.authors     = ["Metabypass"]
+  spec.email       = ["support@metabypass.tech"]
+  spec.homepage    = "https://github.com/metabypass/captcha-solver-ruby"
+  spec.summary     = 'Metabypass | Ruby-based easy implementation for solving any type of captcha by Metabypass '
+  spec.description = 'Metabypass | Ruby-based easy implementation for solving any type of captcha by Metabypass '
+
+  # If this line is removed, all fun times will cease.
+  spec.post_install_message = "Welcome to the party of AI Captcha Solvers !"
+
+  all_files = `git ls-files`.split("\n")
+  spec.files         = all_files
+  spec.require_paths = ["lib"]
+end

data/metabypass.log

@@ -0,0 +1,2 @@
+# Logfile created on 2023-06-20 15:33:36 +0430 by logger.rb/v1.5.3
+E, [2023-06-20T15:37:15.331835 #5068] ERROR -- : error! unauth

data/usage.rb

@@ -0,0 +1,45 @@
+require_relative __dir__+'/lib/metabypass'
+
+
+# ---------------------------- CREDENTIALS -----------------------------
+
+client_id = 'YOUR_CLIENT_ID'
+client_secret = 'YOUR_CLIENT_SECRET'
+email = 'YOUR_EMAIL'
+password = 'YOUR_PASSWORD'
+
+
+
+# Metabypass instance
+metabypass = Metabypass.new(client_id,client_secret,email,password)
+
+
+# ----------------------------IMAGE CAPTCHA SAMPLE -----------------------------
+img="samples/icaptcha1.jpg"
+numeric=0; #default
+min_len=0;  #default
+max_len=0;  #default
+image_captcha= metabypass.image_captcha(img,numeric,min_len,max_len)
+puts metabypass.end_result
+
+
+# # --------------------------- reCAPTCHA V2 SAMPLE -----------------------------
+# url="SITE_URL"
+# sitekey="SITE_KEY"
+# recaptcha_v2= metabypass.recaptcha_v2_handler(url,sitekey)
+# puts metabypass.end_result
+
+# --------------------------- reCAPTCHA V3 SAMPLE -----------------------------
+# url="SITE_URL"
+# sitekey="SITE_KEY"
+# recaptcha_v3= metabypass.recaptcha_v3(url,sitekey)
+# puts metabypass.end_result
+
+
+# --------------------------- reCAPTCHA INVISIBLE SAMPLE -----------------------------
+# url="SITE_URL"
+# sitekey="SITE_KEY"
+# recaptcha_invisible= metabypass.recaptcha_invisible(url,sitekey)
+# puts metabypass.end_result
+
+

metadata

@@ -0,0 +1,59 @@
+--- !ruby/object:Gem::Specification
+name: metabypass
+version: !ruby/object:Gem::Version
+  version: 1.0.1
+platform: ruby
+authors:
+- Metabypass
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2023-06-21 00:00:00.000000000 Z
+dependencies: []
+description: 'Metabypass | Ruby-based easy implementation for solving any type of
+  captcha by Metabypass '
+email:
+- support@metabypass.tech
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- GemFile
+- GemFile.lock
+- README.md
+- lib/auth/auth.rb
+- lib/helpers.rb
+- lib/metabypass.rb
+- lib/modules/captcha_solver.rb
+- lib/modules/recaptcha.rb
+- metabypass.gemspec
+- metabypass.log
+- samples/icaptcha1.jpg
+- samples/icaptcha2.png
+- usage.rb
+homepage: https://github.com/metabypass/captcha-solver-ruby
+licenses:
+- MIT
+metadata: {}
+post_install_message: Welcome to the party of AI Captcha Solvers !
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.10
+signing_key:
+specification_version: 4
+summary: Metabypass | Ruby-based easy implementation for solving any type of captcha
+  by Metabypass
+test_files: []