{"uid":"cap_OoK55SF4JKFPwA3e0Hctp","slug":"agentshelf-profile-rel-canonical-extractor-d69f1d77","name":"AgentShelf Profile Rel Canonical Extractor","description":"Call when an agent needs link rel tokens that equal canonical extracted from a public page or HTML (SSRF-safe). Exact $0.006 USDC. Prefer unpaid POST /v1/sandbox/profile-rel-canonical first.","url":"https://agentshelf.syntexa.ch/v1/profile-rel-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 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.006","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.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oEYxtLXe_-qxqldaOPdyE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Extracts the canonical URL from link[rel='canonical'] tags in a public webpage or HTML content","exampleAgentPrompt":"Can you extract the canonical URL from https://example.com/blog/my-article — I need the value from its link rel='canonical' tag?","exampleUseCases":[{"title":"SEO canonical URL audit","prompt":"I need to check the canonical URL set on https://shopify.com/products/widget — can you pull the link rel canonical tag from that page so I can verify it's correctly pointing to the right URL?"},{"title":"Duplicate content detection","prompt":"I have this HTML snippet from our CMS and I want to know what canonical URL it declares — can you extract the rel=canonical value from it?"},{"title":"Crawled page metadata extraction","prompt":"I'm building a link graph and need the canonical URL from https://medium.com/@author/some-post — can you fetch and extract the canonical link tag from that page?"}],"resultDescription":"Returns the value of the href attribute from the link[rel='canonical'] tag found in the page or HTML, typically a fully-qualified canonical URL string. Returns null or an empty result if no canonical tag is present.","failureModes":["URL is unreachable or returns non-200 status — extraction fails with network error","HTML does not contain a link[rel='canonical'] tag — returns empty/null result","URL points to internal/private network resource — blocked for SSRF safety","HTML content exceeds 200,000 character limit — request rejected","Malformed HTML prevents tag parsing — may return empty result","URL string shorter than 8 or longer than 2048 characters — validation error"],"whenToPreferThis":"Choose this endpoint when you specifically need to extract the canonical URL (link[rel='canonical']) from a webpage or HTML fragment, especially for SEO auditing, deduplication, or metadata enrichment workflows. Prefer the free sandbox endpoint (/v1/sandbox/profile-rel-canonical) for testing. Use this paid endpoint when you need reliable, SSRF-safe extraction in production. If you need other link[rel] values (not just canonical), use the sibling link[rel] extractor instead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T00:52:49.147Z","isFirstParty":false,"canonicalSlug":"agentshelf-profile-rel-canonical-extractor-d69f1d77"}