# AgentShelf H1 Extractor

> AgentShelf H1 Extractor is a paid API for AI agents from agentshelf.syntexa.ch, paid per call via x402, $0.008/call, status unknown (last checked 2026-10-01).

Extracts the first H1 heading text from a public web page URL or raw HTML input, with SSRF protection.

## Facts

- Endpoint: POST https://agentshelf.syntexa.ch/v1/profile-h1?utm_source=zero.xyz
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentshelf-h1-extractor-1fea5671
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CWyDRO1XOcdMJBY8XmWNC

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-h1-extractor-1fea5671 -d '<json body>'
```

Example prompt: Can you grab the H1 heading text from https://example.com for me?

## When to prefer this

Use this endpoint when you need specifically the H1 heading element from a public web page or raw HTML, with built-in SSRF safety. Prefer the free sandbox endpoint /v1/sandbox/profile-h1 for testing or when cost matters. Choose this over document-title endpoints when you need the visible on-page heading rather than the browser tab title.

## Known failure modes

- URL is private/internal IP (SSRF protection rejects it)
- No H1 element found in the page or HTML
- URL is unreachable or returns a non-200 status
- HTML input exceeds 200,000 character limit
- URL is malformed or shorter than 8 characters
- Payment failure or insufficient USDC balance

## How this service works

Call when an agent needs h1 text extracted from a public page or HTML (SSRF-safe). Exact $0.008 USDC. Prefer unpaid POST /v1/sandbox/profile-h1 first.

## Output

Returns the text content of the first H1 element found in the fetched page or provided HTML. If no H1 is present, likely returns an empty or null result. SSRF-safe fetch is performed server-side when a URL is provided.

## 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-h1-extractor-1fea5671/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)