uagenerator

ua-generator-go

A random user-agent generator for Go >= 1.22

Forked from github.com/130347665/ua-generator-go by Ekin Karadeniz. Licensed under Apache 2.0.

Features

• No external dependencies.
• No external user-agent list, no downloads.
• User-agent versions are hardcoded into the code.
• Platform and browser versions are based on real releases.
• Client Hints (Sec-CH-UA fields).
• Easy to integrate into HTTP clients.
• Concurrency-safe.

Install

go get github.com/130347665/ua-generator-go

Note: Upgrade ua-generator periodically to keep user-agent versions up to date.

Basic usage

package main

import (
    "fmt"
    uagenerator "github.com/130347665/ua-generator-go"
)

func main() {
    ua, err := uagenerator.Generate(nil)
    if err != nil {
        panic(err)
    }
    fmt.Println(ua) // Mozilla/5.0 (Macintosh; Intel Mac OS X 10_8_3) AppleWebKit/604.1.38 ...
}

Customization

It takes three different parameters to customize the user-agent.

device   := []string{"desktop", "mobile"}
platform := []string{"windows", "macos", "ios", "linux", "android"}
browser  := []string{"chrome", "edge", "firefox", "safari"}

Note: All parameters are optional and multiple values can be specified using slices.

Customized user-agent generation:

ua, _ := uagenerator.Generate(&uagenerator.GenerateConfig{
    Device:  []string{"desktop"},
    Browser: []string{"chrome", "edge"},
})

fmt.Println(ua.Text)         // Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 ...
fmt.Println(ua.Platform)     // windows
fmt.Println(ua.Browser)      // chrome
fmt.Println(ua.CH.Brands)    // "Not A(Brand";v="99", "Chromium";v="129", "Google Chrome";v="129"
fmt.Println(ua.CH.Mobile)    // ?0
fmt.Println(ua.CH.Platform)  // "Windows"

Headers

ua, _ := uagenerator.Generate(&uagenerator.GenerateConfig{
    Browser: []string{"chrome", "edge"},
})

// Returns a map with user-agent and low-entropy Client Hints:
headers := ua.Headers.Get()
// map[user-agent:Mozilla/5.0 ... sec-ch-ua:... sec-ch-ua-mobile:?0 sec-ch-ua-platform:"Windows"]

// Extend Client Hints via Accept-CH:
ua.Headers.AcceptCH("Sec-CH-UA-Platform-Version, Sec-CH-UA-Full-Version-List")
headers = ua.Headers.Get()
// Now also includes sec-ch-ua-platform-version and sec-ch-ua-full-version-list

Integrating into net/http:

ua, _ := uagenerator.Generate(&uagenerator.GenerateConfig{
    Browser: []string{"chrome", "edge"},
})

req, _ := http.NewRequest("GET", "https://httpbin.org/get", nil)
for k, v := range ua.Headers.Get() {
    req.Header.Set(k, v)
}
resp, _ := http.DefaultClient.Do(req)

Options

WeightedVersions

Increase the probability of the latest versions being chosen. Default is false.

ua, _ := uagenerator.Generate(&uagenerator.GenerateConfig{
    Browser: []string{"chrome", "edge"},
    Options: &uagenerator.Options{
        WeightedVersions: true,
    },
})

VersionRanges

Choose only versions within specified ranges. Default is nil.

ua, _ := uagenerator.Generate(&uagenerator.GenerateConfig{
    Browser: []string{"chrome"},
    Options: &uagenerator.Options{
        VersionRanges: map[string]uagenerator.VersionRange{
            "chrome": uagenerator.NewVersionRange(125, 129), // Between 125 and 129
            "edge":   uagenerator.NewVersionRange(120, 0),   // 120 minimum (0 = no max)
        },
    },
})

Note: If there is no valid version within the range, the filter will skip it and return a random valid version instead.

TiedSafariVersion

Make Safari version tied to macOS/iOS version. Default is false.

ua, _ := uagenerator.Generate(&uagenerator.GenerateConfig{
    Platform: []string{"macos", "ios"},
    Browser:  []string{"safari"},
    Options: &uagenerator.Options{
        TiedSafariVersion: true,
    },
})

License

Apache License 2.0