Automação Lemon Squeezy

O que Automação Lemon Squeezy faz?

Gerencie seu negócio de produtos digitais Lemon Squeezy — acompanhe pedidos, monitore assinaturas, analise clientes, revise descontos e audite checkouts — tudo por meio de comandos em linguagem natural.

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

---

Configuração

1. Adicione o servidor MCP do Composio à 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 e, em seguida, recupere produtos e variantes de 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] (pending/draft/published)

---

2. Acompanhar 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 os itens individuais do pedido.

Ferramentas: LEMON_SQUEEZY_LIST_ALL_ORDERS, LEMON_SQUEEZY_LIST_ALL_ORDER_ITEMS

Exemplo de prompt:

"Mostre todos os pedidos de [email protected] 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 específico do pedido
• page[number] / page[size] — Paginação (máx. 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 avançadas de filtragem para acompanhar a 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 (ex.: 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áx. 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 e-mail [email protected]"

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áx. 100 por página)

---

5. Auditar Descontos e Resgates

Liste todos os códigos de desconto e acompanhe como foram resgatados nos pedidos.

Ferramentas: LEMON_SQUEEZY_LIST_ALL_DISCOUNTS, LEMON_SQUEEZY_LIST_ALL_DISCOUNT_REDEMPTIONS

Exemplo de prompt:

"Mostre todos os descontos da loja 12345 e seu histórico de resgates"

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 da 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 exige 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 conjuntos grandes de dados: Todos os endpoints de listagem usam paginação page[number] / page[size] (máx. 100 por página). Não presuma que a primeira página está completa.
• Nomeação de parâmetros de filtro: Lemon Squeezy usa notação de colchetes para filtros (ex.: filter[store_id], page[number]). Certifique-se de usar nomes de parâmetros exatos.
• Faturas de assinatura vs. pedidos: Faturas de assinatura (LEMON_SQUEEZY_LIST_ALL_SUBSCRIPTION_INVOICES) são separadas de pedidos únicos. Use o endpoint apropriado para seu caso de uso.

---

Referência Rápida

Ação	Slug da Ferramenta	Parâmetros Obrigatórios
Listar lojas	LEMON_SQUEEZY_LIST_ALL_STORES	Nenhum
Listar produtos	LEMON_SQUEEZY_LIST_ALL_PRODUCTS	Nenhum (filtros opcionais)
Listar variantes	LEMON_SQUEEZY_LIST_ALL_VARIANTS	Nenhum (filtros opcionais)
Listar pedidos	LEMON_SQUEEZY_LIST_ALL_ORDERS	Nenhum (filtros opcionais)
Listar itens de pedido	LEMON_SQUEEZY_LIST_ALL_ORDER_ITEMS	Nenhum (filtros opcionais)
Listar assinaturas	LEMON_SQUEEZY_LIST_ALL_SUBSCRIPTIONS	Nenhum (filtros opcionais)
Listar clientes	LEMON_SQUEEZY_LIST_ALL_CUSTOMERS	Nenhum (filtros opcionais)
Listar descontos	LEMON_SQUEEZY_LIST_ALL_DISCOUNTS	Nenhum (filtros opcionais)
Listar resgates de desconto	LEMON_SQUEEZY_LIST_ALL_DISCOUNT_REDEMPTIONS	Nenhum (filtros opcionais)
Listar checkouts	LEMON_SQUEEZY_LIST_ALL_CHECKOUTS	Nenhum (filtros opcionais)

---

Desenvolvido por Composio