top-user-agents 2.0.1 → 2.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +38 -7
  2. package/package.json +9 -5
package/README.md CHANGED
@@ -1,11 +1,30 @@
1
- # top-user-agents
1
+ <div align="center">
2
+ <img src="https://github.com/microlinkhq/cdn/raw/master/dist/logo/banner.png#gh-light-mode-only" alt="microlink logo">
3
+ <img src="https://github.com/microlinkhq/cdn/raw/master/dist/logo/banner-dark.png#gh-dark-mode-only" alt="microlink logo">
4
+ <br>
5
+ <br>
6
+ </div>
2
7
 
3
- ![Last version](https://img.shields.io/github/tag/Kikobeats/top-user-agents.svg?style=flat-square)
8
+ ![Last version](https://img.shields.io/github/tag/microlinkhq/top-user-agents.svg?style=flat-square)
4
9
  [![NPM Status](https://img.shields.io/npm/dm/top-user-agents.svg?style=flat-square)](https://www.npmjs.org/package/top-user-agents)
5
10
 
6
- > A list of most common User Agent used on Internet.
11
+ > The top 100 HTTP [user-agent](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/User-Agent)'s most used over Internet.
7
12
 
8
- The list is auto generated, always up to date with the most common user agents.
13
+ **Highlights**
14
+
15
+ - Only browser agents, not bots.
16
+ - Automagically up to date.
17
+ - A simple JSON file.
18
+
19
+ ## Background
20
+
21
+ There are some scenarios where you need to perform browser-like requests, meaning you need to use an HTTP `user-agent` as much accurate as possible with the real world™️.
22
+
23
+ ![](/stats.png)
24
+
25
+ You can find many list of browser user agents on the Internet, but they are outdated or quickly unmaintained.
26
+
27
+ This list is created collecting user agent from [microlink.io](https://microlink.io) products, that receives [+300M requests every month](https://analytics.microlink.io/).
9
28
 
10
29
  ## Install
11
30
 
@@ -25,11 +44,23 @@ console.log(randomUserAgent())
25
44
  // => 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_2) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/79.0.3945.130 Safari/537.36'
26
45
  ```
27
46
 
47
+ ## About Privacy
48
+
49
+ The information exposed to the user-agent only relies on coarse details.
50
+
51
+ In practice, anyone can put whatever they want in the user-agent string, and send it to the web server.
52
+
53
+ Because that, The user-agent cannot be sufficient condition to identify or reproduce the original request.
54
+
28
55
  ## Related
29
56
 
57
+ - [https-tls](https://github.com/Kikobeats/https-tls) – Setup TLS details according to `user-agent`.
30
58
  - [top-crawler-agents](https://github.com/Kikobeats/top-crawler-agents) – A list of common crawler user agents useful for retrieving metadata from links.
59
+ - [@microlink/ua](https://github.com/microlinkhq/ua) – A simple redis primitives to incr() and top() user agents.
60
+
61
+ ## License
31
62
 
32
- **top-user-agents** © [Kiko Beats](https://kikobeats.com), released under the [MIT](https://github.com/Kikobeats/top-user-agents/blob/master/LICENSE.md) License.<br>
33
- Authored and maintained by [Kiko Beats](https://kikobeats.com) with help from [contributors](https://github.com/Kikobeats/top-user-agents/contributors).
63
+ **top-user-agents** © [microlink.io](https://microlink.io), released under the [MIT](https://github.com/microlinkhq/top-user-agents/blob/master/LICENSE.md) License.<br>
64
+ Authored and maintained by [Kiko Beats](https://kikobeats.com) with help from [contributors](https://github.com/microlinkhq/top-user-agents/contributors).
34
65
 
35
- > [kikobeats.com](https://kikobeats.com) · GitHub [Kiko Beats](https://github.com/Kikobeats) · Twitter [@Kikobeats](https://twitter.com/Kikobeats)
66
+ > [microlink.io](https://microlink.io) · GitHub [microlink.io](https://github.com/microlinkhq) · Twitter [@microlinkhq](https://twitter.com/microlinkhq)
package/package.json CHANGED
@@ -1,15 +1,19 @@
1
1
  {
2
2
  "name": "top-user-agents",
3
3
  "description": "A list of most common User Agent.",
4
- "homepage": "https://github.com/Kikobeats/top-user-agents",
5
- "version": "2.0.1",
4
+ "homepage": "https://microlink.io/user-agents",
5
+ "version": "2.0.3",
6
6
  "main": "index.js",
7
7
  "author": {
8
- "email": "josefrancisco.verdu@gmail.com",
9
- "name": "Kiko Beats",
10
- "url": "https://kikobeats.com"
8
+ "email": "hello@microlink.io",
9
+ "name": "microlink.io",
10
+ "url": "https://microlink.io"
11
11
  },
12
12
  "contributors": [
13
+ {
14
+ "name": "Kiko Beats",
15
+ "email": "josefrancisco.verdu@gmail.com"
16
+ },
13
17
  {
14
18
  "name": "Karl Horky",
15
19
  "email": "karl.horky@gmail.com"