URL inspector
Quick URL health and metadata check - parse the URL structure, verify reachability, and pull page metadata in one pass.
3 tools run server-side in one request. You pay once, settle once, and get a single response - no orchestration, no per-step payments, and a partial-success envelope if any step fails. USDC over x402 on any supported chain.
When to use this pack
An agent needs to verify a URL is live and understand what's behind it before recommending it, embedding it, or crawling it. Combines structural parsing (protocol, host, path), liveness check (status, latency, redirects), and metadata extraction (title, description, OG tags).
Tools in this pack
All 3 run inside the single $0.004 call above. Each is also callable on its own if you only need one part.
- URL parse POST /api/url-parse Parse a URL into components: protocol, host, port, path, query params (decoded), hash, origin, punycode hostname.
- HTTP check POST /api/http-check Check any public URL: status code, latency, final URL after redirects, and response headers. The uptime primitive for agent monitors.
- Page metadata GET /api/meta Fetch page metadata for a URL: title, description, OpenGraph, Twitter cards, canonical URL, favicon.
Bought one at a time, these 3 tools cost $0.004 together; the pack is that sum less a 10% bundle discount, rounded up to the $0.001 settlement floor, which is $0.004.
Workflow
- Call url-parse to decompose the URL into protocol, hostname, path, query parameters, and fragment.
- Call http-check to verify the URL is reachable - status code, latency, redirect chain.
- Call meta to pull the page's title, description, canonical URL, and OpenGraph/Twitter card tags.
Arguments
| Name | Required | Description | Example |
|---|---|---|---|
url | yes | URL to inspect (https://…) | https://stripe.com |
What one call returns
A JSON object with pack, args, steps, summary; steps holds one entry per tool (url-parse, http-check, meta), each with its own result or error. Full example on the API page.
Call it directly
Any x402 client pays the 402 and gets the whole workflow back in one response. With the agent402-client SDK (npm i agent402-client, an ES module):
import { Agent402 } from "agent402-client";
// payFetch: an x402-wrapped fetch your wallet signs (@x402/fetch).
// Tools on the free tier need no options: new Agent402() pays them by proof-of-work.
// an existing prepaid credits key also works: new Agent402({ creditsKey })
const client = new Agent402({ fetch: payFetch });
const result = await client.call("skill-url-inspector", {"url":"https://stripe.com"});
Run it in Claude
claude mcp add agent402 -s user -- npx -y agent402-mcp@latest
Then paste this prompt into Claude:
Inspect https://stripe.com using Agent402's url-inspector skill pack: (1) url-parse for structure, (2) http-check for reachability and latency, (3) meta for page metadata and OG tags. Report the URL health status and key metadata.