SEO Audit Agent Skill

---
description: Crawl, audit, analyze backlinks, and generate an SEO report using YepAPI.
homepage: https://yepapi.com/skills/seo-audit
metadata:
  tags: [yepapi, seo, audit, lighthouse]
---

# SEO Audit Workflow

Systematic SEO audit of any URL or domain using YepAPI endpoints.

## Endpoints Used

| Endpoint | Cost | Purpose |
|----------|------|---------|
| `POST /v1/seo/page-audit` | $0.03 | Technical SEO audit (meta, headings, links, images) |
| `POST /v1/seo/lighthouse` | $0.05 | Google Lighthouse scores (performance, a11y, SEO) |
| `POST /v1/seo/keywords` | $0.15 | Keyword metrics (volume, CPC, difficulty, intent) |
| `POST /v1/seo/backlinks/summary` | $0.03 | Aggregate backlink metrics and dofollow ratio |

## Workflow

### Step 1: Page Audit

Run `POST /v1/seo/page-audit` on the target URL.

```json
{
  "url": "https://example.com"
}
```

Returns: meta tags, heading structure, internal/external links, image alt text, technical issues.

### Step 2: Lighthouse Scores

Run `POST /v1/seo/lighthouse` on the target URL.

```json
{
  "url": "https://example.com"
}
```

Returns: performance, accessibility, SEO, and best practices scores (0-100).

### Step 3: Keyword Metrics (Optional)

If the user provides target keywords, run `POST /v1/seo/keywords`.

```json
{
  "keywords": ["target keyword 1", "target keyword 2"],
  "location": "us"
}
```

Returns: search volume, CPC, keyword difficulty, search intent, 12-month trends.

### Step 4: Backlink Summary

Run `POST /v1/seo/backlinks/summary` on the domain.

```json
{
  "target": "example.com"
}
```

Returns: total backlinks, dofollow ratio, domain rank, referring domains count.

### Step 5: Compile Report

Compile findings into a structured report:

1. **Critical Issues** — broken meta tags, missing H1, Lighthouse scores below 50
2. **Warnings** — duplicate titles, missing alt text, slow LCP
3. **Opportunities** — keyword gaps, backlink growth potential, quick performance wins

## Rules

- Always run page-audit first — cheapest ($0.03) and gives the most context
- Only run lighthouse if the user wants performance data — costs $0.05
- Keyword lookup is optional — only if the user provides target keywords
- Present findings as a prioritized list: critical issues first, then warnings, then opportunities

## Error Handling

- `NO_CREDITS` (402) — Tell the user to add credits at https://yepapi.com/dashboard
- `UPSTREAM_ERROR` (502) — Retry once; if it fails again, skip that step and note it in the report
- `VALIDATION_ERROR` (400) — Check the URL format; must include protocol (https://)
- `RATE_LIMITED` (429) — Wait and retry; respect the `Retry-After` header