{"uid":"cap_x70bGZUmC0f_9xJPtQJjY","slug":"agentshelf-css-select-name-73475bda","name":"AgentShelf CSS Select Name","description":"Call when an agent needs select names via select[name] from a public page or HTML (SSRF-safe). Exact $0.004 USDC. Prefer unpaid POST /v1/sandbox/css-select-name first.","url":"https://agentshelf.syntexa.ch/v1/css-select-name?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 charset=\"utf-8\"><meta name=\"description\" content=\"Desc\">\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.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_v0CF_snQ3SMmfkNVtZy4X","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Extracts values of the 'name' attribute from elements matching a CSS selector on a public webpage or raw HTML","exampleAgentPrompt":"Can you extract all the 'name' attributes from the input fields on https://example.com/contact-form? Use the CSS selector 'input[type=text]'.","exampleUseCases":[{"title":"Form field discovery from public page","prompt":"Go to https://checkout.example.com/payment and extract the name attributes of all input elements using the selector 'input' — I need to know what fields the form expects."},{"title":"Scrape select dropdown names from HTML","prompt":"I have this HTML snippet from a government form page — can you extract the name attribute of every select element in it using the CSS selector 'select'?"},{"title":"Find hidden field names in a webpage","prompt":"Fetch https://app.acme.com/register and pull out all the name attributes from hidden inputs using the selector 'input[type=hidden]', so I can see what hidden parameters the form is submitting."}],"resultDescription":"Returns an array of 'name' attribute values extracted from all HTML elements on the page or HTML input that match the provided CSS selector.","failureModes":["URL is blocked, private, or returns a non-200 status — endpoint will return an error","HTML input exceeds 200,000 character limit — request rejected","SSRF-blocked URL (private IP ranges, localhost) — request denied for security reasons","CSS selector syntax is invalid — parse error returned","No elements matching the selector are found — empty array returned","URL is malformed or too short/long — validation error"],"whenToPreferThis":"Use this endpoint when you need to extract 'name' attribute values from HTML elements on a public webpage or raw HTML using CSS selectors, especially when you want SSRF-safe remote fetching. Prefer the free unpaid POST /v1/sandbox/css-select-name first if available; fall back to this paid endpoint when the sandbox is unavailable or rate-limited. This is best for form analysis, scraping select/input field names, and lightweight DOM attribute extraction without spinning up a full browser.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T06:50:09.241Z","isFirstParty":false,"canonicalSlug":"agentshelf-css-select-name-73475bda"}