first commit

Author: metabypass

.gitignore

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

GemFile

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

GemFile.lock

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

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/>

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

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