User-Agent 工具 API

解析 User-Agent（浏览器、系统、设备、爬虫），随机生成真实格式的 UA

数据来源：本地计算

返回统一的 JSON 格式 { code, message, cached, stale, updatedAt, data }，支持跨域，免注册每天可免费调用 100 次，注册后每天 10000 次。

解析 User-Agent（默认解析调用者自己的）

GET /api/ua/parse

请求参数

  • ua：要解析的 User-Agent（最多 2000 个字符），留空为请求头里调用者自己的 UA，示例 Mozilla/5.0 (iPhone; CPU iPhone OS 17_6_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6 Mobile/15E148 Safari/604.1

返回字段

  • ua（string）：被解析的 User-Agent 原文（去掉首尾空白）；没传 ua 参数且请求头里也没有时为空字符串
  • browser（object）：浏览器（含微信、QQ 等 App 内置浏览器）
  • browser.name（string|null）：浏览器名称：Chrome、Edge、Firefox、Safari、Opera、Opera Mini、WeChat（微信）、WeCom（企业微信）、QQ（手机 QQ）、QQ Browser、UC Browser、Quark（夸克）、Baidu App（百度 App）、Huawei Browser、Mi Browser（小米）、Samsung Internet、vivo Browser、OPPO Browser、360 Browser、Sogou Explorer、DingTalk、Alipay、Yandex、Vivaldi、IE、IE Mobile、Chromium、Android WebView、WebView（iOS App 内嵌网页）；识别不出（包括 curl 等非浏览器客户端）时为 null
  • browser.version（string|null）：UA 中的完整版本号，如 128.0.6613.120；Chrome 等启用了 UA 精简的浏览器只给出主版本（如 128.0.0.0）；没有版本号时为 null
  • browser.major（string|null）：主版本号（version 第一个点之前的部分），如 128；没有版本号时为 null
  • engine（object）：渲染引擎
  • engine.name（string|null）：引擎名称：Blink（Chrome 28 起及其衍生浏览器）、WebKit（Safari 以及 iOS 上的所有浏览器）、Gecko（Firefox）、Trident（IE）、EdgeHTML（旧版 Edge）、Presto（旧版 Opera）；识别不出时为 null
  • engine.version（string|null）：引擎版本：Blink 取 Chrome 版本号，WebKit 取 AppleWebKit 版本号，Gecko 取 rv 版本号；识别不出时为 null
  • os（object）：操作系统
  • os.name（string|null）：系统名称：Windows、Windows Phone、macOS、iOS、iPadOS（iPad 且系统版本 ≥ 13）、Android、HarmonyOS（鸿蒙，含基于 Android 的 2~4 版和 OpenHarmony 内核的 NEXT）、Linux、ChromeOS；识别不出时为 null
  • os.version（string|null）：系统版本（点分隔）：Windows 按内核版本映射，NT 10.0 → 10/11（UA 无法区分 10 和 11）、6.3 → 8.1、6.2 → 8、6.1 → 7、6.0 → Vista、5.1/5.2 → XP；macOS 如 10.15.7（新版 Safari、Chrome 固定报告 10.15.7，不代表真实版本）；HarmonyOS NEXT 为 OpenHarmony 版本号；ChromeOS 为平台版本号；Linux 和没有版本号时为 null
  • device（object）：设备
  • device.type（string）：设备类型：desktop（电脑，也是无法判断时的默认值）、mobile（手机）、tablet（平板：iPad、不带 Mobile 标记的 Android/鸿蒙设备等；iPadOS 13+ 默认请求桌面版网页时会被识别为 desktop）、bot（爬虫或脚本）
  • device.vendor（string|null）：设备厂商：Apple、Samsung、Google、Huawei、Honor、Xiaomi、OPPO、vivo、OnePlus、realme、Meizu、Motorola；按型号前缀和 UA 特征推断，识别不出时为 null
  • device.model（string|null）：设备型号：iPhone、iPad、iPod touch、Mac，或 Android UA 中的型号（如 SM-S9210、23116PN5BC）；Chrome 精简 UA 中的占位型号 K 和识别不出时为 null
  • isBot（boolean）：是否为爬虫或脚本：搜索引擎爬虫（Googlebot、Baiduspider、bingbot、YandexBot、Sogou Spider、360Spider、Bytespider 等）、社交/AI 爬虫（facebookexternalhit、GPTBot、ClaudeBot 等）、无头浏览器、curl、python-requests 等 HTTP 库，以及名称以 bot/spider/crawler 结尾的未知爬虫；UA 为空时也为 true
  • bot（string|null）：爬虫或脚本名称，如 Googlebot、Baiduspider、bingbot、curl；UA 为空时为 unknown；isBot 为 false 时为 null

随机生成真实格式的 User-Agent

GET /api/ua/random

请求参数

  • device：设备类型 desktop / mobile，留空为两者随机，示例 mobile
  • browser：浏览器，留空为随机：chrome / edge / firefox / safari / opera / wechat / qq / uc / quark / baidu / huawei / xiaomi / samsung（uc、quark、baidu、huawei、xiaomi、samsung 只有 mobile），示例 wechat
  • count：数量（1~50），示例 5

返回字段

  • []（object）：data 是数组，长度等于 count，每项是一个随机生成的 UA。模板取自各浏览器真实 UA 的格式，版本号、系统版本和手机型号在常见范围内随机
  • [].ua（string）：User-Agent 字符串
  • [].device（string）：模板所属设备类型：desktop 或 mobile（mobile 均为手机，不含平板）
  • [].browser（string）：用 /api/ua/parse 同一套规则解析出的浏览器名称，如 Chrome、WeChat、UC Browser
  • [].version（string）：解析出的浏览器版本号，如 128.0.0.0
  • [].os（string）：解析出的操作系统名称：Windows、macOS、Linux、Android、iOS、HarmonyOS