MCPcopy Index your code
hub / github.com/Hyper-Solutions/hyper-sdk-go

github.com/Hyper-Solutions/hyper-sdk-go @v2.9.2

Chat with this repo
repository ↗ · DeepWiki ↗ · release v2.9.2 ↗ · + Follow
230 symbols 431 edges 29 files 128 documented · 56%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Hyper Solutions SDK - Go Library for Bot Protection Bypass (Akamai, Incapsula, Kasada, DataDome)

Go Version License GitHub Release GitHub Stars

A powerful Go SDK for bypassing modern bot protection systems including Akamai Bot Manager, Incapsula, Kasada, and DataDome. Generate valid cookies, solve anti-bot challenges, and automate protected endpoints with ease.

Perfect for web scraping, automation, and data collection from protected websites.

🔑 Getting API Access

Before using this SDK, you'll need an API key from Hyper Solutions:

  1. Visit hypersolutions.co to create your account
  2. Choose your plan:
    • 💳 Pay-as-you-go: Perfect for testing and small-scale usage
    • 📊 Subscription plans: Cost-effective for high-volume applications
  3. Get your API key from the dashboard
  4. Start bypassing bot protection with this SDK!

🚀 Quick Start

package main

import (
    "context"
    "fmt"

    "github.com/Hyper-Solutions/hyper-sdk-go/v2"
)

func main() {
    session := hyper.NewSession("your-api-key")

    // Generate Akamai sensor data
    sensorData, sensorContext, err := session.GenerateSensorData(context.Background(), &hyper.SensorInput{
        // Configure your sensor input
    })
    if err != nil {
        panic(err)
    }

    fmt.Printf("Generated sensor data: %s", sensorData)
    fmt.Printf("Sensor context: %s", sensorContext)
}

✨ Features

  • 🛡️ Akamai Bot Manager: Generate sensor data, handle pixel challenges, validate cookies
  • 🔒 Incapsula Protection: Generate Reese84 sensors and UTMVC cookies
  • Kasada Bypass: Generate payload data (CT) and POW tokens (CD)
  • 🎯 DataDome Solutions: Solve tags, slider captchas and interstitial challenges
  • 🔧 Easy Integration: Simple Go API with comprehensive documentation
  • ⚙️ Flexible Configuration: Custom HTTP clients and JWT key support

📦 Installation

Install the Hyper Solutions SDK for Go using:

go get github.com/Hyper-Solutions/hyper-sdk-go/v2

📋 Table of Contents

🔧 Basic Usage

Creating a Session

Initialize the SDK with your API key to start bypassing bot protection:

// Basic session
session := hyper.NewSession("your-api-key")

// Advanced session with custom configuration
session := hyper.NewSession("your-api-key").
    WithJwtKey("your-jwt-key").
    WithClient(customHTTPClient)

🛡️ Akamai Bot Manager

Bypass Akamai Bot Manager protection with sensor data generation, cookie validation, and challenge solving.

Generating Sensor Data

Generate sensor data for valid Akamai cookies and bot detection bypass:

sensorData, sensorContext, err := session.GenerateSensorData(ctx, &hyper.SensorInput{
    // Configure sensor parameters
})
if err != nil {
    // Handle error
}

Parsing Script Path

Extract Akamai Bot Manager script paths from HTML for reverse engineering:

scriptPath, err := akamai.ParseScriptPath(reader)
if err != nil {
    // Handle error
}

Handling Sec-Cpt Challenges

Solve sec-cpt challenges with built-in parsing and payload generation:

  • ParseSecCptChallenge: Parse sec-cpt challenges from HTML
  • ParseSecCptChallengeFromJson: Parse from JSON responses
  • GenerateSecCptPayload: Generate challenge response payloads
  • Sleep: Handle challenge timing requirements
  • SleepWithContext: Context-aware challenge delays

Cookie Validation

Validate Akamai _abck cookies and session states:

  • IsCookieValid: Check cookie validity for request counts
  • IsCookieInvalidated: Determine if more sensors are needed

Pixel Challenge Solving

Handle Akamai pixel challenges for advanced bot detection bypass:

pixelData, err := session.GeneratePixelData(ctx, &hyper.PixelInput{
    // Pixel challenge parameters
})
if err != nil {
    // Handle error
}

Pixel parsing functions: - ParsePixelHtmlVar: Extract pixel variables from HTML - ParsePixelScriptURL: Get pixel script and POST URLs - ParsePixelScriptVar: Parse dynamic pixel values

🔒 Incapsula Protection

Bypass Incapsula bot detection with Reese84 sensors and UTMVC cookie generation.

Generating Reese84 Sensors

Create Reese84 sensor data for Incapsula bypass:

sensorData, err := session.GenerateReese84Sensor(ctx, site, userAgent)
if err != nil {
    // Handle error
}

UTMVC Cookie Generation

Generate UTMVC cookies for Incapsula protection bypass:

utmvcCookie, err := session.GenerateUtmvcCookie(ctx, &hyper.UtmvcInput{
    Script: "incapsula-script-content",
    SessionIds: []string{"session-id-1", "session-id-2"},
    UserAgent: "Mozilla/5.0 (compatible bot)"
})
if err != nil {
    // Handle error
}

Script Path Parsing

Parse UTMVC script paths for Incapsula integration:

scriptPath, err := incapsula.ParseUtmvcScriptPath(scriptReader)
if err != nil {
    // Handle error
}

// Generate submit path
submitPath := incapsula.GetUtmvcSubmitPath()

⚡ Kasada Bypass

Defeat Kasada Bot Manager with payload generation and POW solving.

Generating Payload Data (CT)

Create x-kpsdk-ct tokens for Kasada bypass:

payload, headers, err := session.GenerateKasadaPayload(ctx, &hyper.KasadaPayloadInput{
    // Kasada payload configuration
})
if err != nil {
    // Handle error
}

Generating POW Data (CD)

Solve Kasada Proof-of-Work challenges for x-kpsdk-cd tokens:

powPayload, err := session.GenerateKasadaPow(ctx, &hyper.KasadaPowInput{
    // POW challenge parameters
})
if err != nil {
    // Handle error
}

Script Path Extraction

Extract Kasada script paths from blocked pages (HTTP 429):

scriptPath, err := kasada.ParseScriptPath(reader)
if err != nil {
    // Handle error
}
// Returns: /ips.js?timestamp=...

🎯 DataDome Solutions

Solve DataDome captchas including slider challenges and interstitial pages.

Interstitial Challenge Solving

Bypass DataDome interstitial pages:

payload, headers, err := session.GenerateDataDomeInterstitial(ctx, &hyper.DataDomeInterstitialInput{
    // Interstitial parameters
})
if err != nil {
    // Handle error
}
// POST payload to https://geo.captcha-delivery.com/interstitial/

Slider Captcha Solving

Solve DataDome slider captchas automatically:

checkUrl, headers, err := session.GenerateDataDomeSlider(ctx, &hyper.DataDomeSliderInput{
    // Slider challenge parameters
})
if err != nil {
    // Handle error
}
// GET request to checkUrl

DeviceLink URL Parsing

Extract DataDome device check URLs:

// Interstitial device links
deviceLink, err := datadome.ParseInterstitialDeviceCheckLink(reader, datadomeCookie, referer)
if err != nil {
    // Handle error
}

// Slider device links  
deviceLink, err := datadome.ParseSliderDeviceCheckLink(reader, datadomeCookie, referer)
if err != nil {
    // Handle error
}

Getting Help

📄 License

This SDK is licensed under the MIT License.


Keywords: Go SDK, Golang, bot protection bypass, web scraping, Akamai bypass, Incapsula bypass, Kasada bypass, DataDome bypass, anti-bot, captcha solver, automation, reverse engineering, bot detection, web automation

Core symbols most depended-on inside this repo

sendRequest
called by 14
api.go
MarshalEasyJSON
called by 3
models_easyjson.go
ParseSecCptChallenge
called by 3
akamai/sec_cpt.go
IsCookieValid
called by 3
akamai/stop_signal.go
FloatToStringRadix
called by 3
akamai/internal/radix.go
generateSignature
called by 2
session.go
easyjsonD2b7633eDecodeGithubComHyperSolutionsHyperSdkGoV2
called by 2
models_easyjson.go
easyjsonD2b7633eEncodeGithubComHyperSolutionsHyperSdkGoV2
called by 2
models_easyjson.go

Shape

Method 112
Function 92
Struct 24
TypeAlias 2

Languages

Go100%

Modules by API surface

models_easyjson.go114 symbols
models.go19 symbols
akamai/sec_cpt_easyjson.go18 symbols
akamai/sec_cpt.go12 symbols
session.go8 symbols
internal/decompress.go5 symbols
akamai/sec_cpt_test.go5 symbols
akamai/internal/radix.go5 symbols
akamai/stop_signal_test.go4 symbols
trustdecision.go3 symbols
kasada.go3 symbols
datadome/parse.go3 symbols

For agents

$ claude mcp add hyper-sdk-go \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page