cortex-filters

n8n node: HTTP Request with first-class fields for spatie/laravel-query-builder (filter, include, sort, fields, append, pagination).

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.2.3
Author: Plurinvest

Available Nodes

Documentation generating…

Cortex Filters icon
Cortex Filters
HTTP request with Spatie Query Builder fields (filter, include, sort, fields, append)

Documentation

n8n-nodes-cortex-filters

Community node do n8n: um HTTP Request com campos dedicados para o
spatie/laravel-query-builder —
filters, includes, sorts, fields, appends e paginação, sem montar query string na mão.

Campo no node Query string gerada
Filters (nome, operador opcional, valor) filter[nome]=valor · filter[nome][op]=valor
Includes include=posts,posts.comments
Sorts (campo + asc/desc) sort=-created_at,name
Select Fields (tabela opcional) fields[leads]=id,name — sem tabela, usa o recurso do endpoint (/leads → leads)
Appends append=full_name
Pagination (página única ou todas) page=1&per_page=50

Os nomes dos parâmetros (filter, include, sort, fields, append, page, per_page)
podem ser trocados em Options, caso você tenha alterado o config do Laravel.

Instalação no n8n

Pacote no npm: n8n-nodes-cortex-filters

Opção 1 — pela interface (recomendado)

  1. No n8n, vá em Settings → Community Nodes → Install.
  2. Digite o nome do pacote:
n8n-nodes-cortex-filters
  1. Marque a caixa de confirmação de risco e clique em Install.
  2. O node Cortex Filters aparece na busca de nodes.

Opção 2 — n8n self-hosted (npm / Docker)

Dentro da pasta de nodes do n8n (~/.n8n/nodes; no Docker, /home/node/.n8n/nodes):

mkdir -p ~/.n8n/nodes && cd ~/.n8n/nodes
npm install n8n-nodes-cortex-filters

Reinicie o n8n. No Docker, rode os mesmos comandos dentro do container (o volume precisa ser persistente):

docker compose exec n8n sh -c "mkdir -p /home/node/.n8n/nodes && cd /home/node/.n8n/nodes && npm install n8n-nodes-cortex-filters"
docker compose restart n8n

Instalar direto do GitHub (versão em desenvolvimento)

cd ~/.n8n/nodes && npm install github:Plurinvest/n8n-nodes-cortex-filters

Atualizar

Pela interface: Settings → Community Nodes → Update. Ou:

cd ~/.n8n/nodes && npm update n8n-nodes-cortex-filters

Uso

  1. (Opcional) Crie a credencial Cortex Filters API: Base URL + autenticação por Query Parameter (?api_token=…, o nome do parâmetro é editável), Bearer token ou header customizado.
  2. Adicione o node Cortex Filters, escolha o método e o endpoint (/users), ou uma URL completa.
  3. Preencha Filters / Includes / Sorts / Fields / Appends.
  4. Cada item de data na resposta vira um item de saída (mude em Options → Data Property).

Exemplo — GET /users com:

  • Filter status = active, Filter age operador gte valor 18
  • Includes posts,profile · Sort created_at desc · Fields users → id,name

gera:

/users?filter[status]=active&filter[age][gte]=18&include=posts,profile&sort=-created_at&fields[users]=id,name

O operador é opcional e só faz sentido se sua API tiver filtros customizados que aceitem filter[campo][op].
O Spatie puro usa apenas filter[campo]=valor.

Desenvolvimento

npm install
npm run build      # gera dist/ (que é versionado para permitir instalar via GitHub)

Para testar localmente: npm link nesta pasta e npm link n8n-nodes-cortex-filters em ~/.n8n/nodes.

Publicação automática

Todo push na main dispara o workflow .github/workflows/publish.yml: ele compila, publica no npm e,
se a versão do package.json já existir no npm, sobe o patch automaticamente (0.2.0 → 0.2.1) e
commita a nova versão de volta. Para uma versão minor/major, altere o version no package.json
antes do push. Requer o secret NPM_TOKEN no repositório (token granular com bypass de 2FA).

Licença

MIT

Discussion