{"uid":"cap_Tudnf49KXB-dnmROMkeqa","slug":"agentshelf-xpath-video-poster-extractor-94fb8ce2","name":"AgentShelf XPath Video Poster Extractor","description":"Call when an agent needs poster attributes of //video via //video/@poster from a public page or HTML (SSRF-safe). Exact $0.002 USDC. Prefer unpaid POST /v1/sandbox/xpath-video-poster first.","url":"https://agentshelf.syntexa.ch/v1/xpath-video-poster?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_CotB0pLwSTp8Qp-XdqmJL","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 the poster attribute value from HTML video elements using the XPath expression //video/@poster, given a URL or raw HTML","exampleAgentPrompt":"Can you extract the poster image URL from the video element on this page: https://example.com/watch/movie-trailer — I need the value of the poster attribute from the video tag.","exampleUseCases":[{"title":"Thumbnail preview for media aggregator","prompt":"I'm building a video feed and need to grab the poster image URL from the video tag on this page: https://media.example.com/episodes/s2e4 — can you pull the poster attribute for me?"},{"title":"Video poster from raw HTML snippet","prompt":"Here's some raw HTML I scraped from a site — can you extract the poster attribute from the video element in it? I need the URL it points to for the preview image."},{"title":"Automated poster audit for CMS content","prompt":"Check this article page at https://blog.mysite.com/post/video-intro and tell me what the video poster attribute is set to — I want to verify it's pointing to the right preview image."}],"resultDescription":"Returns the value of the poster attribute extracted from the first //video element found in the provided URL's page source or raw HTML, typically an image URL used as the video's thumbnail or preview image.","failureModes":["No video element found on the page — returns empty or null result","Page is behind authentication or returns non-200 status — fetch fails","Video element exists but has no poster attribute — returns empty","URL is unreachable or times out — network error response","HTML input exceeds 200,000 character limit — request rejected","URL string too short (under 8 chars) or too long (over 2048 chars) — validation error","SSRF-protected URLs (e.g. internal IPs, localhost) are blocked"],"whenToPreferThis":"Use this endpoint when you need to programmatically extract the poster attribute from an HTML video element on a public web page, and you either have the URL or raw HTML available. Prefer the free sandbox endpoint POST /v1/sandbox/xpath-video-poster first; use this paid endpoint when the sandbox is unavailable or rate-limited. This is ideal for media scraping, content auditing, or building video preview features without writing custom XPath parsing code.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T06:48:27.483Z","isFirstParty":false,"canonicalSlug":"agentshelf-xpath-video-poster-extractor-94fb8ce2"}