{"uid":"cap_xwZ4v6Z4mEYwK03rlZg4S","slug":"agentshelf-xpath-nav-href-extractor-9172d83b","name":"AgentShelf XPath Nav Href Extractor","description":"Call when an agent needs href attributes of anchors under //nav via //nav//a/@href from a public page or HTML (SSRF-safe). Exact $0.002 USDC. Prefer unpaid POST /v1/sandbox/xpath-nav-href first.","url":"https://agentshelf.syntexa.ch/v1/xpath-nav-href?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.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_r8wOHGuyWtFUrtN45bp3r","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Extracts href attribute values from anchor elements within nav sections of a web page or HTML document using XPath //nav//a/@href","exampleAgentPrompt":"Can you pull all the navigation link URLs from https://example.com — specifically the href values from anchors inside nav elements?","exampleUseCases":[{"title":"Audit website navigation structure","prompt":"I need to audit the navigation structure of https://mybrand.com — can you extract all the href links from its nav elements so I can see what pages are linked in the menu?"},{"title":"Build sitemap from nav links","prompt":"Grab all the nav anchor hrefs from this HTML I'm pasting so I can use them to build a sitemap: <html><nav><a href='/about'>About</a><a href='/contact'>Contact</a></nav></html>"},{"title":"Monitor competitor navigation changes","prompt":"Extract all the navigation href links from https://competitor.com so I can compare them to last week's list and see if they've added or removed any menu items."}],"resultDescription":"Returns a list of href attribute values found in anchor tags under nav elements on the target page or HTML, extracted via the XPath expression //nav//a/@href. The response typically includes an array of URL strings representing navigation links.","failureModes":["URL is unreachable or returns non-200 status — extraction fails with an error","HTML contains no nav elements or nav anchors — returns empty list","SSRF-blocked URL (private IP ranges, localhost) — rejected with safety error","HTML input exceeds 200,000 character limit — request rejected","Malformed or invalid HTML — XPath may return partial or no results","URL parameter too short (under 8 chars) or too long (over 2048 chars) — validation error"],"whenToPreferThis":"Use this endpoint when you specifically need to extract navigation link hrefs (//nav//a/@href) from a public webpage or raw HTML, and want an SSRF-safe hosted service rather than running XPath locally. Prefer the free sandbox POST /v1/sandbox/xpath-nav-href endpoint first; fall back to this paid endpoint ($0.002 USDC) when the sandbox is unavailable or quota-limited. Choose this over generic scraping APIs when you need precise XPath-scoped nav extraction without building your own parser.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-24T00:53:43.561Z","isFirstParty":false,"canonicalSlug":"agentshelf-xpath-nav-href-extractor-9172d83b"}