Automação com Lemon Squeezy

Gerencie seu negócio de produtos digitais Lemon Squeezy -- rastreie pedidos, monitore assinaturas, analise clientes, revise descontos e audite checkouts -- tudo através de comandos em linguagem natural.

Documentação do Toolkit: composio.dev/toolkits/lemon_squeezy

Configuração

1. Adicione o servidor Composio MCP à configuração do seu cliente:

   https://rube.app/mcp
   

2. Conecte sua conta Lemon Squeezy quando solicitado (autenticação por chave de API).
3. Comece a emitir comandos em linguagem natural para gerenciar sua loja.

Fluxos de Trabalho Principais

1. Descobrir Lojas e Produtos

Liste todas as lojas para obter os IDs das lojas, em seguida, recupere produtos e variantes para uma loja específica.

Ferramentas: LEMON_SQUEEZY_LIST_ALL_STORES, LEMON_SQUEEZY_LIST_ALL_PRODUCTS, LEMON_SQUEEZY_LIST_ALL_VARIANTS

Exemplo de prompt:

"Liste todas as minhas lojas Lemon Squeezy e seus produtos"

Parâmetros principais:

• LEMON_SQUEEZY_LIST_ALL_STORES -- Nenhum parâmetro necessário
• LEMON_SQUEEZY_LIST_ALL_PRODUCTS -- Filtrar por filter[store_id]
• LEMON_SQUEEZY_LIST_ALL_VARIANTS -- Filtrar por filter[product_id], filter[status] (pendente/rascunho/publicado)

2. Rastrear Pedidos e Itens de Pedido

Recupere todos os pedidos com filtragem opcional por loja, e-mail do usuário ou número do pedido, e detalhe itens de pedido individuais.

Ferramentas: LEMON_SQUEEZY_LIST_ALL_ORDERS, LEMON_SQUEEZY_LIST_ALL_ORDER_ITEMS

Exemplo de prompt:

"Mostre todos os pedidos de johndoe@example.com na minha loja Lemon Squeezy"

Parâmetros principais para pedidos:

• filter[store_id] -- Filtrar por ID da loja
• filter[user_email] -- Filtrar por e-mail do cliente
• filter[order_number] -- Filtrar por número de pedido específico
• page[number] / page[size] -- Paginação (máximo de 100 por página)

Parâmetros principais para itens de pedido:

• filter[order_id], filter[product_id], filter[variant_id] -- Filtrar por entidade relacionada

3. Monitorar Assinaturas

Liste todas as assinaturas com opções ricas de filtragem para rastrear receita recorrente.

Ferramenta: LEMON_SQUEEZY_LIST_ALL_SUBSCRIPTIONS

Exemplo de prompt:

"Mostre todas as assinaturas ativas na minha loja Lemon Squeezy"

Parâmetros principais:

• filter[status] -- Filtrar por status (por exemplo, active, cancelled)
• filter[store_id] -- Filtrar por loja
• filter[product_id] -- Filtrar por produto
• filter[user_email] -- Filtrar por e-mail do assinante
• filter[variant_id] -- Filtrar por variante
• page[number] / page[size] -- Paginação (máximo de 100 por página)

4. Gerenciar Clientes

Recupere registros de clientes com detalhes incluindo e-mail, MRR, receita total e URLs do portal do cliente.

Ferramenta: LEMON_SQUEEZY_LIST_ALL_CUSTOMERS

Exemplo de prompt:

"Encontre o cliente Lemon Squeezy com o e-mail johndoe@example.com"

Parâmetros principais:

• filter[email] -- Filtrar por endereço de e-mail exato
• filter[store_id] -- Filtrar por ID da loja
• page[number] / page[size] -- Paginação (máximo de 100 por página)

5. Auditar Descontos e Resgates

Liste todos os códigos de desconto e rastreie como eles foram resgatados em pedidos.

Ferramentas: LEMON_SQUEEZY_LIST_ALL_DISCOUNTS, LEMON_SQUEEZY_LIST_ALL_DISCOUNT_REDEMPTIONS

Exemplo de prompt:

"Mostre todos os descontos para a loja 12345 e seu histórico de resgate"

Parâmetros principais para descontos:

• filter[store_id] -- Filtrar por loja
• page[number] / page[size] -- Paginação

Parâmetros principais para resgates:

• filter[discount_id] -- Filtrar por desconto
• filter[order_id] -- Filtrar por pedido

6. Revisar Checkouts

Liste todas as sessões de checkout com filtragem opcional por loja ou variante.

Ferramenta: LEMON_SQUEEZY_LIST_ALL_CHECKOUTS

Exemplo de prompt:

"Mostre todos os checkouts para a variante 42 na minha loja Lemon Squeezy"

Parâmetros principais:

• filter[store_id] -- Filtrar por ID da loja
• filter[variant_id] -- Filtrar por ID da variante

Armadilhas Conhecidas

• ID da loja é fundamental: A maioria dos filtros requer um store_id. Sempre chame LEMON_SQUEEZY_LIST_ALL_STORES primeiro para descobrir IDs de loja válidos antes de filtrar outros recursos.
• Paginação é obrigatória para grandes conjuntos de dados: Todos os endpoints de lista usam paginação page[number] / page[size] (máximo de 100 por página). Não assuma que a primeira página está completa.
• Nomenclatura de parâmetros de filtro: Lemon Squeezy usa notação de colchetes para filtros (por exemplo, filter[store_id], page[number]). Certifique-se de usar os nomes exatos dos parâmetros.

…