Afilimax

Afilimax é uma biblioteca poderosa para Node.js que unifica a criação de links de afiliado para os maiores marketplaces do Brasil. Com uma única interface, você pode gerar links de afiliado para Amazon, Mercado Livre, Shopee, AliExpress e Magazine Luiza.

A biblioteca utiliza uma abordagem híbrida inteligente:

• Automação (Puppeteer): Para plataformas que não possuem uma API pública de afiliados fácil de usar ou requerem interação simulada (Amazon, Mercado Livre, Magazine Luiza).
• API Oficial: Para plataformas que fornecem APIs robustas (Shopee, AliExpress).

📦 Instalação

npm install afilimax

🚀 Como Usar

A classe principal Afilimax atua como um gerenciador central. Você a configura com as credenciais ou cookies das lojas que deseja utilizar e ela detecta automaticamente de qual loja é o link fornecido.

Exemplo Completo

import { Afilimax } from "afilimax"

// Exemplo de configuração (preencha apenas o que for usar)
const afilimax = new Afilimax({
    // 1. Amazon (Requer Cookies)
    amazon: {
        cookies: [
            { name: "session-id", value: "...", domain: ".amazon.com.br" },
            { name: "ubid-acbbr", value: "...", domain: ".amazon.com.br" },
            // ... exporte seus cookies do navegador
        ],
    },
  
    // 2. Mercado Livre (Requer Cookies)
    mercadoLivre: {
        cookies: [
            { name: "ssid", value: "...", domain: ".mercadolivre.com.br" },
            // ... exporte seus cookies do navegador
        ],
    },

    // 3. Shopee (Requer API Key)
    shopee: {
        appId: "SEU_APP_ID",
        appSecret: "SEU_APP_SECRET",
        subIds: ["campaign_1"], // Opcional: para rastreamento interno
    },

    // 4. AliExpress (Requer API Key)
    aliExpress: {
        appKey: "SEU_APP_KEY",
        appSecret: "SEU_APP_SECRET",
        trackingId: "SEU_TRACKING_ID",
    },

    // 5. Magazine Luiza (Requer Cookies + Slug da sua loja)
    magazineLuiza: {
        affiliateSlug: "nomedasualoja",
        cookies: [
            { name: "sacola", value: "...", domain: ".magazineluiza.com.br" },
            // ... exporte seus cookies do navegador
        ]
    }
})

async function generateLink() {
    try {
        const originalUrl = "https://www.amazon.com.br/dp/B088...XX"
        
        // O método detecta automaticamente que é um link da Amazon
        const affiliateUrl = await afilimax.createAffiliateUrl(originalUrl)
        
        console.log("Link gerado:", affiliateUrl)
    } catch (error) {
        console.error("Erro ao gerar link:", error)
    }
}

generateLink()

⚙️ Detalhes de Configuração por Plataforma

🟠 Amazon & 🟡 Mercado Livre

Estas plataformas utilizam Puppeteer para simular um navegador, logar (via cookies) e gerar o link através do painel de associados (SiteStripe no caso da Amazon).

• Cookies: É essencial exportar os cookies de uma sessão válida do seu navegador onde você já esteja logado na conta de afiliado. Extensões como "EditThisCookie" ou "Cookie-Editor" podem ajudar a extrair o JSON.
• Puppeteer Options: Você pode passar opções adicionais para o Puppeteer (como headless: false para debug) através da propriedade puppeteer na configuração.

🔵 Magazine Luiza (Parceiro Magalu)

Similar à Amazon/Mercado Livre, usa automação.

• affiliateSlug: O identificador da sua loja (ex: se sua loja é magazinevoce.com.br/minhaloja, o slug é minhaloja).
• Cookies: Necessários para "estar logado" e ter permissão de gerar links.

🟠 Shopee

Utiliza a Open Platform API da Shopee.

• Você precisará de uma conta de desenvolvedor/affiliate na Shopee Open Platform para obter o appId e appSecret.
• Suporta subIds para rastreamento de campanhas.

🔴 AliExpress

Utiliza a AliExpress Open Platform API.

• Exige credenciais de desenvolvedor (appKey, appSecret) e o seu trackingId de afiliado.

🛠️ TypeScript

A biblioteca é escrita inteiramente em TypeScript e fornece tipagens completas para todas as opções e retornos.

import { AfilimaxOptions, AmazonServiceOptions } from "afilimax"

⚠️ Notas Importantes

1. Cookies Expiram: Para os serviços baseados em Puppeteer/Cookies, lembre-se que cookies têm validade. Se o script parar de funcionar, provavelmente você precisa atualizar os cookies.
2. Segurança: Nunca comite suas credenciais ou cookies em repositórios públicos. Use variáveis de ambiente (process.env).
3. Desempenho: As chamadas via API (Shopee/AliExpress) são muito mais rápidas que as via Puppeteer. Para Amazon/ML/Magalu, o processo envolve abrir um navegador invisível, o que pode levar alguns segundos.

Domínios aceitos

| Plataforma | Domínios Suportados | | :--- | :--- | | Amazon | amazon.com, amazon.com.br, amzn.to, a.co | | Mercado Livre | mercadolivre.com.br, mercadolivre.com, mercadolibre.com.ar, mercadolibre.com.bo, mercadolibre.cl, mercadolibre.com.co, mercadolibre.co.cr, mercadolibre.com.do, mercadolibre.com.ec, mercadolibre.com.gt, mercadolibre.com.hn, mercadolibre.com.mx, mercadolibre.com.ni, mercadolibre.com.pa, mercadolibre.com.py, mercadolibre.com.pe, mercadolibre.com.sv, mercadolibre.com.uy, mercadolibre.com.ve | | Shopee | shopee.com.br, shopee.com | | AliExpress | aliexpress.com | | Magazine Luiza | magazineluiza.com.br, magazinevoce.com.br, magazineluiza.onelink.me |

Licença

Este projeto está sob a licença MIT.