{"uid":"cap_67ECr1YjgQJApSqpmiTxf","slug":"agentshelf-xpath-header-extractor-b8f6a820","name":"AgentShelf XPath Header Extractor","description":"Call when an agent needs text of //header via //header from a public page or HTML (SSRF-safe). Exact $0.007 USDC. Prefer unpaid POST /v1/sandbox/xpath-header first.","url":"https://agentshelf.syntexa.ch/v1/xpath-header?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.007","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.007/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4qOZt8S5BbKvBEQd_bfI4","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.007","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Extracts the text content of header elements (h1–h6) from a public webpage URL or raw HTML using XPath, with SSRF protection.","exampleAgentPrompt":"Can you pull the main header text from https://example.com/blog/article — just the h1 heading from that page?","exampleUseCases":[{"title":"Extract article title from news page","prompt":"Grab the h1 heading from https://www.bbc.com/news/technology-12345678 so I can display the article title in my dashboard."},{"title":"Check competitor page headline","prompt":"What's the main h1 heading on our competitor's homepage at https://competitor.com? I want to see how they're positioning themselves."},{"title":"Parse header from HTML snippet","prompt":"I have this HTML snippet from a product page — can you extract the h2 header text from it? Here's the HTML: <html><body><h2>Best Running Shoes 2024</h2><p>...</p></body></html>"}],"resultDescription":"Returns the extracted text content of the matched header element(s) found on the page or within the provided HTML, using XPath selection against h1–h6 tags.","failureModes":["URL is unreachable or returns a non-200 status","SSRF protection blocks private/internal IP ranges","HTML is malformed and cannot be parsed","No matching header element found at the specified XPath","Input exceeds maxLength limits (URL > 2048 chars, HTML > 200000 chars)","Payment of $0.007 USDC fails or is not provided"],"whenToPreferThis":"Choose this endpoint when you need to extract only the header/heading text from a page rather than full content, and you want SSRF-safe URL fetching built in. Use the unpaid sandbox POST /v1/sandbox/xpath-header first for testing; use this paid endpoint in production when you need reliable, low-latency header extraction at $0.007 USDC per call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T03:52:42.720Z","isFirstParty":false,"canonicalSlug":"agentshelf-xpath-header-extractor-b8f6a820"}