How to Run a Technical SEO Page Audit Using Minifetch

Run a full technical SEO audit on a single web page. Minifetch builds you a structured report with PASS/ WARN/ FAIL findings for every signal. The audit flags long redirect chains, performance lags, missing or conflicting canonicals, headers, robots directives and more to ensure indexability. No black-box scoring — every threshold is documented and applied deterministically.

Building with an AI agent? This tutorial is also available as a skill your AI agent can load directly. The skill file also contains all the rules Minifetch uses for the audit: minifetch.com/skills/seo-page-audit/SKILL.md

For beginners:

The easiest way to run an audit is by entering your web page URL in the form at the top of our homepage. The results page generates a list of action items with simple, clear explanations in a handy UI (example↗). If you are non-technical and eager to get started or just want to try it out, that's really all you need to know. If you'd like to take the audit data with you and pipe it into an AI agent or automation pipeline there are instructions for workflows below.

One single web page audit costs $0.01. Sign up for automatic starter credits worth 25 free audits to start, then top up with your credit card for as little as $2 after. Minifetch is always pay-as-you-go. No subscription, no setup fees or monthly fees. You can also pay with a crypto wallet; all you need is USDC on Base or Solana.

For developers, builders, and AI agents:

Under the hood the audit is a composer API endpoint: /run/seo-page-audit. It combines our other endpoints: first it runs the /preflight check, extracts the /url-metadata and /url-links, and finally assembles all of that data into an audit report according to deterministic rules. You pay one price for the whole page audit, or call the individual pieces for a fraction of the full audit price. If the page is blocked or errors, the request fails and you are not charged.

  1. Get access - choose a payment method:

    Credit card & API key — Sign up on the dashboard and get credits worth 25 free audits automatically. Then create your API key. No credit card required to begin. Top up for as little as $2 with your credit card. Recommended for most builders.

    USDC on Base or Solana — Just load your wallet with USDC on Base or Solana and you're ready. No "gas token" (ETH or SOL) required. No Minifetch account setup needed. Recommended for agents and agent builders.

  2. Check the URL first Free

    Before spending a credit, run a quick preflight check to confirm the URL is fetchable. This is free and tells you whether the site's robots.txt allows Minifetch to fetch it. If you own the site and want to allow Minifetch access, see: How to Unblock Minifetch from your site.

    - From the homepage, enter your URL in the search box and click "Check URL".

    - Or from your CLI:

    curl "https://minifetch.com/api/v1/free/preflight/url-check?url=https://yoursite.com/your-page"

    - Or with the minifetch api, follow the README "Quick Start" section to initialize the client, then:

    const response = await client.preflightCheck("https://yoursite.com/your-page");
    Tip: The checkAndRunSeoPageAudit() method in the minifetch-api client runs the preflight automatically before every paid fetch — so you only pay when a result is likely. We never charge for blocked pages or errors.

  3. Run the audit $0.01 per URL

    - From the homepage, enter your URL then click "Go Fetch!".

    - Or from your CLI:

    curl "https://minifetch.com/api/v1/run/seo-page-audit?url=https://yoursite.com/your-page" \
  -H "Authorization: Bearer YOUR_API_KEY"

    - Or with the minifetch api:

    const response = await client.checkAndRunSeoPageAudit(
  "https://yoursite.com/your-page"
);
    For developers and AI agents: The API response maps directly to the signals search engines and social platforms care about. Every audit finding has the same shape: 

    {
  "status": "pass" | "warn" | "fail",
  "expected": ,
  ... // additional fields (value, count, length, etc.)
}

    Pure data fields (counts, dates, dimensions) appear without status or expected — they are informational pass-throughs.

  4. Audit rules

    Every threshold is documented. The audit utility applies these deterministically. No scoring model, no AI judgment.

    Audit rules are documented in two places: 1/ In the audit results UI↗ click on the rows that contain a [ + ] and the row will expand to reveal audit logic and rules. 2/ If you prefer, there is also a SKILL.md file that contains the same information, you can feed this file to your AI agent if you're working with one.

  5. Iterating on results

    The audit response from the API is a structured JSON document with pass/ warn/ fail findings throughout. Triage by status: filter for fail first, then warn. Pure data fields without status are informational.

    The full page audit composes the API primitives /extract/url-metadata + /extract/url-links + the audit rules. While iterating or monitoring, you can call the primitives directly; they cost a fraction of the full audit and return much of the same underlying data. The API primitives are also designed to be cheap and token-efficient, offering cost savings on both ends: lower Minifetch price as well as AI compute cost. Fetch only what you need, when you need it. Details on the API primitives are in the full API docs →

    Every audit response includes a minifetchCache object: 

    "minifetchCache": {
  "hit": false,
  "cachedAt": "2026-02-18T22:37:32.889Z",
  "expiresAt": "2026-02-18T22:39:32.889Z"
}

    Watch the minifetchCache.hit field — back-to-back calls within the cache window (~2 min) skip the network fetch entirely. Run the full audit again once your pipeline is stable and the cache expiresAt timestamp has passed. All Minifetch API endpoints share the cache, keyed by URL.