# Syntexa AgentShelf JSON-LD HowTo Extractor

> Syntexa AgentShelf JSON-LD HowTo 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-02).

Extracts JSON-LD @type HowTo structured data from a public URL or raw HTML, returning parsed schema.org HowTo objects.

## Facts

- Endpoint: POST https://agentshelf.syntexa.ch/v1/profile-jsonld-howto?utm_source=zero.xyz
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/syntexa-agentshelf-json-ld-howto-extractor-fb84408c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4mRNiCGJbGZZ28xw1ZvP_

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 syntexa-agentshelf-json-ld-howto-extractor-fb84408c -d '<json body>'
```

Example prompt: Can you extract the HowTo structured data (JSON-LD) from this page: https://www.example.com/how-to-make-pasta — I want the machine-readable step-by-step instructions in schema.org format.

## When to prefer this

Use this endpoint when you need to extract structured schema.org HowTo data from a public webpage or raw HTML, particularly for ingesting step-by-step instructions into a database, agent workflow, or knowledge base. Prefer the free sandbox endpoint (POST /v1/sandbox/profile-jsonld-howto) for testing. Choose this paid endpoint for production use where SSRF-safe remote fetching is required. It is not suitable for general web scraping, arbitrary JSON-LD types, or pages behind authentication.

## Known failure modes

- URL is not publicly accessible or returns a non-200 status — extraction fails
- Page contains no JSON-LD HowTo markup — returns empty result
- HTML input exceeds 200,000 character limit — request rejected
- URL triggers SSRF protection (private IP ranges, localhost) — blocked
- Malformed or invalid JSON-LD on the page — partial or no result returned
- URL string shorter than 8 characters or longer than 2048 characters — validation error

## How this service works

Call when an agent needs JSON-LD @type HowTo extracted from a public page or HTML (SSRF-safe). Exact $0.008 USDC. Prefer unpaid POST /v1/sandbox/profile-jsonld-howto first.

## Output

Returns parsed JSON-LD @type HowTo object(s) found in the page or HTML, including step names, descriptions, images, tools, and supply lists as defined by schema.org. If no HowTo markup is present, returns an empty or null result.

## 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/syntexa-agentshelf-json-ld-howto-extractor-fb84408c/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)