WooCommerce

Loja WooCommerce no seu WordPress: produtos, pedidos, clientes, frete, impostos e relatórios, também via MCP.

  • Categoria: Servidores e infraestrutura
  • Estado: Disponível
  • Requisitos: Um site WordPress instalado como app; O plugin WooCommerce ativo (instalado com extras ou como plugin)
  • Ferramentas MCP (Só leem): ver_reportes_tienda_wordpress, listar_sitios_wordpress
  • Ferramentas MCP (Escrevem ou modificam): instalar_app
  • Ferramentas MCP (Destrutivas): editar_tienda_wordpress, editar_integraciones_wordpress, controlar_extensiones_wordpress

Markdown

O que permite fazer?

O WooCommerce é uma variante de um site WordPress: a ArduMaker o instala ao criar o site e depois permite operar a loja inteira com wp-cli (wp wc, o CLI do WooCommerce sobre sua API REST), como o admin do site.

  • Produtos e variações, categorias, tags, atributos e seus termos, e estoque.
  • Pedidos, notas de pedido e reembolsos.
  • Clientes e cupons.
  • Zonas de frete com seus métodos e locais, impostos e classes de imposto.
  • Gateways de pagamento e ajustes woocommerce_*.
  • Relatórios de vendas e produtos mais vendidos.
  • Webhooks do WooCommerce para outros sistemas.

Quando convém usar?

  • Uma loja própria no seu servidor, sem comissões de plataforma de loja.
  • Carregar ou atualizar catálogo e estoque a partir de um agente de IA.
  • Consultar vendas do mês sem entrar no painel do WordPress.

Como funciona na ArduMaker?

Ao criar o site com config.extras incluindo woocommerce, no passo configurar o plugin woocommerce é instalado e ativado a partir do wordpress.org; se o Elementor não foi pedido, o tema storefront também é ativado, e são criadas as páginas de loja, carrinho, finalizar compra e minha conta. Repetir não duplica nada. Um site trazido de um backup não recebe variantes: traz seus próprios plugins.

Cada operação sobre a loja é wp wc com um recurso e uma ação (listar, ver, crear, editar, eliminar). data.id identifica o objeto, data.parent o objeto do qual depende (produto de uma variação, pedido de um reembolso ou nota, zona de um método, atributo de um termo) e data.fields os campos da API do WooCommerce.

O que muda realmente?

As mudanças ficam no banco do site (wp<id>), igual a se fossem feitas pelo painel do WooCommerce. O estoque é um campo do produto (stock_quantity, manage_stock); o recurso inventario o lista para todos.

Esquema

  1. Agente ou painel: editar_tienda_wordpress
  2. Backend da ArduMaker: permissões e montagem do comando
  3. Agente do VPS: wp wc … como o usuário do site
  4. WooCommerce: banco wp<id>
Uma operação de loja

Resultado esperado

Cada chamada devolve o que o WooCommerce respondeu (o produto, o pedido, a lista). ver_reportes_tienda_wordpress devolve, para o período (por padrão o mês atual, até 1000 pedidos), pedidos, itens, receita, descontos, frete e impostos dos pedidos pagos ou em andamento, ou os produtos mais vendidos por quantidade.

Erros e resolução

  • wordpress_comando_fallido (422): wp wc respondeu com erro; a mensagem traz a saída cortada para corrigir o pedido.
  • O estoque usa o esquema antigo do wp wc: in_stock, não stock_status.
  • Um ajuste precisa se chamar woocommerce_<nome>.
  • Se a variante não pôde ser instalada ao criar o site, a operação falha wordpress_variantes_no_instaladas e pode ser repetida.

Relação com MCP

A loja é operada pelo domínio /mcp/wordpress (referência geral em /mcp/docs):

  • Leitura: ver_reportes_tienda_wordpress (sales ou top_sellers, com period ou date_min/date_max).
  • Escrita (marcada destrutiva porque inclui reembolsos e exclusões): editar_tienda_wordpress com resource e action.
  • Webhooks: editar_integraciones_wordpress (listar_webhooks, crear_webhook com nome, tópico, URL de entrega e segredo, eliminar_webhook).
  • Instalar a loja: instalar_app com app_type: wordpress e config.extras: ["woocommerce"], ou controlar_extensiones_wordpress para adicionar o plugin a um site existente.

É preciso poder alterar o site: um agente autorizado como somente leitura não vê editar_tienda_wordpress.

Funcionalidades relacionadas