# Marketing Seo Contenido

> A Claude skill from victorperez22/marketing-claude-code.

- **Type:** Skill
- **Install:** `agentstack add skill-victorperez22-marketing-claude-code-marketing-seo-contenido`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [victorperez22](https://agentstack.voostack.com/s/victorperez22)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [victorperez22](https://github.com/victorperez22)
- **Source:** https://github.com/victorperez22/marketing-claude-code/tree/main/skills/marketing-seo-contenido

## Install

```sh
agentstack add skill-victorperez22-marketing-claude-code-marketing-seo-contenido
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Auditoria SEO de Contenido

## Proposito de la skill

Auditar SEO de una pagina o web a fondo, cubriendo SEO on-page, calidad de contenido (E-E-A-T), analisis de keywords, SEO tecnico y estrategia de contenido. Combina analisis automatico via `scripts/analizar_pagina.py` con revision experta manual para producir una auditoria SEO accionable.

## Cuando usarla

- El usuario facilita una URL y pide analisis SEO, auditoria o recomendaciones
- El usuario quiere mejorar rankings y trafico organico
- El usuario pregunta por SEO on-page, meta tags, calidad de contenido o SEO tecnico
- El usuario quiere analisis de gaps de contenido o recomendaciones de estrategia
- Se activa con `/marketing seo ` o `/marketing seo`

## Como ejecutarla

### Paso 1: Ejecutar el analisis automatico

Usa el script Python para obtener la data base:

```bash
python3 scripts/analizar_pagina.py 
```

Extrae:

- Title tag y meta description
- Open Graph tags
- Jerarquia de headings (H1-H6)
- Enlaces (internos y externos)
- Imagenes y estado de alt text
- Formularios y CTAs
- Schema / structured data
- Social links
- Scripts de tracking
- Viewport meta (indicador mobile-friendly)
- Canonical tag
- Directivas de robots meta

Captura el JSON y usalo como base del analisis manual.

### Paso 2: Checklist SEO on-page

Evalua cada elemento como Pass, A mejorar o Fail.

#### Title Tag

| Criterio             | Best practice                                                             | Resultado          |
| -------------------- | ------------------------------------------------------------------------- | ------------------ |
| Existe               | Cada pagina debe tener title unico                                        | Pass/Fail          |
| Longitud             | 50-60 caracteres (no se corta en SERPs)                                   | Pass/Amejorar/Fail |
| Keyword principal    | Incluye la keyword target                                                 | Pass/Amejorar/Fail |
| Posicion del keyword | Al principio del title                                                    | Pass/Amejorar/Fail |
| Marca                | Incluye nombre de marca (normalmente al final, separado por pipe o guion) | Pass/Amejorar/Fail |
| Unico                | Distinto al de otras paginas                                              | Pass/Fail          |
| Atractivo            | Querria el usuario hacer click?                                           | Pass/Amejorar/Fail |

**Errores habituales en title:**

- Demasiado largo (truncado en SERP)
- Sin keyword principal
- Keyword stuffing ("Mejor SEO | Top SEO | Software SEO | Plataforma SEO")
- Mismo title en varias paginas
- Titles genericos ("Inicio", "Bienvenido", "Pagina 1")
- Sin marca

#### Meta Description

| Criterio          | Best practice                           | Resultado          |
| ----------------- | --------------------------------------- | ------------------ |
| Existe            | Cada pagina debe tener meta description | Pass/Fail          |
| Longitud          | 150-160 caracteres                      | Pass/Amejorar/Fail |
| Keyword principal | Incluida de forma natural               | Pass/Amejorar/Fail |
| Call to action    | Da razon para clicar                    | Pass/Amejorar/Fail |
| Unica             | Distinta a la de otras paginas          | Pass/Fail          |
| Compelling        | Funciona como ad copy del resultado     | Pass/Amejorar/Fail |

#### Jerarquia de headings (H1-H6)

| Criterio                | Best practice                           | Resultado          |
| ----------------------- | --------------------------------------- | ------------------ |
| H1 existe               | Exactamente un H1 por pagina            | Pass/Fail          |
| H1 con keyword          | Keyword principal en el H1              | Pass/Amejorar/Fail |
| H1 difiere del title    | Relacionados pero distintos             | Pass/Amejorar/Fail |
| Jerarquia logica        | H2 bajo H1, H3 bajo H2 (sin saltos)     | Pass/Amejorar/Fail |
| Subtitulos descriptivos | H2s y H3s describen bien las secciones  | Pass/Amejorar/Fail |
| Keywords en subtitulos  | Secundarias aparecen de forma natural   | Pass/Amejorar/Fail |
| Uso adecuado            | Headers para estructura, no para estilo | Pass/Amejorar/Fail |

#### Optimizacion de imagenes

| Criterio             | Best practice                                              | Resultado          |
| -------------------- | ---------------------------------------------------------- | ------------------ |
| Alt text             | Cada imagen con alt descriptivo                            | Pass/Amejorar/Fail |
| Calidad del alt text | Alt describe la imagen e incluye keywords de forma natural | Pass/Amejorar/Fail |
| Nombres de archivo   | Descriptivos (no IMG_001.jpg)                              | Pass/Amejorar/Fail |
| Tamano de archivo    | Optimizadas para web (preferible WebP, comprimidas)        | Pass/Amejorar/Fail |
| Lazy loading         | Imagenes below-fold con lazy loading                       | Pass/Amejorar/Fail |
| Imagenes responsive  | Usa srcset o picture para tamanos distintos                | Pass/Amejorar/Fail |
| Decorativas          | alt="" vacio en decorativas (no alt ausente)               | Pass/Amejorar/Fail |

#### Linking interno

| Criterio                   | Best practice                             | Resultado          |
| -------------------------- | ----------------------------------------- | ------------------ |
| Enlaces internos presentes | La pagina enlaza a otras relevantes       | Pass/Amejorar/Fail |
| Anchor text                | Descriptivo (no "click aqui")             | Pass/Amejorar/Fail |
| Deep linking               | Enlazan a paginas concretas, no solo home | Pass/Amejorar/Fail |
| Contexto relevante         | Enlaces contextualmente relevantes        | Pass/Amejorar/Fail |
| Cantidad razonable         | 3-10 enlaces internos por 1.000 palabras  | Pass/Amejorar/Fail |
| Sin rotos                  | Sin 404s internos                         | Pass/Fail          |

#### Estructura de URL

| Criterio        | Best practice                                   | Resultado          |
| --------------- | ----------------------------------------------- | ------------------ |
| Legible         | URL humana y descriptiva                        | Pass/Amejorar/Fail |
| Keywords        | URL con keywords relevantes                     | Pass/Amejorar/Fail |
| Longitud        | Menos de 75 caracteres (ideal 4,0s  |
| First Input Delay (FID)        | 300ms |
| Cumulative Layout Shift (CLS)  | 0,25  |
| Time to First Byte (TTFB)      | 500ms |
| First Contentful Paint (FCP)   | 3,0s  |

**Problemas habituales de velocidad a marcar:**

- Imagenes sin optimizar (recomienda WebP, compresion)
- JS o CSS render-blocking
- Sin cache de navegador
- Sin CDN detectada
- Exceso de scripts de terceros (tracking, widgets, fuentes)
- CSS y JS sin minificar
- Sin compresion (gzip o brotli)

#### Mobile-friendliness

- [ ] Viewport meta presente (``)
- [ ] Texto legible sin zoom (16px minimo en body)
- [ ] Tap targets adecuados (minimo 48x48px)
- [ ] Sin scroll horizontal
- [ ] Imagenes responsive
- [ ] Formularios usables en movil

### Paso 6: Analisis de gaps de contenido

Metodologia:

1. **Identifica el cluster tematico:** cual es el tema principal?
2. **Mapea contenido existente:** que subtemas ya cubre?
3. **Detecta subtemas ausentes:** que cubren los competidores que tu no?
4. **Analiza People Also Ask:** que preguntas hace la gente?
5. **Revisa busquedas relacionadas:** que sugiere Google al pie del SERP?

**Plantilla de gaps:**
| Tema ausente | Volumen potencial | Competencia | Tipo de contenido | Prioridad |
| ------------ | ----------------- | ----------- | -------------------- | --------- |
| [Tema] | Alto/Medio/Bajo | Alta/Media/Baja | Blog/Guia/Tool/Pagina | 1-5 |

### Paso 7: Optimizacion para featured snippets

Oportunidades para capturar featured snippets:

**Tipos:**

1. **Parrafo** — respuesta en 40-60 palabras. Pregunta clara en H2/H3 seguida de respuesta concisa.
2. **Lista** — lista ordenada o desordenada con H2 que contiene la query.
3. **Tabla** — tablas HTML con headers claros.
4. **Video** — video con titulo descriptivo y timestamps.

**Checklist:**

- [ ] Ataca queries tipo pregunta ("como", "que es", "por que")
- [ ] Respuesta justo despues del heading
- [ ] Respuestas-parrafo entre 40-60 palabras
- [ ] Usa listas y tablas estructuradas cuando aplica
- [ ] Query objetivo en H2 o H3

### Paso 8: Auditoria de schema markup

| Tipo de schema         | Aplicable a                 | Estado              |
| ---------------------- | --------------------------- | ------------------- |
| Organization           | Home, About                 | Presente/Ausente    |
| LocalBusiness          | Negocios locales            | Presente/Ausente/NA |
| Product                | Paginas de producto         | Presente/Ausente/NA |
| Article                | Blog, noticias              | Presente/Ausente/NA |
| FAQ                    | Secciones FAQ               | Presente/Ausente    |
| HowTo                  | Tutoriales                  | Presente/Ausente/NA |
| Review/AggregateRating | Resenas, testimonios        | Presente/Ausente/NA |
| BreadcrumbList         | Paginas con migas           | Presente/Ausente    |
| WebSite/SearchAction   | Home (sitelinks search box) | Presente/Ausente    |
| Event                  | Paginas de eventos          | Presente/Ausente/NA |

**Guia:**

- Usa JSON-LD (formato preferido por Google)
- Valida con Google Rich Results Test
- No marques contenido invisible
- Mantenlo consistente con lo visible en pagina

### Paso 9: Oportunidades de linking interno

1. **Paginas huerfanas** — sin enlaces internos apuntando a ellas
2. **Hub pages** — paginas con autoridad que deberian enlazar a contenido relacionado
3. **Clusters tematicos** — agrupa contenido relacionado y crea estructura de linking
4. **CTA links** — contenido de blog que enlaza a paginas de producto/servicio
5. **Footer/sidebar** — enlaces sitewide a paginas importantes

**Arquitectura de linking:**

```
Home
  |-- Paginas de categoria/servicio (pillar content)
       |-- Posts/articulos concretos (cluster content)
            |-- Enlaces de vuelta al pillar
  |-- Paginas clave de conversion (pricing, signup, contacto)
       |-- Enlazadas desde contenido relevante
```

### Paso 10: Impacto de Core Web Vitals

Impacto en ingresos de Core Web Vitals:

**Impactos respaldados por data:**

- Webs que pasan todos los Core Web Vitals tienen 24% menos abandonos
- Reducir LCP 100ms correlaciona con +1,1% en CR
- Reducir CLS en 0,1 correlaciona con -15% de bounce rate
- Paginas que cargan en 2,5s | Optimizar hero image, preload de recursos criticos, CDN, reducir TTFB |
| FID/INP | >100ms | Reducir ejecucion de JS, diferir scripts no criticos, web workers |
| CLS | >0,1 | Fijar dimensiones de imagenes, reservar espacio para ads/embeds, no meter contenido sobre existente |

### Paso 11: Estrategia de contenido y blog

Segun los hallazgos, recomienda:

1. **Cadencia de publicacion** — con que frecuencia segun competencia y recursos
2. **Tipos de contenido** — blog, guias, tools, videos, infografias
3. **Estrategia de targeting de keywords** — balance entre volumen alto y long-tail
4. **Longitud de contenido** — benchmark contra el contenido top-rank del keyword
5. **Estrategia de actualizacion** — con que frecuencia refrescar existente
6. **Plan de distribucion** — como promocionar mas alla de organico

**Matriz de priorizacion de contenido:**
| Idea | Volumen | Competencia | Valor de negocio | Score de prioridad |
| ------ | --------------- | --------------- | ---------------- | ------------------ |
| [Tema] | Alto/Medio/Bajo | Alto/Medio/Bajo | Alto/Medio/Bajo | 1-10 |

Scoring: alto volumen + baja competencia + alto valor de negocio = prioridad maxima

## Formato de salida

Genera un archivo `AUDITORIA-SEO.md` con esta estructura:

```markdown
# Auditoria SEO de Contenido

## [URL]

### Fecha: [Fecha]

---

## SEO Health Score: [X/100]

---

## Checklist SEO on-page

### Title Tag

- Estado: [Pass/Amejorar/Fail]
- Actual: "[title actual]"
- Recomendado: "[title mejorado]"
- Issues: [lista de problemas]

### Meta Description

- Estado: [Pass/Amejorar/Fail]
- Actual: "[meta actual]"
- Recomendada: "[meta mejorada]"

### Jerarquia de headings

[Analisis de estructura H1-H6]

### Optimizacion de imagenes

[Resultados de auditoria de alt text]

### Linking interno

[Analisis de enlaces]

### Estructura de URL

[Assessment]

---

## Calidad de contenido (E-E-A-T)

| Dimension         | Score                           | Evidencia |
| ----------------- | ------------------------------- | --------- |
| Experience        | [Fuerte/Presente/Debil/Ausente] | [detalle] |
| Expertise         | [Fuerte/Presente/Debil/Ausente] | [detalle] |
| Authoritativeness | [Fuerte/Presente/Debil/Ausente] | [detalle] |
| Trustworthiness   | [Fuerte/Presente/Debil/Ausente] | [detalle] |

---

## Analisis de keywords

- Keyword principal: [keyword]
- Intent: [tipo]
- Ubicacion de keyword: [resultados del checklist]
- Keywords secundarias: [lista]

---

## SEO tecnico

[Resultados del check]

---

## Analisis de gaps de contenido

[Tabla de temas ausentes]

---

## Oportunidades de featured snippet

[Oportunidades concretas]

---

## Schema markup

[Actual vs recomendado]

---

## Oportunidades de linking interno

[Recomendaciones concretas]

---

## Core Web Vitals

[Assessment con impacto en ingresos]

---

## Recomendaciones de estrategia de contenido

[Plan de publicacion, prioridades]

---

## Recomendaciones priorizadas

### Criticas (fix inmediato)

1. [recomendacion con impacto esperado]

### Alta prioridad (este mes)

1. [recomendacion]

### Media prioridad (este trimestre)

1. [recomendacion]

### Baja prioridad (cuando haya recursos)

1. [recomendacion]
```

## Principios clave

- Las auditorias SEO deben ser educativas, no solo diagnosticas. Explica POR QUE importa cada elemento.
- Aporta siempre "antes" (estado actual) y "despues" (cambio recomendado) para que el cliente vea exactamente que cambiar.
- Ata las mejoras SEO a outcomes de negocio. "Optimizar tu title tag" no le dice nada a un dueno de negocio. "Optimizar tu title tag puede subir el CTR 20-35%, lo que son ~500 visitas extra al mes a esta pagina" si.
- Usa la data del script como punto de partida, pero anade analisis experto encima. El script encuentra los datos; la skill interpreta lo que significan.
- Prioriza por ratio esfuerzo-impacto. Cambiar un title es 5 minutos y afecta a cada impresion. Reescribir contenido son semanas.
- Si el usuario ejecuto `/marketing auditoria` o `/marketing landing`, cruza los hallazgos para un analisis mas completo.

**Nota contexto mercado hispanohablante:** el analisis funciona en cualquier idioma. En Espana B2B, priorizamos conversion sobre SEO organico en el scoring general.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [victorperez22](https://github.com/victorperez22)
- **Source:** [victorperez22/marketing-claude-code](https://github.com/victorperez22/marketing-claude-code)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-victorperez22-marketing-claude-code-marketing-seo-contenido
- Seller: https://agentstack.voostack.com/s/victorperez22
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
