Ontem lançamos o WPVibe MCP, um plugin gratuito para WordPress que permite que qualquer assistente de IA gerencie seu site WordPress por meio de uma conversa natural. Crie posts, atualize plugins, gerencie páginas — basta pedir.
Hoje estamos adicionando algo que eleva tudo a um nível completamente diferente: suporte ao WP-CLI.
Se a API REST deu mãos ao seu assistente de IA, o WP-CLI lhe dá superpoderes.
O problema que deu início a tudo
Compartilhei nossa publicação de lançamento do WPVibe no Twitter e percebi que a pré-visualização estava errada. Não havia imagem em destaque, apenas uma miniatura genérica minúscula. Nada bom para o lançamento de um produto.
Normalmente, depurar isso significa:
- Abrindo as configurações do All in One SEO
- Verificando a guia “Redes sociais”
- Comparando as configurações globais com as configurações por publicação
- Analisando as tags meta HTML presentes no código-fonte da página
- Descobrir qual configuração se sobrepõe a qual
- Testar, atualizar o validador de cartões do Twitter, repetir
Em vez disso, eu simplesmente disse ao meu assistente de IA: “A imagem em destaque não está aparecendo quando compartilho esta publicação no Twitter. Você consegue descobrir o motivo?”
Como o WP-CLI resolveu o problema
Eis o que aconteceu a seguir. O assistente de IA, conectado ao meu site por meio do WPVibe MCP, executou uma série de consultas ao banco de dados usando o WP-CLI para verificar a configuração do All in One SEO:
- Consultei a tabela de publicações do AIOSEO para verificar as configurações de redes sociais específicas de cada publicação
- Acessei as opções globais do AIOSEO para verificar as configurações padrão do Twitter e do Facebook para todo o site
- Recuperei o código HTML da página ativa para verificar quais metatags estavam realmente sendo exibidas
Em poucos segundos, ele identificou três problemas:
- O tipo de cartão do Twitter foi definido como
summary(miniatura pequena) em vez desummary_large_image(banner de largura total) - A fonte padrão da imagem foi definida como uma imagem alternativa genérica de 2020, em vez de usar a imagem em destaque da publicação
- A opção “Usar dados da guia do Facebook” estava desativada, por isso o Twitter não tinha dados de imagem para extrair
Nada disso é disponibilizado pela API REST do WordPress. A IA precisava consultar o aioseo_posts tabela e analisar o aioseo_options opção diretamente. Isso é algo que só o WP-CLI consegue fazer.
Aqui está uma captura de tela da IA diagnosticando o problema em tempo real:
A solução: três configurações, sem precisar clicar
Assim que a IA diagnosticou o problema, ela o corrigiu, atualizando as configurações globais do AIOSEO por meio do endpoint da API REST (que foi identificado ao inspecionar os namespaces de API disponíveis). Uma conversa, três correções:
- Alterou o tipo padrão do cartão do Twitter para
summary_large_image - Defina a fonte de imagem padrão como “imagem em destaque” tanto para o Facebook quanto para o Twitter
- Ativei a opção “Usar dados da guia do Facebook” para que o Twitter herde os dados OG
O resultado? Agora, todas as publicações do site exibem a imagem em destaque na íntegra quando compartilhadas no Twitter ou no Facebook. Uma solução global a partir de uma única conversa.
Então a coisa ficou interessante: uma auditoria completa de SEO
Já que estávamos falando nisso, perguntei: “Você poderia fazer uma auditoria completa de SEO do site?”
Em menos de um minuto, a IA analisou todas as 482 publicações e apresentou uma auditoria completa:
- 14 publicações sem títulos do AIOSEO (incluindo a nossa nova publicação de lançamento do WPVibe)
- 7 publicações sem descrições meta
- 27 páginas sem meta descrições, incluindo páginas importantes como o Diretório de Modelos e a página de Imprensa
- 30 publicações desatualizadas, que não são atualizadas desde 2024 e poderiam ser consolidadas ou marcadas como “noindex”
- 3 publicações com conteúdo curto, com menos de 500 palavras
- Mais de 20 imagens sem texto alternativo nas publicações recentes
Esta não é uma verificação superficial. A IA consultou diretamente as tabelas do banco de dados do AIOSEO, cruzou os metadados das publicações, verificou a extensão do conteúdo e identificou títulos duplicados, tudo isso por meio de comandos WP-CLI executados no site ativo.
Tente obter isso por meio de uma chamada à API REST.
Por que o WP-CLI muda tudo
A API REST do WordPress é ótima para operações CRUD padrão: criar posts, atualizar páginas, gerenciar usuários. Mas ela tem algumas limitações. Ela não consegue:
- Consultar tabelas de banco de dados específicas de plugins (como AIOSEO, WooCommerce ou Yoast)
- Verifique os valores das opções em bruto para depurar problemas de configuração
- Execute operações em massa em centenas de publicações com eficiência
- Pesquisar e substituir em todo o banco de dados
- Exportar ou analisar dados em formatos personalizados
- Verifique os detalhes e a configuração do ambiente do servidor
O WP-CLI é capaz de fazer tudo isso. E quando seu assistente de IA tiver acesso ao WP-CLI, ele poderá diagnosticar problemas que, de outra forma, exigiriam que você se conectasse ao servidor via SSH ou instalasse uma ferramenta de gerenciamento de banco de dados.
Pense da seguinte maneira: a API REST permite que sua IA leia e grave conteúdo do WordPress. O WP-CLI permite que sua IA compreenda seu site WordPress.
O segredo: por que escolhemos a interface do WP-CLI
Aqui vai uma curiosidade sobre como isso funciona nos bastidores. Na verdade, não estamos recorrendo ao binário do WP-CLI no seu servidor. Em vez disso, criamos uma interface compatível com o WP-CLI diretamente dentro do plugin WPVibe.
Por quê? Porque todos os principais modelos de IA — Claude, GPT, Gemini — foram treinados com milhões de exemplos de uso do WP-CLI. Esses modelos já conhecem a sintaxe, os parâmetros e os subcomandos do WP-CLI de cor e de memória. Quando você pede a um assistente de IA para “verificar as configurações do AIOSEO”, ele instintivamente recorre a wp option get aioseo_options ou wp db query porque é isso que se vê milhares de vezes na documentação, nas respostas do Stack Overflow e nos tutoriais do WordPress.
Ao implementar uma interface compatível com o WP-CLI, obtemos todos os benefícios desse conhecimento de IA já existente sem precisar de acesso real ao shell do seu servidor. A IA já conhece os comandos. Nós apenas oferecemos a ela uma maneira segura de executá-los.
O que você pode fazer com o WP-CLI + IA
Aqui estão apenas algumas coisas que se tornam possíveis quando seu assistente de IA tem acesso ao WP-CLI:
- Resolução de problemas de SEO: “Por que minha imagem em destaque não está aparecendo no Twitter?” Diagnosticado e resolvido em uma única conversa.
- Realizar auditorias no site: “Auditar meu SEO em todas as 482 publicações.” Relatório completo em menos de um minuto.
- Verificar as configurações do plugin: “Quais são as minhas configurações fiscais do WooCommerce?” Lê diretamente a tabela de opções.
- Diagnóstico do banco de dados: “Quais posts têm imagens em destaque com erros?” Consulta o postmeta para localizar IDs de anexos órfãos.
- Verificações do ambiente: “A minha versão do PHP é compatível com esta atualização do plugin?” Verifica a configuração do servidor.
Segurança em primeiro lugar
Dar acesso a uma IA ao WP-CLI parece algo poderoso, porque realmente é. É por isso que desenvolvemos a integração do WP-CLI do WPVibe com rigorosas medidas de segurança:
- Apenas leitura por enquanto: a versão atual suporta apenas comandos de leitura, como consultas a bancos de dados, verificação de opções e diagnósticos do site. Os comandos de gravação estarão disponíveis em breve.
- Lista de comandos permitidos: Somente comandos WP-CLI aprovados podem ser executados. Não é permitida a execução de código arbitrário.
- Sanitização personalizada: cada comando da CLI passa por um sanitizador desenvolvido especificamente para esse fim, que previne ataques de injeção ao mesmo tempo em que preserva a sintaxe complexa de consultas necessária ao WP-CLI.
- Sem acesso ao shell: os comandos são executados através da camada de execução interna do WordPress, e não por meio do shell do sistema. Não há nenhum binário do WP-CLI envolvido.
Você conta com o poder de diagnóstico do WP-CLI sem o risco de conceder acesso irrestrito ao servidor a uma IA.
Experimente agora
O suporte ao WP-CLI já está disponível no WPVibe MCP v1.2. Se você já tem o plugin instalado, atualize para a versão mais recente. Se você é novo por aqui, a configuração leva cerca de dois minutos:
- Baixe o plugin gratuito WPVibe
- Instale-o no seu site WordPress
- Conecte-o ao seu assistente de IA (Claude, ChatGPT, Cursor ou qualquer ferramenta compatível com MCP)
- Comece a fazer perguntas sobre o seu site
Os comandos de leitura do WP-CLI são totalmente gratuitos. Você pode realizar auditorias de SEO, solucionar problemas de configuração e inspecionar seu banco de dados sem pagar nada. Os comandos de gravação estarão disponíveis em uma versão Pro futura.
P.S. Estamos adicionando novos comandos do WP-CLI todas as semanas com base em casos de uso reais, como o descrito acima. Se houver algo que você gostaria que sua IA pudesse fazer no seu site WordPress, entre em contato conosco.
