# AgentShelf XPath Address Text Extractor

> AgentShelf XPath Address Text Extractor 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).

Extracts text at an XPath address from a public webpage URL or raw HTML input, SSRF-safe.

## Facts

- Endpoint: POST https://agentshelf.syntexa.ch/v1/xpath-address?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-xpath-address-text-extractor-2caa1e38
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LOOG95khu1o1mJBk79FjA

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-xpath-address-text-extractor-2caa1e38 -d '<json body>'
```

Example prompt: Can you extract the text at XPath //h1[@class='product-title'] from the page at https://example.com/products/widget?

## When to prefer this

Use this endpoint when you need to extract text at a precise XPath location from a public webpage or a known HTML string. It is SSRF-safe and purpose-built for XPath-based extraction without requiring a full browser or LLM. Prefer the free /v1/sandbox/xpath-address endpoint for testing before committing to paid calls.

## Known failure modes

- XPath expression matches no nodes — returns empty or null result
- Invalid XPath syntax causes a parse error
- URL is unreachable, returns non-200, or is blocked by robots/firewall
- HTML input exceeds 200,000 character limit
- URL exceeds 2,048 character limit
- SSRF-protected URLs (private IPs, internal hosts) are rejected
- Malformed or missing both url and html fields causes validation error

## How this service works

Call when an agent needs text of //address via //address from a public page or HTML (SSRF-safe). Exact $0.001 USDC. Prefer unpaid POST /v1/sandbox/xpath-address first.

## Output

Returns the extracted text content found at the specified XPath address within the fetched public page or provided HTML. The response contains the matched text string(s) from the resolved XPath node(s).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "maxLength": 2048,
   "minLength": 8,
   "description": "Public page to fetch. The selector or profile is fixed by the SKU. Provide url or html."
  },
  "html": {
   "type": "string",
   "examples": [
    "<!doctype html><html lang=\"en\"><head><title>Hello</title>\n<meta name=\"description\" content=\"Desc\"><meta property=\"og:title\" content=\"OG\">\n<link rel=\"canonical\" href=\"https://example.com/\"><link rel=\"icon\" href=\"/favicon.ico\">\n</head><body><h1>Hello</h1><a href=\"https://example.com/a\">A</a></body></html>"
   ],
   "maxLength": 200000,
   "minLength": 1,
   "description": "HTML to extract from locally. Provide html or url. When both are set, html is used."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentshelf-xpath-address-text-extractor-2caa1e38/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)