{"id":179,"date":"2026-01-21T07:21:28","date_gmt":"2026-01-21T06:21:28","guid":{"rendered":"https:\/\/helloblog.io\/pt\/wp-cli-abilities-api-wordfence-seguranca-terminal-agentes-ia\/"},"modified":"2026-01-21T07:36:31","modified_gmt":"2026-01-21T06:36:31","slug":"wp-cli-abilities-api-wordfence-seguranca-terminal-agentes-ia","status":"publish","type":"post","link":"https:\/\/helloblog.io\/pt\/wp-cli-abilities-api-wordfence-seguranca-terminal-agentes-ia\/","title":{"rendered":"WP-CLI e Abilities API no Wordfence: operar seguran\u00e7a no WordPress a partir do terminal (e de agentes de IA)"},"content":{"rendered":"\n<p>Para quem administra v\u00e1rios sites WordPress, o wp-admin \u00e9 \u00f3timo\u2026 at\u00e9 deixar de ser. Quando est\u00e1s a lidar com incidentes, scans recorrentes, regras de firewall e rotinas de hardening, a linha de comando (WP-CLI) e a automa\u00e7\u00e3o come\u00e7am a fazer muito mais sentido do que clicar em ecr\u00e3s e esperar por respostas.<\/p>\n\n\n\n<p>Saiu um plugin open-source que faz exatamente essa ponte: adiciona suporte de WP-CLI ao Wordfence Security e, de forma ainda mais relevante, j\u00e1 nasce com integra\u00e7\u00e3o com a nova <strong>WordPress Abilities API<\/strong> (introduzida no WordPress 6.9). Na pr\u00e1tica, al\u00e9m de poderes gerir seguran\u00e7a pelo terminal, tamb\u00e9m passas a ter um conjunto de capacidades \u201cdescobertas\u201d e consum\u00edveis por ferramentas de automa\u00e7\u00e3o e agentes de IA atrav\u00e9s de uma interface padronizada.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">O que este plugin adiciona ao teu fluxo de trabalho<\/h2>\n\n\n\n<p>O plugin cria um novo namespace de comandos no WP-CLI: <code>wp wfsec<\/code>. A ideia \u00e9 simples: expor opera\u00e7\u00f5es comuns do Wordfence (scans, firewall\/WAF, issues e configura\u00e7\u00e3o) diretamente por CLI, com sa\u00eddas adequadas para scripting.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">1) Scans de seguran\u00e7a (malware e integridade)<\/h3>\n\n\n\n<p>Na parte de scanning, o objetivo \u00e9 cobrir o ciclo completo: iniciar scans, acompanhar execu\u00e7\u00e3o e consultar hist\u00f3rico\/logs.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n\n<li>Iniciar scans r\u00e1pidos ou completos (quick\/full).<\/li>\n\n\n<li>Acompanhar o progresso do scan em tempo real.<\/li>\n\n\n<li>Ver hist\u00f3rico de scans e logs detalhados.<\/li>\n\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">2) Gest\u00e3o de firewall \/ WAF<\/h3>\n\n\n\n<p>Para opera\u00e7\u00f5es de resposta a incidentes e mitiga\u00e7\u00e3o r\u00e1pida, o plugin tamb\u00e9m exp\u00f5e a\u00e7\u00f5es de firewall. Aqui, WAF \u00e9 o Web Application Firewall do Wordfence &#8211; a camada que ajuda a bloquear tr\u00e1fego malicioso antes de chegar ao WordPress.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n\n<li>Bloquear ou desbloquear endere\u00e7os IP.<\/li>\n\n\n<li>Definir a dura\u00e7\u00e3o do bloqueio e o motivo (reason).<\/li>\n\n\n<li>Verificar se um IP espec\u00edfico est\u00e1 bloqueado.<\/li>\n\n\n<li>Ativar ou desativar a prote\u00e7\u00e3o do WAF.<\/li>\n\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">3) Acompanhamento de issues (alertas\/amea\u00e7as detetadas)<\/h3>\n\n\n\n<p>O Wordfence regista issues (problemas\/amea\u00e7as) detetados em scans e outras verifica\u00e7\u00f5es. O namespace <code>wfsec<\/code> inclui comandos para listar e gerir esses itens &#8211; \u00fatil tanto para triagem como para limpeza.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n\n<li>Listar todas as issues detetadas.<\/li>\n\n\n<li>Filtrar por estado (new, ignored, resolved).<\/li>\n\n\n<li>Apagar ou gerir amea\u00e7as individuais.<\/li>\n\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">4) Configura\u00e7\u00e3o e licenciamento<\/h3>\n\n\n\n<p>Tamb\u00e9m h\u00e1 suporte para mexer em settings e verificar licen\u00e7a, al\u00e9m de suportar exporta\u00e7\u00e3o\/importa\u00e7\u00e3o de configura\u00e7\u00e3o &#8211; \u00fatil para quem quer alinhar pol\u00edticas de seguran\u00e7a entre v\u00e1rios sites.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n\n<li>Ler e alterar defini\u00e7\u00f5es do Wordfence.<\/li>\n\n\n<li>Verificar o estado da licen\u00e7a.<\/li>\n\n\n<li>Exportar e importar configura\u00e7\u00f5es.<\/li>\n\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Exemplos r\u00e1pidos com <code>wp wfsec<\/code><\/h2>\n\n\n\n<p>Os exemplos abaixo d\u00e3o uma no\u00e7\u00e3o clara do que d\u00e1 para automatizar em Bash, CI\/CD, cronjobs ou ferramentas internas.<\/p>\n\n\n\n<div class=\"wp-block-kevinbatdorf-code-block-pro\" data-code-block-pro-font-family=\"Code-Pro-JetBrains-Mono\" style=\"font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)\"><span style=\"display:block;padding:16px 0 0 16px;margin-bottom:-1px;width:100%;text-align:left;background-color:#24292e\"><svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"54\" height=\"14\" viewBox=\"0 0 54 14\"><g fill=\"none\" fill-rule=\"evenodd\" transform=\"translate(1 1)\"><circle cx=\"6\" cy=\"6\" r=\"6\" fill=\"#FF5F56\" stroke=\"#E0443E\" stroke-width=\".5\"><\/circle><circle cx=\"26\" cy=\"6\" r=\"6\" fill=\"#FFBD2E\" stroke=\"#DEA123\" stroke-width=\".5\"><\/circle><circle cx=\"46\" cy=\"6\" r=\"6\" fill=\"#27C93F\" stroke=\"#1AAB29\" stroke-width=\".5\"><\/circle><\/g><\/svg><\/span><span role=\"button\" tabindex=\"0\" style=\"color:#e1e4e8;display:none\" aria-label=\"Copy\" class=\"code-block-pro-copy-button\"><pre class=\"code-block-pro-copy-button-pre\" aria-hidden=\"true\"><textarea class=\"code-block-pro-copy-button-textarea\" tabindex=\"-1\" aria-hidden=\"true\" readonly># Ver estado geral do Wordfence\nwp wfsec status\n\n# Iniciar um scan completo\nwp wfsec scan start --type=full\n\n# Acompanhar o progresso do scan\nwp wfsec scan status\n\n# Listar todas as issues\nwp wfsec issues ls --status=all\n\n# Bloquear um IP por 24h (86400 segundos)\nwp wfsec firewall block 192.168.1.100 --duration=86400 --reason=&quot;Brute force attempt&quot;\n\n# Verificar o estado da licen\u00e7a\nwp wfsec license status\n<\/textarea><\/pre><svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" style=\"width:24px;height:24px\" fill=\"none\" viewBox=\"0 0 24 24\" stroke=\"currentColor\" stroke-width=\"2\"><path class=\"with-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4\"><\/path><path class=\"without-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2\"><\/path><\/svg><\/span><pre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\"><code><span class=\"line\"><span style=\"color:#6A737D\"># Ver estado geral do Wordfence<\/span><\/span>\n<span class=\"line\"><span style=\"color:#B392F0\">wp<\/span><span style=\"color:#9ECBFF\"> wfsec<\/span><span style=\"color:#9ECBFF\"> status<\/span><\/span>\n<span class=\"line\"><\/span>\n<span class=\"line\"><span style=\"color:#6A737D\"># Iniciar um scan completo<\/span><\/span>\n<span class=\"line\"><span style=\"color:#B392F0\">wp<\/span><span style=\"color:#9ECBFF\"> wfsec<\/span><span style=\"color:#9ECBFF\"> scan<\/span><span style=\"color:#9ECBFF\"> start<\/span><span style=\"color:#79B8FF\"> --type=full<\/span><\/span>\n<span class=\"line\"><\/span>\n<span class=\"line\"><span style=\"color:#6A737D\"># Acompanhar o progresso do scan<\/span><\/span>\n<span class=\"line\"><span style=\"color:#B392F0\">wp<\/span><span style=\"color:#9ECBFF\"> wfsec<\/span><span style=\"color:#9ECBFF\"> scan<\/span><span style=\"color:#9ECBFF\"> status<\/span><\/span>\n<span class=\"line\"><\/span>\n<span class=\"line\"><span style=\"color:#6A737D\"># Listar todas as issues<\/span><\/span>\n<span class=\"line\"><span style=\"color:#B392F0\">wp<\/span><span style=\"color:#9ECBFF\"> wfsec<\/span><span style=\"color:#9ECBFF\"> issues<\/span><span style=\"color:#9ECBFF\"> ls<\/span><span style=\"color:#79B8FF\"> --status=all<\/span><\/span>\n<span class=\"line\"><\/span>\n<span class=\"line\"><span style=\"color:#6A737D\"># Bloquear um IP por 24h (86400 segundos)<\/span><\/span>\n<span class=\"line\"><span style=\"color:#B392F0\">wp<\/span><span style=\"color:#9ECBFF\"> wfsec<\/span><span style=\"color:#9ECBFF\"> firewall<\/span><span style=\"color:#9ECBFF\"> block<\/span><span style=\"color:#79B8FF\"> 192.168.1.100<\/span><span style=\"color:#79B8FF\"> --duration=86400<\/span><span style=\"color:#79B8FF\"> --reason=<\/span><span style=\"color:#9ECBFF\">\"Brute force attempt\"<\/span><\/span>\n<span class=\"line\"><\/span>\n<span class=\"line\"><span style=\"color:#6A737D\"># Verificar o estado da licen\u00e7a<\/span><\/span>\n<span class=\"line\"><span style=\"color:#B392F0\">wp<\/span><span style=\"color:#9ECBFF\"> wfsec<\/span><span style=\"color:#9ECBFF\"> license<\/span><span style=\"color:#9ECBFF\"> status<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n<p>Todos os comandos suportam <code>--format=json<\/code>, o que facilita muito a integra\u00e7\u00e3o com scripts e pipelines (por exemplo, filtrar resultados com <code>jq<\/code>, alimentar alertas, ou gerar relat\u00f3rios).<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">O diferencial: suporte \u00e0 WordPress Abilities API (WordPress 6.9+)<\/h2>\n\n\n\n<p>A parte mais interessante deste projeto \u00e9 a implementa\u00e7\u00e3o da <strong>WordPress Abilities API<\/strong>. Esta API foi introduzida no WordPress 6.9 como uma interface padronizada para que ferramentas de automa\u00e7\u00e3o e agentes de IA consigam <strong>descobrir<\/strong> e <strong>interagir<\/strong> com funcionalidades do WordPress de forma consistente, sem depender de integra\u00e7\u00f5es ad hoc para cada plugin.<\/p>\n\n\n\n<p>Em vez de \u201cinventares\u201d endpoints e contratos para cada cen\u00e1rio, a Abilities API trabalha como uma camada auto-descritiva (self-describing) e validada por esquema (schema-validated), onde um agente pode perceber: que capacidades existem, que entradas aceitam e como chamar cada uma.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">As 7 abilities expostas para Wordfence<\/h3>\n\n\n\n<p>Este plugin exp\u00f5e sete abilities centrais, cobrindo o essencial para monitoriza\u00e7\u00e3o e resposta a incidentes:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n\n<li><strong>scan-status<\/strong> &#8211; obter o estado atual do scan e o progresso.<\/li>\n\n\n<li><strong>scan-start<\/strong> &#8211; iniciar scans de seguran\u00e7a programaticamente.<\/li>\n\n\n<li><strong>issues-list<\/strong> &#8211; recuperar a lista de issues detetadas.<\/li>\n\n\n<li><strong>issues-count<\/strong> &#8211; obter contagens de issues por severidade.<\/li>\n\n\n<li><strong>firewall-status<\/strong> &#8211; verificar o estado do WAF.<\/li>\n\n\n<li><strong>firewall-block<\/strong> &#8211; bloquear IPs via API.<\/li>\n\n\n<li><strong>license-status<\/strong> &#8211; consultar informa\u00e7\u00e3o de licen\u00e7a.<\/li>\n\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">O que isto desbloqueia na pr\u00e1tica<\/h3>\n\n\n\n<p>Com estas abilities, o Wordfence deixa de ser algo que s\u00f3 \u201cvive\u201d dentro do wp-admin. Passa a ser consum\u00edvel por automa\u00e7\u00e3o e por agentes de IA que conseguem descobrir as capacidades expostas e chamar as opera\u00e7\u00f5es sem c\u00f3digo de integra\u00e7\u00e3o espec\u00edfico para cada endpoint custom.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n\n<li>Construir monitoriza\u00e7\u00e3o de seguran\u00e7a com apoio de IA (por exemplo, acompanhar scans e interpretar issues).<\/li>\n\n\n<li>Integrar Wordfence em dashboards internos (NOC\/observability) sem depender da UI do WordPress.<\/li>\n\n\n<li>Automatizar checks rotineiros (iniciar scans, recolher contagens por severidade, aplicar bloqueios) com base em regras e sinais externos.<\/li>\n\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Autentica\u00e7\u00e3o<\/h3>\n\n\n\n<p>A autentica\u00e7\u00e3o \u00e9 feita com <strong>WordPress Application Passwords<\/strong> via <strong>Basic Auth<\/strong>. Ou seja: usas uma Application Password (senha de aplica\u00e7\u00e3o) associada a um utilizador WordPress e autenticas as chamadas com o esquema HTTP Basic.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Requisitos (para evitar surpresas)<\/h2>\n\n\n\n<p>Antes de instalar, confirma estes requisitos &#8211; s\u00e3o relevantes tanto para o WP-CLI como para a Abilities API:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n\n<li>WordPress 6.9+<\/li>\n\n\n<li>PHP 8.0+<\/li>\n\n\n<li>WP-CLI 2.5+<\/li>\n\n\n<li>Plugin Wordfence Security (vers\u00e3o gratuita ou premium)<\/li>\n\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Download e instala\u00e7\u00e3o<\/h2>\n\n\n\n<p>Podes descarregar a vers\u00e3o mais recente e fazer upload para a pasta de plugins do WordPress (<code>\/wp-content\/plugins\/<\/code>).<\/p>\n\n\n<a href=\"https:\/\/github.com\/trueqap\/wpcli-for-wordfence\/releases\/download\/v1.0.0\/wpcli-for-wordfence-1.0.0.zip\" class=\"download-card\" download>\n                <span class=\"download-icon\"><i class=\"fa-duotone fa-file-zipper\"><\/i><\/span>\n                <span class=\"download-info\">\n                    <span class=\"download-title\">Download WP CLI for Wordfence v1.0.0<\/span>\n                    <span class=\"download-meta\"><span class=\"download-filename\">wpcli-for-wordfence-1.0.0.zip<\/span><\/span>\n                <\/span>\n                <span class=\"download-action\"><i class=\"fa-duotone fa-arrow-down-to-line\"><\/i><\/span>\n            <\/a>\n\n\n<p>Se estiveres num setup ao estilo Bedrock, tamb\u00e9m existe a op\u00e7\u00e3o de instalar via Composer (conforme indicado no reposit\u00f3rio).<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Porque isto \u00e9 relevante para quem mant\u00e9m WordPress em escala<\/h2>\n\n\n\n<p>WP-CLI j\u00e1 \u00e9 um pilar para opera\u00e7\u00f5es (deploys, migra\u00e7\u00f5es, manuten\u00e7\u00e3o). Trazer o Wordfence para esse contexto reduz fric\u00e7\u00e3o no dia a dia e melhora tempos de resposta. E a integra\u00e7\u00e3o com a Abilities API aponta para um pr\u00f3ximo passo: seguran\u00e7a \u201coper\u00e1vel\u201d por automa\u00e7\u00e3o e por agentes, com contratos consistentes e descobr\u00edveis no ecossistema WordPress.<\/p>\n\n\n<div class=\"references-section\">\n                <h2>Refer\u00eancias \/ Fontes<\/h2>\n                <ul class=\"references-list\"><li><a href=\"https:\/\/github.com\/trueqap\/wpcli-for-wordfence\" target=\"_blank\" rel=\"noopener noreferrer\">WP-CLI &amp; Abilities API for Wordfence: Manage Security from Terminal and AI Agents<\/a><\/li><\/ul>\n            <\/div>","protected":false},"excerpt":{"rendered":"<p>Gerir Wordfence sem abrir o wp-admin j\u00e1 \u00e9 poss\u00edvel: este plugin open-source adiciona comandos WP-CLI e ainda exp\u00f5e \u201cabilities\u201d para automa\u00e7\u00e3o e agentes de IA via Abilities API do WordPress 6.9.<\/p>\n","protected":false},"author":27,"featured_media":180,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[9],"tags":[80,11,15,10,7],"class_list":["post-179","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-seguranca","tag-api","tag-seguranca","tag-wordfence","tag-wordpress","tag-wp-cli"],"_links":{"self":[{"href":"https:\/\/helloblog.io\/pt\/wp-json\/wp\/v2\/posts\/179","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/helloblog.io\/pt\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/helloblog.io\/pt\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/helloblog.io\/pt\/wp-json\/wp\/v2\/users\/27"}],"replies":[{"embeddable":true,"href":"https:\/\/helloblog.io\/pt\/wp-json\/wp\/v2\/comments?post=179"}],"version-history":[{"count":1,"href":"https:\/\/helloblog.io\/pt\/wp-json\/wp\/v2\/posts\/179\/revisions"}],"predecessor-version":[{"id":181,"href":"https:\/\/helloblog.io\/pt\/wp-json\/wp\/v2\/posts\/179\/revisions\/181"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/helloblog.io\/pt\/wp-json\/wp\/v2\/media\/180"}],"wp:attachment":[{"href":"https:\/\/helloblog.io\/pt\/wp-json\/wp\/v2\/media?parent=179"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/helloblog.io\/pt\/wp-json\/wp\/v2\/categories?post=179"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/helloblog.io\/pt\/wp-json\/wp\/v2\/tags?post=179"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}