NEXUS Semrush

Resumo técnico

Plugin NEXUS de inteligência de SEO e análise competitiva via Semrush API v3: visão geral de domínios (tráfego orgânico/pago, keywords, custo), palavras-chave orgânicas com posicionamento e volume, backlinks (total, domínios referenciadores, autoridade), enriquecimento de domínios/URLs no Intelligence Hub, cache local de 7 dias e interface Alpine.js com 3 slash commands — requer conta paga do Semrush.

Escopo executado

• Backend backend.php (474 linhas): api.semrush.com/?type=...&key=... (query params); autenticação por key (conta paga Semrush).
• Configuração (semrush_settings_save): api_key via DB::setConfig('semrush_settings', ...) com fallback para constante SEMRUSH_API_KEY; semrush_get_api_key() resolve prioridade.
• Tabelas (criadas por semrush_install()): semrush_cache (kind, query_key, data, error, status, http_code; UNIQUE uk_kind_key) e semrush_history (query_type, query_val, status, task_id; idx_created_at).
• Cache: TTL fixo SEMRUSH_CACHE_TTL = 604800 (7 dias), upsert por kind+chave (chave em minúsculo); parâmetro force ignora o cache.
• HTTP (semrush_http_request): connect 4s / timeout 10s; trata erros JSON/CSV e formata mensagens de erro via semrush_format_api_error.
• Domain Overview (semrush_domain_overview) — GET /domain_ranks com export_columns Or,Ot,Oc,Ad,At,Ac; retorna organic_keywords, organic_traffic, organic_cost, adwords_keywords, adwords_traffic, adwords_cost.
• Organic Keywords (semrush_organic_keywords) — GET /domain_organic (limit 10); retorna array de keywords com keyword, position, volume, cpc, url.
• Backlinks Overview (semrush_backlinks_overview) — GET /backlinks_overview (target_type domain); retorna total_backlinks, referring_domains, authority_score, dofollow_ratio (% calculada).
• semrush_status — valida a chave; retorna has_key, modo ("Semrush API (Conectado)" ou "Sem Chave de API") e status dos serviços.
• semrush_history — página e limit ≤ 50; lista consultas com tipo, domínio, status e data.
• Intelligence Hub: enricher semrush (prioridade 60, tipos domain, url) — recebe artefatos, normaliza domínio, consulta domain_overview, emite signal severity: 'info', status: 'active', summary Semrush Overview para {domínio} com payload completo de domain_overview.
• API: 6 actions via PluginManager::registerApiAction (semrush_status, semrush_domain_overview, semrush_organic_keywords, semrush_backlinks_overview, semrush_history, semrush_settings_save).
• UI Alpine.js (tab.php, 363 linhas): 3 abas — Domain Overview (domain input, cards KPI: keywords orgânicos, tráfego, custo, adwords), Organic Keywords (tabela keyword/position/volume/CPC), Backlinks (total, domínios referenciadores, score, dofollow %) e Histórico (queries).
• Fastr: 3 comandos — /semrush <domínio>, /semrush-keywords <domínio>, /semrush-backlinks <domínio>.
• Sem cron — plugin sob demanda (cache de 7 dias absorve repetições).

Stack e ferramentas

• PHP 8 (sem framework)
• MySQL 8 (semrush_cache + semrush_history)
• Alpine.js + Tailwind CSS (premium light, indigo ring)
• Sistema de plugins do NEXUS (PluginManager)
• cURL → Semrush API v3 (api.semrush.com, CSV responses)

Tags operacionais

• SEO
• Semrush
• Inteligência de Mercado
• Palavras-chave
• Backlinks
• Análise Competitiva
• Plugin NEXUS

Resultado operacional

• Análise de SEO sob demanda: visão geral completa de tráfego orgânico/pago, keywords, custo e backlinks — tudo em 3 consultas paralelas.
• Palavras-chave ranqueadas: top 10 keywords com posicionamento atual, volume de busca e CPC — estratégia de conteúdo em tempo real.
• Inteligência de backlinks: total de backlinks, domínios referenciadores, autoridade do site e proporção dofollow — auditoria de link building.
• Enriquecimento automático: domínios/URLs em tarefas/comentários viram sinais estruturados com insights de SEO no Intelligence Hub.
• Cache de 7 dias reduz consumo de cota paga; force permite atualização imediata.
• Histórico auditável de todas as consultas (tipo, domínio, status, data).