Site favicon grabber

Fetch a site's favicon/logo: reads the page's declared <link rel=icon…> tags (all variants with their sizes and types), deterministically picks the largest declared icon (falling back to /favicon.ico), fetches it, and returns the bytes as a base64 data URI plus the resolved icon URL and content type. Icons over 256KB return the URL and metadata without the inline data URI. SSRF-guarded — private-network hosts are rejected. Sites with no reachable icon return {found:false}.

Input

Example output

{
  "found": true,
  "url": "https://github.com/",
  "iconUrl": "https://github.githubassets.com/favicons/favicon.png",
  "finalIconUrl": "https://github.githubassets.com/favicons/favicon.png",
  "contentType": "image/png",
  "bytes": 958,
  "dataUri": "data:image/png;base64,iVBORw0KGgo…",
  "declared": [
    {
      "href": "https://github.githubassets.com/favicons/favicon.png",
      "rel": "alternate icon",
      "sizes": null,
      "type": "image/png",
      "mask": false
    }
  ]
}

Try it — see the 402 challenge (free)

curl -i -X POST https://agent402.tools/api/favicon-grab \
  -H "Content-Type: application/json" \
  -d '{"url":"https://github.com"}'

The response is HTTP 402 Payment Required with exact payment requirements. Any x402 v2 client pays automatically and retries:

Paid call (JavaScript agent)

import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);

const res = await payFetch("https://agent402.tools/api/favicon-grab", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "url": "https://github.com"
  }),
});

Part of these workflows

This tool is one step in a curated multi-tool workflow — agents can fetch the whole sequence as an MCP prompt or call https://agent402.tools/api/skill-packs/{slug}/prompt.

• Entity enrichment — Company name → verified identity + web footprint dossier: Wikidata facts, the official LEI legal-entity record, the SEC EDGAR filer, domain registration, tech stack, and brand favicon — in one pass.

Related tools