marketing: migra superfície SEO para OpenSEO (motor único)

As skills de SEO assentavam em quatro dependências, nenhuma operacional:
SEO Tools API (localhost:3000, pasta inexistente em disco), Ahrefs MCP
(nunca esteve em config), gsc e lighthouse (em disabledServers). Os seis
passos da /seo-audit e o workflow inteiro da /seo-report apontavam para
tooling morto — não eram executáveis.

- seo-audit v3.0: ordem por custo (grátis → lote pago → unitário pago),
  gate de mercado (PT = 2620/pt) e gate de maxPages
- seo-report v3.0: cobertura de crawl obrigatória no entregável
- ferramentas-api.md: inventário das 24 ferramentas OpenSEO + tabela de
  migração endpoint a endpoint
- implementacao-tecnica.md: striking distance, desperdício e filtro de
  ruído do GSC em código
- seo-specialist v3.0: primary_mcps [openseo], bloco de MCPs desligados,
  FID → INP nos Core Web Vitals

maxPages tem default 50: descomplicar.pt auditado com o default deu 25
URLs e 92 issues sem críticos; com maxPages 600 deu 1337 issues e 9
críticos. Documentado como gate — a fase Search Console dimensiona o crawl.

Limitações declaradas nas skills: get_audit_issues devolve contagens sem
URLs pela bridge MCP (structuredContent.issues não é entregue) e o whoami
não expõe saldo de créditos em self-hosted.
This commit is contained in:
2026-07-30 22:39:40 +01:00
parent f90ba6ec76
commit 2d05873642
9 changed files with 545 additions and 497 deletions
@@ -161,20 +161,26 @@ mcp__notebooklm__notebook_query({
## Ferramentas Recomendadas
### Validacao
### No stack (usar primeiro — são estes que temos)
- **Google Search Console** - Monitorizacao, indexacao
- **PageSpeed Insights** - Core Web Vitals
- **Schema Validator** - Testar structured data (schema.org/validator)
- **Mobile-Friendly Test** - Google mobile test
- **Rich Results Test** - Google rich results
| Necessidade | Ferramenta OpenSEO | Custo |
|---|---|---|
| Monitorização, indexação | `get_search_console_performance`, `inspect_urls` | grátis |
| Auditoria técnica completa | `run_site_audit` → `get_audit_issues` | grátis |
| Conteúdo fino, títulos, metas | `get_audit_issues` (`thin-content`, `title-*`, `meta-description-*`) | grátis |
| Keyword research | `get_keyword_metrics` (conhecidas) / `research_keywords` (novas) | pago |
| Backlinks | `get_backlinks_overview`, `get_backlinks_profile` | pago |
| Core Web Vitals | `chrome-devtools → performance_start_trace` | grátis |
### Analise
Inventário e tabela de migração: `../seo-audit/references/ferramentas-api.md`
- **Screaming Frog** - Auditoria tecnica completa
- **Ahrefs/Semrush** - Keyword research, backlinks
- **AnswerThePublic** - Long-tail questions
- **Google Trends** - Sazonalidade keywords
### Externas (validação manual)
- **Schema Validator** — testar structured data (schema.org/validator)
- **Rich Results Test** — Google rich results
- **Mobile-Friendly Test** — Google mobile test
- **AnswerThePublic** — long-tail questions
- **Google Trends** — sazonalidade de keywords
### Optimizacao
@@ -249,13 +249,16 @@ https://site.pt/este-url-e-muito-longo-com-muitas-palavras-desnecessarias/
### Ferramentas
| Ferramenta | Uso | Métricas |
|------------|-----|----------|
| Google Keyword Planner | Volume, CPC | Volume mensal, competição |
| Ahrefs | KD, SERP analysis | Keyword Difficulty, DR necessário |
| Semrush | Concorrência | Gap analysis, trending |
| AnswerThePublic | Long-tail questions | Questões reais utilizadores |
| Google Trends | Sazonalidade | Tendência temporal |
| Ferramenta | Uso | Métricas | Custo |
|------------|-----|----------|-------|
| **OpenSEO** `get_keyword_metrics` | Hidratar até 700 keywords conhecidas | Volume, KD, intenção, CPC, tendência | pago (lote) |
| **OpenSEO** `research_keywords` | Descobrir keywords novas (1-5 seeds) | Volume, KD, ideias relacionadas | pago (~30-100/seed — estimativa do schema, não medida) |
| **OpenSEO** `get_search_console_performance` | O que já posiciona (dados próprios) | Cliques, impressões, CTR, posição | **grátis** |
| **OpenSEO** `get_ranked_keywords` | Keywords de um domínio (nosso ou concorrente) | Posição, volume, tráfego | pago |
| AnswerThePublic | Long-tail questions | Questões reais de utilizadores | grátis |
| Google Trends | Sazonalidade | Tendência temporal | grátis |
**Ordem obrigatória:** Search Console primeiro (grátis e são dados de primeira mão), só depois as pagas. Mercado PT: `locationCode: 2620`, `languageCode: "pt"`.
### Keyword Difficulty Benchmarks