NEXUS Moz Link Explorer

Resumo técnico

O NEXUS Moz Link Explorer consulta autoridade de links (Domain Authority, Page Authority e Spam Score) de qualquer domínio via Moz Link API V2, com monitoramento diário do portfólio e snapshots da evolução. O plugin também executa Link Intersect para descobrir sites que linkam concorrentes mas não linkam você, gerando tarefas de outreach priorizadas por DA — tudo com controle de custo por rows mensais, cache de 24h e slash command no Fastr.

Escopo executado

• Registro do plugin em plugin.php: registerTab('moz', tab.php) com ícone target (categoria Marketing & SEO), registerDoc('moz', doc.md) e 12 ações de API via registerApiAction (prefixo moz_).
• Integração Moz Link API V2 (https://lsapi.seomoz.com/v2): protocolo POST JSON com autenticação via header x-moz-token (API Token) ou Basic Auth legacy (Access ID + Secret Key), timeouts cURL (5s conexão / 20s total).
• Cobrança por rows/mês: url_metrics = 1 row (+1 por modificador), link_intersect = 5 rows por resultado (weighted; máx 50 = 250 rows) e usage_data = grátis. Guarda de custo (moz_guard_rows): cada chamada estima o consumo antes de executar e bloqueia quando o orçamento mensal (row_budget, padrão 3.000) está prestes a estourar.
• Banco de dados (DDL real, moz_install() com CREATE TABLE IF NOT EXISTS): moz_cache (kind, query_key UNIQUE, data LONGTEXT, error, status, http_code, updated_at — cache de respostas por 24h para não repetir consumo de rows), moz_snapshots (target, scope, domain_authority/page_authority/spam_score FLOAT, pages_to_root_domain, root_domains_to_root_domain, external_links, snapshot_date, UNIQUE target+data — snapshot diário com ON DUPLICATE KEY UPDATE) e moz_history (provider, query_type, query_val, status, task_id, created_at — auditoria de consultas).
• Métricas (moz_metrics): DA, PA, Spam Score, link propensity, páginas e domínios referentes, links externos, last crawled e HTTP code de qualquer domínio/URL (target normalizado).
• Monitoramento de portfólio: moz_all_metrics consulta todos os domínios configurados; moz_snapshot_history retorna a evolução de DA/PA/Spam por domínio (janela de dias configurável).
• Link Intersect (moz_intersect): até 6 positive_targets e 6 negative_targets, source_scope = 'page', ordenação por source_domain_authority e limite 1–50 — retorna sources candidatas com DA, Spam Score e matching count.
• Outreach automático (moz_create_outreach): gera tasks [Moz Outreach: {anchor}] {domain} com prioridade por DA (≥40 → prioridade 3, ≥20 → 2, senão 1), descrição estruturada e comentário system — respeitando a flag de config auto_tasks.
• Configuração centralizada em plugin.moz (via DB::getConfig): api_token, access_id/secret_key (legacy), domains (portfólio), default_project, row_budget (10–1.000.000), interval_min (5–10.080), alerts e auto_tasks — com token sempre mascarado na resposta pública (moz_mask: primeiros 4 + últimos 4 caracteres).
• Cron (soft-cron): cronjob.json com o job moz_monitor_metrics (tick, não editável) — moz_cron_check aplica throttle de 3.600s e moz_cron_run sincroniza as métricas de todos os domínios monitorados respeitando o row_budget.
• Erros mapeados da API: 401 (autenticação), 403 (método não reconhecido/conta banida), 429 (rate limit / rows), demais com mensagem da resposta.
• Fast Responses: manifesto fastr.json com /moz <domínio|url> (consulta DA/PA/Spam no chat, argumento obrigatório) via moz_metrics.
• Intel Hub: nx_intel_register_enricher('moz', ['domain', 'hostname', 'url'], 'moz_intel_enrich', 25) — domínios citados em tarefas/comentários ganham artefato com DA/PA/Spam/domínios referentes e severidade (medium se DA ≥ 50).
• Interface (tab.php, 594 linhas): 4 abas — Dashboard (domínios monitorados com métricas), Métricas (consulta DA/PA/Spam + evolução por snapshots), Link Intersect (oportunidades de link building) e Configuração (credenciais, portfólio, row_budget) — com 4 KPIs (Domínios, Snapshots, Eventos hoje, Rows restantes).

Stack e ferramentas

• PHP 8 backend (sem framework) + MySQL (moz_cache, moz_snapshots, moz_history)
• Moz Link API V2 (POST JSON, auth x-moz-token ou Basic Auth)
• cURL com timeouts controlados e mapeamento de erros HTTP
• Alpine.js + Tailwind CSS (4 abas, KPIs, gráficos de evolução e tabelas de oportunidades)
• Plugin API interno: PluginManager tabs/docs/actions + fastr.json + cronjob + intel enricher
• Autenticação via Bearer token da API NEXUS nas chamadas de API

Tags operacionais

• SEO
• Moz
• DA
• PA
• Spam Score
• Backlinks
• Link Building
• Outreach
• Marketing
• Plugin NEXUS

Resultado operacional

• Autoridade de links: DA, PA e Spam Score de qualquer domínio/URL em uma chamada (1 row).
• Monitoramento do portfólio: snapshots diários com evolução de autoridade ao longo do tempo.
• Link Intersect: banco de oportunidades — sites que linkam concorrentes, mas não linkam você.
• Outreach automatizado: tasks [Moz Outreach: …] priorizadas por DA, prontas para a equipe agir.
• Controle de custo: estimativa de rows antes de cada chamada, bloqueio no estouro do orçamento e cache de 24h.
• Acesso rápido: slash /moz <domínio> direto no terminal Fastr.