cloudbypass_skill

Overview

This skill integrates with the Cloudbypass API to fetch web pages protected by Cloudflare, Turnstile, or JavaScript-based challenges. It provides multiple request modes (V1, V2) and a bundled script to perform protected-page retrieval when ordinary HTTP requests fail. Use it when compliant access to challenge-protected content is required and you have an active Cloudbypass key.

How this skill works

The skill forwards the target URL and optional parameters to Cloudbypass API endpoints, which perform challenge resolution and return the fetched HTML and headers. V1 performs simple bypass attempts; V2/V2S use a proxy and more advanced challenge handling. The bundled script (scripts/cloudbypass_request.js) demonstrates how to call the service and pass required environment variables like CLOUDBYPASS_APIKEY and CLOUDBYPASS_PROXY.

When to use it

• When normal HTTP requests return Cloudflare/Turnstile challenges or 403 errors.
• When automated scraping must respect legal and ethical constraints but requires challenge resolution.
• When you need a reliable way to retrieve a page that runs client-side JavaScript protections.
• When you already have or can provision a dedicated Cloudbypass API key and optional proxy.

Best practices

• Keep your CLOUDBYPASS_APIKEY secret and rotate it regularly to limit exposure.
• Use V2/V2S only when necessary and supply CLOUDBYPASS_PROXY to avoid IP-based blocking.
• Monitor usage and billing on api.cloudbypass.com before heavy or autonomous operations.
• Confirm you have permission to access or archive target sites and follow robots.txt and terms.

Example use cases

• Archiving protected pages for a research collection when manual access is impractical.
• Automated testing of public-facing pages behind Turnstile that intermittently block bots.
• Backup workflows that must fetch pages for preservation even when protections are present.
• Integrating the bundled script into an existing pipeline to conditionally escalate to Cloudbypass when standard requests fail.