🚀 AfiliMax CLI

Interface de Linha de Comando (CLI) modular em TypeScript para gerenciamento de credenciais e geração automática de links de afiliados.

📌 Sumário

Recursos
Instalação
Plataformas Suportadas
Uso e Comandos
Métodos de Captura de Cookies (Amazon & Mercado Livre)
Armazenamento Local
Desenvolvimento
Licença

✨ Recursos

🔗 Detecção Automática de Plataforma: Envie qualquer URL de produto e a CLI identifica automaticamente o provedor correto.
🔍 Scraping & Pesquisa de Produtos: Scraping de dados detalhados e pesquisa com navegação paginada no terminal (Amazon, Mercado Livre e AliExpress).
⚡ Geração Instantânea de Afiliado: Crie links de afiliados diretamente a partir dos resultados de busca ou de produtos extraídos.
🍪 Gerenciamento Inteligente de Cookies: Suporte a exportação de cookies via extensão do navegador (recomendado) ou via navegador automatizado (Puppeteer).
🔒 Validação de Expiração: Alerta automático sobre a data de expiração dos cookies salvos.
🎨 Interface Rica no Terminal: Banners ASCII estilizados, relatórios em formato de cartão e mensagens coloridas no padrão ANSI.
📁 Configuração Persistente: Salva com segurança todas as credenciais em ~/.afilimax/config.json.

📦 Instalação

# Instalação global via NPM
npm install -g @afilimax/cli

# Ou execução direta via npx
npx @afilimax/cli --help

🛒 Plataformas Suportadas

Plataforma	Autenticação Exigida	Método de Autenticação
Amazon Associates	Cookies de Sessão	Extensão do Chrome (recomendado) ou Login em Navegador
Mercado Livre Afiliados	Tag/Slug do Afiliado + Cookies	Extensão do Chrome (recomendado) ou Login em Navegador
Shopee Afiliados	App ID + App Secret (+ Sub IDs opcionais)	Parâmetros de linha de comando
AliExpress Open Platform	App Key + App Secret + Tracking ID	Parâmetros de linha de comando
Magazine Luiza (Parceiro Magalu)	Slug do Afiliado + Cookies	Extensão do Chrome (recomendado) ou Login em Navegador

🚀 Uso e Comandos

1. Geração de Links (`create`)

Você pode usar o comando genérico create fornecendo apenas a URL. A plataforma é detectada automaticamente:

afilimax create "https://www.mercadolivre.com.br/p/MLB22649400"
afilimax create "https://www.amazon.com.br/dp/B0D1VHJVS9/"

Ou você pode utilizar os subcomandos explícitos para cada plataforma:

# Amazon (alias: amz)
afilimax create amazon <url>

# Mercado Livre (alias: ml)
afilimax create mercado-livre <url>

# Shopee (alias: sh)
afilimax create shopee <url>

# AliExpress (alias: ali)
afilimax create aliexpress <url>

# Magazine Luiza (alias: magalu, mlz, luiza)
afilimax create magazine-luiza <url>

2. Scraping & Pesquisa de Produtos (`scrape`)

O comando scrape integra as bibliotecas @afilimax/amazon-scraper, @afilimax/mercado-livre-scraper e @afilimax/aliexpress-scraper para extração de dados e busca de produtos com menu interativo e geração de links de afiliados.

📦 Scraping de Produto Individual (`scrape product`)

Extrai os dados estruturados de um produto diretamente a partir da sua URL:

# Detecta a plataforma automaticamente (Amazon, Mercado Livre ou AliExpress)
afilimax scrape product "https://www.mercadolivre.com.br/p/MLB22649400"
afilimax scrape product "https://www.amazon.com.br/dp/B0D1VHJVS9/"
afilimax scrape product "https://pt.aliexpress.com/item/1005009120888793.html"

# Atalho direto
afilimax scrape <url>

# Retorna os dados em formato JSON puro
afilimax scrape product <url> --json

# Gera o link de afiliado automaticamente ao finalizar
afilimax scrape product <url> --affiliate

🔍 Pesquisa de Produtos com Paginação Interativa (`scrape search`)

Pesquisa produtos em tempo real, permitindo navegar entre páginas e selecionar qualquer item para criar o link de afiliado instantaneamente:

# Pesquisa na Amazon (alias: amz)
afilimax scrape search amazon "echo dot"

# Pesquisa no Mercado Livre (alias: ml, mercadolivre)
afilimax scrape search mercado-livre "smart tv 55"

# Pesquisa no AliExpress (alias: ali)
afilimax scrape search aliexpress "fone bluetooth gamer"

Parâmetros e Opções:

<platform> (obrigatório): amazon (amz), mercado-livre (ml) ou aliexpress (ali).
<query> (obrigatório): Termo de pesquisa do produto.
-p, --page <number>: Página inicial (padrão: 1).
-l, --limit <number>: Quantidade de produtos por página (padrão: 10).
-j, --json: Modo não interativo que exporta os itens encontrados em formato JSON.

Recursos do Modo Interativo:

Digite o número correspondente ao produto (ex: 1) para gerar o link de afiliado na hora.
Pressione Enter ou n para avançar para a próxima página.
Digite p para retornar à página anterior.
Digite q para sair.

3. Visualização da Configuração (`config show`)

Para verificar o status das suas credenciais e a expiração dos cookies armazenados:

# Exibe um relatório legível no terminal
afilimax config show

# Alias equivalente
afilimax config ls

# Exibe o objeto JSON bruto de configuração
afilimax config show --json

4. Configuração de Credenciais (`config`)

🟡 Amazon Associates

afilimax config amazon
# ou alias: afilimax config amz

Siga as instruções interativas para colar o JSON de cookies exportado da extensão ou abrir o navegador.

🟡 Mercado Livre Afiliados

afilimax config mercado-livre
# ou alias: afilimax config ml

Solicita a sua Tag/Slug de afiliado e em seguida os cookies de sessão.

🟠 Shopee Afiliados

afilimax config shopee -i <appId> -s <appSecret> [-u <subIds...>]
# ou alias: afilimax config sh -i 18364590164 -s SUASECRET -u canal1 canal2

Flags disponíveis:

-i, --app-id <appId> (obrigatório): App ID do portal de Afiliados da Shopee.
-s, --app-secret <appSecret> (obrigatório): App Secret do portal.
-u, --sub-ids <subIds...> (opcional): Até 5 Sub IDs para rastreamento interno.

🔴 AliExpress Open Platform

afilimax config aliexpress -k <appKey> -s <appSecret> -t <trackingId>
# ou alias: afilimax config ali -k MINHAKEY -s MEUSECRET -t MEUTRACKINGID

Flags disponíveis:

-k, --app-key <appKey> (obrigatório): App Key do AliExpress Open Platform.
-s, --app-secret <appSecret> (obrigatório): App Secret do AliExpress Open Platform.
-t, --tracking-id <trackingId> (obrigatório): Tracking ID para atribuição das vendas.

🔵 Magazine Luiza (Parceiro Magalu)

afilimax config magazine-luiza
# ou aliases: afilimax config magalu | mlz | luiza

Solicita o Slug/Nome da loja do afiliado e em seguida os cookies de sessão.

🍪 Métodos de Captura de Cookies (Amazon, Mercado Livre & Magazine Luiza)

Para as plataformas que necessitam de sessão ativa (Amazon, Mercado Livre e Magazine Luiza), a CLI oferece duas abordagens:

Opção 1: Extensão do Chrome (Recomendada)

Instale a extensão no Chrome: Export Cookie JSON File.
Acesse o site oficial (ex: amazon.com.br ou mercadolivre.com.br) e faça seu login normalmente.
Clique na extensão e escolha Export cookies (um arquivo JSON será baixado).
Copie todo o conteúdo do arquivo baixado e cole no terminal quando solicitado (suporta colagem em múltiplas linhas).

Opção 2: Login via Navegador Integrado

Selecione a opção no menu interativo do CLI.
Uma janela isolada do Chromium será aberta.
Realize o login manualmente no site exibido.
O CLI detectará o encerramento ou a conclusão da sessão e salvará os cookies automaticamente.

📂 Armazenamento Local

Todas as configurações salvas ficam centralizadas no diretório do usuário:

Windows: C:\Users\<Usuario>\.afilimax\config.json
Linux/macOS: ~/.afilimax/config.json

🛠 Desenvolvimento

Caso queira contribuir ou executar a CLI em modo de desenvolvimento local:

# Clonar o repositório
git clone https://github.com/Afilimax/afilimax-cli.git
cd afilimax-cli

# Instalar dependências
npm install

# Executar em modo desenvolvimento (via tsx)
npm run dev -- [comando]
# Exemplo: npm run dev -- config show

# Formatar o código (Prettier)
npm run format

# Executar testes unitários (Vitest)
npm test

# Gerar build de produção
npm run build

🔗 Links Úteis

Repositório GitHub: https://github.com/Afilimax/afilimax-cli
Releases: https://github.com/Afilimax/afilimax-cli/releases
Reportar Erros / Issues: https://github.com/Afilimax/afilimax-cli/issues
Extensão de Cookies Recomendada: Export Cookie JSON File

📄 Licença

Desenvolvido por Marcuth sob a licença MIT.

Name		Name	Last commit message	Last commit date
.github		.github
__tests__		__tests__
src		src
.eslintrc.json		.eslintrc.json
.gitattributes		.gitattributes
.gitignore		.gitignore
.npmignore		.npmignore
.prettierrc.js		.prettierrc.js
GEMINI.md		GEMINI.md
LICENSE		LICENSE
README.md		README.md
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json

Navigation Menu

Repository navigation

About

Repository files navigation

🚀 AfiliMax CLI

📌 Sumário

✨ Recursos

📦 Instalação

🛒 Plataformas Suportadas

🚀 Uso e Comandos

1. Geração de Links (`create`)

2. Scraping & Pesquisa de Produtos (`scrape`)

📦 Scraping de Produto Individual (`scrape product`)

🔍 Pesquisa de Produtos com Paginação Interativa (`scrape search`)

3. Visualização da Configuração (`config show`)

4. Configuração de Credenciais (`config`)

🟡 Amazon Associates

🟡 Mercado Livre Afiliados

🟠 Shopee Afiliados

🔴 AliExpress Open Platform

🔵 Magazine Luiza (Parceiro Magalu)

🍪 Métodos de Captura de Cookies (Amazon, Mercado Livre & Magazine Luiza)

Opção 1: Extensão do Chrome (Recomendada)

Opção 2: Login via Navegador Integrado

📂 Armazenamento Local

🛠 Desenvolvimento

🔗 Links Úteis

📄 Licença

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

🚀 AfiliMax CLI

📌 Sumário

✨ Recursos

📦 Instalação

🛒 Plataformas Suportadas

🚀 Uso e Comandos

1. Geração de Links (create)

2. Scraping & Pesquisa de Produtos (scrape)

📦 Scraping de Produto Individual (scrape product)

🔍 Pesquisa de Produtos com Paginação Interativa (scrape search)

3. Visualização da Configuração (config show)

4. Configuração de Credenciais (config)

🟡 Amazon Associates

🟡 Mercado Livre Afiliados

🟠 Shopee Afiliados

🔴 AliExpress Open Platform

🔵 Magazine Luiza (Parceiro Magalu)

🍪 Métodos de Captura de Cookies (Amazon, Mercado Livre & Magazine Luiza)

Opção 1: Extensão do Chrome (Recomendada)

Opção 2: Login via Navegador Integrado

📂 Armazenamento Local

🛠 Desenvolvimento

🔗 Links Úteis

📄 Licença

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

1. Geração de Links (`create`)

2. Scraping & Pesquisa de Produtos (`scrape`)

📦 Scraping de Produto Individual (`scrape product`)

🔍 Pesquisa de Produtos com Paginação Interativa (`scrape search`)

3. Visualização da Configuração (`config show`)

4. Configuração de Credenciais (`config`)