SEO Analysis Agent Skill
Full-site SEO scoring, crawl health, Core Web Vitals, and site-wide audit patterns using YepAPI.
The Skill
Full content, every format. Copy it, download it, or install with one command.
---
description: Full-site SEO scoring, crawl health, Core Web Vitals, and site-wide audit patterns using YepAPI.
homepage: https://yepapi.com/skills/seo-analysis
metadata:
tags: [yepapi, seo, analysis, audit]
---
# SEO Analysis
Full-site SEO scoring, crawl health, Core Web Vitals tracking, and site-wide audit patterns using YepAPI.
## 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 | Core Web Vitals and Lighthouse scores |
| `POST /v1/seo/keywords` | $0.15 | Keyword metrics (volume, difficulty, intent) |
| `POST /v1/seo/backlinks/summary` | $0.03 | Aggregate backlink health and dofollow ratio |
## Rules
- Start with `page-audit` ($0.03) — cheapest call, gives the most structural context
- Run `lighthouse` for Core Web Vitals: LCP, FID, CLS — flag anything outside "good" thresholds
- Crawl multiple pages for site-wide analysis: homepage, top landing pages, blog index — batch page-audit calls
- Score each page 0-100 based on: meta tags present, heading hierarchy, image alt coverage, internal link ratio
- Use `keywords` only when the user provides target keywords — it costs $0.15 per call
- Use `backlinks/summary` to assess domain authority and link profile health
- Present a site-wide scorecard: aggregate page scores, worst offenders, quick wins
- Prioritize issues: critical (broken meta, missing H1, CLS > 0.25) > warnings (missing alt text, slow LCP) > opportunities (keyword gaps, link building)
- Track over time: suggest re-running audits monthly and comparing scores
## Site-Wide Audit Pattern
1. Audit homepage with `page-audit` + `lighthouse`
2. Audit 3-5 key landing pages with `page-audit`
3. Run `backlinks/summary` on the domain
4. Optionally run `keywords` for target keyword tracking
5. Compile into a scorecard with per-page grades and a site-wide average
## 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` headerInstall
Why Use the SEO Analysis Skill?
Without this skill, your AI guesses at seo analysis patterns. It might hallucinate deprecated APIs, use outdated conventions, or miss best practices entirely. With it, your AI follows a proven ruleset — every suggestion aligns with current standards.
Drop this skill into your project and your AI instantly knows the rules. Better code suggestions, fewer errors, faster shipping. This skill also teaches your AI how to call YepAPI endpoints for real data — keyword metrics, SERP results, backlinks, or whatever this workflow needs.
Try These Prompts
These prompts work better with the SEO Analysis skill installed. Your AI knows the context and writes code that fits.
"Build a site-wide SEO scoring dashboard with crawl health and Core Web Vitals using YepAPI"
"Create an SEO analysis tool that grades pages on content, technical, and backlink factors"
"Set up automated SEO monitoring with weekly site audits and regression alerts"
SEO Analysis skill — FAQ
It connects to YepAPI for site-wide SEO scoring, crawl health analysis, and Core Web Vitals tracking. Your AI builds comprehensive SEO analysis tools with page-by-page grading.
Run `npx skills add YepAPI/skills --skill seo-analysis` in your project root. This copies the skill file into your repo where your AI coding tool can read it automatically.
The audit skill runs one-time crawl-and-fix checks. The analysis skill provides ongoing scoring, monitoring, and trend tracking. Use both together for a complete SEO workflow.