n8n-node-shopee-afiliado

Visão geral

n8n-node-shopee-afiliado é um node customizado para o n8n que permite integrar de forma simples e segura a API de afiliados da Shopee aos seus fluxos de automação. Com ele, você pode:

• Consultar produtos, categorias e lojas da Shopee.
• Gerar links de afiliado curtos e rastreáveis.
• Recuperar informações de comissão e estatísticas de campanhas.
• Automatizar processos de marketing (ex.: postagem automática em redes sociais, atualização de planilhas, disparo de newsletters).

Por que usar?

• Elimina a necessidade de escrever código manual para lidar com a autenticação OAuth 2.0 da Shopee.
• Mantém a lógica de chamada à API centralizada e reutilizável em vários workflows.
• Compatível com a versão LTS do n8n (v1.x) e pode ser facilmente instalado via npm.

Principais funcionalidades

Funcionalidade	Descrição
Autenticação OAuth 2.0	Gerencia refresh token e acessos automáticos.
Buscar produtos	Filtra por ID, palavra‑chave, categoria, preço, etc.
Gerar links de afiliado	Cria URLs curtos com tracking ID.
Obter comissões	Consulta métricas de performance da sua conta de afiliado.
Gerenciamento de campanhas	Cria, atualiza e lista campanhas existentes.
Suporte a Rate‑Limit	Implementa retry automático com back‑off exponencial.

Instalação

npm install
npm run build

Operações disponíveis

Operação	Descrição	Principais parâmetros
Get Offers	Recupera ofertas de produtos com base em itemId, listType e demais filtros.	itemId (único), listType, matchId, keyword, shopId, productCatId, sortType, page, limit, isAMSOffer, isKeySeller, shortlink, thumbnail
Search Products	Busca produtos por palavra‑chave.	keyword, shopId, productCatId, sortType, page, limit, isAMSOffer, isKeySeller, shortlink, thumbnail

Propriedades comuns (reutilizadas)

• keyword – Busca produtos pelo nome.
• shopId – Filtra produtos de uma loja específica.
• productCatId – Filtra por categoria Shopee.
• sortType – Tipo de ordenação (Relevance, Items Sold, Price Desc/Asc, Commission Desc).
• page – Número da página da consulta.
• limit – Quantidade máxima de produtos retornados.
• isAMSOffer – Filtra ofertas com comissão AMS.
• isKeySeller – Filtra ofertas de sellers principais da Shopee.
• shortlink – Gera links curtos de afiliado (opcional, pode aumentar o tempo de execução).
• thumbnail – Adiciona fórmula IMAGE para Google Sheets.

Parâmetros específicos de Get Offers

• itemId – Busca um produto específico pelo ID.
• listType – Tipo de lista de ofertas (All, Top Performing, Landing Category, Detail Category, Detail Shop).
• matchId – Valor de matchId correspondente ao listType (CategoryId ou ShopId).

Credenciais

Crie uma credencial chamada Shopee Affiliate API com o partner_id e api_key fornecidos pela Shopee.

Testes

Testes unitários foram adicionados em nodes/ShopeeAffiliate/actions/__tests__/ usando Jest. Execute-os com:

npm test

Observação de desempenho

A opção Short Link faz requisições adicionais à API para gerar links curtos e pode aumentar o tempo de execução da operação.

---

Para mais detalhes, consulte a documentação oficial da Shopee Affiliate API.