x402AgentTools

๐Ÿท๏ธURL Metadata (Live)

Fetch a URL server-side and extract its title, meta description, Open Graph and Twitter card tags, canonical URL and favicon โ€” the data agents need to preview or classify a link. SSRF-guarded: private networks are blocked, 10s timeout, 1MB cap.

๐Ÿ”Œ Server-side tool

This tool runs on the server (it fetches third-party URLs directly and cannot run in your browser). Use the paid JSON API below โ€” the worked examples show real server-side results and refresh automatically.

Worked examples

Inspect example.com

GET /api/v1/live/url-metadata?url=https%3A%2F%2Fexample.com

Result: Example Domain

x402 protocol site

GET /api/v1/live/url-metadata?url=https%3A%2F%2Fwww.x402.org

Result: x402

A blog post

GET /api/v1/live/url-metadata?url=https%3A%2F%2Fblog.google

Result: News from Google | Google Product and Technology News and Stories

Machine API (x402)

$0.003 / call

This tool is also a JSON API for AI agents. Requests without payment receive 402 Payment Required plus instructions; agents pay USDC on Base via the x402 protocol โ€” no accounts, no API keys.

GET /api/v1/live/url-metadata?url=https%3A%2F%2Fexample.com HTTP/1.1
Host: agenttools-hub.vercel.app

โ†’ 402 (payment required, instructions in headers)
โ†’ 200 (after X-PAYMENT header; JSON body below)

{
  "tool": "live/url-metadata",
  "input": {"url":"https://example.com"},
  "result": { "value": null, "answer": "Example Domain" }
}

Agent docs: /llms.txt ยท OpenAPI spec ยท integration guide

About this tool

Give it a URL and get back the metadata an agent needs to reference the page: title, description, Open Graph image, canonical URL and favicon. Fetching happens server-side with an SSRF guard (private networks blocked, redirects re-validated, hard size and time caps) so it is safe to expose.

Frequently asked questions

What is SSRF protection and why does it matter?

A URL-fetching service can be abused to probe internal networks. This tool resolves the hostname first and refuses private/loopback/link-local addresses, follows redirects manually with re-validation, and caps response size and time.

Does it render JavaScript?

No โ€” it reads the served HTML. Most sites put Open Graph tags in static HTML precisely for social crawlers, so coverage is high.

Related tools