CapMonster Cloud Ruby Client

Official Ruby client for CapMonster Cloud.

Solve CAPTCHAs (reCAPTCHA, Cloudflare Turnstile, and more) via the CapMonster Cloud API.

Install

gem install capmonstercloud

Or add to your Gemfile:

gem "capmonstercloud"

Quick start

require "capmonstercloud"

client = CapMonsterCloud::Client.new(client_key: "YOUR_API_KEY")

puts client.get_balance

result = client.solve({
  "type" => "RecaptchaV2TaskProxyless",
  "websiteURL" => "https://example.com",
  "websiteKey" => "SITE_KEY"
})

puts result.dig("solution", "gRecaptchaResponse")

API

  • get_balance — account balance
  • create_task(task) — submit a captcha task, returns taskId
  • get_task_result(task_id) — poll once
  • solve(task, timeout:, poll_interval:) — create + poll until ready

License

MIT