agentutility(7)$ man user-agent-parse
/user-agent-parse
PRICE / CALL
$0.005
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
webprobeCATEGORY
uncategorized
STATUS
● live
NAME
user-agent-parse — parses a user-agent string entirely locally with regex, no external lookups
SYNOPSIS
POST https://x402.agentutility.ai/user-agent-parse
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Parses a User-Agent string entirely locally with regex, no external lookups. Detects browser (Chrome, Firefox, Safari, Edge, Opera, Vivaldi, Samsung), OS (Windows, macOS, iOS, Android, Linux, ChromeOS) with version, device type (desktop / mobile / tablet / bot), and identifies 32+ specific bots/crawlers. Use it as a UA classifier, browser detection, OS detection, bot detection, or AI crawler identifier (GPTBot, ClaudeBot, PerplexityBot).
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| user_agent | string | Raw User-Agent header string. Up to 2000 chars. | required |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| user_agent | string | Echoes back the raw User-Agent string that was parsed. |
| is_bot | string | Boolean flag indicating whether the UA matches a known bot or crawler signature. |
| bot | string | Identified bot name when is_bot is true (e.g. GPTBot, ClaudeBot, PerplexityBot), null otherwise. |
| browser | string | Detected browser name and version (e.g. Chrome 120, Firefox 115, Safari 17). |
| os | string | Detected operating system and version (e.g. Windows 11, macOS 14, iOS 17, Android 14). |
| device | string | Device class inferred from the UA: desktop, mobile, tablet, or bot. |
| source | string | Origin of the parse result, e.g. local-regex. |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/user-agent-parse \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# Install the MCP package for this endpoint's cluster npx -y @agentutility/mcp-<cluster> # Required: EVM private key with USDC on Base export X402_PRIVATE_KEY=0x... # Then call the user-agent-parse tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- web-probeuser-agentbrowser-detectionos-detectionbot-detectionai-crawlerua-parser
- methods
- POST
- cluster
- webprobe
- price
- $0.005 USDC per call
ADJACENT — other endpoints in webprobe
| endpoint | description | price |
|---|---|---|
| arxiv-bibtex | Turns an arXiv paper into a BibTeX entry: pulls title, authors, year, abstract, and DOI from the arXiv API and generates a properly-forma… | $0.005 |
| brand-domain-check | Checks whether a brand or company domain is established, expiring, registrar-locked, or newly registered, on the same RDAP backend as who… | $0.005 |
| brand-name-score | Scores a candidate brand or startup name on quality and risk. | $0.005 |
| brand-watch-domain-risk | Checks new or suspicious brand-adjacent domains for age, registrar, expiry, DNSSEC, and transfer/lock statuses. | $0.005 |
| company-name-score | Scores the quality of a company name before you commit to domain, handle, trademark, and launch work. | $0.005 |
| creator-domain-check | Checks creator, newsletter, podcast, and community domains for age, expiry, registrar, DNSSEC, and suspicious new-registration flags. | $0.005 |
| crypto-headlines | Crypto headlines API for agents that need breaking cryptocurrency news by topic or query. | $0.005 |
| crypto-news | Crypto news API that searches recent cryptocurrency headlines for a topic, token, protocol, or market event. | $0.005 |
SEE ALSO