# Seo Audit

> Audita un sitio y entrega un informe SEO de una página, en lenguaje llano, que cualquiera puede accionar, centrado en una única acción para esta semana.

Fuente: https://skillsagentes.com/skills/every-app/open-seo/seo-audit
Markdown: https://skillsagentes.com/skills/every-app/open-seo/seo-audit.md

Repositorio: https://github.com/every-app/open-seo
Autor: every-app
Licencia: MIT
Actualizado: hace 12 días
Coste de contexto: 32 tok instalada, 1.8k tok al activarse, 3.1k tok con todos los archivos del bundle
Bundle: 2 archivos, 12 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add every-app/open-seo --skill seo-audit --agent claude-code
# Cursor
npx -y skills add every-app/open-seo --skill seo-audit --agent cursor
# Codex
npx -y skills add every-app/open-seo --skill seo-audit --agent codex
# Gemini CLI
npx -y skills add every-app/open-seo --skill seo-audit --agent gemini
# Windsurf
npx -y skills add every-app/open-seo --skill seo-audit --agent windsurf
# Cline
npx -y skills add every-app/open-seo --skill seo-audit --agent cline
```

## Qué hace

- Audita un dominio y produce un informe HTML de una página que hasta un principiante total puede leer una vez y accionar.
- Todo el informe existe para apoyar UNA acción que el dueño puede hacer esta semana; lo demás es detalle de apoyo.
- Usa herramientas MCP de OpenSEO: `run_site_audit`, `get_backlinks_overview`, `get_domain_overview` y una sola llamada de `research_keywords`, con gasto de créditos modesto.
- Verifica cada hallazgo contra el HTML real de la página antes de reportarlo y no dramatiza la falta de datos de backlinks o ranking.
- Rellena `template.html` con orden fijo (veredicto, la única acción, arreglos pequeños, dónde enfocarse, ya funciona, método) y tono calmado y llano.

## Cuándo usarla

- Se pide una auditoría o revisión SEO de un dominio, sobre todo si la salida es un informe compartible para alguien no experto.

## Cuándo no

- Análisis para expertos de un competidor o de un mercado: usa competitor-analysis o competitive-landscape.

## Qué la activa

- "Hazme una auditoría SEO de midominio.com"
- "Necesito un informe SEO de una página para enseñárselo a mi jefe"
- "Revisa el SEO de este sitio y dime la primera cosa que debería arreglar"

## Antes de instalar

- Necesita OpenSEO MCP conectado, un `projectId` (o crear el proyecto) y créditos; `whoami` confirma la conexión antes de gastar.

## Archivos

- SKILL.md — 7 KB
- template.html — 5 KB

## SKILL.md

Reproducido tal cual desde every-app/open-seo bajo MIT. Esta sección es el documento original y está en inglés.

# OpenSEO SEO Audit

## Goal

Audit a domain and produce a one-page HTML report that anyone, including a complete SEO beginner, can read once and act on. The whole report exists to support ONE action the owner can take this week; everything else is supporting detail.

Use this when asked for an SEO audit or review of a domain, especially when the output is a shareable report for a non-expert. For expert-facing analysis of a competitor or market, use `competitor-analysis` or `competitive-landscape` instead.

## Required inputs

- Domain to audit
- `projectId` (use `list_projects`; if no project matches the domain, create one with `create_project`)

## Project context

The project-context tools are free and shared with the app and other agents.

1. Call `get_project_context` first and ground the report in it — what the business does decides which findings matter and what the one thing should be.
2. This skill needs `business_overview`. If it is empty, run a minimal inline setup: infer what the business does from the site and confirm it with the user in one question, write it back with `update_project_context`, then continue the audit. Never front-load the full interview; suggest `seo-project-setup` at the end for the rest.
3. Before spending credits, check the research log. If the same research ran within the last 30 days, reuse that result and say so instead of re-buying it.
4. On finish, write back what is durable — a corrected `business_overview`, the pages the report singles out via `addKeyPages` — and append a research log entry: `{ appendResearchLog: { summary: "Site audit: <domain>. Verdict: <conclusion>" } }`.

## OpenSEO MCP tools

- `whoami`: confirm connection and remaining credits before spending anything. If OpenSEO is not connected, stop and ask the user to connect it.
- `list_projects` / `create_project`: resolve the `projectId`.
- `run_site_audit`: start the crawl (default page budget). Leave Lighthouse off (its default) — it adds several minutes and this report doesn't need it; pass `runLighthouse: true` only when the user asks for performance/Core Web Vitals depth. Then check `get_audit_status` (the crawl takes a minute or two — wait between checks rather than polling in a loop) and read `get_audit_issues`. Use `get_audit_pages` when per-page evidence helps.
- `get_backlinks_overview`: backlink and referring-domain picture; usually the deciding data for the "one thing".
- `get_domain_overview`: estimated organic traffic and organic keyword count. Skip when the site is clearly dead.
- `research_keywords`: keyword ideas with volume and difficulty, used to propose a starting focus area. One call with 1-3 seeds taken from what the site is actually about. Skip when the site is down.

Keep total spend modest: one audit, one backlinks overview, at most one domain overview, and at most one keyword-research call. Only the overview and keyword lookups spend credits.

## Workflow

1. `whoami`, then resolve the `projectId`.
2. `run_site_audit` for the domain (Lighthouse stays off unless the user asked for performance depth). While it crawls, fetch `get_backlinks_overview`.
3. When the crawl finishes, read `get_audit_issues` (and `get_domain_overview` if the site is alive).
4. If the audit comes back broken or nearly empty (certificate errors, 5xx, one page crawled): investigate before writing. Check the certificate and redirect variants yourself, and search the web for the business. A dead domain often has a live successor site, which flips the whole recommendation to "redirect the old domain".
5. Verify every finding you plan to report against the live page HTML by fetching pages yourself. Report nothing you have not seen evidence for.
6. Decide the one thing. Derive it from the data, never from generic advice. Common patterns:
   - Clean site, no backlinks: outreach to guests, partners, or directories, with a ready-to-send message.
   - Dead domain, live successor site: permanent redirect via hosting support, with the exact sentence to send them.
   - Blocked or noindexed pages: remove the block.
   It must be doable this week by a non-technical person, with copy-paste-ready mechanics included.
7. When the site is healthy, propose a starting focus area: run one `research_keywords` call seeded from the site's actual topic, then pick one theme and 3 to 5 specific, low-difficulty keywords the site can realistically rank for, each with the page or post to make. This is a starting direction, not a keyword strategy; point the user at the `keyword-research` skill for the full workflow. Skip this step entirely when the site is down — the one thing is all that matters there.
8. Write the report using `template.html` in this skill directory (see Output format).
9. Review before delivering: run an adversarial pass with a second agent or model if your environment has one, otherwise do a fresh self-review. Give the reviewer the verified facts and have it attack four things: claims beyond the facts, unglossed jargon, anything overwhelming for a beginner, and dramatic language. The reviewer may also flag true facts it was not given; check those against your evidence instead of "fixing" them.
10. Deliver the report: if your environment can publish or preview HTML (for example as an artifact), do that; otherwise save the HTML file and tell the user to open it in their browser.

## Output format

Use `template.html` next to this file. Fill in content; keep the CSS and structure as they are (light palette only, no dark mode).

- Header: domain as the title, the review date on its own line under it, then a 2-3 sentence summary of the whole report (overall state; the main gap and the one thing; what the report covers).
- Section order: verdict, the one thing, small fixes (5 to 10 max, ordered by impact), where to focus first (healthy sites only), already working, method footer.
- Each fix row shows the exact evidence (a quoted tag or number) and concrete steps a non-technical person can follow.
- "Where to focus first" names one topic area and 3 to 5 keywords, each with its search volume in plain words and the page or post to make. Omit the section when the site is down.

## Guardrails

- Tone: calm and plain. No exclamation points, no drama words, no em dashes, no "Not X. Y." contrasts, no filler. Severity words only where literally true (a down site is critical; a long title is not).
- Gloss every term of art in plain English on first use: canonical, meta description, alt text, crawler, 301, structured data.
- Skip nitpicks that do not matter for the specific site. A beginner report with twenty findings has failed.
- Missing backlink or ranking data means "no recorded data", not a penalty; say so rather than dramatizing it.
- Favor keywords the site can win now: specific intent, low difficulty. Do not list head terms a new site cannot rank for yet.
- Separate what the tools reported from what you verified yourself, and note both in the method footer.

## Dónde encaja

- Categoría: [SEO y GEO](https://skillsagentes.com/categorias/seo-geo.md) — Keywords, auditorías on-page, datos estructurados y visibilidad en respuestas de IA.
- Creador: [every-app](https://skillsagentes.com/creators/every-app.md) — 19 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Seo Coach](https://skillsagentes.com/skills/every-app/open-seo/seo-coach.md): Entra en un modo de coach de OpenSEO cercano que explica los flujos, recomienda los siguientes pasos y ayuda a usar bien agentes, búsqueda web, scraping y datos MCP.
- [Seo Project Setup](https://skillsagentes.com/skills/every-app/open-seo/seo-project-setup.md): Rellena el contexto compartido de OpenSEO de un proyecto (alcance del sitio, objetivos, posicionamiento, competidores, páginas clave y preferencias), más comprobaciones de MCP y entrada de Search Console.
- [Create Repo Skill](https://skillsagentes.com/skills/every-app/open-seo/create-repo-skill.md): Crea o actualiza una skill en este repositorio de la forma correcta: hogar canónico en `.agents/skills`, marca interna o pública, symlinks en `.claude/skills` y registro en las docs públicas para las skills de producto.
- [Keyword Research](https://skillsagentes.com/skills/every-app/open-seo/keyword-research.md): Descubre oportunidades de palabras clave, evalúa métricas y SERPs y guarda o etiqueta los términos prometedores usando los datos MCP de OpenSEO.
- [Local Seo](https://skillsagentes.com/skills/every-app/open-seo/local-seo.md): Audita un Google Business Profile, lo compara con competidores locales y mapea la visibilidad en Google Maps alrededor de una ubicación para decidir qué arreglar primero.

## Skills relacionadas

- [Keyword Research](https://skillsagentes.com/skills/every-app/open-seo/keyword-research.md): Descubre oportunidades de palabras clave, evalúa métricas y SERPs y guarda o etiqueta los términos prometedores usando los datos MCP de OpenSEO.
- [Seo Project Setup](https://skillsagentes.com/skills/every-app/open-seo/seo-project-setup.md): Rellena el contexto compartido de OpenSEO de un proyecto (alcance del sitio, objetivos, posicionamiento, competidores, páginas clave y preferencias), más comprobaciones de MCP y entrada de Search Console.
- [Seo Coach](https://skillsagentes.com/skills/every-app/open-seo/seo-coach.md): Entra en un modo de coach de OpenSEO cercano que explica los flujos, recomienda los siguientes pasos y ayuda a usar bien agentes, búsqueda web, scraping y datos MCP.
- [Local Seo](https://skillsagentes.com/skills/every-app/open-seo/local-seo.md): Audita un Google Business Profile, lo compara con competidores locales y mapea la visibilidad en Google Maps alrededor de una ubicación para decidir qué arreglar primero.
- [Keyword Clustering](https://skillsagentes.com/skills/every-app/open-seo/keyword-clustering.md): Agrupa palabras clave por intención y las mapea a páginas existentes o propuestas, decidiendo qué página debe apuntar a cada clúster e identificando riesgo de canibalización.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)