O que shopifyql-skill faz?
Habilidade de ShopifyQL e Linguagem de Consulta de Segmento para Claude Code — escreva, depure e explique consultas de análise do Shopify e filtros de segmento de clientes.
Visão Geral
Esta habilidade permite que o Claude Code entenda e trabalhe com duas linguagens de consulta específicas do ecossistema Shopify:
- ShopifyQL: Linguagem de consulta analítica para métricas de negócio como vendas, tráfego e inventário.
- Segment Query Language: Linguagem para definir segmentos de clientes com base em comportamento, atributos e histórico de pedidos.
Sintaxe Básica do ShopifyQL
-- Exemplo de consulta ShopifyQL
SHOW sales BY product SINCE -30d UNTIL TODAY
-- Agrupamento por região
SHOW sales BY region SINCE last_month
Cláusulas Principais
| Cláusula | Descrição |
|---|---|
SHOW | Especifica a métrica desejada |
BY | Define a dimensão de agrupamento |
SINCE | Data de início do período |
UNTIL | Data de fim do período (opcional) |
WHERE | Filtros condicionais |
ORDER BY | Ordenação dos resultados |
LIMIT | Número máximo de linhas |
Linguagem de Consulta de Segmento
A linguagem de segmento usa operadores e funções para definir públicos:
// Exemplo: Clientes que compraram mais de 3 vezes nos últimos 60 dias
customer.purchase_count >= 4 AND customer.last_purchase_date >= -60d
Operadores
=(igual)!=(diferente)>=/<=(maior ou igual / menor ou igual)>/<(maior que / menor que)IN(em lista)NOT IN(não em lista)
Funções Comuns
| Função | Descrição |
|---|---|
customer.purchase_count | Número total de compras do cliente |
customer.last_purchase_date | Data da última compra |
customer.total_spent | Valor total gasto pelo cliente |
product.tags | Tags do produto |
order.subtotal | Subtotal do pedido |
Uso no Claude Code
Para usar esta habilidade, basta descrever em linguagem natural o que você precisa:
"Mostre as vendas dos últimos 30 dias agrupadas por categoria de produto"
"Crie um segmento de clientes que gastaram mais de R$500 nos últimos 90 dias"
"Depure esta consulta ShopifyQL: SHOW sales BY customer SINCE -90d"
Exemplos de Conversão
Consulta em Linguagem Natural → ShopifyQL
Entrada: "Quero ver os 10 produtos mais vendidos esta semana"
Saída:
SHOW sales BY product SINCE -7d ORDER BY sales DESC LIMIT 10
Descrição de Segmento → Query
Entrada: "Clientes que não compraram nos últimos 6 meses mas já gastaram mais de R$1000"
Saída:
customer.last_purchase_date <= -180d AND customer.total_spent > 1000
Depuração e Explicação
A habilidade também pode:
- Identificar erros de sintaxe em consultas existentes
- Explicar o significado de cada cláusula em uma consulta complexa
- Sugerir otimizações de performance
- Converter entre linguagem natural e ShopifyQL/segmento
Plataformas Suportadas
- Claude Code (modelo de linha de comando)
- Compatível com Cursor, Codex e outros agentes de IA que suportam skills markdown
Contribuição
Contribuições são bem-vindas! Abra uma issue ou pull request no repositório do GitHub.
Licença
MIT