@comandosai/n8n-nodes-rss-bridge 0.1.1

package/README.md

@@ -0,0 +1,62 @@
+# Commandos RSS (кастомная нода n8n)
+
+Нода выполняет два последовательных запроса в Commandos API: `detect`, затем `collect`.
+Оба запроса должны работать синхронно через вебхук `comandos_rss`.
+
+## Где находится
+
+- Код ноды: `/root/sandbox/nodes/rss-bridge`
+- Пакет: `@comandosai/n8n-nodes-rss-bridge`
+
+## Требования
+
+- n8n (dev окружение)
+- Node.js 18+
+- Доступ к Commandos API (`https://api.comandos.ai`)
+- `RSS_BRIDGE` включён в `SYNC_PROCESS_TYPES` на API (иначе API вернёт `taskId` вместо ответа).
+
+## Доступ
+
+Нода работает только через Commandos API и требует лицензионный ключ.
+Без ключа запросы не будут выполнены.
+
+## Подключение в n8n-dev
+
+В `docker-compose` уже настроено:
+
+- монтирование `/root/sandbox/nodes` в `/custom/commandos`
+- переменная `N8N_CUSTOM_EXTENSIONS=/custom/commandos`
+
+После изменений перезапусти n8n.
+
+## Credentials
+
+Тип: `Commandos API`
+
+Поля:
+- `License Key` — передаётся как `X-License-Key` в API
+
+## Параметры
+
+- `URL список` — строка с URL, разделители: перенос строки, запятая, точка с запятой
+- `Период` — `Часы` или `Дни`
+- `Значение периода (0-100)` — 0 отключает фильтрацию
+- `Точка отсчета (ISO, опционально)` — если не задано, используется текущее время сервера
+
+## Выход
+
+```json
+{
+  "detect": { ... },
+  "collect": { ... }
+}
+```
+
+## Сборка
+
+```bash
+npm install
+npm run build
+```
+
+После сборки перезапусти n8n, чтобы нода появилась в списке.

package/RSS.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128">
+  <rect width="128" height="128" rx="16" fill="#ff8a00" />
+  <circle cx="32" cy="96" r="10" fill="#ffffff" />
+  <path d="M24 68a36 36 0 0 1 36 36" fill="none" stroke="#ffffff" stroke-width="12" stroke-linecap="round" />
+  <path d="M24 44a60 60 0 0 1 60 60" fill="none" stroke="#ffffff" stroke-width="12" stroke-linecap="round" />
+</svg>

package/credentials/ComandosApi.credentials.ts

@@ -0,0 +1,19 @@
+import type { ICredentialType, INodeProperties } from 'n8n-workflow';
+
+export class ComandosApi implements ICredentialType {
+  name = 'comandosApi';
+  displayName = 'Comandos API';
+  documentationUrl = 'https://api.comandos.ai';
+  properties: INodeProperties[] = [
+    {
+      displayName: 'License Key',
+      name: 'licenseKey',
+      type: 'string',
+      default: '',
+      required: true,
+      typeOptions: {
+        password: true,
+      },
+    },
+  ];
+}

package/dist/credentials/ComandosApi.credentials.d.ts

@@ -0,0 +1,7 @@
+import type { ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class ComandosApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+}

package/dist/credentials/ComandosApi.credentials.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ComandosApi = void 0;
+class ComandosApi {
+    constructor() {
+        this.name = 'comandosApi';
+        this.displayName = 'Comandos API';
+        this.documentationUrl = 'https://api.comandos.ai';
+        this.properties = [
+            {
+                displayName: 'License Key',
+                name: 'licenseKey',
+                type: 'string',
+                default: '',
+                required: true,
+                typeOptions: {
+                    password: true,
+                },
+            },
+        ];
+    }
+}
+exports.ComandosApi = ComandosApi;

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import { ComandosRssBridge } from './nodes/ComandosRssBridge.node';
+import { ComandosApi } from './credentials/ComandosApi.credentials';
+export { ComandosRssBridge, ComandosApi };

package/dist/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ComandosApi = exports.ComandosRssBridge = void 0;
+const ComandosRssBridge_node_1 = require("./nodes/ComandosRssBridge.node");
+Object.defineProperty(exports, "ComandosRssBridge", { enumerable: true, get: function () { return ComandosRssBridge_node_1.ComandosRssBridge; } });
+const ComandosApi_credentials_1 = require("./credentials/ComandosApi.credentials");
+Object.defineProperty(exports, "ComandosApi", { enumerable: true, get: function () { return ComandosApi_credentials_1.ComandosApi; } });

package/dist/nodes/ComandosRssBridge.node.d.ts

@@ -0,0 +1,5 @@
+import type { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class ComandosRssBridge implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/dist/nodes/ComandosRssBridge.node.js

@@ -0,0 +1,171 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ComandosRssBridge = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const COMANDOS_API_URL = String(process.env.COMANDOS_API_BASE_URL || process.env.COMMANDOS_API_BASE_URL || "https://api.comandos.ai").trim();
+const splitUrls = (raw) => raw
+    .split(/[\n,;]+/)
+    .map((entry) => entry.trim())
+    .filter((entry) => entry.length > 0);
+const normalizeUrls = (value) => {
+    if (Array.isArray(value)) {
+        return value.map((entry) => String(entry || '').trim()).filter((entry) => entry.length > 0);
+    }
+    if (typeof value === 'string') {
+        return splitUrls(value);
+    }
+    return [];
+};
+const normalizeSinceValue = (value, itemIndex, node) => {
+    if (typeof value === 'number' && Number.isFinite(value)) {
+        return value;
+    }
+    const raw = String(value || '').trim();
+    if (raw === '') {
+        return 0;
+    }
+    if (!/^\d+$/.test(raw)) {
+        throw new n8n_workflow_1.NodeOperationError(node.getNode(), 'Значение периода должно быть числом', {
+            itemIndex,
+        });
+    }
+    return Number(raw);
+};
+class ComandosRssBridge {
+    constructor() {
+        this.description = {
+            displayName: 'Comandos RSS',
+            name: 'comandosRssBridge',
+            group: ['transform'],
+            version: 1,
+            description: 'Последовательные запросы detect + collect через Comandos API',
+            defaults: {
+                name: 'Comandos RSS',
+            },
+            icon: 'file:RSSS.png',
+            inputs: ['main'],
+            outputs: ['main'],
+            credentials: [
+                {
+                    name: 'comandosApi',
+                    required: true,
+                },
+            ],
+            properties: [
+                {
+                    displayName: 'URL список',
+                    name: 'urls',
+                    type: 'string',
+                    default: '',
+                    placeholder: 'https://t.me/ai_comandos\nhttps://www.youtube.com/@kokorevinvest',
+                    typeOptions: {
+                        rows: 6,
+                    },
+                    description: 'URL можно разделять переносом строки, запятой или точкой с запятой',
+                },
+                {
+                    displayName: 'Период',
+                    name: 'sinceUnit',
+                    type: 'options',
+                    options: [
+                        { name: 'Часы', value: 'hours' },
+                        { name: 'Дни', value: 'days' },
+                    ],
+                    default: 'days',
+                },
+                {
+                    displayName: 'Значение периода (0-100)',
+                    name: 'sinceValue',
+                    type: 'number',
+                    default: 5,
+                },
+                {
+                    displayName: 'Точка отсчета (ISO, опционально)',
+                    name: 'now',
+                    type: 'string',
+                    default: '',
+                    placeholder: '2026-01-03T12:00:00+00:00',
+                },
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const credentials = await this.getCredentials('comandosApi');
+        const licenseKey = String(credentials.licenseKey || '').trim();
+        if (!licenseKey) {
+            throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Лицензионный ключ обязателен');
+        }
+        const results = [];
+        for (let i = 0; i < items.length; i += 1) {
+            const rawUrls = this.getNodeParameter('urls', i);
+            const sinceUnit = String(this.getNodeParameter('sinceUnit', i) || 'days');
+            const sinceValue = normalizeSinceValue(this.getNodeParameter('sinceValue', i), i, this);
+            const now = String(this.getNodeParameter('now', i) || '').trim();
+            const urls = normalizeUrls(rawUrls);
+            if (urls.length === 0) {
+                throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Нужно указать хотя бы один URL', {
+                    itemIndex: i,
+                });
+            }
+            if (sinceValue < 0 || sinceValue > 100) {
+                throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Значение периода должно быть в диапазоне 0-100', {
+                    itemIndex: i,
+                });
+            }
+            const detectResponse = await this.helpers.request({
+                method: 'POST',
+                url: `${COMANDOS_API_URL}/tasks`,
+                json: true,
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-License-Key': licenseKey,
+                },
+                body: {
+                    process_type: 'RSS_BRIDGE',
+                    payload: {
+                        action: 'detect',
+                        urls,
+                    },
+                },
+            });
+            if (detectResponse && detectResponse.taskId) {
+                throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'RSS_BRIDGE должен работать синхронно. Добавьте RSS_BRIDGE в SYNC_PROCESS_TYPES на API.', { itemIndex: i });
+            }
+            const detections = Array.isArray(detectResponse === null || detectResponse === void 0 ? void 0 : detectResponse.detections)
+                ? detectResponse.detections
+                : [];
+            const collectPayload = {
+                action: 'collect',
+                urls,
+                detections,
+                since_value: sinceValue,
+                since_unit: sinceUnit,
+            };
+            if (now) {
+                collectPayload.now = now;
+            }
+            const collectResponse = await this.helpers.request({
+                method: 'POST',
+                url: `${COMANDOS_API_URL}/tasks`,
+                json: true,
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-License-Key': licenseKey,
+                },
+                body: {
+                    process_type: 'RSS_BRIDGE',
+                    payload: collectPayload,
+                },
+            });
+            results.push({
+                json: {
+                    detect: detectResponse,
+                    collect: collectResponse,
+                },
+            });
+        }
+        return [results];
+    }
+}
+exports.ComandosRssBridge = ComandosRssBridge;

package/index.ts

@@ -0,0 +1,4 @@
+import { ComandosRssBridge } from './nodes/ComandosRssBridge.node';
+import { ComandosApi } from './credentials/ComandosApi.credentials';
+
+export { ComandosRssBridge, ComandosApi };

package/nodes/ComandosRssBridge.node.ts

@@ -0,0 +1,195 @@
+import type {
+  IDataObject,
+  IExecuteFunctions,
+  INodeExecutionData,
+  INodeType,
+  INodeTypeDescription,
+} from 'n8n-workflow';
+import { NodeOperationError } from 'n8n-workflow';
+
+const COMANDOS_API_URL = String(process.env.COMANDOS_API_BASE_URL || process.env.COMMANDOS_API_BASE_URL || "https://api.comandos.ai").trim();
+
+const splitUrls = (raw: string): string[] =>
+  raw
+    .split(/[\n,;]+/)
+    .map((entry) => entry.trim())
+    .filter((entry) => entry.length > 0);
+
+const normalizeUrls = (value: unknown): string[] => {
+  if (Array.isArray(value)) {
+    return value.map((entry) => String(entry || '').trim()).filter((entry) => entry.length > 0);
+  }
+  if (typeof value === 'string') {
+    return splitUrls(value);
+  }
+  return [];
+};
+
+const normalizeSinceValue = (value: unknown, itemIndex: number, node: IExecuteFunctions): number => {
+  if (typeof value === 'number' && Number.isFinite(value)) {
+    return value;
+  }
+  const raw = String(value || '').trim();
+  if (raw === '') {
+    return 0;
+  }
+  if (!/^\d+$/.test(raw)) {
+    throw new NodeOperationError(node.getNode(), 'Значение периода должно быть числом', {
+      itemIndex,
+    });
+  }
+  return Number(raw);
+};
+
+export class ComandosRssBridge implements INodeType {
+  description: INodeTypeDescription = {
+    displayName: 'Comandos RSS',
+    name: 'comandosRssBridge',
+    group: ['transform'],
+    version: 1,
+    description: 'Последовательные запросы detect + collect через Comandos API',
+    defaults: {
+      name: 'Comandos RSS',
+    },
+    icon: 'file:RSSS.png',
+    inputs: ['main'],
+    outputs: ['main'],
+    credentials: [
+      {
+        name: 'comandosApi',
+        required: true,
+      },
+    ],
+    properties: [
+      {
+        displayName: 'URL список',
+        name: 'urls',
+        type: 'string',
+        default: '',
+        placeholder: 'https://t.me/ai_comandos\nhttps://www.youtube.com/@kokorevinvest',
+        typeOptions: {
+          rows: 6,
+        },
+        description: 'URL можно разделять переносом строки, запятой или точкой с запятой',
+      },
+      {
+        displayName: 'Период',
+        name: 'sinceUnit',
+        type: 'options',
+        options: [
+          { name: 'Часы', value: 'hours' },
+          { name: 'Дни', value: 'days' },
+        ],
+        default: 'days',
+      },
+      {
+        displayName: 'Значение периода (0-100)',
+        name: 'sinceValue',
+        type: 'number',
+        default: 5,
+      },
+      {
+        displayName: 'Точка отсчета (ISO, опционально)',
+        name: 'now',
+        type: 'string',
+        default: '',
+        placeholder: '2026-01-03T12:00:00+00:00',
+      },
+    ],
+  };
+
+  async execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]> {
+    const items = this.getInputData();
+    const credentials = await this.getCredentials('comandosApi');
+    const licenseKey = String(credentials.licenseKey || '').trim();
+
+    if (!licenseKey) {
+      throw new NodeOperationError(this.getNode(), 'Лицензионный ключ обязателен');
+    }
+
+    const results: INodeExecutionData[] = [];
+
+    for (let i = 0; i < items.length; i += 1) {
+      const rawUrls = this.getNodeParameter('urls', i);
+      const sinceUnit = String(this.getNodeParameter('sinceUnit', i) || 'days');
+      const sinceValue = normalizeSinceValue(this.getNodeParameter('sinceValue', i), i, this);
+      const now = String(this.getNodeParameter('now', i) || '').trim();
+      const urls = normalizeUrls(rawUrls);
+
+      if (urls.length === 0) {
+        throw new NodeOperationError(this.getNode(), 'Нужно указать хотя бы один URL', {
+          itemIndex: i,
+        });
+      }
+      if (sinceValue < 0 || sinceValue > 100) {
+        throw new NodeOperationError(this.getNode(), 'Значение периода должно быть в диапазоне 0-100', {
+          itemIndex: i,
+        });
+      }
+
+      const detectResponse = await this.helpers.request({
+        method: 'POST',
+        url: `${COMANDOS_API_URL}/tasks`,
+        json: true,
+        headers: {
+          'Content-Type': 'application/json',
+          'X-License-Key': licenseKey,
+        },
+        body: {
+          process_type: 'RSS_BRIDGE',
+          payload: {
+            action: 'detect',
+            urls,
+          },
+        },
+      });
+
+      if (detectResponse && (detectResponse as IDataObject).taskId) {
+        throw new NodeOperationError(
+          this.getNode(),
+          'RSS_BRIDGE должен работать синхронно. Добавьте RSS_BRIDGE в SYNC_PROCESS_TYPES на API.',
+          { itemIndex: i },
+        );
+      }
+
+      const detections = Array.isArray((detectResponse as IDataObject)?.detections)
+        ? ((detectResponse as IDataObject).detections as IDataObject[])
+        : [];
+
+      const collectPayload: IDataObject = {
+        action: 'collect',
+        urls,
+        detections,
+        since_value: sinceValue,
+        since_unit: sinceUnit,
+      };
+
+      if (now) {
+        collectPayload.now = now;
+      }
+
+      const collectResponse = await this.helpers.request({
+        method: 'POST',
+        url: `${COMANDOS_API_URL}/tasks`,
+        json: true,
+        headers: {
+          'Content-Type': 'application/json',
+          'X-License-Key': licenseKey,
+        },
+        body: {
+          process_type: 'RSS_BRIDGE',
+          payload: collectPayload,
+        },
+      });
+
+      results.push({
+        json: {
+          detect: detectResponse as IDataObject,
+          collect: collectResponse as IDataObject,
+        },
+      });
+    }
+
+    return [results];
+  }
+}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@comandosai/n8n-nodes-rss-bridge",
+  "version": "0.1.1",
+  "description": "Comandos RSS Bridge custom node",
+  "author": "Comandos AI",
+  "license": "UNLICENSED",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.json && mkdir -p dist/nodes && cp -f RSSS.png dist/nodes/"
+  },
+  "dependencies": {
+    "n8n-workflow": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^18.19.0",
+    "typescript": "^5.4.5"
+  },
+  "n8n": {
+    "nodes": [
+      "dist/nodes/ComandosRssBridge.node.js"
+    ],
+    "credentials": [
+      "dist/credentials/ComandosApi.credentials.js"
+    ]
+  }
+}

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2019",
+    "module": "CommonJS",
+    "lib": ["ES2019"],
+    "declaration": true,
+    "outDir": "./dist",
+    "rootDir": ".",
+    "strict": true,
+    "esModuleInterop": true,
+    "resolveJsonModule": true,
+    "skipLibCheck": true
+  },
+  "include": ["nodes/**/*.ts", "credentials/**/*.ts", "index.ts"]
+}