{"uid":"cap_bTJz6sbQVItA5Uy91r6JI","slug":"agentshelf-url-parser-abeb4eab","name":"AgentShelf URL Parser","description":"Call when an agent needs a URL split into scheme, host, path, query, and hash. No network. Exact $0.001 USDC. Prefer unpaid POST /v1/sandbox/url-parts first.","url":"https://agentshelf.syntexa.ch/v1/url-parts?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"type":"string","examples":["https://example.com/a?id=1#top"],"maxLength":2048,"minLength":8,"description":"Absolute URL to split into scheme, host, path, query, and hash. No fetch."}}},"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_m12jvzJAGDcktOuop7w2D","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":"Splits a URL into its constituent parts (scheme, host, path, query, and hash) without making any network requests","exampleAgentPrompt":"Can you break this URL into its parts — scheme, host, path, query, and hash — for me? The URL is https://example.com/products/search?q=shoes&color=red#results","exampleUseCases":[{"title":"Extract hostname from redirect URL","prompt":"I have this redirect URL https://shop.mystore.com/redirect?target=https%3A%2F%2Fpartner.site.com%2Fproducts%3Fid%3D42%23section2 — can you pull out just the host and path parts for me?"},{"title":"Validate URL structure before processing","prompt":"Before I send this URL to my pipeline, can you parse it into its scheme, host, path, query, and hash so I can confirm it's structured correctly? The URL is ftp://files.internal.org/data/export?format=csv&year=2024"},{"title":"Extract query string for analytics","prompt":"I need to know what query parameters are in this analytics URL: https://analytics.example.com/track?event=click&user=abc123&page=home#top — can you split it into its components?"}],"resultDescription":"Returns an object containing the parsed URL components: scheme (e.g. 'https'), host (e.g. 'example.com'), path (e.g. '/products/search'), query string (e.g. '?q=shoes'), and hash fragment (e.g. '#results'), derived purely from the input string with no network activity.","failureModes":["URL shorter than 8 characters returns a validation error","URL exceeds 2048 characters returns a length error","Malformed or unparseable URL strings may return an error or empty component fields","Missing required 'url' field returns a 400-style bad request response"],"whenToPreferThis":"Use this endpoint when you need a deterministic, offline URL decomposition with no network side effects and a guaranteed fixed cost of $0.001 USDC. It is ideal when you only need structural URL components (scheme, host, path, query, hash) without resolving, fetching, or following the URL. Prefer the free sandbox endpoint POST /v1/sandbox/url-parts first if available in your environment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T03:08:12.910Z","isFirstParty":false,"canonicalSlug":"agentshelf-url-parser-abeb4eab"}