Get a random and legit user-agent for your HTTP client

Stores and randomly accesses a HTTP user agent from an available list of user agents in disk.

Features

Randomly ⚡ pick between 899 unique user agents ✅
HTTP user agents are stored 💾 in a disk file to avoid filling up your app's memory space ✅
File disk reads are optimized 🏃 to only read as much as needed ✅
Cache results using memoizee ✅
Supports Bluebird 🐦 promises ✅

How to install

npm install random-http-useragent -g

How to use

Use it in your terminal

random-http-useragent

Use it in your app

Get a random user agent

const RandomHttpUserAgent = require('random-http-useragent')

RandomHttpUserAgent.get()
  .then((userAgent) => console.log(userAgent))
  .catch((error) => console.error(error.message))

Cache returned user agents for 2 minutes

const RandomHttpUserAgent = require('random-http-useragent')

RandomHttpUserAgent.configure({ memoizee: { maxAge: 120000 } })

RandomHttpUserAgent.get()
  .then((userAgent) => console.log(userAgent))
  .catch((error) => console.error(error.message))

How to contribute

You can contribute either with code (e.g., new features, bug fixes and documentation) or by donating 5 EUR. You can read the contributing guidelines for instructions on how to contribute with code.

All donation proceedings will go to the Sverige för UNHCR, a swedish partner of the UNHCR - The UN Refugee Agency, a global organisation dedicated to saving lives, protecting rights and building a better future for refugees, forcibly displaced communities and stateless people.

Used by

request-on-steroids - An HTTP client ✨ with retry, circuit-breaker and tor support 📦 out-of-the-box
facebook-login-for-robots - Facebook Login for 🤖 robots
browser-as-a-service - A web browser 🌎 hosted as a service, to render your JavaScript web pages as HTML
pollmommy - ⭐️ Hack your 🙈 vote out of 📈 Polldaddy surveys - used by 💰 BBC, Microsoft, Forbes, Pfizer, IBM

License

Read the license for permissions and limitations.

hfreire/random-http-useragent