{"uid":"cap_daYUDci902bc1raMU-huH","slug":"agentshelf-css-canonical-link-extractor-33ceca06","name":"AgentShelf CSS Canonical Link Extractor","description":"Call when an agent needs canonical hrefs via link[rel='canonical'] from a public page or HTML (SSRF-safe). Exact $0.001 USDC. Prefer unpaid POST /v1/sandbox/css-link-canonical first.","url":"https://agentshelf.syntexa.ch/v1/css-link-canonical?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.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jW_uhi7EIDnwVixSOPH91","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Extracts canonical URL(s) from a public webpage or raw HTML by selecting link[rel='canonical'] elements, with SSRF protection.","exampleAgentPrompt":"What's the canonical URL declared on https://example.com/some-article? Fetch the page and pull out the link[rel='canonical'] href.","exampleUseCases":[{"title":"SEO canonical tag audit","prompt":"Check https://www.myblog.com/post/how-to-bake-bread and tell me what canonical URL it declares — I want to make sure it's pointing to itself and not some other page."},{"title":"Deduplication before indexing","prompt":"Before I index this page, can you pull the canonical href from https://shop.example.com/product/blue-widget so I know which URL to store as the authoritative version?"},{"title":"Canonical check from raw HTML","prompt":"I have the raw HTML of a page already — can you extract the canonical link tag href from it for me? Here it is: <html><head><link rel='canonical' href='https://example.com/real-page'/></head></html>"}],"resultDescription":"Returns the href value(s) found in link[rel='canonical'] elements from the fetched or provided HTML. Typically a single canonical URL string, or an empty result if no canonical tag is present.","failureModes":["URL is unreachable or returns non-200 status — extraction fails with an error","SSRF-blocked URL (private IP, metadata endpoint) — rejected before fetch","No link[rel='canonical'] element found — returns empty result","HTML is malformed and canonical tag is unparseable — returns empty or partial result","Input HTML exceeds 200,000 character limit — request rejected","URL shorter than 8 characters or longer than 2048 — validation error"],"whenToPreferThis":"Use this endpoint when you need to programmatically determine the canonical URL of a page for SEO auditing, deduplication, or crawl prioritization. Prefer the free sandbox endpoint (/v1/sandbox/css-link-canonical) for testing. Use this paid endpoint for production use where SSRF safety and reliable parsing are required. Choose this over a generic HTML fetcher when you specifically need the canonical link tag and want a clean, structured result without post-processing raw HTML yourself.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T06:47:59.797Z","isFirstParty":false,"canonicalSlug":"agentshelf-css-canonical-link-extractor-33ceca06"}