{"uid":"cap_asX6S_YEjVyDb7XiSWRuB","slug":"agentshelf-profile-canonical-link-extractor-7d348810","name":"AgentShelf Profile Canonical Link Extractor","description":"Call when an agent needs the canonical link href extracted from a public page or HTML (SSRF-safe). Exact $0.001 USDC. Prefer unpaid POST /v1/sandbox/profile-canonical first.","url":"https://agentshelf.syntexa.ch/v1/profile-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.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_CxT8tQbKP6Vv-iiKHNr7U","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 the canonical link href from a public webpage by URL or raw HTML, with SSRF protection","exampleAgentPrompt":"Can you extract the canonical link href from this page — https://example.com/blog/my-post — so I know what URL it officially declares as its canonical version?","exampleUseCases":[{"title":"SEO canonical URL audit","prompt":"I have a list of blog posts and I need to check what canonical URL each one declares — can you start with https://myblog.com/2024/post-title and pull the canonical link href from that page?"},{"title":"Deduplication before crawl indexing","prompt":"Before I index this page, I need to know if it declares a different canonical URL — can you extract the canonical link href from the HTML I'm giving you? Here's the full HTML: <!DOCTYPE html><html><head><link rel=\"canonical\" href=\"https://example.com/official-page\"/></head><body></body></html>"},{"title":"Detect canonical mismatch for content syndication","prompt":"I syndicated an article to https://partner-site.com/articles/some-article — can you fetch that URL and tell me what canonical link it points to, so I can confirm it's pointing back to my original?"}],"resultDescription":"Returns the extracted canonical link href string found in the <link rel='canonical' href='...'> tag of the provided page or HTML. If no canonical tag is present, returns an appropriate null or empty response.","failureModes":["URL is unreachable or returns non-200 status — fetch fails with an error","No canonical link tag present in the page — returns empty or null canonical","SSRF-blocked URL (private IP ranges, internal hostnames) — rejected for security reasons","HTML too large (exceeds 200,000 character limit) — input validation error","URL too short (below 8 characters) — rejected by input schema","Malformed HTML where canonical tag cannot be parsed — may return empty result"],"whenToPreferThis":"Use this endpoint when you need to reliably extract the declared canonical URL from a public webpage or known HTML content in a paid, SSRF-safe manner. Prefer the free sandbox endpoint POST /v1/sandbox/profile-canonical for testing or unpaid use. Choose this over general HTML scrapers when you specifically need only the canonical link href without any broader extraction overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T06:45:40.209Z","isFirstParty":false,"canonicalSlug":"agentshelf-profile-canonical-link-extractor-7d348810"}