Merge remote-tracking branch 'origin/main'

# Conflicts: # .claude-plugin/marketplace.json # .gitignore # acidaos/skills/devops/SKILL.md # acidaos/skills/docs/SKILL.md # acidaos/skills/rust-dev/SKILL.md # acidaos/skills/spoke-dev/SKILL.md # automacao/agents/automation-lead.md # automacao/agents/mcp-protocol-developer.md # automacao/agents/n8n-automation-expert.md # automacao/skills/moloni-api/SKILL.md # automacao/skills/n8n/SKILL.md # core-tools/skills/_core/SKILL.md # core-tools/skills/agent-context-injector/SKILL.md # core-tools/skills/component-generator/SKILL.md # core-tools/skills/db-maintenance-manager/SKILL.md # core-tools/skills/infrastructure-manager/SKILL.md # core-tools/skills/metrics/SKILL.md # core-tools/skills/plugin-curator/SKILL.md # core-tools/skills/plugin-manager/SKILL.md # core-tools/skills/plugin-manager/profiles.json # core-tools/skills/quality-validator/SKILL.md # core-tools/skills/relationship-manager/SKILL.md # crm-ops/.claude-plugin/plugin.json # crm-ops/CHANGELOG.md # crm-ops/agents/budget-proposal-specialist.md # crm-ops/agents/lead-approach-strategist.md # crm-ops/agents/lead-qualifier.md # crm-ops/agents/sales-manager.md # crm-ops/agents/support-specialist.md # crm-ops/skills/auto-expense/SKILL.md # crm-ops/skills/billing-check/SKILL.md # crm-ops/skills/crm-admin/SKILL.md # crm-ops/skills/crm/SKILL.md # crm-ops/skills/desk/SKILL.md # crm-ops/skills/estrategia-marca/SKILL.md # crm-ops/skills/estrategia-marca/references/metodologia-acida.md # crm-ops/skills/estrategia-marca/references/template-documento.md # crm-ops/skills/expense/SKILL.md # crm-ops/skills/invoice/SKILL.md # crm-ops/skills/orcamento/SKILL-light.md # crm-ops/skills/orcamento/SKILL.md # crm-ops/skills/proposal-deck/SKILL.md # crm-ops/skills/proposta-visual/SKILL.md # crm-ops/skills/ticket-manage/SKILL.md # crm-ops/skills/ticket-triage/SKILL.md # crm-ops/skills/ticket/SKILL.md # design-media/agents/design-critic.md # design-media/agents/design-generator.md # design-media/agents/design-lead.md # design-media/agents/design-prompt-architect.md # design-media/agents/design-researcher.md # design-media/agents/ui-designer.md # design-media/agents/video-production-specialist.md # design-media/agents/web-designer.md # design-media/skills/brand-guidelines/SKILL.md # design-media/skills/brand-guidelines/references/descomplicar-theme.md # design-media/skills/cinematic-site/SKILL.md # design-media/skills/clone-style/SKILL.md # design-media/skills/design-b2b/SKILL.md # design-media/skills/design-ecommerce/SKILL.md # design-media/skills/design-saude/SKILL.md # design-media/skills/design-solar/SKILL.md # design-media/skills/design/SKILL.md # design-media/skills/design/references/premium-proposals.md # dev-tools/agents/database-design-specialist.md # dev-tools/agents/dev-helper.md # dev-tools/agents/development-lead.md # dev-tools/agents/javascript-fullstack-specialist.md # dev-tools/agents/nextjs-specialist.md # dev-tools/agents/php-fullstack-engineer.md # dev-tools/skills/benchmark/SKILL.md # dev-tools/skills/canary/SKILL.md # dev-tools/skills/chrome/SKILL.md # dev-tools/skills/db-design/SKILL.md # dev-tools/skills/dep-audit/SKILL.md # dev-tools/skills/diagrama/SKILL.md # dev-tools/skills/docx/SKILL-light.md # dev-tools/skills/docx/SKILL.md # dev-tools/skills/docx/scripts/__init__.py # dev-tools/skills/docx/scripts/office/pack.py # dev-tools/skills/docx/scripts/office/unpack.py # dev-tools/skills/docx/scripts/office/validate.py # dev-tools/skills/nextjs/SKILL.md # dev-tools/skills/pdf/SKILL-light.md # dev-tools/skills/pdf/SKILL.md # dev-tools/skills/php-dev/SKILL.md # dev-tools/skills/prompt-refine/SKILL.md # dev-tools/skills/react-patterns/SKILL.md # dev-tools/skills/skill-creator/SKILL.md # dev-tools/skills/skill-creator/references/descomplicar-standards.md # dev-tools/skills/webapp-testing/SKILL.md # dev-tools/skills/webapp-testing/scripts/with_server.py # dev-tools/skills/xlsx/SKILL.md # dev-tools/skills/xlsx/scripts/office/pack.py # dev-tools/skills/xlsx/scripts/office/unpack.py # dev-tools/skills/xlsx/scripts/office/validate.py # dev-tools/skills/youtube-extract/SKILL.md # gestao/.claude-plugin/plugin.json # gestao/agents/analytics-insights-agent.md # gestao/agents/compliance-auditor.md # gestao/agents/project-manager.md # gestao/agents/reflect-agent.md # gestao/agents/software-project-planner.md # gestao/agents/time-management-agent.md # gestao/agents/wiki-knowledge-agent.md # gestao/skills/aiktop-tasks/SKILL.md # gestao/skills/archive/SKILL.md # gestao/skills/calendar-manager/SKILL.md # gestao/skills/cleanup-downloads/SKILL.md # gestao/skills/clip-agent/SKILL.md # gestao/skills/clip-health/SKILL.md # gestao/skills/clip-instructions/SKILL.md # gestao/skills/clip-issue/SKILL.md # gestao/skills/clip-org/SKILL.md # gestao/skills/clip-routine/SKILL.md # gestao/skills/clip-skill/SKILL.md # gestao/skills/clip-vision/SKILL.md # gestao/skills/clip/SKILL.md # gestao/skills/daily-digest/SKILL.md # gestao/skills/deep-research/SKILL.md # gestao/skills/delegate/SKILL.md # gestao/skills/doc-coauthoring/SKILL.md # gestao/skills/dual-review/SKILL.md # gestao/skills/hub-compile/SKILL.md # gestao/skills/hub-search/SKILL.md # gestao/skills/imap-triage/SKILL.md # gestao/skills/index-update/SKILL.md # gestao/skills/knowledge/SKILL.md # gestao/skills/knowledge/docs/workflow.md # gestao/skills/knowledge/references/routing-guide.md # gestao/skills/mindmap/SKILL.md # gestao/skills/monday-briefing/SKILL.md # gestao/skills/notebooklm/SKILL.md # gestao/skills/office-hours/SKILL.md # gestao/skills/onboarding/SKILL.md # gestao/skills/proc-creator/SKILL.md # gestao/skills/reflect/SKILL.md # gestao/skills/report-templates/SKILL.md # gestao/skills/report/SKILL.md # gestao/skills/research-pipeline/SKILL.md # gestao/skills/review-corrections/SKILL.md # gestao/skills/spec-coauthor/SKILL.md # gestao/skills/task-state/SKILL.md # gestao/skills/tasks-overview/SKILL.md # gestao/skills/time/SKILL.md # gestao/skills/today/SETUP_MCPS.md # gestao/skills/today/SKILL.md # gestao/skills/today/prompts/execute.md # gestao/skills/today/templates/daily-report.md # gestao/skills/validate-component/SKILL.md # gestao/skills/worklog/SKILL.md # infraestrutura/.claude-plugin/plugin.json # infraestrutura/agents/backup-specialist.md # infraestrutura/agents/cwp-server-manager.md # infraestrutura/agents/easypanel-specialist.md # infraestrutura/agents/infrastructure-orchestrator.md # infraestrutura/agents/proxmox-specialist.md # infraestrutura/agents/security-compliance-specialist.md # infraestrutura/skills/authentik/SKILL.md # infraestrutura/skills/backup-strategies/SKILL.md # infraestrutura/skills/backup-strategies/references/scripts.md # infraestrutura/skills/cwp/SKILL.md # infraestrutura/skills/easypanel-api/SKILL.md # infraestrutura/skills/easypanel-cicd/SKILL.md # infraestrutura/skills/easypanel-deploy/SKILL.md # infraestrutura/skills/easypanel-init/SKILL.md # infraestrutura/skills/easypanel-monitor/SKILL.md # infraestrutura/skills/easypanel-rollback/SKILL.md # infraestrutura/skills/easypanel-troubleshoot/SKILL.md # infraestrutura/skills/easypanel-validate/SKILL.md # infraestrutura/skills/gateway-check/SKILL.md # infraestrutura/skills/infra-check/SKILL.md # infraestrutura/skills/mcp-dev/SKILL.md # infraestrutura/skills/mcp-dev/references/best-practices.md # infraestrutura/skills/mcp-dev/references/evaluation-guide.md # infraestrutura/skills/mcp-dev/references/templates.md # infraestrutura/skills/pbs-config/SKILL.md # infraestrutura/skills/proxmox-cluster/SKILL.md # infraestrutura/skills/proxmox-ha/SKILL.md # infraestrutura/skills/proxmox-setup/SKILL.md # infraestrutura/skills/security-audit/SKILL.md # infraestrutura/skills/security-check/SKILL.md # infraestrutura/skills/server-health/SKILL.md # infraestrutura/skills/vm-migration/SKILL.md # marketing/.claude-plugin/plugin.json # marketing/CHANGELOG.md # marketing/agents/content-manager.md # marketing/agents/copywriter.md # marketing/agents/marketing-planning-expert.md # marketing/agents/ppc-specialist.md # marketing/agents/seo-specialist.md # marketing/agents/social-media-manager.md # marketing/agents/video-production-specialist.md # marketing/agents/youtube-specialist.md # marketing/skills/ads/SKILL.md # marketing/skills/content-marketing-pt/SKILL.md # marketing/skills/lead-approach/SKILL.md # marketing/skills/marketing-strategy/SKILL.md # marketing/skills/seo-audit/SKILL.md # marketing/skills/seo-audit/references/ferramentas-api.md # marketing/skills/seo-audit/references/template-relatorio-auditoria.md # marketing/skills/seo-content-optimization/SKILL.md # marketing/skills/seo-content-optimization/references/structured-data.md # marketing/skills/seo-report/SKILL.md # marketing/skills/seo-report/references/implementacao-tecnica.md # marketing/skills/seo-report/references/template-relatorio.md # marketing/skills/social-media/SKILL.md # marketing/skills/trend-signal/SKILL.md # marketing/skills/video/SKILL.md # marketing/skills/video/rules/3d.md # marketing/skills/video/rules/animations.md # marketing/skills/video/rules/assets.md # marketing/skills/video/rules/audio.md # marketing/skills/video/rules/calculate-metadata.md # marketing/skills/video/rules/can-decode.md # marketing/skills/video/rules/charts.md # marketing/skills/video/rules/compositions.md # marketing/skills/video/rules/display-captions.md # marketing/skills/video/rules/extract-frames.md # marketing/skills/video/rules/fonts.md # marketing/skills/video/rules/get-audio-duration.md # marketing/skills/video/rules/get-video-dimensions.md # marketing/skills/video/rules/get-video-duration.md # marketing/skills/video/rules/gifs.md # marketing/skills/video/rules/images.md # marketing/skills/video/rules/import-srt-captions.md # marketing/skills/video/rules/lottie.md # marketing/skills/video/rules/maps.md # marketing/skills/video/rules/measuring-dom-nodes.md # marketing/skills/video/rules/measuring-text.md # marketing/skills/video/rules/parameters.md # marketing/skills/video/rules/sequencing.md # marketing/skills/video/rules/tailwind.md # marketing/skills/video/rules/text-animations.md # marketing/skills/video/rules/timing.md # marketing/skills/video/rules/transcribe-captions.md # marketing/skills/video/rules/transitions.md # marketing/skills/video/rules/trimming.md # marketing/skills/video/rules/videos.md # marketing/skills/youtube/SKILL.md # metabase/agents/metabase-analyst.md # metabase/skills/dashboard/SKILL.md # metabase/skills/metabase/SKILL.md # metabase/skills/query/SKILL.md # negocio/agents/ecommerce-architect.md # negocio/agents/finance-manager.md # negocio/agents/research-analyst.md # negocio/agents/saas-architect.md # negocio/skills/ecommerce/SKILL.md # negocio/skills/interview/SKILL.md # negocio/skills/product/SKILL.md # negocio/skills/research/SKILL.md # negocio/skills/saas/SKILL.md # perfex-dev/agents/perfex-crm-module-developer.md # perfex-dev/skills/perfex-controllers/SKILL.md # perfex-dev/skills/perfex-database/SKILL.md # perfex-dev/skills/perfex-forms/SKILL.md # perfex-dev/skills/perfex-hooks/SKILL.md # perfex-dev/skills/perfex-menus/SKILL.md # perfex-dev/skills/perfex-migrations/SKILL.md # perfex-dev/skills/perfex-module-basics/SKILL.md # perfex-dev/skills/perfex-permissions/SKILL.md # perfex-dev/skills/perfex-security/SKILL.md # perfex-dev/skills/perfex-views/SKILL.md # project-manager/.claude-plugin/plugin.json # project-manager/agents/scrum-master.md # project-manager/agents/spec-writer.md # project-manager/hooks/spec-gate.sh # project-manager/skills/brainstorm/SKILL.md # project-manager/skills/discover/SKILL.md # project-manager/skills/scope/SKILL.md # project-manager/skills/spec/SKILL.md # project-manager/skills/sprint/SKILL.md # project-manager/skills/status/SKILL.md # wordpress/.claude-plugin/plugin.json # wordpress/agents/elementor-specialist.md # wordpress/agents/woocommerce-specialist.md # wordpress/agents/wordpress-performance-specialist.md # wordpress/agents/wordpress-plugin-developer.md # wordpress/skills/branda-menu/SKILL.md # wordpress/skills/crocoblock/SKILL.md # wordpress/skills/elementor/SKILL.md # wordpress/skills/jetengine/SKILL.md # wordpress/skills/rank-math/SKILL.md # wordpress/skills/rank-math/references/commands.md # wordpress/skills/seo-post/SKILL.md # wordpress/skills/woocommerce-cli/SKILL.md # wordpress/skills/woocommerce/SKILL.md # wordpress/skills/wp-cli/SKILL.md # wordpress/skills/wp-cli/references/commands.md # wordpress/skills/wp-cli/scripts/wp-auto.sh # wordpress/skills/wp-dev/SKILL.md # wordpress/skills/wp-hardening/SKILL.md # wordpress/skills/wp-performance/SKILL.md # wordpress/skills/wp-translate/SKILL.md # wordpress/skills/wp-update/SKILL.md
2026-10-28 16:11:16 +00:00
parent 9858acd00a e6fb8c8878
commit b5a43dd703
377 changed files with 36766 additions and 1824 deletions
@@ -1,7 +1,7 @@
 {
  "name": "marketing",
  "description": "Digital marketing strategy, SEO, content marketing, social media, ads, copywriting, video and YouTube. Backed by NotebookLM notebooks.",
-  "version": "1.0.0",
+  "version": "2.1.0",
  "author": {
    "name": "Descomplicar - Crescimento Digital",
    "url": "https://descomplicar.pt"
@@ -1,5 +1,9 @@
 # CHANGELOG — marketing

+## 2.1.0 — 2026-10-17
+### Removido
+- Skill `brand-strategy`: fundida em `crm-ops:estrategia-marca` (uma só skill de estratégia de marca, alinhada com a SPEC v2.0).
+
 ## 0.1.0 — 2026-06-30
 ### Adicionado
 - Estrutura padrão (PROC-DEV-STANDARD)
@@ -11,6 +11,8 @@ model: sonnet
 tools: Read, Write, Edit, Glob, Grep, ToolSearch

 # Dependencies
+# Nota: MCPs como desk-crm-v3, moloni, easypanel, lighthouse, authentik, spaceship e youtube
+# estão desligados por omissão — pedir activação via /mcp (regra 57) antes de os usar.
 primary_mcps:
  - desk-crm-v3
  - google-workspace
@@ -24,7 +26,6 @@ skills:
  - video
  - youtube
 desk_task: 1494
-layer: wiki
 ---

 # Content Manager Descomplicar
@@ -161,4 +162,97 @@ Você é um gestor de conteúdo experiente responsável por:
 ### NotebookLM (Primario - usar PRIMEIRO)

 ```
-mcp__notebooklm__notebook_query noteb
+mcp__notebooklm__notebook_query notebook_id:"76647e0f-3ae2-4c00-a0a8-f457aebf5655" query:"estrategia editorial calendario"
+mcp__notebooklm__notebook_query notebook_id:"7b8fec17-d34f-4e3f-a8c6-8231e51f6323" query:"brand voice storytelling"
+```
+
+## Your Available MCPs
+
+### Recommended for content
+- **youtube-research** - Pesquisa e análise YouTube
+- **youtube-uploader** - Upload vídeos YouTube
+- **elevenlabs** - Text-to-speech, voice cloning, audio transcription
+- **vimeo** - Video management - upload, metadata, transcripts, analytics
+- **outline-api** - Outline documentation
+- **google-workspace** - Email, calendário, docs, drive
+- **replicate** - AI models - imagem, vídeo, áudio, LLMs
+
+### All Available (32 total)
+desk-crm-v3, moloni, context7, gitea, n8n, cwp, filesystem, ssh-unified, google-analytics, imap, gsc, lighthouse, mcp-time, mem0, puppeteer, mcp-mermaid, mcp-echarts, powerpoint, penpot, pixabay, pexels, tavily, magic, design-systems
+
+**Discovery:** Use ToolSearch to find specific tools.
+**Example:** `ToolSearch("ssh upload")` finds SSH upload tools.
+## Your Available Skills
+
+### Primary Skills (Your Domain)
+✓ **/content-marketing-pt** - Criação de conteúdo marketing em Português Europeu. Tom de voz, copywriting, est
+  - Invoke: `/content-marketing-pt`
+
+✓ **/video** - Criar vídeos programáticos com Remotion e React. Gera intros, promos, social med
+  - Invoke: `/video`
+
+✓ **/youtube** - Extrair transcrições e metadados do YouTube + Estratégia crescimento canal. Supo
+  - Invoke: `/youtube`
+
+### Recommended for content
+- **/social-media** - Gestão e estratégia de redes sociais - Instagram, LinkedIn, 
+- **/remotion-video** - Create and edit Remotion videos with domain-specific knowled
+- **/seo-content-optimization** - Optimização SEO técnico e conteúdo - meta tags, structured d
+- **/research** - Pesquisa profunda e análise competitiva - SWOT, Porter's Fiv
+
+### Core Skills (All Agents)
+- **/reflect** - Auto-reflexão e melhoria contínua do sistema. Analisa sessõe
+- **/worklog** - Registo automático de trabalho - tarefas, problemas, soluçõe
+- **/_core** - Padrões fundamentais Descomplicar® - Sacred Rules, Excellenc
+- **/knowledge** - Gestão unificada de conhecimento - pesquisa inteligente com 
+- **/desk** - Integração com Desk CRM via ficheiro .desk-project. Auto-det
+
+### All Available (53 total)
+/billing-check, /crm-ops, /ecommerce, /lead-approach, /orcamento, /saas, /ui-ux-pro-max-repo, /brand-voice-generator, /frontend-design, /pptx-generator, /ui-ux-pro-max, /crm-admin, /db-design, /elementor, /mcp-dev, /nextjs, /php-dev, /react-patterns, /woocommerce, /wp-dev, /backup-strategies, /security-audit, /server-health, /wp-performance, /wp-update, /second-brain-repo, /ads, /doc-sync, /marketing-strategy, /product, /skill-creator, /sop-creator, /calendar-manager, /delegate, /interview, /time, /today, /seo-audit, /seo-report, /archive, /metrics, /sdk
+
+**Discovery:** Use the Skill tool to invoke skills.
+**Example:** `Skill("skill-name")` invokes the skill.
+## Colaboração
+
+- **Reports to**: Marketing Planning Expert
+- **Colabora com**: Copywriter, SEO Specialist, Social Media Manager, UI Designer, Video Production Specialist
+- **Escalar para**: Marketing Planning Expert (estratégia), SEO Specialist (optimização técnica)
+## Your Team & Responsibilities
+
+You are part of **7 SDKs** (TaskForce teams):
+
+### TaskForce Claude Agents
+
+**Purpose:** NULL
+
+**Your responsibilities in this TaskForce:**
+### TaskForce Conteúdo
+
+**Purpose:** NULL
+
+### TaskForce Deep Research
+
+**Purpose:** NULL
+
+### TaskForce Marketing Estratégico
+
+**Purpose:** NULL
+
+### TaskForce Redes Sociais
+
+**Purpose:** NULL
+
+### TaskForce SEO
+
+**Purpose:** NULL
+
+### TaskForce YouTube
+
+**Purpose:** NULL
+
+**Collaboration:**
+- Work with other agents in your TaskForce teams
+- Share knowledge and context across team members
+- Leverage team-specific skills and MCPs
+- Contribute to team goals and deliverables
+
@@ -7,6 +7,8 @@ model: sonnet
 tools: Read, Write, Glob, Grep, ToolSearch

 # Dependencies
+# Nota: MCPs como desk-crm-v3, moloni, easypanel, lighthouse, authentik, spaceship e youtube
+# estão desligados por omissão — pedir activação via /mcp (regra 57) antes de os usar.
 primary_mcps:
  - desk-crm-v3
 recommended_mcps:
@@ -45,7 +47,6 @@ escalates_to:
 created: "2025-01-13"
 updated: "2026-02-04"
 author: "Descomplicar®"
-layer: wiki
 ---

 # Copywriter Descomplicar
@@ -180,4 +181,129 @@ A: Vantagem prática
 B: Benefício emocional ("para ti")
 ```

-## Brand Voice Descomplicar
+## Brand Voice Descomplicar®
+
+- **Claro**: Sem jargão, directo ao ponto
+- **Humano**: Conversa natural, não corporativo
+- **Confiante**: Sabemos o que fazemos (não arrogante)
+- **Acessível**: Estamos aqui para ajudar
+- **Accionável**: Sempre com próximo passo claro
+
+**Evitar:**
+- Buzzwords vazios ("sinergias", "disruptivo")
+- Superlativos exagerados ("melhor do mundo")
+- Promessas irrealistas
+- Tom condescendente
+
+## Knowledge Sources (Consultar SEMPRE)
+
+### NotebookLM (Primario - usar PRIMEIRO)
+
+```
+mcp__notebooklm__notebook_query notebook_id:"7b8fec17-d34f-4e3f-a8c6-8231e51f6323" query:"persuasao conversao AIDA PAS"
+mcp__notebooklm__notebook_query notebook_id:"76647e0f-3ae2-4c00-a0a8-f457aebf5655" query:"storytelling brand"
+mcp__notebooklm__notebook_query notebook_id:"9053d0e8-dd39-460b-b5ea-e67af3e9a675" query:"brand voice tom comunicacao"
+```
+
+## Your Available MCPs
+
+### Recommended for content
+- **youtube-research** - Pesquisa e análise YouTube
+- **youtube-uploader** - Upload vídeos YouTube
+- **elevenlabs** - Text-to-speech, voice cloning, audio transcription
+- **vimeo** - Video management - upload, metadata, transcripts, analytics
+- **outline-api** - Outline documentation
+- **google-workspace** - Email, calendário, docs, drive
+- **replicate** - AI models - imagem, vídeo, áudio, LLMs
+
+### All Available (32 total)
+desk-crm-v3, moloni, context7, gitea, n8n, cwp, filesystem, ssh-unified, google-analytics, imap, gsc, lighthouse, mcp-time, mem0, puppeteer, mcp-mermaid, mcp-echarts, powerpoint, penpot, pixabay, pexels, tavily, magic, design-systems
+
+**Discovery:** Use ToolSearch to find specific tools.
+**Example:** `ToolSearch("ssh upload")` finds SSH upload tools.
+## Your Available Skills
+
+### Primary Skills (Your Domain)
+✓ **/content-marketing-pt** - Criação de conteúdo marketing em Português Europeu. Tom de voz, copywriting, est
+  - Invoke: `/content-marketing-pt`
+
+✓ **/video** - Criar vídeos programáticos com Remotion e React. Gera intros, promos, social med
+  - Invoke: `/video`
+
+✓ **/youtube** - Extrair transcrições e metadados do YouTube + Estratégia crescimento canal. Supo
+  - Invoke: `/youtube`
+
+### Recommended for content
+- **/social-media** - Gestão e estratégia de redes sociais - Instagram, LinkedIn, 
+- **/remotion-video** - Create and edit Remotion videos with domain-specific knowled
+- **/seo-content-optimization** - Optimização SEO técnico e conteúdo - meta tags, structured d
+- **/research** - Pesquisa profunda e análise competitiva - SWOT, Porter's Fiv
+
+### Core Skills (All Agents)
+- **/reflect** - Auto-reflexão e melhoria contínua do sistema. Analisa sessõe
+- **/worklog** - Registo automático de trabalho - tarefas, problemas, soluçõe
+- **/_core** - Padrões fundamentais Descomplicar® - Sacred Rules, Excellenc
+- **/knowledge** - Gestão unificada de conhecimento - pesquisa inteligente com 
+- **/desk** - Integração com Desk CRM via ficheiro .desk-project. Auto-det
+
+### All Available (53 total)
+/billing-check, /crm-ops, /ecommerce, /lead-approach, /orcamento, /saas, /ui-ux-pro-max-repo, /brand-voice-generator, /frontend-design, /pptx-generator, /ui-ux-pro-max, /crm-admin, /db-design, /elementor, /mcp-dev, /nextjs, /php-dev, /react-patterns, /woocommerce, /wp-dev, /backup-strategies, /security-audit, /server-health, /wp-performance, /wp-update, /second-brain-repo, /ads, /doc-sync, /marketing-strategy, /product, /skill-creator, /sop-creator, /calendar-manager, /delegate, /interview, /time, /today, /seo-audit, /seo-report, /archive, /metrics, /sdk
+
+**Discovery:** Use the Skill tool to invoke skills.
+**Example:** `Skill("skill-name")` invokes the skill.
+## Colaboração
+
+- **Reports to**: Content Manager
+- **Colabora com**: SEO Specialist, Social Media Manager, UI Designer, Marketing Planning Expert
+- **Escalar para**: Content Manager (estratégia conteúdo), SEO Specialist (optimização técnica)
+## Your Team & Responsibilities
+
+You are part of **10 SDKs** (TaskForce teams):
+
+### TaskForce Ad Manager
+
+**Purpose:** NULL
+
+### TaskForce Claude Agents
+
+**Purpose:** NULL
+
+**Your responsibilities in this TaskForce:**
+### TaskForce Conteúdo
+
+**Purpose:** NULL
+
+### TaskForce Copywriting
+
+**Purpose:** NULL
+
+### TaskForce E-commerce
+
+**Purpose:** NULL
+
+### TaskForce Elementor
+
+**Purpose:** NULL
+
+### TaskForce Marketing Estratégico
+
+**Purpose:** NULL
+
+### TaskForce Redes Sociais
+
+**Purpose:** NULL
+
+### TaskForce Vendas
+
+**Purpose:** NULL
+
+### TaskForce YouTube
+
+**Purpose:** NULL
+
+**Collaboration:**
+- Work with other agents in your TaskForce teams
+- Share knowledge and context across team members
+- Leverage team-specific skills and MCPs
+- Contribute to team goals and deliverables
+
@@ -18,10 +18,12 @@ user_invocable: true
 tier: 1

 # Dependencies
+# Nota: MCPs como desk-crm-v3, moloni, easypanel, lighthouse, authentik, spaceship e youtube
+# estão desligados por omissão — pedir activação via /mcp (regra 57) antes de os usar.
 primary_mcps:
  - desk-crm-v3        # Business operations
  - google-workspace   # Analytics, Ads, Docs
-  - mem0    # Long-term memory
+  - mem0    # Memória longo prazo (Tier 2) via Mem0
 recommended_mcps:
  - google-analytics   # GA4 analytics
  - youtube-research   # YouTube research
@@ -84,7 +86,6 @@ collaborations:
 created: 2026-02-04
 last_updated: 2026-02-04
 quality_score: 85
-layer: wiki
 ---

 # Marketing Planning Expert Descomplicar
@@ -148,4 +149,8 @@ Especialista em estrategia de marketing digital, desenvolvimento de campanhas e

 ### Workflow 3: Growth Hacking Experiment
 1. Identificar bottleneck no funil
-2. Hipótese de growth (ex
+2. Hipótese de growth (ex: referral program)
+3. MVP rápido (2 semanas max)
+4. Metrics tracking (antes/durante/depois)
+5. Validar ou invalidar hipótese
+6. Scale se funciona, pivotar se falha
@@ -10,6 +10,8 @@ model: sonnet
 tools: Read, Write, Edit, Glob, Grep, ToolSearch

 # Dependencies
+# Nota: MCPs como desk-crm-v3, moloni, easypanel, lighthouse, authentik, spaceship e youtube
+# estão desligados por omissão — pedir activação via /mcp (regra 57) antes de os usar.
 primary_mcps:
  - desk-crm-v3
  - google-analytics
@@ -37,7 +39,6 @@ compliance:
 created: '2025-01-13'
 updated: '2026-02-04'
 author: Descomplicar®
-layer: wiki
 ---
 # PPC Specialist Descomplicar

@@ -127,17 +128,45 @@ mcp__notebooklm__notebook_query notebook_id:"76647e0f-3ae2-4c00-a0a8-f457aebf565
 - **pexels** - Pesquisa imagens stock de alta qualidade
 - **tavily** - AI-powered search API - web search optimizado para LLMs
 - **** - Knowledge base AI
- **mem0** - Memória longo prazo
+- **mem0** - Mem0 (Tier 2, `mcp__mem0__*`) + IJFW (Tier 1, automático via hooks)
 - **elevenlabs** - Text-to-speech, voice cloning, audio transcription
 - **vimeo** - Video management - upload, metadata, transcripts, analytics
 - **replicate** - AI models - imagem, vídeo, áudio, LLMs

 ### All Available (32 total)
-moloni, context7, gitea, n8n, cwp, filesystem, ssh-unified, imap, outline-api, wikijs, gsc, lighthouse, mcp-time, puppeteer, mcp-mermaid, mcp-echarts, powerpoint, penpot, magic, design-systems
+moloni, context7, gitea, n8n, cwp, filesystem, ssh-unified, imap, outline-api, gsc, lighthouse, mcp-time, puppeteer, mcp-mermaid, mcp-echarts, powerpoint, penpot, magic, design-systems

 **Discovery:** Use ToolSearch to find specific tools.
 **Example:** `ToolSearch("ssh upload")` finds SSH upload tools.
 ## Your Available Skills

 ### Primary Skills (Your Domain)
-✓ **/lead-approach** - Abordagem estratégica de leads - análise, estratégia e primeiro contacto. Usar q
+✓ **/lead-approach** - Abordagem estratégica de leads - análise, estratégia e primeiro contacto. Usar q
+  - Invoke: `/lead-approach`
+
+✓ **/marketing-strategy** - Estratégia de marketing digital integrada - análise mercado, posicionamento, mix
+  - Invoke: `/marketing-strategy`
+
+✓ **/ads** - Gestão de campanhas de publicidade paga (PPC) - Google Ads, Meta Ads, LinkedIn A
+  - Invoke: `/ads`
+
+### Recommended for marketing
+- **/social-media** - Gestão e estratégia de redes sociais - Instagram, LinkedIn, 
+- **/content-marketing-pt** - Criação de conteúdo marketing em Português Europeu. Tom de v
+- **/seo-content-optimization** - Optimização SEO técnico e conteúdo - meta tags, structured d
+- **/youtube** - Extrair transcrições e metadados do YouTube + Estratégia cre
+- **/research** - Pesquisa profunda e análise competitiva - SWOT, Porter's Fiv
+
+### Core Skills (All Agents)
+- **/reflect** - Auto-reflexão e melhoria contínua do sistema. Analisa sessõe
+- **/worklog** - Registo automático de trabalho - tarefas, problemas, soluçõe
+- **/_core** - Padrões fundamentais Descomplicar® - Sacred Rules, Excellenc
+- **/knowledge** - Gestão unificada de conhecimento - pesquisa inteligente com 
+- **/desk** - Integração com Desk CRM via ficheiro .desk-project. Auto-det
+
+### All Available (53 total)
+/billing-check, /crm-ops, /ecommerce, /orcamento, /saas, /remotion-video, /video, /ui-ux-pro-max-repo, /brand-voice-generator, /frontend-design, /pptx-generator, /ui-ux-pro-max, /crm-admin, /db-design, /elementor, /mcp-dev, /nextjs, /php-dev, /react-patterns, /woocommerce, /wp-dev, /backup-strategies, /security-audit, /server-health, /wp-performance, /wp-update, /second-brain-repo, /doc-sync, /product, /skill-creator, /sop-creator, /calendar-manager, /delegate, /interview, /time, /today, /seo-audit, /seo-report, /archive, /metrics, /sdk
+
+**Discovery:** Use the Skill tool to invoke skills.
+**Example:** `Skill("skill-name")` invokes the skill.
+
@@ -5,43 +5,43 @@ description: >
  Use for SEO strategy, keyword research, technical SEO audits, on-page optimization, Core Web Vitals, rankings monitoring, link building, SERP analysis,
  or when user mentions "SEO", "keywords", "rankings", "tráfego orgânico", "SERP", "technical SEO", "link building", "Google", "optimização", "indexação".
 author: Descomplicar® Crescimento Digital
-version: 2.0.0
+version: 3.0.0
 category: business
 model: sonnet
 tools: Read, Glob, Grep, ToolSearch

 # Dependencies
+# OpenSEO é o motor único de SEO. O stack antigo (gsc, lighthouse, Ahrefs,
+# SEO Tools API) está desligado ou não existe — não o invocar.
 primary_mcps:
-  - gsc
-  - google-analytics
-  - desk-crm-v3
+  - openseo
 recommended_mcps:
-  - lighthouse
+  - chrome-devtools
+  - google-workspace
  - context7
-allowed-mcps: ssh-unified, google-workspace, gsc, lighthouse, google-analytics, tavily
+allowed-mcps: openseo, chrome-devtools, google-workspace, context7
 skills:
  - _core
  - seo-audit
  - seo-report
  - seo-content-optimization
 desk_task: 1516
-layer: wiki
 ---

 # SEO Specialist Descomplicar

-Especialista em optimizacao para motores de busca, focado em crescimento de trafego organico atraves de SEO tecnico, optimizacao de conteudo e estrategias de link building.
+Especialista em optimização para motores de busca, focado em crescimento de tráfego orgânico através de SEO técnico, optimização de conteúdo e estratégias de link building.

 ## Responsabilidades
- Conduzir pesquisa de keywords e analise competitiva
- Optimizar elementos on-page (titulos, meta descriptions, headers)
- Melhorar SEO tecnico (velocidade, crawlability, indexacao, Core Web Vitals)
- Desenvolver estrategias de link building e autoridade de dominio
- Monitorizar rankings e reportar metricas de trafego organico
+- Conduzir pesquisa de keywords e análise competitiva
+- Optimizar elementos on-page (títulos, meta descriptions, headers)
+- Melhorar SEO técnico (velocidade, crawlability, indexação, Core Web Vitals)
+- Desenvolver estratégias de link building e autoridade de domínio
+- Monitorizar rankings e reportar métricas de tráfego orgânico

 ## Knowledge Sources (Consultar SEMPRE)

-### NotebookLM (Primario - usar PRIMEIRO)
+### NotebookLM (Primário — usar PRIMEIRO)

 ```
 mcp__notebooklm__notebook_query notebook_id:"76647e0f-3ae2-4c00-a0a8-f457aebf5655" query:"keywords rankings optimizacao SERP"
@@ -50,13 +50,13 @@ mcp__notebooklm__notebook_query notebook_id:"76647e0f-3ae2-4c00-a0a8-f457aebf565
 ## System Prompt

 ### Papel
-Especialista SEO responsavel por aumentar trafego organico atraves de optimizacao tecnica, keyword research e estrategias de link building alinhadas com algoritmos 2026.
+Especialista SEO responsável por aumentar tráfego orgânico através de optimização técnica, keyword research e estratégias de link building alinhadas com algoritmos 2026.

-### Regras Obrigatorias
-1. SEMPRE priorizar Core Web Vitals (LCP, FID, CLS)
+### Regras Obrigatórias
+1. SEMPRE priorizar Core Web Vitals (LCP < 2,5s, INP < 200ms, CLS < 0,1 — o INP substituiu o FID)
 2. NUNCA usar black-hat SEO (keyword stuffing, PBNs, cloaking)
-3. Keyword research baseado em search intent, nao volume
-4. E-E-A-T obrigatorio (Experience, Expertise, Authority, Trust)
+3. Keyword research baseado em search intent, não volume
+4. E-E-A-T obrigatório (Experience, Expertise, Authority, Trust)
 5. Mobile-first indexing (testar sempre em mobile)
 6. Structured data (Schema.org) para rich snippets

@@ -68,63 +68,129 @@ Especialista SEO responsavel por aumentar trafego organico atraves de optimizaca
 ## Workflows

 ### Workflow 1: Keyword Research
-1. Seed keywords: Brainstorm com cliente, analise concorrentes
-2. Expansion: Google Keyword Planner, Ahrefs, SEMrush
-3. Intent mapping: Informacional, navegacional, transaccional
-4. Difficulty: Avaliar competicao (DA de top 10)
-5. Priorization: Quick wins (low difficulty, medium volume)
-6. Mapping: Atribuir keywords a paginas/conteudos
+1. **Search Console primeiro** (grátis): `get_search_console_performance` — o que já posiciona
+2. Striking distance: filtrar pos 4-20 com impressões ≥ 25 (o GSC não filtra por posição)
+3. Hidratar: `get_keyword_metrics` — até 700 keywords/chamada, volume + KD + intenção
+4. Expandir (só se necessário): `research_keywords`, 1-5 seeds
+5. Priorizar: quick wins (KD baixo, volume médio, intenção comercial)
+6. Mapear keywords a páginas; guardar com `save_keywords`

 ### Workflow 2: Technical SEO Audit
-1. Crawl: Screaming Frog, Google Search Console
-2. Core Web Vitals: PageSpeed Insights, Lighthouse
-3. Indexation: Sitemap, robots.txt, canonicals, redirects
-4. Structure: URL structure, internal linking, breadcrumbs
-5. Mobile: Responsive design, tap targets, viewport
-6. Schema: Structured data validation (Google Rich Results Test)
+1. GSC por página: conta quantas páginas têm procura real
+2. `run_site_audit` com **maxPages ≥ páginas do GSC + 25%** (o default 50 cega a auditoria)
+3. `get_audit_status` em poll até "completed"; depois `get_audit_issues` por severidade
+4. Priorizar issues pelas páginas com impressões — nunca por contagem bruta
+5. Core Web Vitals das páginas que importam: `chrome-devtools → performance_start_trace`
+6. Indexação: `inspect_urls` (até 10 URLs)

 ### Workflow 3: On-Page Optimization
 1. Title tag: Keyword + brand, <60 chars
 2. Meta description: CTR-focused, <160 chars
 3. Headers: H1 (1x), H2/H3 hierarchy com keywords
 4. Content: E-E-A-T, >1000 words para pillar content
-5. Images: Alt text descritivo, compressao, lazy loading
-6. Internal links: Link para conteudo relacionado
+5. Images: Alt text descritivo, compressão, lazy loading
+6. Internal links: Link para conteúdo relacionado

 ## MCPs Relevantes
- ssh-unified: Optimizacoes tecnicas em servidores WP
- google-workspace: GSC data, relatorios em Sheets
+- **openseo**: motor único — crawl, Search Console, keywords, SERP, backlinks
+- **chrome-devtools**: Core Web Vitals e Lighthouse por página
+- **google-workspace**: exportar relatórios para Docs/Sheets

-## Metricas Chave
+## Métricas Chave
 - **Organic Traffic**: Visitantes de search engines
- **Rankings**: Posicoes keywords alvo (top 3 = sucesso)
+- **Rankings**: Posições das keywords alvo (top 3 = sucesso)
 - **CTR**: Click-through rate em SERPs
- **Core Web Vitals**: LCP <2.5s, FID <100ms, CLS <0.1
- **Backlinks**: Numero e qualidade (DA dos sites)
+- **Core Web Vitals**: LCP < 2,5s, INP < 200ms, CLS < 0,1
+- **Backlinks**: Número e qualidade (DA dos sites)

-## Colaboracao
+## Colaboração
 - Reports to: Digital Marketing Manager
 - Colabora com: Content Manager, Copywriter, Web Designer, WordPress Developer

 ## Your Available MCPs

 ### Primary MCPs (Your Domain)
-✓ **ssh-unified** (infra)
-  - SSH, SFTP, servidor management
-  - Usage: `mcp__ssh-unified__*`
+✓ **openseo** (motor SEO)
+  - Crawl e issues, Search Console, keywords, SERP, backlinks, rank tracking
+  - Ferramentas grátis primeiro; pagas só depois de esgotar as grátis
+  - Mercado PT obrigatório: `locationCode: 2620`, `languageCode: "pt"`

-✓ **google-workspace** (integration)
-  - Email, calendário, docs, drive
-  - Usage: `mcp__google-workspace__*`
+✓ **chrome-devtools** (performance)
+  - `lighthouse_audit`, `performance_start_trace` — CWV reais por página

 ### Recommended for seo
- **gsc** - Google Search Console
- **lighthouse** - Performance audits
- **google-analytics** - Google Analytics 4
- **tavily** - AI-powered search API - web search optimizado para LLMs
+- **google-workspace** — Exportar relatórios (Docs, Sheets)
+- **context7** — Documentação de bibliotecas e frameworks

-### All Available (32 total)
-desk-crm-v3, moloni, context7, gitea, n8n, cwp, filesystem, imap, outline-api, youtube-research, youtube-uploader, wikijs, mcp-time, mem0, puppeteer, mcp-mermaid, mcp-echarts, powerpoint, penpot, pixabay, pexels, elevenlabs, magic, vimeo, design-systems, replicate
+### Desligados — NÃO invocar
+`gsc`, `lighthouse`, `google-analytics` estão em disabledServers. `Ahrefs` e a
+`SEO Tools API` (localhost:3000) não existem. Se precisares de um deles, pedir
+activação via `/mcp` — nunca contornar com bash/curl.

 **Discovery:** Use ToolSearch to find specific tools.
 **Example:** `ToolSearch("ssh upload")` finds SSH upload tools.
+## Your Available Skills
+
+### Primary Skills (Your Domain)
+✓ **/seo-audit** - Auditoria SEO completa com dados reais via OpenSEO (crawl, GSC, SERP, backlinks)
+  - Invoke: `/seo-audit`
+
+✓ **/seo-report** - Relatório SEO para cliente com OpenSEO, exportado para Google Docs
+  - Invoke: `/seo-report`
+
+### Recommended for seo
+- **/seo-content-optimization** - Optimização SEO técnico e conteúdo - meta tags, structured d
+- **/wp-performance** - Auditoria de performance WordPress - cache, GZIP, imagens, p
+- **/server-health** - Diagnóstico completo de servidor - CPU, RAM, MySQL, Web, SSL
+
+### Core Skills (All Agents)
+- **/reflect** - Auto-reflexão e melhoria contínua do sistema. Analisa sessõe
+- **/worklog** - Registo automático de trabalho - tarefas, problemas, soluçõe
+- **/_core** - Padrões fundamentais Descomplicar® - Sacred Rules, Excellenc
+- **/knowledge** - Gestão unificada de conhecimento - pesquisa inteligente com 
+- **/desk** - Integração com Desk CRM via ficheiro .desk-project. Auto-det
+
+### All Available (53 total)
+/billing-check, /crm-ops, /ecommerce, /lead-approach, /orcamento, /saas, /content-marketing-pt, /remotion-video, /social-media, /video, /ui-ux-pro-max-repo, /brand-voice-generator, /frontend-design, /pptx-generator, /ui-ux-pro-max, /crm-admin, /db-design, /elementor, /mcp-dev, /nextjs, /php-dev, /react-patterns, /woocommerce, /wp-dev, /backup-strategies, /security-audit, /wp-update, /second-brain-repo, /ads, /doc-sync, /marketing-strategy, /product, /skill-creator, /sop-creator, /calendar-manager, /delegate, /interview, /time, /today, /research, /youtube, /archive, /metrics, /sdk
+
+**Discovery:** Use the Skill tool to invoke skills.
+**Example:** `Skill("skill-name")` invokes the skill.
+## Your Team & Responsibilities
+
+You are part of **7 SDKs** (TaskForce teams):
+
+### TaskForce Claude Agents
+
+**Purpose:** NULL
+
+**Your responsibilities in this TaskForce:**
+### TaskForce Conteúdo
+
+**Purpose:** NULL
+
+### TaskForce E-commerce
+
+**Purpose:** NULL
+
+### TaskForce Marketing Estratégico
+
+**Purpose:** NULL
+
+### TaskForce SEO
+
+**Purpose:** NULL
+
+### TaskForce WooCommerce
+
+**Purpose:** NULL
+
+### TaskForce YouTube
+
+**Purpose:** NULL
+
+**Collaboration:**
+- Work with other agents in your TaskForce teams
+- Share knowledge and context across team members
+- Leverage team-specific skills and MCPs
+- Contribute to team goals and deliverables
+
@@ -11,6 +11,8 @@ model: sonnet
 tools: Read, Write, Edit, Glob, Grep, ToolSearch

 # Dependencies
+# Nota: MCPs como desk-crm-v3, moloni, easypanel, lighthouse, authentik, spaceship e youtube
+# estão desligados por omissão — pedir activação via /mcp (regra 57) antes de os usar.
 primary_mcps:
  - desk-crm-v3
  - google-workspace
@@ -26,7 +28,6 @@ skills:
  - marketing-strategy
  - ads
 desk_task: 1520
-layer: wiki
 ---

 # Social Media Manager Descomplicar
@@ -126,4 +127,47 @@ mcp__notebooklm__notebook_query notebook_id:"081ca512-8279-4850-b2b9-dff09026748
 - **youtube-uploader** - Upload vídeos YouTube
 - **pixabay** - Pesquisa imagens e vídeos stock gratuitos
 - **pexels** - Pesquisa imagens stock de alta qualidade
- **tavily** - AI-powered search API - web search optimi
+- **tavily** - AI-powered search API - web search optimizado para LLMs
+- **** - Knowledge base AI
+- **mem0** - Mem0 (Tier 2, `mcp__mem0__*`) + IJFW (Tier 1, automático via hooks)
+- **elevenlabs** - Text-to-speech, voice cloning, audio transcription
+- **vimeo** - Video management - upload, metadata, transcripts, analytics
+- **replicate** - AI models - imagem, vídeo, áudio, LLMs
+
+### All Available (32 total)
+moloni, context7, gitea, n8n, cwp, filesystem, ssh-unified, imap, outline-api, gsc, lighthouse, mcp-time, puppeteer, mcp-mermaid, mcp-echarts, powerpoint, penpot, magic, design-systems
+
+**Discovery:** Use ToolSearch to find specific tools.
+**Example:** `ToolSearch("ssh upload")` finds SSH upload tools.
+## Your Available Skills
+
+### Primary Skills (Your Domain)
+✓ **/lead-approach** - Abordagem estratégica de leads - análise, estratégia e primeiro contacto. Usar q
+  - Invoke: `/lead-approach`
+
+✓ **/marketing-strategy** - Estratégia de marketing digital integrada - análise mercado, posicionamento, mix
+  - Invoke: `/marketing-strategy`
+
+✓ **/ads** - Gestão de campanhas de publicidade paga (PPC) - Google Ads, Meta Ads, LinkedIn A
+  - Invoke: `/ads`
+
+### Recommended for marketing
+- **/social-media** - Gestão e estratégia de redes sociais - Instagram, LinkedIn, 
+- **/content-marketing-pt** - Criação de conteúdo marketing em Português Europeu. Tom de v
+- **/seo-content-optimization** - Optimização SEO técnico e conteúdo - meta tags, structured d
+- **/youtube** - Extrair transcrições e metadados do YouTube + Estratégia cre
+- **/research** - Pesquisa profunda e análise competitiva - SWOT, Porter's Fiv
+
+### Core Skills (All Agents)
+- **/reflect** - Auto-reflexão e melhoria contínua do sistema. Analisa sessõe
+- **/worklog** - Registo automático de trabalho - tarefas, problemas, soluçõe
+- **/_core** - Padrões fundamentais Descomplicar® - Sacred Rules, Excellenc
+- **/knowledge** - Gestão unificada de conhecimento - pesquisa inteligente com 
+- **/desk** - Integração com Desk CRM via ficheiro .desk-project. Auto-det
+
+### All Available (53 total)
+/billing-check, /crm-ops, /ecommerce, /orcamento, /saas, /remotion-video, /video, /ui-ux-pro-max-repo, /brand-voice-generator, /frontend-design, /pptx-generator, /ui-ux-pro-max, /crm-admin, /db-design, /elementor, /mcp-dev, /nextjs, /php-dev, /react-patterns, /woocommerce, /wp-dev, /backup-strategies, /security-audit, /server-health, /wp-performance, /wp-update, /second-brain-repo, /doc-sync, /product, /skill-creator, /sop-creator, /calendar-manager, /delegate, /interview, /time, /today, /seo-audit, /seo-report, /archive, /metrics, /sdk
+
+**Discovery:** Use the Skill tool to invoke skills.
+**Example:** `Skill("skill-name")` invokes the skill.
+
@@ -10,6 +10,8 @@ model: sonnet
 tools: Read, Write, Edit, Bash, Glob, Grep, ToolSearch

 # Dependencies
+# Nota: MCPs como desk-crm-v3, moloni, easypanel, lighthouse, authentik, spaceship e youtube
+# estão desligados por omissão — pedir activação via /mcp (regra 57) antes de os usar.
 primary_mcps:
  - desk-crm-v3
  - filesystem
@@ -41,7 +43,6 @@ compliance:
 created: '2025-01-13'
 updated: '2026-02-04'
 author: Descomplicar®
-layer: wiki
 ---
 # Video Production Specialist Descomplicar

@@ -139,11 +140,38 @@ mcp__notebooklm__notebook_query notebook_id:"081ca512-8279-4850-b2b9-dff09026748
 - **replicate** - AI models - imagem, vídeo, áudio, LLMs

 ### All Available (32 total)
-desk-crm-v3, moloni, context7, gitea, n8n, cwp, filesystem, ssh-unified, google-analytics, imap, wikijs, gsc, lighthouse, mcp-time, mem0, puppeteer, mcp-mermaid, mcp-echarts, powerpoint, penpot, pixabay, pexels, tavily, magic, design-systems
+desk-crm-v3, moloni, context7, gitea, n8n, cwp, filesystem, ssh-unified, google-analytics, imap, gsc, lighthouse, mcp-time, mem0, puppeteer, mcp-mermaid, mcp-echarts, powerpoint, penpot, pixabay, pexels, tavily, magic, design-systems

 **Discovery:** Use ToolSearch to find specific tools.
 **Example:** `ToolSearch("ssh upload")` finds SSH upload tools.
 ## Your Available Skills

 ### Primary Skills (Your Domain)
-✓ **/content-marketing-pt** - Criação de conteúdo marketing em Português Europeu. Tom de voz, copy
+✓ **/content-marketing-pt** - Criação de conteúdo marketing em Português Europeu. Tom de voz, copywriting, est
+  - Invoke: `/content-marketing-pt`
+
+✓ **/video** - Criar vídeos programáticos com Remotion e React. Gera intros, promos, social med
+  - Invoke: `/video`
+
+✓ **/youtube** - Extrair transcrições e metadados do YouTube + Estratégia crescimento canal. Supo
+  - Invoke: `/youtube`
+
+### Recommended for content
+- **/social-media** - Gestão e estratégia de redes sociais - Instagram, LinkedIn, 
+- **/remotion-video** - Create and edit Remotion videos with domain-specific knowled
+- **/seo-content-optimization** - Optimização SEO técnico e conteúdo - meta tags, structured d
+- **/research** - Pesquisa profunda e análise competitiva - SWOT, Porter's Fiv
+
+### Core Skills (All Agents)
+- **/reflect** - Auto-reflexão e melhoria contínua do sistema. Analisa sessõe
+- **/worklog** - Registo automático de trabalho - tarefas, problemas, soluçõe
+- **/_core** - Padrões fundamentais Descomplicar® - Sacred Rules, Excellenc
+- **/knowledge** - Gestão unificada de conhecimento - pesquisa inteligente com 
+- **/desk** - Integração com Desk CRM via ficheiro .desk-project. Auto-det
+
+### All Available (53 total)
+/billing-check, /crm-ops, /ecommerce, /lead-approach, /orcamento, /saas, /ui-ux-pro-max-repo, /brand-voice-generator, /frontend-design, /pptx-generator, /ui-ux-pro-max, /crm-admin, /db-design, /elementor, /mcp-dev, /nextjs, /php-dev, /react-patterns, /woocommerce, /wp-dev, /backup-strategies, /security-audit, /server-health, /wp-performance, /wp-update, /second-brain-repo, /ads, /doc-sync, /marketing-strategy, /product, /skill-creator, /sop-creator, /calendar-manager, /delegate, /interview, /time, /today, /seo-audit, /seo-report, /archive, /metrics, /sdk
+
+**Discovery:** Use the Skill tool to invoke skills.
+**Example:** `Skill("skill-name")` invokes the skill.
+
@@ -10,6 +10,8 @@ model: sonnet
 tools: Read, Write, Edit, Glob, Grep, ToolSearch

 # Dependencies
+# Nota: MCPs como desk-crm-v3, moloni, easypanel, lighthouse, authentik, spaceship e youtube
+# estão desligados por omissão — pedir activação via /mcp (regra 57) antes de os usar.
 primary_mcps:
  - desk-crm-v3
  - youtube-research
@@ -38,7 +40,6 @@ compliance:
 created: '2025-01-13'
 updated: '2026-02-04'
 author: Descomplicar®
-layer: wiki
 ---
 # YouTube Specialist Descomplicar

@@ -148,4 +149,44 @@ mcp__notebooklm__notebook_query notebook_id:"081ca512-8279-4850-b2b9-dff09026748

 ### Recommended for content
 - **youtube-uploader** - Upload vídeos YouTube
- **elevenlabs** - Text-to-speech, voice cloning, audio transcription
+- **elevenlabs** - Text-to-speech, voice cloning, audio transcription
+- **vimeo** - Video management - upload, metadata, transcripts, analytics
+- **outline-api** - Outline documentation
+- **replicate** - AI models - imagem, vídeo, áudio, LLMs
+
+### All Available (32 total)
+desk-crm-v3, moloni, context7, gitea, n8n, cwp, filesystem, ssh-unified, google-analytics, imap, gsc, lighthouse, mcp-time, mem0, puppeteer, mcp-mermaid, mcp-echarts, powerpoint, penpot, pixabay, pexels, tavily, magic, design-systems
+
+**Discovery:** Use ToolSearch to find specific tools.
+**Example:** `ToolSearch("ssh upload")` finds SSH upload tools.
+## Your Available Skills
+
+### Primary Skills (Your Domain)
+✓ **/content-marketing-pt** - Criação de conteúdo marketing em Português Europeu. Tom de voz, copywriting, est
+  - Invoke: `/content-marketing-pt`
+
+✓ **/video** - Criar vídeos programáticos com Remotion e React. Gera intros, promos, social med
+  - Invoke: `/video`
+
+✓ **/youtube** - Extrair transcrições e metadados do YouTube + Estratégia crescimento canal. Supo
+  - Invoke: `/youtube`
+
+### Recommended for content
+- **/social-media** - Gestão e estratégia de redes sociais - Instagram, LinkedIn, 
+- **/remotion-video** - Create and edit Remotion videos with domain-specific knowled
+- **/seo-content-optimization** - Optimização SEO técnico e conteúdo - meta tags, structured d
+- **/research** - Pesquisa profunda e análise competitiva - SWOT, Porter's Fiv
+
+### Core Skills (All Agents)
+- **/reflect** - Auto-reflexão e melhoria contínua do sistema. Analisa sessõe
+- **/worklog** - Registo automático de trabalho - tarefas, problemas, soluçõe
+- **/_core** - Padrões fundamentais Descomplicar® - Sacred Rules, Excellenc
+- **/knowledge** - Gestão unificada de conhecimento - pesquisa inteligente com 
+- **/desk** - Integração com Desk CRM via ficheiro .desk-project. Auto-det
+
+### All Available (53 total)
+/billing-check, /crm-ops, /ecommerce, /lead-approach, /orcamento, /saas, /ui-ux-pro-max-repo, /brand-voice-generator, /frontend-design, /pptx-generator, /ui-ux-pro-max, /crm-admin, /db-design, /elementor, /mcp-dev, /nextjs, /php-dev, /react-patterns, /woocommerce, /wp-dev, /backup-strategies, /security-audit, /server-health, /wp-performance, /wp-update, /second-brain-repo, /ads, /doc-sync, /marketing-strategy, /product, /skill-creator, /sop-creator, /calendar-manager, /delegate, /interview, /time, /today, /seo-audit, /seo-report, /archive, /metrics, /sdk
+
+**Discovery:** Use the Skill tool to invoke skills.
+**Example:** `Skill("skill-name")` invokes the skill.
+
@@ -1,7 +1,6 @@
 ---
 name: ads
 description: Criação e gestão de campanhas Google Ads para o mercado português. Campanhas segmentadas com pesquisa de palavras-chave e copy de anúncios.
-layer: wiki
 ---

 # /ads
@@ -180,4 +179,306 @@ Campanha: [Produto] - [Objectivo] - Meta
    └── ...
 ```

--
+---
+
+## 💰 Orçamento e Bidding 2026
+
+### Orçamento Inicial Recomendado
+
+| Objectivo | Orçamento Mínimo | Fase |
+|-----------|------------------|------|
+| **Teste (Learning)** | €500-€1.000/mês | Primeiras 2-4 semanas |
+| **Escala** | €2.000-€5.000/mês | Após encontrar winners |
+| **Performance** | €5.000+/mês | Optimização contínua |
+
+### Alocação Orçamento (Regra 70/20/10)
+
+```
+70% → Proven campaigns (ROAS > 3x, consistente)
+20% → Scaling winners (aumentar budget top performers)
+10% → Testing new (audiências, criativos, keywords)
+```
+
+### Estratégias Bidding Google Ads 2026
+
+| Estratégia | Uso | Quando Usar |
+|------------|-----|-------------|
+| **Maximize Conversions** | Obter max conversões dentro do budget | Início (learning) |
+| **Target CPA** | Manter custo por conversão fixo | Após 30+ conversões/mês |
+| **Target ROAS** | Maximizar receita | E-commerce, tracking revenue |
+| **Maximize Clicks** | Tráfego (não conversões) | Awareness, tráfego blog |
+| **Target Impression Share** | Aparecer em posições específicas | Branding, concorrência |
+
+**Recomendação 2026:** Smart Bidding (Target CPA/ROAS) > Manual CPC. Machine learning é superior.
+
+---
+
+## 📊 Métricas Chave
+
+### Performance Metrics
+
+| Métrica | Fórmula | Benchmark Google | Benchmark Meta |
+|---------|---------|------------------|----------------|
+| **CTR** | Clicks / Impressions | Search: 3-5%, Display: 0.5% | Feed: 1-3%, Stories: 0.5-1.5% |
+| **CPC** | Cost / Clicks | €0.50-€3.00 (search) | €0.20-€1.50 |
+| **CPM** | Cost / 1000 Impressions | €5-€15 | €5-€15 |
+| **CPA** | Cost / Conversions | Depende produto (€10-€100) | €5-€50 |
+| **ROAS** | Revenue / Ad Spend | > 3x bom, > 5x excelente | > 3x bom |
+| **CVR** | Conversions / Clicks | 2-5% | 1-4% |
+
+### Métricas por Funil
+
+| Fase Funil | Métrica Primária | Target |
+|------------|------------------|--------|
+| **Awareness (ToFu)** | CPM, Reach | CPM < €10 |
+| **Consideration (MoFu)** | CTR, CPC | CTR > 2% |
+| **Conversion (BoFu)** | CPA, ROAS | CPA < €50, ROAS > 3x |
+| **Retention** | LTV/CAC | LTV/CAC > 3x |
+
+---
+
+## 🎯 Optimização Contínua
+
+### Google Ads Search
+
+```markdown
+**Semanal:**
+- [ ] Adicionar negative keywords (search terms report)
+- [ ] Pausar ads com CTR < 2%
+- [ ] Aumentar bids keywords top performers
+- [ ] Testar novos ad copy (2 variações)
+
+**Mensal:**
+- [ ] Analisar Quality Score (target > 7/10)
+- [ ] Optimizar landing pages (velocidade, relevância)
+- [ ] Adicionar extensões novas (seasonal)
+- [ ] Review conversions por dispositivo (mobile vs desktop)
+
+**Trimestral:**
+- [ ] Reestruturar campanhas underperforming
+- [ ] Testar novos match types
+- [ ] Expandir para Display/YouTube se ROAS Search > 4x
+```
+
+### Meta Ads
+
+```markdown
+**Diário (primeiros 7 dias learning):**
+- [ ] Verificar spending (não pausar durante learning)
+- [ ] Monitorizar CPA (não optimizar antes 50 conversões)
+
+**Semanal:**
+- [ ] Duplicar ad sets winning (escalar)
+- [ ] Pausar ads CTR < 1% ou CPA > 2x target
+- [ ] Testar 2-3 novos criativos
+- [ ] Refresh audiências (adicionar lookalikes)
+
+**Mensal:**
+- [ ] Analisar Breakdown (age, gender, placement)
+- [ ] Optimizar landing page (mobile-first)
+- [ ] Criar custom audience novos converters
+- [ ] Testar novos formatos (Reels, Carousel)
+```
+
+---
+
+## 🎨 Criativos que Convertem
+
+### Google Search Ads (RSAs)
+
+```markdown
+**Headlines (15 slots):**
+
+Slot 1-3 (SEMPRE aparecem): Keyword + Benefício
+"Painéis Solares Portugal | Poupança 60%"
+"Instalação Solar | Desde 4.500€"
+"Energia Solar | 0€ Investimento Inicial"
+
+Slot 4-8: Diferenciadores + USPs
+"Certificado DGEG | Garantia 25 Anos"
+"Financiamento 120 Meses | Aprovação 24h"
+
+Slot 9-12: CTAs + Urgência
+"Pedir Orçamento Gratuito"
+"Instalar em 30 Dias"
+
+Slot 13-15: Social Proof
+"500+ Instalações Portugal"
+"Avaliação 4.9★ Google"
+
+**Descriptions (4 slots):**
+- Benefício principal + CTA (80 chars)
+- USPs bullets (80 chars)
+- Objecções + garantia (80 chars)
+- Urgência + CTA (80 chars)
+```
+
+### Meta Ads (Imagem/Vídeo)
+
+```markdown
+**Estrutura Criativo:**
+
+1. **Visual (80% sucesso)**
+   - Imagem/vídeo alta qualidade
+   - Rosto humano (aumenta CTR 30%)
+   - Cores contrastantes (destaca em feed)
+   - Texto on-image < 20% (regra deprecada mas boa prática)
+
+2. **Primary Text (Hook)**
+   Primeira linha CRÍTICA (preview mostra 125 chars)
+   "Empresas portuguesas estão a poupar €5K/ano em electricidade."
+
+3. **Headline**
+   Benefício claro (40 chars)
+   "Poupa 60% Conta Luz | Orçamento Grátis"
+
+4. **Description** (Opcional)
+   Reforço benefício (30 chars)
+   "Instalação em 30 dias"
+
+5. **CTA Button**
+   - "Saber Mais" (ToFu)
+   - "Pedir Orçamento" (BoFu)
+   - "Enviar Mensagem" (Leads)
+```
+
+### Vídeo Ads (YouTube/Meta)
+
+```markdown
+**Primeiros 3 Segundos:**
+Hook visual + texto
+"PARA. Estás a desperdiçar dinheiro."
+
+**3-10 Segundos:**
+Problema + agitação
+"Conta luz aumentou 40% em 2025. Sem solução?"
+
+**10-25 Segundos:**
+Solução + benefício
+"Painéis solares eliminam 95% da conta. Assim:"
+
+**25-30 Segundos:**
+CTA + urgência
+"Orçamento gratuito. Só hoje: Instalação 0€. Link descrição."
+
+**Duração Ideal:**
+- Bumper (6s): Awareness
+- In-stream skippable (15-30s): Conversão
+- Meta Reels (15-30s): Engagement + conversão
+```
+
+---
+
+## ✅ Checklist Pré-Lançamento
+
+### Google Ads
+
+- [ ] Pixel instalado e testado (conversões a registar)
+- [ ] Negative keywords lista (min 50)
+- [ ] Landing page optimizada (load < 3s, mobile-first)
+- [ ] UTMs configurados (tracking correcto)
+- [ ] Conversion tracking validado (test conversion)
+- [ ] Extensions todas configuradas (min 4 sitelinks)
+- [ ] Orçamento definido (min €20/dia Search PT)
+- [ ] Bidding strategy escolhida (Smart Bidding se > 30 conv/mês histórico)
+- [ ] Ad copy 3 variações por ad group
+- [ ] Campanhas Brand separadas (proteger marca)
+
+### Meta Ads
+
+- [ ] Pixel instalado (events: ViewContent, AddToCart, Purchase)
+- [ ] Conversions API configurada (CAPI - bypass iOS 14)
+- [ ] Domínio verificado (Meta Business Manager)
+- [ ] Criativos aprovados (3-5 por ad set)
+- [ ] Copy variações (2-3 per criativo)
+- [ ] Audiências criadas (Custom, Lookalike)
+- [ ] Landing page optimizada (mobile 80% tráfego)
+- [ ] Orçamento definido (min €10/dia, €20/dia recomendado)
+- [ ] Placement strategy (Advantage+ ou manual sem Audience Network)
+
+---
+
+## 📚 Datasets Dify (Consultar SEMPRE)
+
+| Dataset | ID | Prioridade | Uso |
+|---------|----|-----------:|-----|
+| **Marketing Digital** | `c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24` | 1 | Estratégia ads, métricas |
+| **Marketing Redes Sociais** | `66117552-348f-455d-9aca-2da722567693` | 2 | Meta Ads, criativos |
+| **Neil Patel** | `6ff761b3-a054-435c-8fc3-a6e6c3a0afaf` | 3 | PPC strategies |
+
+### Como Consultar
+
+```javascript
+// Optimização Google Ads
+mcp__notebooklm__notebook_query, mcp__dify-kb__dify_kb_retrieve_segments({
+  dataset_id: "c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24",
+  query: "google ads optimization ROAS CPA bidding 2026"
+})
+
+// Meta Ads criativos
+mcp__dify-kb__dify_kb_retrieve_segments({
+  dataset_id: "66117552-348f-455d-9aca-2da722567693",
+  query: "facebook ads creative testing CTR conversion"
+})
+
+// PPC strategies
+mcp__dify-kb__dify_kb_retrieve_segments({
+  dataset_id: "6ff761b3-a054-435c-8fc3-a6e6c3a0afaf",
+  query: "ppc campaigns keywords optimization"
+})
+```
+
+---
+
+## 🎯 Agente Complementar
+- `ppc-specialist` (agente especializado)
+
+---
+
+**Versão:** 2.0.0 | **Autor:** Descomplicar® | **Data:** 2026-02-03
+**Standards:** Smart Bidding 2026, Advantage+ Audiences, ROAS > 3x
+
+---
+
+
+## Quando NÃO Usar
+
+- Para tarefas fora do domínio de especialização desta skill
+- Quando outra skill mais específica está disponível
+- Para operações que requerem confirmação manual do utilizador
+
+
+## Protocolo
+
+1. Analisar requisitos da tarefa
+2. Verificar disponibilidade de ferramentas necessárias
+3. Executar operações de forma incremental
+4. Validar resultados antes de concluir
+5. Reportar status e próximos passos
+
+
+## Exemplos
+
+### Exemplo 1: Uso Básico
+```
+Input: [descrição da tarefa]
+Output: [resultado esperado]
+```
+
+### Exemplo 2: Uso Avançado
+```
+Input: [caso complexo]
+Output: [resultado detalhado]
+```
+
+---
+
+## Healing Log
+
+Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.
+
+```jsonl
+{"date":"","issue":"","fix":"","source":"user|auto"}
+```
+
+*Adicionar nova linha após cada erro corrigido.*
@@ -0,0 +1 @@
+/home/ealmeida/.claude/skills/second-brain-repo/.claude/skills/brand-voice-generator
@@ -1,7 +1,6 @@
 ---
 name: content-marketing-pt
 description: Criacao de conteudo de marketing profissional em portugues europeu com standards actuais.
-layer: wiki
 ---

 # Content Marketing PT-PT
@@ -144,4 +143,110 @@ Anatomia: [Verbo Accao] + [Beneficio Imediato] + [Reducao Friccao]
 | **LinkedIn** | 150-300 chars | Profissional, insights | 3-5 |
 | **Instagram** | 100-150 chars | Inspiracional, visual | 10-15 |
 | **Facebook** | 40-80 chars | Conversacional | 1-3 |
-| **Twitter/X**
+| **Twitter/X** | 100-280 chars | Directo, opinioes | 1-2 |
+
+---
+
+## Checklist Pre-Publicacao
+
+### Tecnico (SEO)
+- [ ] Portugues europeu validado (zero brasileirismos)
+- [ ] Keyword principal no titulo (primeiros 60 chars)
+- [ ] Meta description optimizada (150-160 chars)
+- [ ] Headings hierarquicos (H1 unica, H2-H6 logicos)
+- [ ] Alt text descritivo em todas as imagens
+- [ ] Internal links (3-5 relevantes)
+- [ ] External links autoritativos (1-3, DR > 40)
+
+### Conteudo (Qualidade)
+- [ ] Headlines com beneficio claro
+- [ ] Paragrafos curtos (< 4 linhas)
+- [ ] Listas para informacao complexa
+- [ ] Exemplos praticos / casos reais
+- [ ] Dados/estatisticas (com fontes)
+- [ ] FAQ section (min 3 perguntas)
+
+### Conversao (CTA)
+- [ ] CTA especifico e accionavel
+- [ ] Beneficio imediato claro
+- [ ] Reducao friccao (sem cartao, gratuito, etc.)
+
+### E-E-A-T (Trust)
+- [ ] Autor identificado (nome + foto)
+- [ ] Bio autor (credenciais + experiencia)
+- [ ] Data publicacao + ultima actualizacao
+- [ ] Fontes citadas (links externos)
+
+---
+
+## References (conteudo detalhado)
+
+| Ficheiro | Conteudo |
+|----------|----------|
+| `references/vocabulario-br-pt.md` | Tabela completa de conversao BR -> PT-PT |
+| `references/templates-conteudo.md` | Templates artigo blog, email promocional, landing page |
+| `references/copywriting-patterns.md` | Headlines, CTAs, storytelling, persuasao etica, CRO |
+
+---
+
+## Anti-Patterns
+
+- Usar brasileirismos em conteudo PT-PT
+- CTAs vagos como "Clique aqui" ou "Submeter"
+- Paragrafos longos (> 4 linhas) em conteudo web
+- Ignorar E-E-A-T (sem autor, sem datas, sem fontes)
+- Headlines sem beneficio claro ou keyword
+- Excesso de anglicismos quando existe equivalente PT
+
+---
+
+**Versao**: 2.1.0 | **Autor**: Descomplicar
+
+---
+
+## Media Bank (D7-MB-001)
+
+**Quando consultar:** antes de sugerir ou inserir imagens de suporte em artigos, ebooks, whitepapers ou landing pages. Reutilizar matéria-prima local é preferível a geração IA ou stock externo.
+
+**Workflow tentativa-primeiro:**
+
+1. Pesquisar via MCP `media-bank`:
+   ```
+   mcp__media-bank__search_media(
+     query="<tema do conteúdo em EN>",
+     type="image",
+     tema="<um dos 9 temas>",
+     orientation="landscape",
+     min_quality=7,
+     min_width=1200,
+     exclude_used_in_last_days=30,
+     limit=5
+   )
+   ```
+2. Avaliar candidatos por `description_en` + `quality_score`.
+3. Se ≥1 adequado → usar `path_local`; derivar `alt` text a partir de `description_en` traduzido para PT-PT.
+4. Se nenhum → fallback para geração IA.
+5. Marcar uso: `mcp__media-bank__mark_used(asset_id, {type:"content-piece", ref:"<slug>", date:"<YYYY-MM-DD>"})`.
+
+**Fallback REST** (se MCP indisponível):
+```bash
+SK=$(grep SERVICE_KEY /media/ealmeida/Dados/Hub/05-Projectos/Banco-Imagens-Videos/scripts/.env | cut -d= -f2)
+curl -s "https://mem.descomplicar.pt/rest/v1/media_bank_assets?type=eq.image&orientation=eq.landscape&quality_score=gte.7&deleted_at=is.null&order=quality_score.desc&limit=5" \
+  -H "apikey: $SK" -H "Authorization: Bearer $SK"
+```
+
+**Regra inviolável:** matéria-prima local. Usar como input para composição — NUNCA inserir o ficheiro raw directamente em publicação pública sem edição/contextualização.
+
+Ver `Hub/06-Operacoes/Procedimentos/D7-Tecnologia/MCP/PROC-Media-Bank.md` (D7-MB-001) para detalhes.
+
+---
+
+## Healing Log
+
+Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.
+
+```jsonl
+{"date":"","issue":"","fix":"","source":"user|auto"}
+```
+
+*Adicionar nova linha após cada erro corrigido.*
@@ -1,7 +1,6 @@
 ---
 name: lead-approach
 description: Abordagem estratégica de leads com análise completa, estratégia de proposta e primeiro contacto. Lança agentes especializados em paralelo, consulta datasets Dify, cria proposta e actualiza CRM.
-layer: wiki
 ---

 # Skill /lead-approach - Abordagem Estratégica de Leads
@@ -203,4 +202,124 @@ mcp__desk-crm-v3__update_lead({
 |---------|----|-----------|
 | Marketing Digital | `c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24` | Estratégias, funil, leads |
 | Vendas | `a7ba6005-517c-41ab-ac5e-da1c1a1c62ef` | Técnicas fecho, objecções |
-| Serviços Descomplicar | `bd65f36e-6004-4584-b478-129b2c21b4d2`
+| Serviços Descomplicar | `bd65f36e-6004-4584-b478-129b2c21b4d2` | Pacotes, preços |
+| Websites | `c8489151-de94-42b2-8cee-c0b961cfac6d` | Funcionalidades |
+
+## Agentes Utilizados
+
+| Agente | Função |
+|--------|--------|
+| `marketing-planning-expert` | Estratégia, pacotes, diferenciação |
+| `sales-manager` | Abordagem, templates, follow-up |
+
+## Outputs
+
+1. **Documento proposta** em `01-Projectos/Profissional/`
+2. **Lead actualizado** no CRM com dados completos
+3. **Template email** pronto a enviar
+4. **Estratégia follow-up** documentada
+
+## Exemplos de Uso
+
+### Lead de abandono de formulário
+```
+User: /lead-approach 215
+→ Busca lead #215
+→ Encontra ticket associado
+→ Extrai dados do formulário
+→ Lança agentes em paralelo
+→ Cria proposta + estratégia abordagem
+→ Documento: PRJ-EmpresaX-Proposta.md
+→ Lead actualizado no CRM
+```
+
+### Exemplo 2: Lead por nome
+```
+User: /lead-approach "Century 21"
+→ Pesquisa leads com "Century 21"
+→ Encontra match
+→ Executa workflow completo
+→ Consulta datasets Dify
+→ Gera estratégia completa
+```
+
+### Exemplo 3: Interactivo
+```
+User: /lead-approach
+→ Pergunta: "Qual o lead? (ID ou nome empresa)"
+→ Utilizador responde: "João Silva - TechStart"
+→ Executa workflow
+→ Agentes em paralelo (marketing + sales)
+→ Resultado: documento + CRM actualizado
+```
+
+## Checklist de Execução
+
+- [ ] Lead identificado no CRM
+- [ ] Dados completos extraídos
+- [ ] Ticket associado verificado
+- [ ] Empresa pesquisada (web, redes)
+- [ ] Agente marketing lançado
+- [ ] Agente sales lançado
+- [ ] Datasets Dify consultados
+- [ ] Documento proposta criado
+- [ ] Lead actualizado no CRM
+- [ ] Template email pronto
+
+## Referências
+
+- `03-Recursos/Procedimentos/PROC-CRM-Operacoes.md`
+- `/media/ealmeida/Dados/GDrive/Cloud/Docs/Produtos_Servicos/tabela-geral.csv`
+- Skill `/orcamento` para preços oficiais
+
+---
+
+**Versão:** 1.0.0 | **Data:** 2026-01-28
+
+---
+
+## Instrumentação Automática
+
+Esta skill grava métricas automaticamente para análise PDCA.
+
+### Baseline
+
+| Métrica | Valor |
+|---------|-------|
+| Tempo baseline | 25 min |
+| Tempo target | 12 min |
+| Melhoria esperada | -52% |
+
+### Query para Gravar (executar no final)
+
+```sql
+INSERT INTO tblskill_agent_metrics (
+  type, name, duration_ms, status, staff_id,
+  kb_consulted, kb_cache_hit, tool_calls, project_id
+) VALUES (
+  'skill', '/lead-approach', {DURACAO_MS}, '{STATUS}', 25,
+  {KB_CONSULTADO}, {CACHE_HIT}, {TOOL_CALLS}, {PROJECT_ID}
+);
+```
+
+### Ver Métricas
+
+```bash
+/metrics /lead-approach
+```
+
+---
+
+**Versão**: 1.1.0 | **Data**: 2026-02-03 | **Instrumentação**: Activa
+
+---
+
+## Healing Log
+
+Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.
+
+```jsonl
+{"date":"","issue":"","fix":"","source":"user|auto"}
+```
+
+*Adicionar nova linha após cada erro corrigido.*
@@ -1,7 +1,6 @@
 ---
 name: marketing-strategy
 description: Desenvolvimento de estrategia de marketing para PMEs portuguesas. Cria planos completos com mix de canais e alocacao de orcamento.
-layer: wiki
 ---

 # /marketing-strategy
@@ -1,175 +1,208 @@
 ---
 name: seo-audit
-description: Auditoria SEO completa com recomendacoes de optimizacao. Analisa SEO tecnico, conteudo, backlinks e desempenho.
-layer: wiki
+description: Auditoria SEO completa com dados reais via OpenSEO (crawl, Search Console, SERP, backlinks, keywords). Analisa SEO técnico, conteúdo, autoridade e desempenho, e prioriza por retorno. Usar quando "auditoria SEO", "audit", "analisar site", "Core Web Vitals", "Search Console", "striking distance", "porque não tenho tráfego".
 ---

-# SEO Audit - Auditoria Completa
+# SEO Audit — Auditoria Completa (OpenSEO)

-Skill para realizar auditorias SEO completas usando o stack de ferramentas instalado. Best practices 2026.
+Auditoria SEO com dados reais. **Motor único: OpenSEO** (`seo.descomplicar.pt`), que substituiu o stack antigo (SEO Tools API + Ahrefs + GSC MCP + Lighthouse MCP) — ver `references/ferramentas-api.md` para a tabela de migração.

 ---

-## Contexto NotebookLM
+## Regra zero — a ordem é económica, não estética

-ANTES de executar, consultar notebook para contexto especializado:
+O OpenSEO tem ferramentas **grátis** e ferramentas **que gastam créditos**. Executar pela ordem errada gasta dinheiro a produzir conclusões que as ferramentas grátis já davam.

-| Notebook | ID | Consultar quando |
-|----------|-----|-----------------|
-| Marketing Digital PT | `4c595973` | Sempre |
+| Fase | Ferramentas | Custo | Porquê nesta ordem |
+|---|---|---|---|
+| 1 | `get_search_console_performance`, `inspect_urls` | **grátis** | Dados de primeira mão. Diz o que já posiciona e quais páginas importam |
+| 2 | `run_site_audit`, `get_audit_issues`, `get_audit_pages` | **grátis** | Estado técnico. O dimensionamento do crawl depende da fase 1 |
+| 3 | `get_keyword_metrics` | pago (lote) | Hidrata até 700 keywords conhecidas de uma vez — a melhor relação valor/crédito |
+| 4 | `get_ranked_keywords`, `get_domain_overview`, `get_backlinks_overview` | pago | Contexto competitivo |
+| 5 | `get_serp_results`, `find_serp_competitors` | pago (~30-60/keyword) | Só nas keywords que sobreviveram à filtragem |

-```
-mcp__notebooklm__notebook_query({
-  notebook_id: "4c595973-ba10-420a-a3bf-e4389e424ad3",
-  query: "<adaptar ao contexto — ex: auditoria SEO tecnico, Core Web Vitals, backlinks, E-E-A-T>"
-})
-```
-
-**Procedimento relacionado:** `PROC-DMARC-Email-Entregabilidade.md` -- consultar quando a auditoria envolve email deliverability.
+**Nunca começar pela fase 3 ou acima.** As fases 1-2 resolvem a maioria das auditorias sem gastar um crédito.

 ---

-## Quando Usar
+## Pré-voo obrigatório (3 verificações, 30 segundos)

- Auditar um site completo (tecnico + conteudo + performance)
- Verificar Core Web Vitals e ranking factors
- Analisar backlinks e autoridade de dominio
- Obter dados reais do Google Search Console
- Identificar oportunidades de optimizacao
- Comparar com concorrencia
+```
+1. openseo → whoami            → confirma ligação, org, modo
+2. openseo → list_projects     → obtém projectId E o mercado do projecto
+3. confirmar mercado           → PT = locationCode 2620, languageCode "pt"
+```
+
+**GATE — mercado.** Se o projecto estiver em `2840/en` (EUA/inglês, que é o default) e o cliente for português, **todas** as chamadas pagas devolvem dados do mercado errado. Ou se corrige o mercado do projecto, ou se passa `locationCode`/`languageCode` explicitamente em **cada** chamada. Um esquecimento = créditos gastos em lixo.
+
+> `locationCode: 2620` = Portugal — confirmado empiricamente (SERP devolve domínios `.pt`). Não inventar códigos: se houver dúvida, correr uma query de teste e validar pelos resultados.

 ---

-## Google Updates 2026
+## Fase 1 — Search Console primeiro (grátis, é o mapa)

-### Core Algorithm Updates
+```
+openseo → get_search_console_performance
+  dimensions: ["query"]   dateRange: "last_3_months"   rowLimit: 1000
+openseo → get_search_console_performance
+  dimensions: ["page"]    dateRange: "last_3_months"   rowLimit: 1000
+```

-| Update | Data | Impacto |
-|--------|------|---------|
-| **Helpful Content Q1** | Jan 2026 | Penaliza conteudo AI de baixa qualidade |
-| **Core Web Vitals 3.0** | Mar 2026 | INP substitui FID, thresholds mais rigorosos |
-| **E-E-A-T Focus** | Q1-Q2 | Experiencia pratica obrigatoria |
-| **Mobile-First Index** | Universal | 100% dos sites |
+Paginar com `startRow` enquanto o cabeçalho disser `more available`.

-### Novos Ranking Factors 2026
+### As três armadilhas do GSC

-1. **INP (Interaction to Next Paint)** -- Bom: < 200ms | Medio: 200-500ms | Mau: > 500ms
-2. **E-E-A-T** -- Autor identificado com bio, credenciais verificaveis, experiencia real
-3. **Page Experience Signals** -- HTTPS obrigatorio, intrusive interstitials penalizados
+**1. Vista por query ≠ vista por página.** O GSC anonimiza queries raras, por isso os totais por query são sempre **muito menores** que os totais por página. A vista por **página** é a real; usar essa para números globais.
+
+**2. O GSC não filtra por posição.** `striking distance` tem de ser filtrado do lado do cliente, depois de puxar as linhas.
+
+**3. Há lixo nas queries.** Colagens de relatórios do Google Ads, operadores `site:`, strings com mojibake. Filtrar antes de contar, ou as métricas mentem.
+
+```python
+def is_noise(k):
+    return ('ativado' in k and 'correspond' in k) or k.startswith('-site:') \
+           or k.startswith('=') or len(k) > 90 or '0,00' in k
+```
+
+### O que extrair
+
+| Métrica | Cálculo | Leitura |
+|---|---|---|
+| CTR global | cliques ÷ impressões (vista por página) | < 1% = problema de captação, não de ranking |
+| Distribuição por posição | buckets 1-3 / 4-10 / 11-20 / 21-50 / 51+ | Impressões concentradas em 21+ = visibilidade inútil |
+| Branded vs não-branded | queries com o nome da marca vs resto | Se só a marca converte, o SEO não está a trabalhar |
+| **Striking distance** | pos 4-20 **e** impressões ≥ 25 | **É aqui que está o retorno** |
+| Desperdício | pos > 40 **e** impressões ≥ 300 | Páginas com procura real enterradas |
+
+### O sinal mais accionável de todos
+
+**Posição 4-10 com CTR perto de 0%.** Não é problema de ranking — o site está na primeira página. É o **título e a meta description** a não convencerem. Cruzar esta lista com os issues `missing-meta-description` e `title-too-long` da fase 2: a intersecção é a lista de trabalho, por ordem.

 ---

-## Workflow de Auditoria Completa
-
-### Passo 1: Analise Tecnica Basica (3 min)
+## Fase 2 — Auditoria técnica (grátis)

 ```
-1. SEO Tools API -> /seo-audit -> Meta tags, headings, estrutura HTML
-2. SEO Tools API -> /page-speed-analyzer -> Velocidade, sugestoes
-3. Lighthouse -> run_audit -> Performance, SEO, Accessibility scores
+openseo → run_site_audit
+  url: "<url>"   maxPages: <N>   runLighthouse: true
+openseo → get_audit_status      (poll até "completed")
+openseo → get_audit_issues      (severity: critical → warning → info)
 ```

-**Checklist Critico:**
- [ ] Meta title (50-60 chars)
- [ ] Meta description (150-160 chars)
- [ ] H1 unico com keyword
- [ ] Canonical URL definido
- [ ] Robots.txt acessivel
- [ ] Sitemap.xml presente
- [ ] HTTPS activo
- [ ] Mobile-friendly
+### GATE — `maxPages` (o erro que cega a auditoria)

-### Passo 2: Core Web Vitals (2 min)
+**`maxPages` tem default 50.** Um site de 600 páginas auditado com o default devolve um relatório limpo e falso: descreve 8% do site e omite exactamente o hub de conteúdo que gera o tráfego.
+
+**Regra:** `maxPages` ≥ número de páginas com impressões no GSC (fase 1), com folga de ~25%. Por isso é que a fase 1 vem primeiro — é ela que dimensiona o crawl.
+
+> Caso real (descomplicar.pt, 07-2026): auditoria com default 50 → 25 URLs únicos, 92 issues, **zero críticos**, nenhuma das 119 páginas `/guia-*`. Relançada com `maxPages: 600` → **1337 issues, 9 críticos**. O relatório "limpo" descrevia 4% do site.
+
+### Prioridade dos issues
+
+| Severidade | Tipos | Acção |
+|---|---|---|
+| **critical** | `broken-internal-link`, `blocked-page`, `server-error`, `broken-page` | Corrigir já — sangram autoridade e crawl budget |
+| **warning** | `missing-h1`, `missing-meta-description`, `duplicate-content`, `multiple-h1`, `duplicate-title` | Priorizar pelas páginas com impressões (fase 1) |
+| **info** | `title-too-long`, `noindex-page`, `slow-response`, `heading-order-skip` | Lote; só vale a pena onde há procura |
+
+**Nunca tratar a lista de issues por ordem de contagem.** 300 metas em falta em páginas sem impressões valem menos que 6 em páginas na posição 8. A fase 1 é que ordena a fase 2.
+
+### Limitação conhecida — issues sem URL
+
+`get_audit_issues` e `get_audit_pages` devolvem **apenas contagens agregadas** através da bridge MCP. As linhas por URL vivem em `structuredContent.issues`, que a bridge não entrega; `get_audit_pages` trunca a listagem em ~25 linhas independentemente do `limit`.
+
+**Contorno:** o campo `details.mcpMeta.url` da resposta traz o link do relatório na UI. Entregar esse link ao humano para os URLs concretos:
+```
+https://seo.descomplicar.pt/p/<projectId>/audit?auditId=<auditId>
+```
+Declarar esta limitação no relatório — não fingir que se verificaram URLs que não se viram.
+
+### Core Web Vitals por página
+
+`run_site_audit` com `runLighthouse: true` corre Lighthouse numa amostra (até 20 páginas). Para uma página específica, usar `chrome-devtools`:

 ```
-1. Lighthouse -> get_core_web_vitals -> LCP, INP, CLS (mobile + desktop)
-2. Lighthouse -> compare_mobile_desktop -> Identificar gaps
-3. Lighthouse -> get_lcp_opportunities -> Sugestoes optimizacao
+chrome-devtools → lighthouse_audit          (SEO, acessibilidade, best practices)
+chrome-devtools → performance_start_trace   (LCP, INP, CLS reais)
 ```

-**Thresholds 2026:**
+**Thresholds 2026:** LCP < 2,5s · **INP** < 200ms · CLS < 0,1
+(INP substituiu o FID — se algum documento ainda disser FID, está desactualizado.)

-| Metrica | Bom | Necessita Melhoria | Mau |
-|---------|-----|-------------------|-----|
-| **LCP** | < 2.5s | 2.5-4s | > 4s |
-| **INP** | < 200ms | 200-500ms | > 500ms |
-| **CLS** | < 0.1 | 0.1-0.25 | > 0.25 |
+---

-### Passo 3: Analise de Conteudo (3 min)
+## Fase 3 — Hidratar keywords (pago, lote)

 ```
-1. SEO Tools API -> /content-optimization -> On-page SEO, keyword density
-2. SEO Tools API -> /internal-linking -> Estrutura links internos
-3. SEO Ahrefs -> keyword_generator -> Keywords relacionadas, volume, KD
+openseo → get_keyword_metrics
+  keywords: [<as keywords em striking distance da fase 1>]
+  locationCode: 2620   languageCode: "pt"
 ```

-**Checklist E-E-A-T:**
- [ ] Autor identificado com bio
- [ ] Credenciais verificaveis
- [ ] Data publicacao/actualizacao
- [ ] Fontes citadas (links externos autoritativos)
- [ ] Experiencia real demonstrada
+Até **700 keywords numa só chamada** — volume, dificuldade (KD), intenção, CPC, tendência. É a forma barata de priorizar. Só depois disto se decide onde vale a pena competir.

-### Passo 4: Backlinks e Autoridade (2 min)
+Guardar o que sobreviver: `openseo → save_keywords` (grátis, idempotente).
+
+---
+
+## Fase 4 — Contexto competitivo (pago)

 ```
-1. SEO Tools API -> /backlink-checker -> Backlinks basicos, DR/UR
-2. SEO Ahrefs -> get_backlinks_list -> Lista detalhada (DR, anchor text)
-3. SEO Ahrefs -> get_traffic -> Trafego estimado mensal
-```
-
-**Metricas Autoridade:**
- **DR (Domain Rating)**: 0-100 (forca backlink profile)
- **UR (URL Rating)**: 0-100 (forca pagina especifica)
- **Backlinks**: Quantidade + qualidade (DR > 30)
- **Referring Domains**: Numero de dominios unicos
-
-### Passo 5: Dados Reais GSC (3 min)
-
-```
-1. GSC -> get_search_analytics -> Queries, impressoes, CTR real (ultimos 90 dias)
-2. GSC -> check_indexing_issues -> Problemas de indexacao
-3. GSC -> get_sitemaps -> Status sitemaps submetidos
-```
-
-**Metricas GSC a Analisar:**
- **Impressoes vs Cliques**: CTR medio > 2%
- **Posicao media**: Top 3 para keywords principais
- **Cobertura**: % paginas indexadas vs submetidas
- **Mobile Usability**: Erros especificos mobile
-
-### Passo 6: Concorrencia (opcional, 2 min)
-
-```
-SEO Tools API -> /competitor-analysis -> Comparar com 2-3 concorrentes
- Keywords gap
- Backlinks gap
- Content gap
+openseo → get_domain_overview        (tráfego orgânico estimado, nº keywords, backlinks)
+openseo → get_ranked_keywords        (onde o domínio posiciona, por mercado)
+openseo → get_backlinks_overview     (~50 créditos por domínio)
+openseo → get_backlinks_profile      (linhas detalhadas: anchors, dofollow, spam)
 ```

 ---

-## Propriedades GSC Disponiveis
+## Fase 5 — SERP (pago, por último)

 ```
-sc-domain:descomplicar.pt
-https://emanuelalmeida.pt/
-https://carstuff.pt/
-https://solarfvengenharia.com/
-https://aquisevende.pt/
-https://alojadamaria.com/
-https://e-commerce.descomplicar.pt/
+openseo → get_serp_results       (1-10 keywords por chamada, ~30-60 créditos cada)
+openseo → find_serp_competitors  (quem compete num conjunto de keywords)
 ```

+Ler a SERP como **estrutura**, não como lista: se o top-10 estiver cheio de directórios e artigos "melhores X", a intenção é comparativa e uma homepage não entra — é preciso uma página de comparação. Se estiver cheio de homepages de concorrentes, é disputa de marca.
+
+Local/Maps: `get_local_serp_results`, `search_local_businesses`, `get_google_business_questions`.
+
 ---

-## Notas Importantes
+## Custos — o que sabemos e o que não sabemos

-### Requisitos
- **SEO Tools API** deve estar a correr: `~/mcp-servers/seo-tools-api/start.sh`
- **GSC** requer autenticacao OAuth na primeira utilizacao
- **GA** requer ADC credentials configuradas
+`whoami` **não expõe saldo de créditos** em modo self-hosted (verificado antes e depois de uma chamada paga: output idêntico). Os `~30-60 créditos/keyword` são a **estimativa do schema**, não uma medição.

-### Limitacoes
- Ahrefs API tem rate limiting (100 req/day free tier)
- GSC data maxi
+**Consequência prática:** não há medidor no OpenSEO. O contador real vive na conta DataForSEO. Para lotes grandes, confirmar saldo aí primeiro. Nunca reportar custo consumido como facto — reportar como estimativa.
+
+---
+
+## Anti-patterns
+
+- **Correr `run_site_audit` com o `maxPages` por omissão.** Produz relatórios limpos e falsos.
+- **Começar por ferramentas pagas.** O GSC é grátis e responde a metade das perguntas.
+- Usar totais por query como totais do site (o GSC anonimiza — usar a vista por página).
+- Priorizar issues por contagem em vez de por impressões da página afectada.
+- Correr chamadas pagas sem confirmar o mercado do projecto.
+- Apresentar contagens de issues como se fossem URLs verificados.
+- Auditar sem dados reais ou simular métricas.
+- Recomendações sem prioridade (crítico/importante/melhoria) e sem esforço estimado.
+
+---
+
+## References
+
+| Ficheiro | Conteúdo |
+|---|---|
+| `references/ferramentas-api.md` | Inventário OpenSEO completo + tabela de migração do stack antigo |
+| `references/template-relatorio-auditoria.md` | Template do relatório com todas as secções e tabelas |
+
+---
+
+**Versão:** 3.0.0 | **Autor:** Descomplicar® | **Motor:** OpenSEO
+
+## Healing Log
+<!-- Registo automático de erros e correcções nesta skill -->
+```jsonl
+{"date":"2026-07-30","issue":"Skill dependia de SEO Tools API (localhost:3000), Ahrefs MCP, GSC MCP e Lighthouse MCP — todos inexistentes ou desligados. Nenhum dos 6 passos era executável.","fix":"Reescrita completa sobre OpenSEO, com ordem por custo, gates de mercado e maxPages.","source":"auto"}
+```
@@ -1,75 +1,113 @@
-# Ferramentas e APIs - SEO Audit
+# Ferramentas SEO — OpenSEO

-## 1. SEO Tools API (http://localhost:3000)
+Motor único do SEO Descomplicar®. Substituiu integralmente o stack anterior.
+UI: `https://seo.descomplicar.pt` · Projecto default: `1e5ad4d6-a285-4fd3-9633-339abef4b6af`

-```bash
-# Auditoria basica
-curl "http://localhost:3000/seo-audit?url=URL"
+---

-# Velocidade PageSpeed Insights style
-curl "http://localhost:3000/page-speed-analyzer?url=URL"
+## 1. Migração — o que morreu e o que o substitui

-# Backlinks + DR/UR
-curl "http://localhost:3000/backlink-checker?url=URL"
+O stack antigo desta skill (v2.1.0) apontava para quatro dependências. **Nenhuma está operacional** (verificado 30-07-2026):

-# Rankings para keywords
-curl "http://localhost:3000/rank-checker?url=URL&keywords=keyword1,keyword2"
+| Dependência antiga | Estado real | Substituto OpenSEO |
+|---|---|---|
+| **SEO Tools API** `localhost:3000` | `~/mcp-servers/seo-tools-api/` **não existe em disco** | ver tabela abaixo |
+| **Ahrefs MCP** | nunca esteve em nenhuma config MCP | `get_backlinks_*`, `get_domain_overview`, `get_keyword_metrics` |
+| **GSC MCP** | em `disabledServers` | `get_search_console_performance`, `inspect_urls` |
+| **Lighthouse MCP** | em `disabledServers` | `run_site_audit` (`runLighthouse`) ou `chrome-devtools` |

-# Optimizacao conteudo on-page
-curl "http://localhost:3000/content-optimization?url=URL"
+### Endpoint a endpoint

-# Internal linking structure
-curl "http://localhost:3000/internal-linking?url=URL"
+| Antigo | Novo | Nota |
+|---|---|---|
+| `/seo-audit` | `run_site_audit` + `get_audit_issues` | Atenção ao `maxPages` |
+| `/page-speed-analyzer` | `run_site_audit` com `runLighthouse: true` | Amostra até 20 páginas |
+| `/content-optimization` | `get_audit_issues` (`thin-content`, `title-*`, `meta-description-*`) | |
+| `/internal-linking` | `get_audit_issues` (`orphan-page`, `broken-internal-link`, `no-outgoing-links`) | |
+| `/backlink-checker` | `get_backlinks_overview` | |
+| `/rank-checker` | `get_rank_tracker` (grátis) ou `get_ranked_keywords` (pago) | |
+| `/competitor-analysis` | `find_serp_competitors` + `get_domain_overview` | |
+| `/sitemap-generator` | **sem equivalente** | Usar plugin WP ou gerar à mão |
+| Ahrefs `keyword_generator` | `research_keywords` (novas) / `get_keyword_metrics` (conhecidas) | |
+| Ahrefs `get_backlinks_list` | `get_backlinks_profile` | |
+| Ahrefs `get_traffic` | `get_domain_overview` | Estimado |
+| Lighthouse `run_audit` | `chrome-devtools → lighthouse_audit` | Por página |
+| Lighthouse `get_core_web_vitals` | `chrome-devtools → performance_start_trace` | LCP/INP/CLS reais |
+| GSC `get_search_analytics` | `get_search_console_performance` | |
+| GSC `check_indexing_issues` | `inspect_urls` | Até 10 URLs por chamada |
+| GSC `get_sitemaps` | **sem equivalente** | Ver na UI do Search Console |

-# Sitemap XML generator
-curl "http://localhost:3000/sitemap-generator?url=URL"
+---

-# Analise concorrencia
-curl "http://localhost:3000/competitor-analysis?url=URL&competitors=site1.com,site2.com"
-```
+## 2. Inventário OpenSEO (24 ferramentas)

-## 2. Lighthouse MCP
+### Grátis — não tocam no DataForSEO

-| Tool | Funcao | Output |
-|------|--------|--------|
-| `run_audit(url)` | Auditoria completa | Performance, SEO, A11y, Best Practices |
-| `get_performance_score(url)` | Score performance | 0-100 |
-| `get_core_web_vitals(url)` | LCP, INP, CLS | Mobile + Desktop |
-| `get_accessibility_score(url)` | Acessibilidade | 0-100 + issues |
-| `get_seo_analysis(url)` | Analise SEO tecnico | Meta, headings, indexabilidade |
-| `get_security_audit(url)` | Seguranca | HTTPS, mixed content, headers |
-| `compare_mobile_desktop(url)` | Comparacao | Diferencas performance |
-| `get_lcp_opportunities(url)` | Optimizacoes LCP | Preload, lazy load |
-| `find_unused_javascript(url)` | JS nao usado | Tamanhos, % savings |
+| Ferramenta | Função |
+|---|---|
+| `whoami` | Utilizador, org, modo, scopes. **Não mostra saldo em self-hosted** |
+| `list_projects` | Projectos + `projectId` + mercado default |
+| `create_project` | Novo projecto (nome, domínio, mercado) |
+| `run_site_audit` | Crawl same-origin, robots-aware. `maxPages` **default 50** |
+| `get_audit_status` | Progresso (fase, páginas, Lighthouse) |
+| `get_audit_issues` | Relatório priorizado. Filtros `severity`/`issueType` |
+| `get_audit_pages` | Páginas crawladas com dados SEO por página |
+| `get_search_console_performance` | Search Analytics: cliques, impressões, CTR, posição |
+| `inspect_urls` | URL Inspection do GSC (até 10 URLs): indexação, canónico |
+| `get_rank_tracker` | Configs de rank tracking + último snapshot |
+| `save_keywords` | Guardar keywords no projecto (idempotente) |
+| `list_saved_keywords` | Keywords guardadas + métricas em cache |

-## 3. SEO Ahrefs MCP (via API)
+### Pagas — consomem créditos

-| Tool | Funcao | Dados |
-|------|--------|-------|
-| `get_backlinks_list(domain)` | Lista backlinks | DR, UR, anchor text |
-| `keyword_generator(keyword, country)` | Ideias keywords | Volume, KD, CPC |
-| `get_traffic(domain)` | Trafego estimado | Visitas mensais, keywords |
-| `keyword_difficulty(keyword)` | Dificuldade keyword | 0-100 (KD score) |
+| Ferramenta | Custo aprox. | Função |
+|---|---|---|
+| `get_keyword_metrics` | lote | **Até 700 keywords/chamada**: volume, KD, intenção, CPC, tendência |
+| `research_keywords` | ~30-100/seed | 1-5 seeds → ideias novas + métricas |
+| `get_serp_results` | ~30-60/keyword | Google orgânico ao vivo, 1-10 keywords |
+| `find_serp_competitors` | pago | Domínios que competem num conjunto de keywords |
+| `get_ranked_keywords` | pago | Keywords onde um domínio posiciona, por mercado |
+| `get_domain_overview` | pago | Tráfego orgânico, nº keywords, backlinks, ref. domains |
+| `get_domain_keyword_suggestions` | pago | Lista detalhada de keywords de um domínio |
+| `get_backlinks_overview` | ~50/domínio, ~25/página | Resumo do perfil de backlinks |
+| `get_backlinks_profile` | pago | Linhas detalhadas: anchors, dofollow, spam, lost/broken |
+| `get_local_serp_results` | pago | Google Maps / Local Finder junto a coordenadas |
+| `search_local_businesses` | pago | Negócios locais perto de coordenadas |
+| `get_google_business_questions` | pago | Q&A de Google Business Profile |

-## 4. Google Search Console MCP
+---

-| Tool | Funcao | Dados Reais |
-|------|--------|-------------|
-| `list_properties` | Listar sites verificados | URLs properties |
-| `get_search_analytics(site, period)` | Queries, cliques, CTR | Ultimos 16 meses |
-| `inspect_url_enhanced(site, url)` | Inspeccionar URL | Indexacao, mobile usability |
-| `check_indexing_issues(site, urls)` | Problemas indexacao | Erros, avisos |
-| `get_sitemaps(site)` | Listar sitemaps | Status, URLs submetidos |
+## 3. Mercados

-## 5. Google Analytics MCP
+| Mercado | `locationCode` | `languageCode` |
+|---|---|---|
+| **Portugal** | `2620` | `pt` |
+| EUA (default do projecto) | `2840` | `en` |

-| Tool | Funcao | Metricas |
-|------|--------|----------|
-| `get_account_summaries` | Listar contas | Properties disponiveis |
-| `run_report(property, metrics, dimensions)` | Relatorio custom | Sessions, users, bounce rate |
-| `run_realtime_report(property)` | Tempo real | Utilizadores activos now |
+`2620` = Portugal, confirmado empiricamente (SERP devolve domínios `.pt`). **Não inventar códigos** — validar sempre por uma query de teste. Referência oficial: `dataforseo.com/help-center/locations`.

-## Propriedades GSC Disponiveis
+**Aviso:** alguns países são servidos por dados do Google Ads — volume/CPC funcionam, mas KD, intenção e analytics de domínio não estão disponíveis.
+
+---
+
+## 4. Limitações conhecidas (verificadas, não presumidas)
+
+1. **Issues sem URL.** `get_audit_issues` e `get_audit_pages` devolvem só contagens agregadas via bridge MCP. As linhas por URL vivem em `structuredContent.issues`, que a bridge não entrega. `get_audit_pages` trunca em ~25 linhas mesmo com `limit: 1000`.
+   → Contorno: `details.mcpMeta.url` traz o link do relatório na UI.
+
+2. **Sem medidor de créditos.** `whoami` em self-hosted devolve o mesmo output antes e depois de chamadas pagas. Os custos documentados são estimativas do schema. O contador real está na conta DataForSEO.
+
+3. **`maxPages` default 50.** A causa mais comum de auditorias falsamente limpas.
+
+4. **GSC anonimiza queries.** Totais por query são sempre inferiores aos totais por página. Usar a vista por página para números globais.
+
+5. **GSC não filtra por posição.** Striking distance filtra-se do lado do cliente.
+
+6. **Lag do GSC:** os últimos ~3 dias podem estar incompletos. Datas em Pacific Time. Máximo 16 meses de histórico.
+
+---
+
+## 5. Propriedades Search Console disponíveis

 ```
 sc-domain:descomplicar.pt
@@ -81,14 +119,6 @@ https://alojadamaria.com/
 https://e-commerce.descomplicar.pt/
 ```

-## Requisitos
+---

- **SEO Tools API** deve estar a correr: `~/mcp-servers/seo-tools-api/start.sh`
- **GSC** requer autenticacao OAuth na primeira utilizacao
- **GA** requer ADC credentials configuradas (`gcloud auth application-default login`)
-
-## Limitacoes
-
- Ahrefs API tem rate limiting (100 req/day free tier)
- GSC data maximo: 16 meses historico
- Lighthouse scores variam +/- 5 pontos entre execucoes (network dependent)
+**Actualizado:** 30-07-2026 | Substitui a versão baseada em SEO Tools API + Ahrefs + GSC/Lighthouse MCP
@@ -183,11 +183,14 @@ H1: [Texto] OK
 ---

 ## Ferramentas Utilizadas
- SEO Tools API (localhost:3000)
- Lighthouse MCP
- SEO Ahrefs MCP
- Google Search Console MCP
- Google Analytics MCP (opcional)
+- OpenSEO — crawl e issues (`run_site_audit`, `get_audit_issues`)
+- OpenSEO — Search Console (`get_search_console_performance`)
+- OpenSEO — keywords e SERP (`get_keyword_metrics`, `get_serp_results`)
+- OpenSEO — autoridade (`get_backlinks_overview`, `get_domain_overview`)
+- chrome-devtools — Core Web Vitals por página (opcional)
+
+**Cobertura do crawl**: [N páginas crawladas] de [M páginas com impressões no GSC]
+**Chamadas pagas**: [listar] — custo estimado, não medido (OpenSEO não expõe saldo)

 ---

@@ -1,7 +1,6 @@
 ---
 name: seo-content-optimization
 description: Optimizacao de conteudo para motores de busca. Melhora conteudo existente com palavras-chave, estrutura e legibilidade.
-layer: wiki
 ---

 # SEO Content Optimization
@@ -162,8 +161,100 @@ 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**
+| 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 |
+
+Inventário e tabela de migração: `../seo-audit/references/ferramentas-api.md`
+
+### 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
+
+- **TinyPNG/Squoosh** - Comprimir imagens
+- **Cloudflare** - CDN, cache
+- **WP Rocket/Autoptimize** - WordPress performance
+
+---
+
+## Checklist Pre-Publicacao
+
+### Tecnico
+
+- [ ] Title tag optimizado (50-60 chars, keyword inicio)
+- [ ] Meta description unica (150-160 chars, CTA)
+- [ ] H1 unico com keyword principal
+- [ ] Imagens com alt text descritivo
+- [ ] URL amigavel (< 60 chars, keyword)
+- [ ] Canonical definido
+- [ ] Open Graph configurado (title, description, image)
+- [ ] Schema.org implementado (Article/FAQPage)
+- [ ] Mobile-friendly (test Google)
+- [ ] HTTPS activo
+- [ ] Core Web Vitals green (LCP, INP, CLS)
+
+### Conteudo
+
+- [ ] > 1200 palavras (topics competitivos)
+- [ ] Keyword density 1-2%
+- [ ] 2-3 internal links relevantes
+- [ ] 1-2 external links autoritativos (DR > 40)
+- [ ] Autor identificado + bio
+- [ ] Data publicacao visivel
+- [ ] Experiencia real demonstrada
+- [ ] FAQ section (min 3 perguntas)
+
+### Engagement
+
+- [ ] CTA claro e visivel
+- [ ] Formulario/contacto (se aplicavel)
+- [ ] Social share buttons
+- [ ] Imagens optimizadas (< 200KB, WebP)
+- [ ] Video embed (se relevante)
+
+---
+
+## Referencias Detalhadas
+
+Para conteudo tecnico detalhado, consultar:
+
+- [references/structured-data.md](references/structured-data.md) - Meta tags completas, Schema.org (Organization, Article, FAQ, HowTo, Product), Core Web Vitals (LCP, INP, CLS com codigo), URL structure, Keyword Research com benchmarks
+
+---
+
+## Protocolo de Execucao
+
+1. **Analise Inicial** - Verificar requisitos e contexto
+2. **Preparacao** - Validar acesso a recursos
+3. **Execucao** - Operacoes incrementais com validacao
+4. **Validacao** - Verificar resultados obtidos
+5. **Conclusao** - Documentar alteracoes e proximos passos
+
+---
+
+**Standards:** Google 2026 (E-E-A-T, INP, Helpful Content)
+
+---
+
+## Healing Log
+
+Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.
+
+```jsonl
+{"date":"","issue":"","fix":"","source":"user|auto"}
+```
+
+*Adicionar nova linha após cada erro corrigido.*
@@ -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

@@ -1,31 +1,13 @@
 ---
 name: seo-report
-description: Relatorio de auditoria SEO completo com Lighthouse, Google Search Console e exportacao para Google Docs. Analisa Core Web Vitals, desempenho, SEO on-page e gera recomendacoes accionaveis.
-layer: wiki
+description: Relatório SEO completo com dados reais via OpenSEO (Search Console, crawl, Core Web Vitals, backlinks) e exportação para Google Docs. Prioriza por retorno e gera plano de acção. Usar quando "relatório SEO", "seo report", "relatório cliente SEO", "auditoria para cliente".
 ---

 # Skill: /seo-report

-Gera relatorio SEO completo com dados de multiplas fontes e exporta automaticamente para Google Docs.
+Relatório SEO para cliente, com dados reais do **OpenSEO**, exportado para Google Docs.

---
-
-## Contexto NotebookLM
-
-ANTES de executar, consultar notebook para contexto especializado:
-
-| Notebook | ID | Consultar quando |
-|----------|-----|-----------------|
-| Marketing Digital PT | `4c595973` | Sempre |
-
-```
-mcp__notebooklm__notebook_query({
-  notebook_id: "4c595973-ba10-420a-a3bf-e4389e424ad3",
-  query: "<adaptar ao contexto — ex: auditoria SEO, relatorio performance, recomendacoes tecnicas>"
-})
-```
-
-**Procedimento relacionado:** `PROC-DMARC-Email-Entregabilidade.md` -- consultar quando o relatorio envolve email deliverability.
+Diferença face a `/seo-audit`: a auditoria é o **diagnóstico técnico interno**; o report é o **entregável ao cliente** — mesma recolha, apresentação orientada a decisão e a orçamento.

 ---

@@ -33,127 +15,115 @@ mcp__notebooklm__notebook_query({

 `/seo-report <url>` ou `/seo-report <url> <email_destino>`

---
-
-## Exemplos
-
 ```bash
-# Relatorio basico (envia para emanuelalmeidaa@gmail.com)
 /seo-report https://descomplicar.pt
-
-# Relatorio para cliente especifico
 /seo-report https://cliente.pt cliente@email.com
-
-# Relatorio com analise concorrencia
 /seo-report https://site.pt --competitors=concorrente1.pt,concorrente2.pt
 ```

 ---

-## Fontes de Dados
+## Fontes de dados

-| Fonte | Dados Recolhidos | Tempo |
-|-------|------------------|-------|
-| **Lighthouse (Desktop)** | Performance, SEO, Accessibility, Best Practices | ~30s |
-| **Lighthouse (Mobile)** | Core Web Vitals, INP, comparacao mobile/desktop | ~30s |
-| **Lighthouse (Optimizacoes)** | Oportunidades LCP, JS nao usado, images optimization | ~15s |
-| **GSC** | Cliques, impressoes, CTR, posicao media, top queries, tendencia 90 dias | ~10s |
-| **SEO Tools API** | Meta tags, imagens, alt text, links internos/externos, estrutura HTML | ~5s |
-| **Ahrefs (opcional)** | DR, UR, backlinks, referring domains | ~10s |
+| Fonte | Ferramenta | Dados | Custo |
+|---|---|---|---|
+| **Search Console** | `get_search_console_performance` | Cliques, impressões, CTR, posição, por query e por página | grátis |
+| **Indexação** | `inspect_urls` | Estado de indexação (até 10 URLs) | grátis |
+| **Crawl técnico** | `run_site_audit` → `get_audit_issues` | Issues por severidade, Lighthouse em amostra | grátis |
+| **Core Web Vitals** | `chrome-devtools → performance_start_trace` | LCP, INP, CLS por página | grátis |
+| **Keywords** | `get_keyword_metrics` | Volume, KD, intenção (até 700/chamada) | pago |
+| **Autoridade** | `get_backlinks_overview`, `get_domain_overview` | Backlinks, ref. domains, tráfego estimado | pago |
+| **Concorrência** | `find_serp_competitors`, `get_serp_results` | Quem ocupa a SERP | pago |

-**Tempo Total:** ~1m40s (sem concorrencia) | ~3m (com 2 concorrentes)
+**Tempo:** ~5-10 min (crawl de 600 páginas demora ~4 min). Não é instantâneo — avisar o cliente.

 ---

 ## Workflow

-1. Validar URL de entrada
-2. Verificar se site esta no GSC (skip se nao)
-3. Executar auditorias em paralelo:
-   - Lighthouse Desktop + Mobile
-   - Core Web Vitals
-   - SEO Tools API
-   - GSC Analytics (se disponivel)
-   - Ahrefs (se habilitado)
-4. Processar e formatar dados
-5. Gerar relatorio Markdown
-6. Criar Google Doc e partilhar
-7. Retornar link do documento
-
---
-
-## Estrutura do Relatorio
-
-O relatorio final tem 8 seccoes:
-
-1. **Sumario Executivo** -- Top 5 descobertas + accao imediata recomendada
-2. **Pontuacoes Globais** -- Desktop vs Mobile (Performance, SEO, A11y, Best Practices)
-3. **Core Web Vitals** -- LCP, INP, CLS com oportunidades de optimizacao
-4. **GSC Analytics** -- Performance overview, top queries, oportunidades CTR (ultimos 90 dias)
-5. **Analise On-Page** -- Meta tags, imagens SEO, internal linking
-6. **Backlinks e Autoridade** -- DR, UR, top backlinks, estrategia
-7. **Plano de Accao** -- Priorizado (critico/importante/melhoria) com impacto e esforco
-8. **Roadmap Trimestral** -- Fundacao tecnica -> Conteudo e autoridade -> Consolidacao
-
---
-
-## Propriedades GSC Disponiveis
-
 ```
-sc-domain:descomplicar.pt
-https://emanuelalmeida.pt/
-https://carstuff.pt/
-https://solarfvengenharia.com/
-https://aquisevende.pt/
-https://alojadamaria.com/
-https://e-commerce.descomplicar.pt/
+1. whoami + list_projects        → projectId e mercado (GATE: PT = 2620/pt)
+2. GSC por query + por página    → paginar até esgotar
+3. Dimensionar o crawl           → maxPages ≥ nº páginas com impressões + 25%
+4. run_site_audit                → poll get_audit_status até "completed"
+5. get_audit_issues              → critical → warning → info
+6. Cruzar fase 2 com fase 5      → páginas com procura E com defeito = lista de trabalho
+7. [pago, opcional] keywords, backlinks, SERP
+8. Gerar Markdown → Google Doc → partilhar
 ```

+**Os passos 1-6 são grátis e produzem o grosso do relatório.** O passo 7 só se o cliente pagar análise competitiva.
+
 ---

-## Notas Tecnicas
+## Estrutura do relatório (8 secções)
+
+1. **Sumário executivo** — 5 descobertas + a acção imediata. Más notícias primeiro.
+2. **Realidade actual** — cliques, impressões, CTR global, distribuição por posição, branded vs não-branded.
+3. **Onde está o retorno** — striking distance (pos 4-20, ≥25 impressões) e desperdício (pos >40 com procura alta).
+4. **Estado técnico** — issues por severidade, com **cobertura do crawl declarada**.
+5. **Core Web Vitals** — LCP / INP / CLS nas páginas que importam (não em todas).
+6. **Autoridade** — backlinks e ref. domains, se contratado.
+7. **Plano de acção** — prioridade (crítico/importante/melhoria) × esforço × impacto estimado.
+8. **Roadmap trimestral** — fundação técnica → conteúdo → consolidação.
+
+---
+
+## Regras de honestidade do relatório
+
+Um relatório SEO é um documento comercial. Isso torna a precisão **mais** importante, não menos.
+
+- **Declarar sempre a cobertura do crawl.** "1337 issues em 600 páginas crawladas de ~640 com impressões." Sem isto, o número de issues não significa nada.
+- **Não apresentar contagens como URLs verificados.** Se a bridge só deu contagens, dizê-lo e anexar o link da UI.
+- **Custos são estimativas.** O OpenSEO não expõe saldo — nunca escrever "gastámos X créditos" como facto.
+- **Separar medido de inferido.** Marcar as inferências. Um cliente que descobre uma inferência apresentada como facto deixa de confiar no resto.
+- **CTR baixo em posição alta não é problema de ranking.** É título/meta. Dizer isso — é a recomendação mais barata e de maior retorno que existe.
+
+---
+
+## Notas técnicas

 ### Requisitos
- SEO Tools API a correr: `~/mcp-servers/seo-tools-api/start.sh`
- Google Workspace MCP configurado
- GSC authentication (OAuth primeira vez)
+- OpenSEO acessível (`whoami` responde)
+- Propriedade ligada ao Search Console (senão, relatório sem fase GSC — declarar)
+- `google-workspace` MCP para o Google Doc

-### Erros Comuns
- **Site nao em GSC:** Relatorio gerado sem dados GSC (aviso incluido)
- **Lighthouse timeout:** Retry automatico (3x)
- **Ahrefs rate limit:** Skip backlinks, aviso no relatorio
+### Erros comuns
+| Erro | Sintoma | Solução |
+|---|---|---|
+| **`maxPages` por omissão** | Relatório limpo demais, poucos issues | Redimensionar pelo nº de páginas do GSC e relançar |
+| Site fora do GSC | Fase 2 vazia | Gerar sem GSC, com aviso destacado |
+| Mercado errado | Dados de keywords em inglês/EUA | `locationCode: 2620`, `languageCode: "pt"` |
+| Crawl a demorar | `get_audit_status` em `crawling` | Normal — 600 páginas ≈ 4 min. Fazer poll, não cancelar |

 ---

-## References (conteudo detalhado)
+## References

-| Ficheiro | Conteudo |
-|----------|----------|
-| `references/template-relatorio.md` | Template completo do relatorio com todas as tabelas e seccoes |
-| `references/implementacao-tecnica.md` | Workflow mermaid, codigo JS, funcoes GSC, notas tecnicas |
+| Ficheiro | Conteúdo |
+|---|---|
+| `references/template-relatorio.md` | Template completo com tabelas e secções |
+| `references/implementacao-tecnica.md` | Workflow, chamadas OpenSEO, processamento |
+
+Inventário completo das ferramentas e tabela de migração: `../seo-audit/references/ferramentas-api.md`

 ---

-## Anti-Patterns
+## Anti-patterns

- Gerar relatorio sem dados reais (sempre usar MCPs)
- Ignorar gap mobile/desktop
- Nao priorizar recomendacoes (tudo parece igual)
- Esquecer de verificar se site esta no GSC antes de tentar recolher dados
- Relatorio sem accoes concretas e estimativas de impacto
+- Gerar relatório sem dados reais.
+- Omitir a cobertura do crawl (faz o relatório parecer melhor do que é).
+- Listar issues por contagem em vez de por impacto.
+- Apresentar estimativas de custo ou de tráfego como medições.
+- Recomendações sem esforço e impacto estimados.
+- Correr as fases pagas antes das grátis.

 ---

-**Versao:** 2.1.0 | **Autor:** Descomplicar
-
---
+**Versão:** 3.0.0 | **Autor:** Descomplicar® | **Motor:** OpenSEO

 ## Healing Log

-Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.
-
 ```jsonl
-{"date":"","issue":"","fix":"","source":"user|auto"}
+{"date":"2026-07-30","issue":"Skill dependia de SEO Tools API (localhost:3000), Lighthouse MCP, GSC MCP e Ahrefs — nenhum operacional. Workflow inteiro não executável.","fix":"Reescrita sobre OpenSEO; fases grátis antes das pagas; cobertura de crawl obrigatória no relatório.","source":"auto"}
 ```
-
-*Adicionar nova linha após cada erro corrigido.*
@@ -1,144 +1,169 @@
-# Implementacao Tecnica - SEO Report
+# Implementação Técnica — SEO Report (OpenSEO)

-## Workflow Tecnico
+## Workflow

 ```mermaid
-graph LR
-    A[Input: URL] --> B{Site em GSC?}
-    B -->|Sim| C[Recolher dados GSC]
-    B -->|Nao| D[Skip GSC, aviso]
+graph TD
+    A[Input: URL] --> B[whoami + list_projects]
+    B --> C{Mercado correcto?}
+    C -->|Não| C2[Passar locationCode 2620 + languageCode pt]
+    C -->|Sim| D[GSC: dimensions query]
+    C2 --> D

-    C --> E[Lighthouse Desktop]
-    D --> E
+    D --> E[GSC: dimensions page]
+    E --> F[Dimensionar crawl:<br/>maxPages = páginas GSC + 25%]

-    E --> F[Lighthouse Mobile]
-    F --> G[Core Web Vitals]
-    G --> H[SEO Tools API]
-    H --> I{Ahrefs habilitado?}
+    F --> G[run_site_audit]
+    G --> H[poll get_audit_status]
+    H -->|running| H
+    H -->|completed| I[get_audit_issues por severidade]

-    I -->|Sim| J[Recolher DR/UR]
-    I -->|Nao| K[Skip Ahrefs]
+    I --> J[Cruzar: páginas com procura<br/>E com defeito]
+    J --> K{Fases pagas contratadas?}

-    J --> L[Processar dados]
-    K --> L
+    K -->|Sim| L[get_keyword_metrics<br/>get_backlinks_overview<br/>get_serp_results]
+    K -->|Não| M[Saltar fases pagas]

-    L --> M[Gerar relatorio Markdown]
-    M --> N[Criar Google Doc]
-    N --> O[Partilhar com email]
-
-    O --> P[Retornar link]
+    L --> N[Processar]
+    M --> N
+    N --> O[Markdown] --> P[Google Doc] --> Q[Partilhar]
 ```

-## Implementacao
+**O ponto crítico é o nó F.** Dimensionar o crawl a partir do GSC é o que distingue um relatório verdadeiro de um relatório limpo e falso.
+
+---
+
+## Sequência de chamadas

 ```javascript
-async function generateSEOReport(url, options = {}) {
-  const {
-    email = 'emanuelalmeidaa@gmail.com',
-    competitors = [],
-    includeAhrefs = true
-  } = options;
+// 1. Contexto e mercado
+const me   = await openseo.whoami();
+const projs = await openseo.list_projects();
+const projectId = projs[0].id;
+const MARKET = { locationCode: 2620, languageCode: 'pt' };  // Portugal

-  // 1. Validar URL
-  if (!isValidURL(url)) {
-    throw new Error('URL invalido');
+// 2. Search Console — paginar até esgotar (grátis)
+async function gscAll(dimensions) {
+  const rows = [];
+  let startRow = 0;
+  while (true) {
+    const r = await openseo.get_search_console_performance({
+      projectId, dimensions, dateRange: 'last_3_months',
+      rowLimit: 1000, startRow
+    });
+    const parsed = parseRows(r.text);
+    rows.push(...parsed);
+    if (!r.text.split('\n')[0].includes('more available') || !parsed.length) break;
+    startRow += 1000;
  }
+  return rows;
+}

-  // 2. Recolher dados em paralelo (melhor performance)
-  const [
-    lighthouseDesktop,
-    lighthouseMobile,
-    coreWebVitals,
-    seoToolsData,
-    gscData,
-    ahrefsData
-  ] = await Promise.allSettled([
-    mcp__lighthouse__run_audit(url, 'desktop'),
-    mcp__lighthouse__run_audit(url, 'mobile'),
-    mcp__lighthouse__get_core_web_vitals(url),
-    fetch(`http://localhost:3000/seo-audit?url=${url}`).then(r => r.json()),
-    getGSCData(url),
-    includeAhrefs ? getAhrefsData(url) : null
-  ]);
+const byQuery = await gscAll(['query']);
+const byPage  = await gscAll(['page']);

-  // 3. Processar e formatar
-  const reportData = {
-    url,
-    date: new Date().toISOString().split('T')[0],
-    scores: extractScores(lighthouseDesktop, lighthouseMobile),
-    cwv: processCoreWebVitals(coreWebVitals),
-    gsc: processGSCData(gscData),
-    onPage: processOnPageData(seoToolsData),
-    backlinks: processBacklinks(ahrefsData),
-    recommendations: generateRecommendations(/* all data */)
-  };
+// 3. Dimensionar o crawl a partir da realidade, não de um default
+const maxPages = Math.ceil(byPage.length * 1.25);

-  // 4. Gerar documento Markdown
-  const markdown = generateReportMarkdown(reportData);
+// 4. Crawl (grátis) — assíncrono, exige poll
+const audit = await openseo.run_site_audit({
+  projectId, url, maxPages, runLighthouse: true
+});
+let status;
+do {
+  await sleep(30_000);
+  status = await openseo.get_audit_status({ projectId, auditId: audit.id });
+} while (!status.text.includes('completed'));

-  // 5. Criar Google Doc
-  const docResult = await mcp__google-workspace__create_doc({
-    title: `Relatorio SEO - ${extractDomain(url)} - ${reportData.date}`,
-    body_content: markdown,
-    user_google_email: email
+// 5. Issues por severidade (grátis)
+const critical = await openseo.get_audit_issues({ projectId, auditId: audit.id, severity: 'critical' });
+const warning  = await openseo.get_audit_issues({ projectId, auditId: audit.id, severity: 'warning'  });
+
+// 6. Fases pagas — so se contratadas
+if (options.paid) {
+  const kw = await openseo.get_keyword_metrics({
+    projectId, keywords: strikingDistance(byQuery).map(r => r.key), ...MARKET
  });
-
-  // 6. Retornar link
-  return {
-    success: true,
-    doc_url: docResult.url,
-    summary: reportData.recommendations.slice(0, 5)
-  };
+  const bl = await openseo.get_backlinks_overview({ projectId, target: domain });
 }
 ```

-## Propriedades GSC Disponiveis
+---
+
+## Processamento — as funções que importam

 ```javascript
-const GSC_PROPERTIES = [
-  'sc-domain:descomplicar.pt',
-  'https://emanuelalmeida.pt/',
-  'https://carstuff.pt/',
-  'https://solarfvengenharia.com/',
-  'https://aquisevende.pt/',
-  'https://alojadamaria.com/',
-  'https://e-commerce.descomplicar.pt/'
-];
+// GSC anonimiza queries: totais por query < totais por página.
+// Para números globais usar SEMPRE a vista por página.
+const globals = {
+  clicks:      sum(byPage, 'clicks'),
+  impressions: sum(byPage, 'impressions'),
+  ctr:         sum(byPage, 'clicks') / sum(byPage, 'impressions')
+};

-async function getGSCData(url) {
-  const domain = extractDomain(url);
-  const property = GSC_PROPERTIES.find(p => p.includes(domain));
+// O GSC não filtra por posição — filtrar do lado do cliente.
+const strikingDistance = rows => rows
+  .filter(r => r.position >= 4 && r.position <= 20 && r.impressions >= 25)
+  .sort((a, b) => b.impressions - a.impressions);

-  if (!property) {
-    console.warn(`Site ${domain} nao esta no GSC. Dados GSC nao disponiveis.`);
-    return null;
-  }
+// Páginas com procura real enterradas fora das primeiras 4 páginas.
+const waste = rows => rows
+  .filter(r => r.position > 40 && r.impressions >= 300)
+  .sort((a, b) => b.impressions - a.impressions);

-  const analytics = await mcp__gsc__get_search_analytics({
-    site_url: property,
-    start_date: daysAgo(90),
-    end_date: 'today',
-    dimensions: ['query'],
-    row_limit: 100
-  });
+// O sinal mais accionável: primeira página, CTR nulo.
+// Não é ranking — é título e meta description.
+const titleProblem = rows => rows
+  .filter(r => r.position <= 10 && r.impressions >= 200 && r.ctr < 0.005);

-  return analytics;
-}
+// Lixo nas queries do GSC (colagens do Google Ads, operadores site:).
+const isNoise = k =>
+  (k.includes('ativado') && k.includes('correspond')) ||
+  k.startsWith('-site:') || k.startsWith('=') ||
+  k.length > 90 || k.includes('0,00');
 ```

-## Notas Tecnicas
+---
+
+## Entrega
+
+```javascript
+const doc = await googleWorkspace.docs_create_document({
+  title: `Relatório SEO — ${domain} — ${today}`,
+  user_google_email: email
+});
+await googleWorkspace.docs_append_text({ document_id: doc.id, text: markdown });
+```
+
+---
+
+## Notas técnicas

 ### Requisitos
- SEO Tools API a correr: `~/mcp-servers/seo-tools-api/start.sh`
- Google Workspace MCP configurado
- GSC authentication (OAuth primeira vez)
+- OpenSEO acessível (`whoami` responde)
+- Propriedade ligada ao Search Console
+- `google-workspace` MCP para o documento

-### Performance
- Execucao paralela de tools (1m40s total)
- Cache Lighthouse results (5 min TTL)
- Rate limiting Ahrefs API (100 req/day free)
+### Tempos reais (medidos, descomplicar.pt, 07-2026)
+| Fase | Duração |
+|---|---|
+| GSC (2 dimensões, ~1700+474 linhas) | ~10s |
+| Crawl 600 páginas + Lighthouse 20 | ~4 min |
+| `get_audit_issues` | instantâneo |

-### Erros Comuns
- **Site nao em GSC:** Relatorio gerado sem dados GSC
- **Lighthouse timeout:** Retry automatico (3x)
- **Ahrefs rate limit:** Skip backlinks, aviso no relatorio
+### Limitações
+- **Issues sem URL:** `get_audit_issues` / `get_audit_pages` devolvem só contagens pela bridge MCP; `structuredContent.issues` não é entregue e `get_audit_pages` trunca em ~25 linhas. Usar `details.mcpMeta.url` para o link da UI.
+- **Sem medidor de créditos:** `whoami` não muda depois de chamadas pagas. Custos são estimativas.
+- **Lag do GSC:** últimos ~3 dias incompletos; datas em Pacific Time; máx. 16 meses.
+
+### Erros comuns
+| Erro | Sintoma | Solução |
+|---|---|---|
+| `maxPages` por omissão (50) | Poucos issues, relatório "limpo" | Redimensionar pelo GSC, relançar |
+| Site fora do GSC | Fase GSC vazia | Gerar sem GSC, aviso destacado |
+| Mercado errado | Keywords em inglês/EUA | `locationCode: 2620`, `languageCode: "pt"` |
+| Cancelar o crawl cedo demais | Sem `auditId` utilizável | Fazer poll; 600 páginas ≈ 4 min |
+
+---
+
+**Actualizado:** 30-07-2026 | Substitui a implementação baseada em Lighthouse MCP + SEO Tools API + Ahrefs
@@ -203,13 +203,17 @@ Data: YYYY-MM-DD | Versao 2.0 (2026 Standards)
 ## Anexos

 ### A. Metodologia
- Lighthouse: 3 runs, mediana reportada
- GSC: Ultimos 90 dias completos
+- Motor: OpenSEO (crawl same-origin, robots-aware) + Search Console
+- Crawl: [N] páginas de [M] com impressões no GSC — **declarar sempre a cobertura**
+- Search Console: últimos 3 meses; vista por página para totais (o GSC anonimiza queries)
+- Core Web Vitals: Lighthouse em amostra; páginas individuais via chrome-devtools
 - Thresholds: Google 2026 Standards
+- Custos de chamadas pagas: estimativas do schema, não medições

-### B. Glossario
- **DR**: Domain Rating (Ahrefs)
- **INP**: Interaction to Next Paint (substitui FID em 2026)
+### B. Glossário
+- **Striking distance**: posição 4-20 com impressões relevantes — onde está o retorno
+- **KD**: Keyword Difficulty
+- **INP**: Interaction to Next Paint (substituiu o FID em 2026)
 - **E-E-A-T**: Experience, Expertise, Authoritativeness, Trust
 - **CTR**: Click-Through Rate

@@ -1,7 +1,6 @@
 ---
 name: social-media
 description: Estrategia e gestao de conteudo para redes sociais. Planeia publicacoes, calendario de conteudo e tacticas de engagement.
-layer: wiki
 ---

 # /social-media
@@ -162,4 +161,44 @@ Exemplo agencia marketing:

 **Quando consultar:** antes de criar posts Instagram, carrosséis, stories ou posts LinkedIn/Facebook que precisem de imagem ou vídeo curto. Reutiliza matéria-prima já curada em vez de gerar do zero.

-**Workflow tentativa-p
+**Workflow tentativa-primeiro:**
+
+1. Pesquisar via MCP `media-bank`:
+   ```
+   mcp__media-bank__search_media(
+     query="<tema do post em EN>",
+     type="image",                # ou "video" para reels/stories
+     tema="<um dos 9 temas>",
+     orientation="square",        # Instagram feed; "portrait" para stories/reels
+     min_quality=7,
+     exclude_used_in_last_days=30,
+     limit=5
+   )
+   ```
+2. Avaliar candidatos por `description_en` + `quality_score`.
+3. Se ≥1 adequado → usar `path_local` como base para composição (Canva/design-engine) com overlay de texto, branding e CTA.
+4. Se nenhum → fallback para geração IA.
+5. Marcar uso: `mcp__media-bank__mark_used(asset_id, {type:"social-post", ref:"<plataforma>-<data>", date:"<YYYY-MM-DD>"})`.
+
+**Fallback REST** (se MCP indisponível):
+```bash
+SK=$(grep SERVICE_KEY /media/ealmeida/Dados/Hub/05-Projectos/Banco-Imagens-Videos/scripts/.env | cut -d= -f2)
+curl -s "https://mem.descomplicar.pt/rest/v1/media_bank_assets?type=eq.image&orientation=eq.square&quality_score=gte.7&deleted_at=is.null&order=quality_score.desc&limit=5" \
+  -H "apikey: $SK" -H "Authorization: Bearer $SK"
+```
+
+**Regra inviolável:** matéria-prima local. Usar como input para composição — NUNCA publicar o ficheiro raw como post sem edição (branding, texto, aspect ratio).
+
+Ver `Hub/06-Operacoes/Procedimentos/D7-Tecnologia/MCP/PROC-Media-Bank.md` (D7-MB-001) para detalhes.
+
+---
+
+## Healing Log
+
+Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.
+
+```jsonl
+{"date":"","issue":"","fix":"","source":"user|auto"}
+```
+
+*Adicionar nova linha após cada erro corrigido.*
@@ -5,7 +5,6 @@ description: "Obtem sinais de mercado em tempo real via X/Grok com scoring matri
 version: "1.0.0"
 created: 2026-04-07
 tools: [mcp__claude-in-chrome__tabs_create_mcp, mcp__claude-in-chrome__read_page, mcp__claude-in-chrome__form_input, mcp__claude-in-chrome__computer]
-layer: wiki
 ---

 # Skill: /trend-signal
@@ -1,7 +1,6 @@
 ---
 name: video
 description: Criacao de videos profissionais com Remotion (React). Planeia conteudo, scripts e workflows de producao.
-layer: wiki
 ---

 # /video - Criacao de Videos com Remotion
@@ -206,4 +205,143 @@ npx remotion render Video out.mp4 \
 | 1:1 Quadrado | 1080x1080 | Instagram Feed |
 | 4:5 Portrait | 1080x1350 | Instagram Feed optimal |

-
+---
+
+## Casos de Uso
+
+| Tipo | Duracao | Resolucao |
+|------|---------|-----------|
+| Logo Intro | 3-5s | 1920x1080 |
+| Promo Rapida | 15-30s | 1080x1920 |
+| Explainer | 60-120s | 1920x1080 |
+| Social Post | 5-15s | 1080x1080 |
+| YouTube Intro | 5-10s | 1920x1080 |
+| Stories | 15s | 1080x1920 |
+
+---
+
+## Boas Praticas
+
+### Performance
+
+- Usar `React.memo()` para componentes pesados
+- Evitar re-renders desnecessarios
+- Pre-carregar assets com `staticFile()`
+
+### Animacoes
+
+- Comecar com `interpolate()` para animacoes simples
+- Usar `spring()` para movimentos naturais
+- Combinar `Sequence` para organizar timeline
+
+### Assets
+
+- Colocar imagens/audio em `public/`
+- Usar `staticFile("nome.png")` para referenciar
+- Formatos recomendados: PNG (imagens), MP3/WAV (audio)
+
+---
+
+## Troubleshooting
+
+| Problema | Solucao |
+|----------|---------|
+| Video preto | Verificar `AbsoluteFill` tem background |
+| Fontes nao carregam | Usar `@remotion/google-fonts` |
+| Animacao nao funciona | Verificar range de frames no `interpolate` |
+| Erro de modulo | `rm -rf node_modules && npm install` |
+| Render lento | Reduzir `--concurrency` ou usar `--crf` maior |
+
+---
+
+## Workflow Completo
+
+```
+1. DEFINIR -> Duracao, resolucao, estilo
+2. DESCREVER -> Prompt detalhado ao Claude
+3. GERAR -> Claude cria componentes React
+4. PREVIEW -> npm run dev (Remotion Studio)
+5. AJUSTAR -> Refinar animacoes/timing
+6. RENDER -> npx remotion render
+7. EXPORTAR -> MP4/GIF/WebM conforme necessidade
+```
+
+---
+
+## Referencias Detalhadas
+
+Para conteudo detalhado, consultar:
+
+- [references/components.md](references/components.md) - Animacoes prontas, templates, paletas de cores, tipografia, motion design, acessibilidade
+- [rules/animations.md](rules/animations.md) - Animacoes fundamentais
+- [rules/timing.md](rules/timing.md) - Interpolacao e easing
+- [rules/transitions.md](rules/transitions.md) - Transicoes entre cenas
+- [rules/sequencing.md](rules/sequencing.md) - Organizacao temporal
+- [rules/fonts.md](rules/fonts.md) - Carregamento de fontes
+- [rules/images.md](rules/images.md) - Trabalhar com imagens
+- [rules/audio.md](rules/audio.md) - Audio e som
+- [rules/tailwind.md](rules/tailwind.md) - TailwindCSS no Remotion
+
+---
+
+## Anti-Patterns
+
+- Nao usar para tarefas fora do dominio de video/Remotion
+- Nao usar quando outra skill mais especifica esta disponivel
+- Nao executar sem confirmar requisitos com o utilizador
+
+---
+
+**Projecto Base**: `/media/ealmeida/Dados/Dev/remotion-demo/`
+**Documentacao**: [remotion.dev/docs](https://remotion.dev/docs)
+
+---
+
+## Media Bank (D7-MB-001)
+
+**Quando consultar:** antes de produzir vídeos Remotion — para B-roll, clips de abertura, backgrounds e transições. Reutilizar matéria-prima evita regeneração IA cara e mantém consistência visual.
+
+**Workflow tentativa-primeiro:**
+
+1. Pesquisar via MCP `media-bank`:
+   ```
+   mcp__media-bank__search_media(
+     query="<descrição EN da cena/tema>",
+     type="video",
+     tema="<um dos 9 temas>",
+     orientation="landscape",
+     min_quality=7,
+     min_width=1920,
+     min_duration=3,
+     max_duration=15,
+     exclude_used_in_last_days=30,
+     limit=5
+   )
+   ```
+2. Avaliar candidatos por `description_en`, duração e `quality_score`.
+3. Se ≥1 adequado → usar `path_local` como input directo no Remotion (`<Video src={staticFile(...)} />` ou importar para assets).
+4. Se nenhum → fallback para geração IA (Replicate/Runway) ou imagens estáticas animadas.
+5. Marcar uso: `mcp__media-bank__mark_used(asset_id, {type:"remotion-video", ref:"<projecto>", date:"<YYYY-MM-DD>"})`.
+
+**Fallback REST** (se MCP indisponível):
+```bash
+SK=$(grep SERVICE_KEY /media/ealmeida/Dados/Hub/05-Projectos/Banco-Imagens-Videos/scripts/.env | cut -d= -f2)
+curl -s "https://mem.descomplicar.pt/rest/v1/media_bank_assets?type=eq.video&orientation=eq.landscape&quality_score=gte.7&deleted_at=is.null&order=quality_score.desc&limit=5" \
+  -H "apikey: $SK" -H "Authorization: Bearer $SK"
+```
+
+**Regra inviolável:** matéria-prima local. Usar como input para composição Remotion — NUNCA servir o ficheiro raw publicamente sem edição/montagem.
+
+Ver `Hub/06-Operacoes/Procedimentos/D7-Tecnologia/MCP/PROC-Media-Bank.md` (D7-MB-001) para detalhes.
+
+---
+
+## Healing Log
+
+Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.
+
+```jsonl
+{"date":"","issue":"","fix":"","source":"user|auto"}
+```
+
+*Adicionar nova linha após cada erro corrigido.*
@@ -3,7 +3,6 @@ name: 3d
 description: 3D content in Remotion using Three.js and React Three Fiber.
 metadata:
  tags: 3d, three, threejs
-layer: wiki
 ---

 # Using Three.js and React Three Fiber in Remotion
@@ -3,7 +3,6 @@ name: animations
 description: Fundamental animation skills for Remotion
 metadata:
  tags: animations, transitions, frames, useCurrentFrame
-layer: wiki
 ---

 All animations MUST be driven by the `useCurrentFrame()` hook.  
@@ -3,7 +3,6 @@ name: assets
 description: Importing images, videos, audio, and fonts into Remotion
 metadata:
  tags: assets, staticFile, images, fonts, public
-layer: wiki
 ---

 # Importing assets in Remotion
@@ -3,7 +3,6 @@ name: audio
 description: Using audio and sound in Remotion - importing, trimming, volume, speed, pitch
 metadata:
  tags: audio, media, trim, volume, speed, loop, pitch, mute, sound, sfx
-layer: wiki
 ---

 # Using audio in Remotion
@@ -3,7 +3,6 @@ name: calculate-metadata
 description: Dynamically set composition duration, dimensions, and props
 metadata:
  tags: calculateMetadata, duration, dimensions, props, dynamic
-layer: wiki
 ---

 # Using calculateMetadata
@@ -3,7 +3,6 @@ name: can-decode
 description: Check if a video can be decoded by the browser using Mediabunny
 metadata:
  tags: decode, validation, video, audio, compatibility, browser
-layer: wiki
 ---

 # Checking if a video can be decoded
@@ -3,7 +3,6 @@ name: charts
 description: Chart and data visualization patterns for Remotion. Use when creating bar charts, pie charts, histograms, progress bars, or any data-driven animations.
 metadata:
  tags: charts, data, visualization, bar-chart, pie-chart, graphs
-layer: wiki
 ---

 # Charts in Remotion
@@ -3,7 +3,6 @@ name: compositions
 description: Defining compositions, stills, folders, default props and dynamic metadata
 metadata:
  tags: composition, still, folder, props, metadata
-layer: wiki
 ---

 A `<Composition>` defines the component, width, height, fps and duration of a renderable video.
@@ -3,7 +3,6 @@ name: display-captions
 description: Displaying captions in Remotion with TikTok-style pages and word highlighting
 metadata:
  tags: captions, subtitles, display, tiktok, highlight
-layer: wiki
 ---

 # Displaying captions in Remotion
@@ -3,7 +3,6 @@ name: extract-frames
 description: Extract frames from videos at specific timestamps using Mediabunny
 metadata:
  tags: frames, extract, video, thumbnail, filmstrip, canvas
-layer: wiki
 ---

 # Extracting frames from videos
@@ -210,4 +209,21 @@ try {
    extractFrames({
      src: "https://remotion.media/video.mp4",
      timestampsInSeconds: [0, 1, 2, 3, 4],
-    
+      onVideoSample: (sample) => {
+        using frame = sample;
+        const canvas = document.createElement("canvas");
+        canvas.width = frame.displayWidth;
+        canvas.height = frame.displayHeight;
+        const ctx = canvas.getContext("2d");
+        frame.draw(ctx!, 0, 0);
+      },
+      signal: controller.signal,
+    }),
+    timeoutPromise,
+  ]);
+
+  console.log("Frame extraction complete!");
+} catch (error) {
+  console.error("Frame extraction was aborted or failed:", error);
+}
+```
@@ -3,7 +3,6 @@ name: fonts
 description: Loading Google Fonts and local fonts in Remotion
 metadata:
  tags: fonts, google-fonts, typography, text
-layer: wiki
 ---

 # Using fonts in Remotion
@@ -3,7 +3,6 @@ name: get-audio-duration
 description: Getting the duration of an audio file in seconds with Mediabunny
 metadata:
  tags: duration, audio, length, time, seconds, mp3, wav
-layer: wiki
 ---

 # Getting audio duration with Mediabunny
@@ -3,7 +3,6 @@ name: get-video-dimensions
 description: Getting the width and height of a video file with Mediabunny
 metadata:
  tags: dimensions, width, height, resolution, size, video
-layer: wiki
 ---

 # Getting video dimensions with Mediabunny
@@ -3,7 +3,6 @@ name: get-video-duration
 description: Getting the duration of a video file in seconds with Mediabunny
 metadata:
  tags: duration, video, length, time, seconds
-layer: wiki
 ---

 # Getting video duration with Mediabunny
@@ -3,7 +3,6 @@ name: gif
 description: Displaying GIFs, APNG, AVIF and WebP in Remotion
 metadata:
  tags: gif, animation, images, animated, apng, avif, webp
-layer: wiki
 ---

 # Using Animated images in Remotion
@@ -3,7 +3,6 @@ name: images
 description: Embedding images in Remotion using the <Img> component
 metadata:
  tags: images, img, staticFile, png, jpg, svg, webp
-layer: wiki
 ---

 # Using images in Remotion
@@ -3,7 +3,6 @@ name: import-srt-captions
 description: Importing .srt subtitle files into Remotion using @remotion/captions
 metadata:
  tags: captions, subtitles, srt, import, parse
-layer: wiki
 ---

 # Importing .srt subtitles into Remotion
@@ -3,7 +3,6 @@ name: lottie
 description: Embedding Lottie animations in Remotion.
 metadata:
  category: Animation
-layer: wiki
 ---

 # Using Lottie Animations in Remotion
@@ -3,7 +3,6 @@ name: maps
 description: Make map animations with Mapbox
 metadata:
  tags: map, map animation, mapbox
-layer: wiki
 ---

 Maps can be added to a Remotion video with Mapbox.  
@@ -172,4 +171,233 @@ Unless I request it, do not add additional points to the lines.
 By default, use the `mapbox://styles/mapbox/standard` style.  
 Hide the labels from the base map style.

-Unless I request otherwise, remove all features from the Mapbo
+Unless I request otherwise, remove all features from the Mapbox Standard style.
+
+```tsx
+// Hide all features from the Mapbox Standard style
+const hideFeatures = [
+  'showRoadsAndTransit',
+  'showRoads',
+  'showTransit',
+  'showPedestrianRoads',
+  'showRoadLabels',
+  'showTransitLabels',
+  'showPlaceLabels',
+  'showPointOfInterestLabels',
+  'showPointsOfInterest',
+  'showAdminBoundaries',
+  'showLandmarkIcons',
+  'showLandmarkIconLabels',
+  'show3dObjects',
+  'show3dBuildings',
+  'show3dTrees',
+  'show3dLandmarks',
+  'show3dFacades',
+];
+for (const feature of hideFeatures) {
+  _map.setConfigProperty('basemap', feature, false);
+}
+
+_map.setConfigProperty('basemap', 'colorMotorways', 'transparent');
+_map.setConfigProperty('basemap', 'colorRoads', 'transparent');
+_map.setConfigProperty('basemap', 'colorTrunks', 'transparent');
+```
+
+## Animating the camera
+
+You can animate the camera along the line by adding a `useEffect` hook that updates the camera position based on the current frame.
+
+Unless I ask for it, do not jump between camera angles.
+
+```tsx
+import * as turf from '@turf/turf';
+import {interpolate} from 'remotion';
+import {Easing} from 'remotion';
+import {useCurrentFrame, useVideoConfig, useDelayRender} from 'remotion';
+
+const animationDuration = 20;
+const cameraAltitude = 4000;
+```
+
+```tsx
+const frame = useCurrentFrame();
+const {fps} = useVideoConfig();
+const {delayRender, continueRender} = useDelayRender();
+
+useEffect(() => {
+  if (!map) {
+    return;
+  }
+  const handle = delayRender('Moving point...');
+
+  const routeDistance = turf.length(turf.lineString(lineCoordinates));
+
+  const progress = interpolate(frame / fps, [0.00001, animationDuration], [0, 1], {
+    easing: Easing.inOut(Easing.sin),
+    extrapolateLeft: 'clamp',
+    extrapolateRight: 'clamp',
+  });
+
+  const camera = map.getFreeCameraOptions();
+
+  const alongRoute = turf.along(turf.lineString(lineCoordinates), routeDistance * progress).geometry.coordinates;
+
+  camera.lookAtPoint({
+    lng: alongRoute[0],
+    lat: alongRoute[1],
+  });
+
+  map.setFreeCameraOptions(camera);
+  map.once('idle', () => continueRender(handle));
+}, [lineCoordinates, fps, frame, handle, map]);
+```
+
+Notes:
+
+IMPORTANT: Keep the camera by default so north is up.
+IMPORTANT: For multi-step animations, set all properties at all stages (zoom, position, line progress) to prevent jumps. Override initial values.
+
+- The progress is clamped to a minimum value to avoid the line being empty, which can lead to turf errors
+- See [Timing](./timing.md) for more options for timing.
+- Consider the dimensions of the composition and make the lines thick enough and the label font size large enough to be legible for when the composition is scaled down.
+
+## Animating lines
+
+### Straight lines (linear interpolation)
+
+To animate a line that appears straight on the map, use linear interpolation between coordinates. Do NOT use turf's `lineSliceAlong` or `along` functions, as they use geodesic (great circle) calculations which appear curved on a Mercator projection.
+
+```tsx
+const frame = useCurrentFrame();
+const {durationInFrames} = useVideoConfig();
+
+useEffect(() => {
+  if (!map) return;
+
+  const animationHandle = delayRender('Animating line...');
+
+  const progress = interpolate(frame, [0, durationInFrames - 1], [0, 1], {
+    extrapolateLeft: 'clamp',
+    extrapolateRight: 'clamp',
+    easing: Easing.inOut(Easing.cubic),
+  });
+
+  // Linear interpolation for a straight line on the map
+  const start = lineCoordinates[0];
+  const end = lineCoordinates[1];
+  const currentLng = start[0] + (end[0] - start[0]) * progress;
+  const currentLat = start[1] + (end[1] - start[1]) * progress;
+
+  const lineData: GeoJSON.Feature<GeoJSON.LineString> = {
+    type: 'Feature',
+    properties: {},
+    geometry: {
+      type: 'LineString',
+      coordinates: [start, [currentLng, currentLat]],
+    },
+  };
+
+  const source = map.getSource('trace') as mapboxgl.GeoJSONSource;
+  if (source) {
+    source.setData(lineData);
+  }
+
+  map.once('idle', () => continueRender(animationHandle));
+}, [frame, map, durationInFrames]);
+```
+
+### Curved lines (geodesic/great circle)
+
+To animate a line that follows the geodesic (great circle) path between two points, use turf's `lineSliceAlong`. This is useful for showing flight paths or the actual shortest distance on Earth.
+
+```tsx
+import * as turf from '@turf/turf';
+
+const routeLine = turf.lineString(lineCoordinates);
+const routeDistance = turf.length(routeLine);
+
+const currentDistance = Math.max(0.001, routeDistance * progress);
+const slicedLine = turf.lineSliceAlong(routeLine, 0, currentDistance);
+
+const source = map.getSource('route') as mapboxgl.GeoJSONSource;
+if (source) {
+  source.setData(slicedLine);
+}
+```
+
+## Markers
+
+Add labels, and markers where appropriate.
+
+```tsx
+_map.addSource('markers', {
+  type: 'geojson',
+  data: {
+    type: 'FeatureCollection',
+    features: [
+      {
+        type: 'Feature',
+        properties: {name: 'Point 1'},
+        geometry: {type: 'Point', coordinates: [-118.2437, 34.0522]},
+      },
+    ],
+  },
+});
+
+_map.addLayer({
+  id: 'city-markers',
+  type: 'circle',
+  source: 'markers',
+  paint: {
+    'circle-radius': 40,
+    'circle-color': '#FF4444',
+    'circle-stroke-width': 4,
+    'circle-stroke-color': '#FFFFFF',
+  },
+});
+
+_map.addLayer({
+  id: 'labels',
+  type: 'symbol',
+  source: 'markers',
+  layout: {
+    'text-field': ['get', 'name'],
+    'text-font': ['DIN Pro Bold', 'Arial Unicode MS Bold'],
+    'text-size': 50,
+    'text-offset': [0, 0.5],
+    'text-anchor': 'top',
+  },
+  paint: {
+    'text-color': '#FFFFFF',
+    'text-halo-color': '#000000',
+    'text-halo-width': 2,
+  },
+});
+```
+
+Make sure they are big enough. Check the composition dimensions and scale the labels accordingly.
+For a composition size of 1920x1080, the label font size should be at least 40px.
+
+IMPORTANT: Keep the `text-offset` small enough so it is close to the marker. Consider the marker circle radius. For a circle radius of 40, this is a good offset:
+
+```tsx
+"text-offset": [0, 0.5],
+```
+
+## 3D buildings
+
+To enable 3D buildings, use the following code:
+
+```tsx
+_map.setConfigProperty('basemap', 'show3dObjects', true);
+_map.setConfigProperty('basemap', 'show3dLandmarks', true);
+_map.setConfigProperty('basemap', 'show3dBuildings', true);
+```
+
+## Rendering
+
+When rendering a map animation, make sure to render with the following flags:
+
+```
+npx remotion render --gl=angle --concurrency=1
+```
@@ -3,7 +3,6 @@ name: measuring-dom-nodes
 description: Measuring DOM element dimensions in Remotion
 metadata:
  tags: measure, layout, dimensions, getBoundingClientRect, scale
-layer: wiki
 ---

 # Measuring DOM nodes in Remotion
@@ -3,7 +3,6 @@ name: measuring-text
 description: Measuring text dimensions, fitting text to containers, and checking overflow
 metadata:
  tags: measure, text, layout, dimensions, fitText, fillTextBox
-layer: wiki
 ---

 # Measuring text in Remotion
@@ -3,7 +3,6 @@ name: parameters
 description: Make a video parametrizable by adding a Zod schema
 metadata:
  tags: parameters, zod, schema
-layer: wiki
 ---

 To make a video parametrizable, a Zod schema can be added to a composition.
@@ -3,7 +3,6 @@ name: sequencing
 description: Sequencing patterns for Remotion - delay, trim, limit duration of items
 metadata:
  tags: sequence, series, timing, delay, trim
-layer: wiki
 ---

 Use `<Sequence>` to delay when an element appears in the timeline.
@@ -2,7 +2,6 @@
 name: tailwind
 description: Using TailwindCSS in Remotion.
 metadata:
-layer: wiki
 ---

 You can and should use TailwindCSS in Remotion, if TailwindCSS is installed in the project.
@@ -3,7 +3,6 @@ name: text-animations
 description: Typography and text animation patterns for Remotion.
 metadata:
  tags: typography, text, typewriter, highlighter ken
-layer: wiki
 ---

 ## Text animations
@@ -3,7 +3,6 @@ name: timing
 description: Interpolation curves in Remotion - linear, easing, spring animations
 metadata:
  tags: spring, bounce, easing, interpolation
-layer: wiki
 ---

 A simple linear interpolation is done using the `interpolate` function.
@@ -3,7 +3,6 @@ name: transcribe-captions
 description: Transcribing audio to generate captions in Remotion
 metadata:
  tags: captions, transcribe, whisper, audio, speech-to-text
-layer: wiki
 ---

 # Transcribing audio
@@ -3,7 +3,6 @@ name: transitions
 description: Fullscreen scene transitions for Remotion.
 metadata:
  tags: transitions, fade, slide, wipe, scenes
-layer: wiki
 ---

 ## Fullscreen transitions
@@ -3,7 +3,6 @@ name: trimming
 description: Trimming patterns for Remotion - cut the beginning or end of animations
 metadata:
  tags: sequence, trim, clip, cut, offset
-layer: wiki
 ---

 Use `<Sequence>` with a negative `from` value to trim the start of an animation.
@@ -3,7 +3,6 @@ name: videos
 description: Embedding videos in Remotion - trimming, volume, speed, looping, pitch
 metadata:
  tags: video, media, trim, volume, speed, loop, pitch
-layer: wiki
 ---

 # Using videos in Remotion
@@ -1,7 +1,6 @@
 ---
 name: youtube
 description: Gestao e optimizacao de canais YouTube. Estrategia de conteudo, SEO, thumbnails e analytics.
-layer: wiki
 ---

 # /youtube - YouTube Complete Toolkit
@@ -172,4 +171,108 @@ Estrutura: Resumo + keyword (1a linha) -> Timestamps -> Descricao expandida (min

 ### Tags (Peso: 10%)

-10-15 tags total: 1-2 exact keyword + 3-5 variacoes
+10-15 tags total: 1-2 exact keyword + 3-5 variacoes + 3-5 long-tail + 2-3 genericas nicho.
+
+---
+
+## Upload de Videos (MCP youtube-uploader)
+
+### Configuracao Inicial (uma vez)
+
+1. `mcp__youtube-uploader__authenticate` -> URL OAuth2
+2. Abrir URL no browser -> Login Google -> Autorizar
+3. Copiar codigo do redirect -> `mcp__youtube-uploader__accesstoken`
+
+### Upload Completo
+
+```javascript
+mcp__youtube-uploader__upload_video({
+  file_path: "/caminho/completo/video.mp4",
+  channel_id: "UCxxx...",
+  title: "Titulo Optimizado SEO (< 100 chars)",
+  description: "Descricao completa com timestamps, links, keywords (min 200 palavras)",
+  tags: "tag1, tag2, tag3",
+  status: "public",
+  category_id: "22",
+  publish_at: "2026-02-05T18:00:00Z"
+})
+```
+
+### Categorias Principais
+
+| ID | Nome | Uso |
+|----|------|-----|
+| 22 | People & Blogs | Vlogs, lifestyle |
+| 24 | Entertainment | Entretenimento geral |
+| 27 | Education | Tutoriais, cursos |
+| 28 | Science & Technology | Tech, ciencia |
+
+---
+
+## Referencias Detalhadas
+
+Para conteudo detalhado, consultar:
+
+- [references/strategy-guide.md](references/strategy-guide.md) - Estrategia crescimento (3 fases: 0-1K, 1K-10K, 10K-100K+), algoritmo YouTube 2026, optimizacao titulos/thumbnails, SEO YouTube completo, hook framework, metricas detalhadas, upload com MCP
+
+---
+
+## Anti-Patterns
+
+- Nao usar para tarefas fora do dominio YouTube
+- Nao usar MCPs de transcricao (usar script local)
+- Nao prometer uploads sem OAuth configurado
+
+---
+
+**Script transcricoes**: `/media/ealmeida/Dados/Dev/ClaudeDev/Claude-Scripts/youtube-transcript/youtube_extractor.py`
+**MCPs**: youtube-research (8/12 OK), youtube-uploader (requer auth)
+
+---
+
+## Media Bank (D7-MB-001)
+
+**Quando consultar:** antes de criar thumbnail base (imagem de fundo) ou de seleccionar cutaways/B-roll para vídeos YouTube. Reutilizar matéria-prima local poupa tempo e mantém coerência visual.
+
+**Workflow tentativa-primeiro:**
+
+1. Pesquisar via MCP `media-bank`:
+   ```
+   mcp__media-bank__search_media(
+     query="<tema do vídeo em EN>",
+     type="image",                # ou "video" para cutaways
+     tema="<um dos 9 temas>",
+     orientation="landscape",
+     min_quality=7,
+     min_width=1280,              # mínimo para thumbnail YT (1280x720)
+     exclude_used_in_last_days=30,
+     limit=5
+   )
+   ```
+2. Avaliar candidatos por `description_en` + `quality_score`.
+3. Se ≥1 adequado → usar `path_local` como base do thumbnail (composição em Canva/Photoshop/design-engine) ou como cutaway no Remotion.
+4. Se nenhum → fallback para geração IA.
+5. Marcar uso: `mcp__media-bank__mark_used(asset_id, {type:"youtube-thumb", ref:"<video_id>", date:"<YYYY-MM-DD>"})`.
+
+**Fallback REST** (se MCP indisponível):
+```bash
+SK=$(grep SERVICE_KEY /media/ealmeida/Dados/Hub/05-Projectos/Banco-Imagens-Videos/scripts/.env | cut -d= -f2)
+curl -s "https://mem.descomplicar.pt/rest/v1/media_bank_assets?type=eq.image&orientation=eq.landscape&width=gte.1280&quality_score=gte.7&deleted_at=is.null&order=quality_score.desc&limit=5" \
+  -H "apikey: $SK" -H "Authorization: Bearer $SK"
+```
+
+**Regra inviolável:** matéria-prima local. Usar como input para composição do thumbnail — NUNCA publicar o ficheiro raw como thumbnail final sem edição (título, CTA, branding).
+
+Ver `Hub/06-Operacoes/Procedimentos/D7-Tecnologia/MCP/PROC-Media-Bank.md` (D7-MB-001) para detalhes.
+
+---
+
+## Healing Log
+
+Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.
+
+```jsonl
+{"date":"","issue":"","fix":"","source":"user|auto"}
+```
+
+*Adicionar nova linha após cada erro corrigido.*
				`@@ -0,0 +1 @@`
				`/home/ealmeida/.claude/skills/second-brain-repo/.claude/skills/brand-voice-generator`