# On-Page SEO Audit

SEO audit and on-page SEO analyzer: one page in about a second, a score out of 100 and a plain list of issues by severity.

Send a URL and get an on-page audit in about a second: what the page tells search engines, what it is missing, and a plain list of issues to fix, each with a severity. One page per call, read as HTML without running scripts. We honour robots.txt and opt-outs and ask each site slowly, so a page we may not read is refused and not charged.

- About a second per page.
- A plain list of issues with a severity each, not a dump of numbers: missing title, noindex, images without alt text, no structured data.
- We honour robots.txt and opt-outs; a page we may not read is refused and not charged.

## Calls

### `POST https://readymadeapi.com/v1/seo/audit`

Fetch one public page and report its title, description, headings, canonical address, indexing rules, language, images without alt text, links, social tags and structured data, with issues ranked by severity and a score out of 100.

- Price: $0.0012 per page
- MCP tool: `seo_audit_audit`
- Answers in the same call.

Request:

```json
{
  "url": "https://readymadeapi.com/samples/shop-page.html"
}
```

Answer:

```json
{
  "canonical": null,
  "description": null,
  "h1": ["Oak desk Linnea", "Now 449,00 EUR"],
  "headings": [2, 0, 0, 0, 0, 0],
  "hreflang": [],
  "html_bytes": 403,
  "images": {
    "total": 2,
    "without_alt": 1
  },
  "issues": [
    {
      "code": "noindex",
      "message": "The robots meta tag asks search engines not to index this page.",
      "severity": "error"
    },
    {
      "code": "short_title",
      "message": "The title is only 4 characters.",
      "severity": "warning"
    },
    {
      "code": "missing_description",
      "message": "The page has no meta description.",
      "severity": "warning"
    },
    {
      "code": "multiple_h1",
      "message": "The page has 2 <h1> headings; one main heading is clearer.",
      "severity": "warning"
    },
    {
      "code": "missing_lang",
      "message": "The <html> tag has no lang attribute.",
      "severity": "warning"
    },
    {
      "code": "missing_viewport",
      "message": "There is no viewport meta tag, so the page may not fit phones.",
      "severity": "warning"
    },
    {
      "code": "images_without_alt",
      "message": "1 of 2 images have no alt attribute.",
      "severity": "warning"
    },
    {
      "code": "missing_canonical",
      "message": "The page names no canonical address.",
      "severity": "info"
    },
    {
      "code": "no_open_graph",
      "message": "There are no Open Graph tags, so shared links show a plain preview.",
      "severity": "info"
    },
    {
      "code": "no_structured_data",
      "message": "There is no JSON-LD structured data.",
      "severity": "info"
    },
    {
      "code": "thin_content",
      "message": "The page has 18 words of text without running scripts.",
      "severity": "info"
    }
  ],
  "lang": null,
  "links": {
    "external": 1,
    "internal": 1,
    "nofollow": 1
  },
  "robots": "noindex, follow",
  "score": 35,
  "social": [],
  "structured_data": [],
  "title": "Shop",
  "url": "https://readymadeapi.com/samples/shop-page.html",
  "viewport": false,
  "words": 18
}
```

## Limits

- One public page per call, read without running scripts.

## Questions

**What does it check?**

Title, description, headings, canonical address, indexing rules, language, viewport, images without alt text, links, Open Graph and Twitter tags, structured data, word count and page size. In the answer, headings is the count of h1 to h6, in that order.

**Does it run JavaScript?**

No. It reads the HTML as a search engine's first pass does, and says so in the report.

**Does it crawl my site?**

No. One page per call.

**Why did I get a 429 site_busy?**

We ask each site slowly, across all our users. When a site has been asked too often you get an uncharged 429 with a Retry-After.

## Using it

- Send `Authorization: Bearer <key>` and a JSON body. Keys and credit: https://readymadeapi.com/account
- Every answer carries `X-Request-Id`, `X-Units` and `X-Charged-Usd`.
- An error is a JSON problem with a `title` to act on and a `detail` in plain words; nothing is charged for it.
- Full schema: https://readymadeapi.com/openapi.json
