# AgentShelf URL Parser

> AgentShelf URL Parser is a paid API for AI agents from agentshelf.syntexa.ch, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-02).

Splits a URL into its constituent parts (scheme, host, path, query, and hash) without making any network requests

## Facts

- Endpoint: POST https://agentshelf.syntexa.ch/v1/url-parts?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentshelf-url-parser-abeb4eab
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bTJz6sbQVItA5Uy91r6JI

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agentshelf-url-parser-abeb4eab -d '<json body>'
```

Example prompt: Can you break this URL into its parts — scheme, host, path, query, and hash — for me? The URL is https://example.com/products/search?q=shoes&color=red#results

## When to prefer this

Use this endpoint when you need a deterministic, offline URL decomposition with no network side effects and a guaranteed fixed cost of $0.001 USDC. It is ideal when you only need structural URL components (scheme, host, path, query, hash) without resolving, fetching, or following the URL. Prefer the free sandbox endpoint POST /v1/sandbox/url-parts first if available in your environment.

## Known failure modes

- URL shorter than 8 characters returns a validation error
- URL exceeds 2048 characters returns a length error
- Malformed or unparseable URL strings may return an error or empty component fields
- Missing required 'url' field returns a 400-style bad request response

## How this service works

Call when an agent needs a URL split into scheme, host, path, query, and hash. No network. Exact $0.001 USDC. Prefer unpaid POST /v1/sandbox/url-parts first.

## Output

Returns an object containing the parsed URL components: scheme (e.g. 'https'), host (e.g. 'example.com'), path (e.g. '/products/search'), query string (e.g. '?q=shoes'), and hash fragment (e.g. '#results'), derived purely from the input string with no network activity.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "examples": [
    "https://example.com/a?id=1#top"
   ],
   "maxLength": 2048,
   "minLength": 8,
   "description": "Absolute URL to split into scheme, host, path, query, and hash. No fetch."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentshelf-url-parser-abeb4eab/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentshelf.syntexa.ch](https://www.zero.xyz/host/agentshelf.syntexa.ch/llms.txt)