antybrowser 1.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: bff1786517371078f55df991001650e41795454d0ccb713a31f5c15b2c6593f2
+  data.tar.gz: a8b2ec507cad13e46b9b0d98d8e852f0c654df29fea8a304aa591bd63e3d4dfd
+SHA512:
+  metadata.gz: 1cf03735d5855d81f3cd41cf09cb9430ead5baa7dd4e82795925eaed08dcf87c863bf817f31594ba2d3bef1f675f4171c22aa341572c4b83e1c4c549ab3954a6
+  data.tar.gz: '0955ef66029fabebe6f54b1c921f94d20d8416db28bf31aa412315ab0842b98a4d9a62326879ed5487f64b145dbf6fd61826fa2c0c4c443e00f556656dfc7740'

data/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AntyBrowser
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,69 @@
+# antybrowser (Ruby)
+
+Official Antybrowser Ruby SDK for the Local API.
+
+## Installation
+
+```bash
+gem install antybrowser
+```
+
+Or in your Gemfile:
+
+```ruby
+gem "antybrowser"
+```
+
+## Quick Start
+
+```ruby
+require "antybrowser"
+
+client = Antybrowser::Client.new("your_api_key")
+
+# List profiles
+profiles = client.get_profiles
+profiles.each { |p| puts "#{p.name} (status: #{p.status})" }
+
+# Start a profile
+result = client.start_profile(123)
+puts "Debug port: #{result['data']['debugPort']}"
+```
+
+## Configuration
+
+```ruby
+# Default (port 5173)
+client = Antybrowser::Client.new("my_key")
+
+# Custom port
+client = Antybrowser::Client.new("my_key", port: 5174)
+
+# Custom base URL
+client = Antybrowser::Client.new("my_key", base_url: "http://10.0.0.5:5173")
+```
+
+## Error Handling
+
+```ruby
+begin
+  client.get_profiles
+rescue Antybrowser::AntybrowserError => e
+  puts "Status: #{e.status_code}"
+  puts "Body: #{e.response_body}"
+end
+```
+
+## Available Methods
+
+- `get_status` / `get_settings` / `get_sync_status` / `refresh_sync`
+- `get_profiles` / `create_profile` / `update_profile` / `delete_profile`
+- `start_profile` / `stop_profile` / `duplicate_profile`
+- `get_automations` / `run_automation`
+- `get_groups` / `create_group` / `update_group` / `delete_group`
+- `get_proxies` / `create_proxy` / `check_proxy` / `check_proxies_bulk` / `delete_proxy`
+- `get_extensions` / `delete_extension` / `get_profile_extensions` / `set_profile_extensions`
+
+## License
+
+MIT

data/antybrowser.gemspec

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require_relative "lib/antybrowser/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "antybrowser"
+  spec.version       = Antybrowser::VERSION
+  spec.authors       = ["Antybrowser Team"]
+  spec.email         = ["support@antybrowser.com"]
+
+  spec.summary       = "Official Antybrowser SDK — Ruby client for the Local API"
+  spec.description   = "Manage browser profiles, proxies, automations, groups, and extensions via the Antybrowser Local API."
+  spec.homepage      = "https://antybrowser.com"
+  spec.license       = "MIT"
+
+  spec.required_ruby_version = ">= 3.0"
+
+  spec.metadata["homepage_uri"]    = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/antybrowser/SDK"
+  spec.metadata["changelog_uri"]   = "https://github.com/antybrowser/SDK/blob/main/ruby/CHANGELOG.md"
+
+  spec.files = Dir["lib/**/*.rb"] + ["antybrowser.gemspec", "README.md", "LICENSE.txt"]
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+end

data/lib/antybrowser/client.rb

@@ -0,0 +1,211 @@
+require "net/http"
+require "json"
+require "uri"
+
+module Antybrowser
+  class Client
+    attr_reader :base_url, :api_key
+
+    def initialize(api_key, port: 5173, base_url: nil, timeout: 30)
+      @api_key = api_key
+      @base_url = base_url || "http://127.0.0.1:#{port}"
+      @timeout = timeout
+    end
+
+    # ─── System ──────────────────────────────────────────────────────────
+
+    def get_status
+      get("/api/status")
+    end
+
+    def get_settings
+      get("/api/settings")
+    end
+
+    def get_sync_status
+      SyncStatus.new(get("/api/sync/status"))
+    end
+
+    def refresh_sync(profile_id: nil)
+      body = profile_id ? { "profileId" => profile_id } : {}
+      post("/api/sync/refresh", body)
+    end
+
+    # ─── Profiles ────────────────────────────────────────────────────────
+
+    def get_profiles
+      get("/api/profiles").map { |d| Profile.new(d) }
+    end
+
+    def create_profile(data)
+      Profile.new(post("/api/profiles", data))
+    end
+
+    def update_profile(id, data)
+      Profile.new(put("/api/profiles/#{id}", data))
+    end
+
+    def delete_profile(id)
+      delete("/api/profiles/#{id}")
+    end
+
+    def start_profile(id)
+      result = post("/api/profiles/#{id}/start", {})
+      { "success" => result["success"], "data" => result["data"] }
+    end
+
+    def stop_profile(id)
+      post("/api/profiles/#{id}/stop", {})
+    end
+
+    def duplicate_profile(id, name: nil, directory_name: nil)
+      body = {}
+      body["name"] = name if name
+      body["directoryName"] = directory_name if directory_name
+      Profile.new(post("/api/profiles/#{id}/duplicate", body))
+    end
+
+    # ─── Automations ─────────────────────────────────────────────────────
+
+    def get_automations
+      get("/api/automations").map { |d| Automation.new(d) }
+    end
+
+    def run_automation(id, profile_id:, delete_cookies: nil, variables: nil)
+      body = { "profileId" => profile_id }
+      body["deleteCookies"] = delete_cookies unless delete_cookies.nil?
+      body["variables"] = variables if variables
+      result = post("/api/automations/#{id}/run", body)
+      {
+        "success" => result["success"],
+        "message" => result["message"],
+        "variables" => result["variables"],
+      }
+    end
+
+    # ─── Groups ──────────────────────────────────────────────────────────
+
+    def get_groups
+      get("/api/groups").map { |d| Group.new(d) }
+    end
+
+    def create_group(data)
+      Group.new(post("/api/groups", data))
+    end
+
+    def update_group(id, data)
+      Group.new(put("/api/groups/#{id}", data))
+    end
+
+    def delete_group(id)
+      delete("/api/groups/#{id}")
+    end
+
+    # ─── Proxies ─────────────────────────────────────────────────────────
+
+    def get_proxies
+      get("/api/proxies").map { |d| Proxy.new(d) }
+    end
+
+    def create_proxy(data)
+      Proxy.new(post("/api/proxies", data))
+    end
+
+    def check_proxy(host:, port:, username: nil, password: nil, type: nil)
+      body = { "host" => host, "port" => port }
+      body["username"] = username if username
+      body["password"] = password if password
+      body["type"] = type if type
+      ProxyCheckResult.new(post("/api/proxies/check", body))
+    end
+
+    def check_proxies_bulk(proxies)
+      result = post("/api/proxies/check-bulk", { "proxies" => proxies })
+      results = result["results"] || result
+      results.map { |r| ProxyCheckResult.new(r) }
+    end
+
+    def delete_proxy(id)
+      delete("/api/proxies/#{id}")
+    end
+
+    # ─── Extensions ──────────────────────────────────────────────────────
+
+    def get_extensions
+      get("/api/extensions").map { |d| Extension.new(d) }
+    end
+
+    def delete_extension(id)
+      delete("/api/extensions/#{id}")
+    end
+
+    def get_profile_extensions(profile_id, details: false)
+      get("/api/profiles/#{profile_id}/extensions?details=#{details}").map { |d| Extension.new(d) }
+    end
+
+    def set_profile_extensions(profile_id, extension_ids)
+      post("/api/profiles/#{profile_id}/extensions", { "extensionIds" => extension_ids })
+    end
+
+    private
+
+    def get(path)
+      request(Net::HTTP::Get, path)
+    end
+
+    def post(path, body)
+      request(Net::HTTP::Post, path, body)
+    end
+
+    def put(path, body)
+      request(Net::HTTP::Put, path, body)
+    end
+
+    def delete(path)
+      request(Net::HTTP::Delete, path)
+    end
+
+    def request(method_class, path, body = nil)
+      uri = URI.parse("#{@base_url}#{path}")
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.open_timeout = @timeout
+      http.read_timeout = @timeout
+
+      req = method_class.new(uri.request_uri)
+      req["x-api-key"] = @api_key
+      req["Content-Type"] = "application/json"
+      req.body = body.to_json if body
+
+      begin
+        response = http.request(req)
+      rescue StandardError => e
+        raise AntybrowserError, "Failed to connect to Antybrowser: #{e.message}"
+      end
+
+      parse_response(response)
+    end
+
+    def parse_response(response)
+      code = response.code.to_i
+      body = response.body || ""
+
+      if code < 200 || code >= 300
+        raise AntybrowserError.new(
+          "API request failed with status #{code}",
+          status_code: code,
+          response_body: body
+        )
+      end
+
+      return {} if body.strip.empty?
+
+      JSON.parse(body)
+    rescue JSON::ParserError
+      raise AntybrowserError.new(
+        "Invalid JSON response from API",
+        status_code: response.code.to_i,
+        response_body: body
+      )
+    end
+  end
+end

data/lib/antybrowser/error.rb

@@ -0,0 +1,11 @@
+module Antybrowser
+  class AntybrowserError < StandardError
+    attr_reader :status_code, :response_body
+
+    def initialize(message, status_code: nil, response_body: nil)
+      super(message)
+      @status_code = status_code
+      @response_body = response_body
+    end
+  end
+end

data/lib/antybrowser/models.rb

@@ -0,0 +1,136 @@
+module Antybrowser
+  class Profile
+    attr_reader :id, :name, :directory_name, :group_id, :proxy_id,
+                :browser_type, :browser_version, :os_fingerprint,
+                :screen_resolution, :language, :accept_language, :timezone,
+                :use_fingerprint, :fingerprint_id, :restore_session,
+                :low_bandwidth, :notes, :status, :debug_port,
+                :created_at, :updated_at, :extra
+
+    def initialize(data)
+      @id = data["id"]
+      @name = data["name"]
+      @directory_name = data["directoryName"]
+      @group_id = data["groupId"]
+      @proxy_id = data["proxyId"]
+      @browser_type = data["browserType"]
+      @browser_version = data["browserVersion"]
+      @os_fingerprint = data["osFingerprint"]
+      @screen_resolution = data["screenResolution"]
+      @language = data["language"]
+      @accept_language = data["acceptLanguage"]
+      @timezone = data["timezone"]
+      @use_fingerprint = data["useFingerprint"]
+      @fingerprint_id = data["fingerprintId"]
+      @restore_session = data["restoreSession"]
+      @low_bandwidth = data["lowBandwidth"]
+      @notes = data["notes"]
+      @status = data["status"]
+      @debug_port = data["debugPort"]
+      @created_at = data["createdAt"]
+      @updated_at = data["updatedAt"]
+      @extra = data.reject { |k, _v| known_keys.include?(k) }
+    end
+
+    private
+
+    def known_keys
+      %w[id name directoryName groupId proxyId browserType browserVersion
+         osFingerprint screenResolution language acceptLanguage timezone
+         useFingerprint fingerprintId restoreSession lowBandwidth notes
+         status debugPort createdAt updatedAt]
+    end
+  end
+
+  class Proxy
+    attr_reader :id, :name, :type, :host, :port, :username, :status,
+                :country_code, :ip, :country, :timezone, :asn, :isp, :extra
+
+    def initialize(data)
+      @id = data["id"]
+      @name = data["name"]
+      @type = data["type"]
+      @host = data["host"]
+      @port = data["port"]
+      @username = data["username"]
+      @status = data["status"]
+      @country_code = data["countryCode"]
+      @ip = data["ip"]
+      @country = data["country"]
+      @timezone = data["timezone"]
+      @asn = data["asn"]
+      @isp = data["isp"]
+      @extra = data.reject { |k, _v| known_keys.include?(k) }
+    end
+
+    private
+
+    def known_keys
+      %w[id name type host port username status countryCode ip country timezone asn isp]
+    end
+  end
+
+  class Group
+    attr_reader :id, :name, :description, :color, :display_order, :created_at, :updated_at
+
+    def initialize(data)
+      @id = data["id"]
+      @name = data["name"]
+      @description = data["description"]
+      @color = data["color"]
+      @display_order = data["displayOrder"]
+      @created_at = data["createdAt"]
+      @updated_at = data["updatedAt"]
+    end
+  end
+
+  class Extension
+    attr_reader :id, :name, :path, :description, :icon, :created_at
+
+    def initialize(data)
+      @id = data["id"]
+      @name = data["name"]
+      @path = data["path"]
+      @description = data["description"]
+      @icon = data["icon"]
+      @created_at = data["createdAt"]
+    end
+  end
+
+  class Automation
+    attr_reader :id, :name, :description, :status, :last_run, :created_at, :updated_at
+
+    def initialize(data)
+      @id = data["id"]
+      @name = data["name"]
+      @description = data["description"]
+      @status = data["status"]
+      @last_run = data["lastRun"]
+      @created_at = data["createdAt"]
+      @updated_at = data["updatedAt"]
+    end
+  end
+
+  class SyncStatus
+    attr_reader :total, :completed, :is_syncing, :active, :errors, :progress
+
+    def initialize(data)
+      @total = data["total"] || 0
+      @completed = data["completed"] || 0
+      @is_syncing = data["isSyncing"] || false
+      @active = data["active"] || []
+      @errors = data["errors"] || {}
+      @progress = data["progress"] || {}
+    end
+  end
+
+  class ProxyCheckResult
+    attr_reader :success, :details, :error_message
+
+    def initialize(data)
+      @success = data["success"] || false
+      @details = data["details"]
+      @error_message = data["errorMessage"]
+    end
+  end
+end

data/lib/antybrowser/version.rb

@@ -0,0 +1,3 @@
+module Antybrowser
+  VERSION = "1.0.2"
+end

data/lib/antybrowser.rb

@@ -0,0 +1,4 @@
+require_relative "antybrowser/version"
+require_relative "antybrowser/error"
+require_relative "antybrowser/models"
+require_relative "antybrowser/client"

metadata

@@ -0,0 +1,83 @@
+--- !ruby/object:Gem::Specification
+name: antybrowser
+version: !ruby/object:Gem::Version
+  version: 1.0.2
+platform: ruby
+authors:
+- Antybrowser Team
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-09-06 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: Manage browser profiles, proxies, automations, groups, and extensions
+  via the Antybrowser Local API.
+email:
+- support@antybrowser.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- antybrowser.gemspec
+- lib/antybrowser.rb
+- lib/antybrowser/client.rb
+- lib/antybrowser/error.rb
+- lib/antybrowser/models.rb
+- lib/antybrowser/version.rb
+homepage: https://antybrowser.com
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://antybrowser.com
+  source_code_uri: https://github.com/antybrowser/SDK
+  changelog_uri: https://github.com/antybrowser/SDK/blob/main/ruby/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Official Antybrowser SDK — Ruby client for the Local API
+test_files: []