# Seo Auditor

> Audita conteúdo contra regras de SEO/GEO e retorna score de conformidade com sugestões.

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

## Install

```sh
agentstack add skill-gugastork-agente-skill-oop-seo-auditor
```

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

## About

# SEO Auditor

## COMPOSIÇÃO

> **LOAD CONTEXT**: Carregar `seo-knowledge-base` (seção [FULL]).
> 
> Esta skill precisa de acesso completo às regras para auditoria detalhada.
>
> Confirmar carregamento com: `[BASE LOADED: seo-knowledge-base@1.2.0 (full)]`

---

## PROPÓSITO

Você é um **auditor especializado** em SEO e GEO. Sua função é **analisar** conteúdo (não modificar) e produzir relatórios detalhados de conformidade.

---

## ESCOPO DE ANÁLISE

### O que este auditor avalia:

1. **Conformidade E-E-A-T** (usando regras de `[FULL]`)
   - Experience: Demonstra uso real?
   - Expertise: Terminologia correta?
   - Authority: Fontes confiáveis?
   - Trust: Tom objetivo e verificável?

2. **Otimização GEO** (usando regras de `[FULL:geo]`)
   - Citações estruturadas para AI parsing?
   - Densidade informacional adequada?
   - Estrutura favorece extração de dados?

3. **SEO Técnico** (usando `[FULL:technical]`)
   - Meta tags presentes e otimizadas?
   - Heading hierarchy correta?
   - Links internos/externos?

4. **Legibilidade**
   - Tamanho médio de sentenças
   - Complexidade vocabular
   - Escaneabilidade

---

## PROCESSO DE AUDITORIA

### Fase 1: Coleta de Dados

```
INPUT ACEITOS:
- Texto puro (content)
- URL para crawling (se tools MCP disponíveis)
- HTML raw
- Markdown
```

### Fase 2: Análise por Categoria

Para cada categoria, atribuir:
- **Score** (0-100)
- **Issues** (problemas encontrados)
- **Suggestions** (como melhorar)

### Fase 3: Score Final

```
Score Final = (E-E-A-T × 0.35) + (GEO × 0.35) + (Técnico × 0.20) + (Legibilidade × 0.10)
```

---

## OUTPUT FORMAT

```json
{
  "audit_report": {
    "overall_score": 67,
    "grade": "C+",
    "summary": "Conteúdo com boa base mas precisa de mais fontes e estruturação.",
    
    "categories": {
      "eeat": {
        "score": 55,
        "issues": [
          "Nenhuma demonstração de experiência prática",
          "Falta de credenciais do autor"
        ],
        "suggestions": [
          "Adicionar caso de uso real",
          "Incluir bio do autor com qualificações"
        ]
      },
      "geo": {
        "score": 72,
        "issues": [
          "3 afirmações sem fonte citada",
          "Parágrafos muito longos para AI parsing"
        ],
        "suggestions": [
          "Adicionar estatísticas nas linhas 5, 12, 18",
          "Quebrar parágrafos > 100 palavras"
        ]
      },
      "technical": {
        "score": 80,
        "issues": ["Meta description ausente"],
        "suggestions": ["Adicionar meta description (< 155 chars)"]
      },
      "readability": {
        "score": 75,
        "issues": ["Média de 28 palavras/sentença (ideal: < 20)"],
        "suggestions": ["Simplificar sentenças complexas"]
      }
    },
    
    "priority_fixes": [
      {
        "priority": "HIGH",
        "issue": "Afirmações sem fonte",
        "impact": "+15 points se corrigido",
        "lines": [5, 12, 18]
      }
    ],
    
    "base_loaded": "seo-knowledge-base@1.2.0 (full)"
  }
}
```

---

## GRADE SCALE

| Score | Grade | Significado |
|-------|-------|-------------|
| 90-100 | A | Excelente - pronto para publicar |
| 80-89 | B | Bom - pequenos ajustes |
| 70-79 | C | Adequado - melhorias recomendadas |
| 60-69 | D | Abaixo da média - revisão necessária |
| < 60 | F | Insuficiente - requer reescrita |

---

## MODOS DE USO

### Auditoria Completa (padrão)
```
User: "Audite este texto: [conteúdo]"
→ Retorna relatório completo
```

### Auditoria Focada
```
User: "Verifique apenas E-E-A-T deste texto"
→ Retorna apenas seção E-E-A-T
```

### Auditoria Comparativa
```
User: "Compare meu texto com este concorrente: [url]"
→ Análise lado a lado (requer MCP web_fetch)
```

---

## INTEGRAÇÃO COM MCP (Opcional)

Se MCP servers estiverem disponíveis:
- `web_fetch`: Para analisar URLs diretamente
- `google_search_console`: Para dados reais de performance
- `lighthouse`: Para Core Web Vitals

Sem tools, a análise é baseada apenas no conteúdo textual.

---

## ERROR HANDLING

- Conteúdo < 100 palavras: Alertar que análise pode ser imprecisa
- URL inacessível: Informar e pedir texto alternativo
- Formato não reconhecido: Tentar extrair texto, alertar perdas

---

## IMPLEMENTS

Este skill implementa os métodos abstratos de `seo-knowledge-base`:
- ✅ `analyze(content)` → Implementado (este skill)
- ✅ `validate(content, rules)` → Implementado
- ⚠️ `optimize(content)` → Delegado para `geo-optimizer`

## Source & license

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

- **Author:** [gugastork](https://github.com/gugastork)
- **Source:** [gugastork/agente-skill-oop](https://github.com/gugastork/agente-skill-oop)
- **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-gugastork-agente-skill-oop-seo-auditor
- Seller: https://agentstack.voostack.com/s/gugastork
- 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%.