affiliate-marketplaces

Crawlers de listas de afiliados (Mercado Livre hoje; extensível para Amazon e outros marketplaces).

Package Information

Released: 5 mo ago
Downloads: 37 weekly / 93 monthly
Latest Version: 0.1.6
Author: fabcovalesci

Available Nodes

Affiliate Marketplace List icon
Affiliate Marketplace List
Mercado Livre: lista social / ofertas e URLs de hub de favoritos (convertidas para lista social pública). Amazon reservado para versões futuras.

Documentation

@fabcovalesci/n8n-nodes-affiliate-marketplaces

Pacote n8n Community Node: crawl de listas do Mercado Livre (grid Nordic em __NORDIC_RENDERING_CTX__) via fetch nativo — Node 18+.

Inclui marketplace Mercado Livre e Amazon (em breve) no painel do nó.

Repositório / pasta de trabalho

Trate esta pasta (onde está este README.md e o package.json do pacote) como raiz do projeto Git que você versiona e publica no npm.

.
├── README.md
├── package.json
├── lib/
│   └── mercadolivreSocialList.js
├── nodes/
│   └── AffiliateMarketplaceList/
│       ├── AffiliateMarketplaceList.node.js
│       └── icon.svg
└── scripts/
    └── smoke-url.js

Instalar dependências

npm install

(Não há runtime deps além do peer n8n-workflow, já resolvido pelo n8n.)

URLs suportadas

Modo no nó Exemplo
Lista de afiliados https://www.mercadolivre.com.br/social/NICK/lists/UUID?matt_tool=…
Catálogo / ofertas https://www.mercadolivre.com.br/ofertas?category=MLB5672&page=1
Hub favoritos (myaccount) https://myaccount.mercadolivre.com.br/bookmarks/wishlist/hub/detail/UUID → o crawl usa a lista pública www…/social/NICK/lists/UUID

Hub myaccount não é público (403). Informe o nick da lista social em:

  • campo Nick na lista social no nó, ou
  • …/detail/UUID?nickname=NICK, ou
  • env MERCADOLIVRE_SOCIAL_NICKNAME.

Publicar no npm

npm publish --access public

(publishConfig.access já está public no package.json.)

Instalar no n8n (Community Nodes)

Settings → Community Nodes → Install → @fabcovalesci/n8n-nodes-affiliate-marketplaces

Desenvolvimento local (npm link)

Na pasta do pacote:

npm link

No host onde roda o n8n (ajuste o caminho conforme sua instalação):

npm link @fabcovalesci/n8n-nodes-affiliate-marketplaces

Reinicie o n8n. O nó aparece como Affiliate Marketplace List.

Parâmetros do nó

  1. Marketplace — Mercado Livre ou Amazon (em breve).
  2. Mercado Livre · tipo de página — Lista de afiliados ou Catálogo / ofertas (pageSource na saída: affiliate ou catalog).
  3. URL da página — ver tabela acima; fragmento #… é ignorado ao paginar.
  4. Nick na lista social — só para URLs myaccount…/bookmarks/…/detail/….
  5. Máximo de páginas — default 250, teto 500 (?page=N).

Saída JSON

products, itemsCollected, pageSource, listUrl (URL efetiva após resolver hub → social), totalDeclared, campos de paginação, etc.

Teste pela CLI (sem n8n)

npm run test:lib
npm run smoke:url -- "<URL>" [affiliate|catalog] [maxPages] [socialNickname]

Exemplos:

npm run smoke:url -- "https://www.mercadolivre.com.br/ofertas?category=MLB5672&page=1" catalog 1
npm run smoke:url -- "https://myaccount.mercadolivre.com.br/bookmarks/wishlist/hub/detail/UUID?nickname=SEU_NICK" affiliate 5

Licença

MIT

Discussion