@seranking/n8n-nodes-seranking 1.5.10 → 1.5.13

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

@@ -1,5 +1,10 @@
-import { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+import { IExecuteFunctions, ILoadOptionsFunctions, INodeExecutionData, INodePropertyOptions, INodeType, INodeTypeDescription } from 'n8n-workflow';
 export declare class SeRanking implements INodeType {
     description: INodeTypeDescription;
+    methods: {
+        loadOptions: {
+            getAuditIssueCodes(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+        };
+    };
     execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
 }

package/dist/nodes/SeRanking/SeRanking.node.js

@@ -11,6 +11,7 @@ const SerpClassicDescription_1 = require("./dataApi/descriptions/SerpClassicDesc
 const ProjectManagementDescription_1 = require("./projectApi/descriptions/ProjectManagementDescription");
 const ProjectGroupsDescription_1 = require("./projectApi/descriptions/ProjectGroupsDescription");
 const AiResultTrackerDescription_1 = require("./projectApi/descriptions/AiResultTrackerDescription");
+const AirtGroupsDescription_1 = require("./projectApi/descriptions/AirtGroupsDescription");
 const KeywordGroupsDescription_1 = require("./projectApi/descriptions/KeywordGroupsDescription");
 const CompetitorsDescription_1 = require("./projectApi/descriptions/CompetitorsDescription");
 const UrlTagsDescription_1 = require("./projectApi/descriptions/UrlTagsDescription");
@@ -31,6 +32,7 @@ const SerpClassicOperations_1 = require("./dataApi/operations/SerpClassicOperati
 const ProjectManagementOperations_1 = require("./projectApi/operations/ProjectManagementOperations");
 const ProjectGroupsOperations_1 = require("./projectApi/operations/ProjectGroupsOperations");
 const AiResultTrackerOperations_1 = require("./projectApi/operations/AiResultTrackerOperations");
+const AirtGroupsOperations_1 = require("./projectApi/operations/AirtGroupsOperations");
 const KeywordGroupsOperations_1 = require("./projectApi/operations/KeywordGroupsOperations");
 const CompetitorsOperations_1 = require("./projectApi/operations/CompetitorsOperations");
 const UrlTagsOperations_1 = require("./projectApi/operations/UrlTagsOperations");
@@ -83,6 +85,7 @@ class SeRanking {
                             resource: [
                                 'accountSystem',
                                 'aiResultTracker',
+                                'airtGroups',
                                 'analyticsTraffic',
                                 'backlinkChecker',
                                 'competitors',
@@ -117,6 +120,11 @@ class SeRanking {
                             value: 'aiResultTracker',
                             description: 'Track brand visibility across AI search engines',
                         },
+                        {
+                            name: 'AIRT Groups',
+                            value: 'airtGroups',
+                            description: 'Manage AI Result Tracker prompt groups',
+                        },
                         {
                             name: 'AI Search',
                             value: 'aiSearch',
@@ -228,6 +236,8 @@ class SeRanking {
                 ...ProjectGroupsDescription_1.projectGroupsFields,
                 ...AiResultTrackerDescription_1.aiResultTrackerOperations,
                 ...AiResultTrackerDescription_1.aiResultTrackerFields,
+                ...AirtGroupsDescription_1.airtGroupsOperations,
+                ...AirtGroupsDescription_1.airtGroupsFields,
                 ...KeywordGroupsDescription_1.keywordGroupsOperations,
                 ...KeywordGroupsDescription_1.keywordGroupsFields,
                 ...CompetitorsDescription_1.competitorsOperations,
@@ -252,6 +262,34 @@ class SeRanking {
                 ...SearchVolumeDescription_1.searchVolumeFields,
             ],
         };
+        this.methods = {
+            loadOptions: {
+                async getAuditIssueCodes() {
+                    const auditId = this.getCurrentNodeParameter('auditId');
+                    if (!auditId) {
+                        return [];
+                    }
+                    const response = await this.helpers.httpRequestWithAuthentication.call(this, 'seRankingProjectApi', {
+                        method: 'GET',
+                        url: `https://api4.seranking.com/audit/${auditId}/report`,
+                        json: true,
+                    });
+                    const codes = new Set();
+                    const sections = (response && response.sections) || [];
+                    for (const section of sections) {
+                        const props = section && section.props;
+                        if (props && typeof props === 'object') {
+                            for (const key of Object.keys(props)) {
+                                codes.add(key);
+                            }
+                        }
+                    }
+                    return Array.from(codes)
+                        .sort()
+                        .map((code) => ({ name: code, value: code }));
+                },
+            },
+        };
     }
     async execute() {
         const items = this.getInputData();
@@ -288,6 +326,9 @@ class SeRanking {
                     case 'aiResultTracker':
                         responseData = await AiResultTrackerOperations_1.AiResultTrackerOperations.call(this, i);
                         break;
+                    case 'airtGroups':
+                        responseData = await AirtGroupsOperations_1.AirtGroupsOperations.call(this, i);
+                        break;
                     case 'keywordGroups':
                         responseData = await KeywordGroupsOperations_1.KeywordGroupsOperations.call(this, i);
                         break;

package/dist/nodes/SeRanking/projectApi/descriptions/AiResultTrackerDescription.js

@@ -302,6 +302,14 @@ exports.aiResultTrackerFields = [
             },
         },
         options: [
+            {
+                displayName: 'Group IDs',
+                name: 'groupIds',
+                type: 'string',
+                default: '',
+                placeholder: '12,18',
+                description: 'Comma-separated prompt group IDs to filter by',
+            },
             {
                 displayName: 'Limit',
                 name: 'limit',
@@ -333,6 +341,28 @@ exports.aiResultTrackerFields = [
         placeholder: 'best seo tool,seo rank tracker,website audit tool',
         description: 'Comma-separated list of keyword prompts to add (max 255 chars each)',
     },
+    {
+        displayName: 'Additional Fields',
+        name: 'additionalFields',
+        type: 'collection',
+        placeholder: 'Add Field',
+        default: {},
+        displayOptions: {
+            show: {
+                resource: ['aiResultTracker'],
+                operation: ['addPrompts'],
+            },
+        },
+        options: [
+            {
+                displayName: 'Group ID',
+                name: 'groupId',
+                type: 'number',
+                default: 0,
+                description: 'Target prompt group ID. Defaults to the site\'s default group.',
+            },
+        ],
+    },
     {
         displayName: 'Keyword-LLM Link IDs',
         name: 'k2siteLlmIds',
@@ -377,6 +407,14 @@ exports.aiResultTrackerFields = [
                 placeholder: '2026-01-31',
                 description: 'End date (YYYY-MM-DD). Defaults to current date.',
             },
+            {
+                displayName: 'Group IDs',
+                name: 'groupIds',
+                type: 'string',
+                default: '',
+                placeholder: '12,18',
+                description: 'Comma-separated prompt group IDs to filter by',
+            },
             {
                 displayName: 'Limit',
                 name: 'limit',
@@ -405,7 +443,7 @@ exports.aiResultTrackerFields = [
             },
         },
         default: 0,
-        description: 'Value of the <code>k2site_llm_id</code> field from List Prompts (the SE Ranking docs call this parameter <code>keyword_id</code>, but the endpoint actually expects <code>k2site_llm_id</code>)',
+        description: 'Value of the <code>k2site_llm_id</code> field from List Prompts',
     },
     {
         displayName: 'Additional Fields',

package/dist/nodes/SeRanking/projectApi/descriptions/AirtGroupsDescription.d.ts

@@ -0,0 +1,3 @@
+import { INodeProperties } from 'n8n-workflow';
+export declare const airtGroupsOperations: INodeProperties[];
+export declare const airtGroupsFields: INodeProperties[];

package/dist/nodes/SeRanking/projectApi/descriptions/AirtGroupsDescription.js

@@ -0,0 +1,231 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.airtGroupsFields = exports.airtGroupsOperations = void 0;
+exports.airtGroupsOperations = [
+    {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        noDataExpression: true,
+        displayOptions: {
+            show: {
+                resource: ['airtGroups'],
+            },
+        },
+        options: [
+            {
+                name: 'Change Group Order',
+                value: 'changeGroupOrder',
+                description: 'Move a group to a new position in the site group order',
+                action: 'Change prompt group order',
+            },
+            {
+                name: 'Create Prompt Group',
+                value: 'createPromptGroup',
+                description: 'Create a new prompt group for a site',
+                action: 'Create prompt group',
+            },
+            {
+                name: 'Delete All Prompts in Group',
+                value: 'deleteAllPromptsInGroup',
+                description: 'Remove every prompt currently assigned to the group (group itself is kept)',
+                action: 'Delete all prompts in group',
+            },
+            {
+                name: 'Delete Prompt Group',
+                value: 'deletePromptGroup',
+                description: 'Delete a prompt group; its prompts move to the default group',
+                action: 'Delete prompt group',
+            },
+            {
+                name: 'List Prompt Groups',
+                value: 'listPromptGroups',
+                description: 'List prompt groups for a site, optionally filtered by LLM engine',
+                action: 'List prompt groups',
+            },
+            {
+                name: 'Move All Prompts Between Groups',
+                value: 'moveAllPromptsBetweenGroups',
+                description: 'Move every prompt from one group to another',
+                action: 'Move all prompts between groups',
+            },
+            {
+                name: 'Move Prompts to Group',
+                value: 'movePromptsToGroup',
+                description: 'Move a specific set of prompts into a target group',
+                action: 'Move prompts to group',
+            },
+            {
+                name: 'Rename Prompt Group',
+                value: 'renamePromptGroup',
+                description: 'Update the name of an existing prompt group',
+                action: 'Rename prompt group',
+            },
+        ],
+        default: 'listPromptGroups',
+    },
+];
+exports.airtGroupsFields = [
+    {
+        displayName: 'Site ID',
+        name: 'siteId',
+        type: 'number',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['airtGroups'],
+            },
+        },
+        default: 0,
+        description: 'Unique project (site) ID',
+    },
+    {
+        displayName: 'Group ID',
+        name: 'groupId',
+        type: 'number',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['airtGroups'],
+                operation: [
+                    'renamePromptGroup',
+                    'deletePromptGroup',
+                    'changeGroupOrder',
+                    'deleteAllPromptsInGroup',
+                    'movePromptsToGroup',
+                ],
+            },
+        },
+        default: 0,
+        description: 'Prompt group ID',
+    },
+    {
+        displayName: 'Group Name',
+        name: 'groupName',
+        type: 'string',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['airtGroups'],
+                operation: ['createPromptGroup'],
+            },
+        },
+        default: '',
+        placeholder: 'Brand queries',
+        description: 'Non-empty, max 255 characters, unique within the site',
+    },
+    {
+        displayName: 'New Group Name',
+        name: 'groupName',
+        type: 'string',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['airtGroups'],
+                operation: ['renamePromptGroup'],
+            },
+        },
+        default: '',
+        placeholder: 'Updated group name',
+        description: 'New name for the prompt group; non-empty, max 255 characters',
+    },
+    {
+        displayName: 'Place Before Group ID',
+        name: 'beforeId',
+        type: 'number',
+        displayOptions: {
+            show: {
+                resource: ['airtGroups'],
+                operation: ['changeGroupOrder'],
+            },
+        },
+        default: 0,
+        description: 'Place the group immediately before this neighbour. Provide exactly ONE of Before or After — leave the other at 0',
+    },
+    {
+        displayName: 'Place After Group ID',
+        name: 'afterId',
+        type: 'number',
+        displayOptions: {
+            show: {
+                resource: ['airtGroups'],
+                operation: ['changeGroupOrder'],
+            },
+        },
+        default: 0,
+        description: 'Place the group immediately after this neighbour. Provide exactly ONE of Before or After — leave the other at 0',
+    },
+    {
+        displayName: 'Keyword-LLM Link IDs',
+        name: 'k2siteLlmIds',
+        type: 'string',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['airtGroups'],
+                operation: ['movePromptsToGroup'],
+            },
+        },
+        default: '',
+        placeholder: '2164555,2164556,2164557',
+        description: 'Comma-separated list of integer k2site_llm_id values (from List Prompts)',
+    },
+    {
+        displayName: 'Source Group ID',
+        name: 'fromGroupId',
+        type: 'number',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['airtGroups'],
+                operation: ['moveAllPromptsBetweenGroups'],
+            },
+        },
+        default: 0,
+        description: 'Group whose prompts will be moved',
+    },
+    {
+        displayName: 'Target Group ID',
+        name: 'toGroupId',
+        type: 'number',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['airtGroups'],
+                operation: ['moveAllPromptsBetweenGroups'],
+            },
+        },
+        default: 0,
+        description: 'Destination group; must differ from Source Group ID',
+    },
+    {
+        displayName: 'Additional Fields',
+        name: 'additionalFields',
+        type: 'collection',
+        placeholder: 'Add Field',
+        default: {},
+        displayOptions: {
+            show: {
+                resource: ['airtGroups'],
+                operation: ['listPromptGroups'],
+            },
+        },
+        options: [
+            {
+                displayName: 'Include Prompt Counts',
+                name: 'keysCount',
+                type: 'boolean',
+                default: false,
+                description: 'Whether to include keys_count on every group',
+            },
+            {
+                displayName: 'Filter by Site LLM IDs',
+                name: 'siteLlmIds',
+                type: 'string',
+                default: '',
+                placeholder: '1130467,1130468',
+                description: 'Comma-separated list of site_llm_id values to filter groups by',
+            },
+        ],
+    },
+];

package/dist/nodes/SeRanking/projectApi/descriptions/WebsiteAuditDescription.js

@@ -230,10 +230,14 @@ exports.websiteAuditFields = [
         ],
     },
     {
-        displayName: 'Issue Code',
+        displayName: 'Issue Code Name or ID',
         name: 'issueCode',
-        type: 'string',
+        type: 'options',
         required: true,
+        typeOptions: {
+            loadOptionsMethod: 'getAuditIssueCodes',
+            loadOptionsDependsOn: ['auditId'],
+        },
         displayOptions: {
             show: {
                 resource: ['websiteAuditProject'],
@@ -241,8 +245,7 @@ exports.websiteAuditFields = [
             },
         },
         default: '',
-        placeholder: 'title_duplicate',
-        description: 'Unique issue code',
+        description: 'Issue code from the audit report. Set the Audit ID first; the dropdown will populate from the audit\'s issue codes. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>',
     },
     {
         displayName: 'Additional Fields',

package/dist/nodes/SeRanking/projectApi/operations/AiResultTrackerOperations.js

@@ -79,13 +79,22 @@ async function AiResultTrackerOperations(index) {
                 query.limit = additionalFields.limit;
             if (additionalFields.offset !== undefined)
                 query.offset = additionalFields.offset;
-            return await apiRequest_1.apiRequest.call(this, 'GET', `/sites/${siteId}/airt/llm/${llmId}/prompts`, {}, query, index);
+            let endpoint = `/sites/${siteId}/airt/llm/${llmId}/prompts`;
+            if (additionalFields.groupIds) {
+                const ids = additionalFields.groupIds.split(',').map((id) => id.trim());
+                endpoint += '?' + ids.map((id) => `group_ids[]=${encodeURIComponent(id)}`).join('&');
+            }
+            return await apiRequest_1.apiRequest.call(this, 'GET', endpoint, {}, query, index);
         }
         case 'addPrompts': {
             const llmId = this.getNodeParameter('llmId', index);
             const promptsStr = this.getNodeParameter('prompts', index);
             const prompts = promptsStr.split(',').map((p) => p.trim()).filter((p) => p.length > 0);
-            return await apiRequest_1.apiRequest.call(this, 'POST', `/sites/${siteId}/airt/llm/${llmId}/prompts`, { prompts }, {}, index);
+            const additionalFields = this.getNodeParameter('additionalFields', index, {});
+            const body = { prompts };
+            if (additionalFields.groupId)
+                body.group_id = additionalFields.groupId;
+            return await apiRequest_1.apiRequest.call(this, 'POST', `/sites/${siteId}/airt/llm/${llmId}/prompts`, body, {}, index);
         }
         case 'deletePrompts': {
             const llmId = this.getNodeParameter('llmId', index);
@@ -106,7 +115,12 @@ async function AiResultTrackerOperations(index) {
                 query.limit = additionalFields.limit;
             if (additionalFields.offset !== undefined)
                 query.offset = additionalFields.offset;
-            return await apiRequest_1.apiRequest.call(this, 'GET', `/sites/${siteId}/airt/llm/${llmId}/prompts/rankings`, {}, query, index);
+            let endpoint = `/sites/${siteId}/airt/llm/${llmId}/prompts/rankings`;
+            if (additionalFields.groupIds) {
+                const ids = additionalFields.groupIds.split(',').map((id) => id.trim());
+                endpoint += '?' + ids.map((id) => `group_ids[]=${encodeURIComponent(id)}`).join('&');
+            }
+            return await apiRequest_1.apiRequest.call(this, 'GET', endpoint, {}, query, index);
         }
         case 'getPromptAnswer': {
             const llmId = this.getNodeParameter('llmId', index);

package/dist/nodes/SeRanking/projectApi/operations/AirtGroupsOperations.d.ts

@@ -0,0 +1,2 @@
+import { IExecuteFunctions } from 'n8n-workflow';
+export declare function AirtGroupsOperations(this: IExecuteFunctions, index: number): Promise<any>;

package/dist/nodes/SeRanking/projectApi/operations/AirtGroupsOperations.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AirtGroupsOperations = AirtGroupsOperations;
+const apiRequest_1 = require("../../utils/apiRequest");
+async function AirtGroupsOperations(index) {
+    const operation = this.getNodeParameter('operation', index);
+    const siteId = this.getNodeParameter('siteId', index);
+    switch (operation) {
+        case 'listPromptGroups': {
+            const additionalFields = this.getNodeParameter('additionalFields', index, {});
+            const query = {};
+            if (additionalFields.keysCount === true) {
+                query.keys_count = 1;
+            }
+            if (additionalFields.siteLlmIds) {
+                const ids = additionalFields.siteLlmIds
+                    .split(',')
+                    .map((s) => parseInt(s.trim(), 10))
+                    .filter((n) => !Number.isNaN(n));
+                if (ids.length > 0) {
+                    query['site_llm_ids[]'] = ids;
+                }
+            }
+            return await apiRequest_1.apiRequest.call(this, 'GET', `/sites/${siteId}/airt/prompt-groups`, {}, query, index);
+        }
+        case 'createPromptGroup': {
+            const name = this.getNodeParameter('groupName', index);
+            if (!name || name.trim() === '') {
+                throw new Error('Group name cannot be empty');
+            }
+            return await apiRequest_1.apiRequest.call(this, 'POST', `/sites/${siteId}/airt/prompt-groups`, { name: name.trim() }, {}, index);
+        }
+        case 'renamePromptGroup': {
+            const groupId = this.getNodeParameter('groupId', index);
+            const name = this.getNodeParameter('groupName', index);
+            if (!name || name.trim() === '') {
+                throw new Error('Group name cannot be empty');
+            }
+            return await apiRequest_1.apiRequest.call(this, 'PATCH', `/sites/${siteId}/airt/prompt-groups/${groupId}`, { name: name.trim() }, {}, index);
+        }
+        case 'deletePromptGroup': {
+            const groupId = this.getNodeParameter('groupId', index);
+            await apiRequest_1.apiRequest.call(this, 'DELETE', `/sites/${siteId}/airt/prompt-groups/${groupId}`, {}, {}, index);
+            return { success: true, deleted: true, group_id: groupId };
+        }
+        case 'changeGroupOrder': {
+            const groupId = this.getNodeParameter('groupId', index);
+            const beforeId = this.getNodeParameter('beforeId', index, 0);
+            const afterId = this.getNodeParameter('afterId', index, 0);
+            const hasBefore = beforeId > 0;
+            const hasAfter = afterId > 0;
+            if (hasBefore === hasAfter) {
+                throw new Error('Provide exactly one of "Place Before Group ID" or "Place After Group ID" (not both, not neither)');
+            }
+            const body = {};
+            if (hasBefore)
+                body.before_id = beforeId;
+            if (hasAfter)
+                body.after_id = afterId;
+            await apiRequest_1.apiRequest.call(this, 'POST', `/sites/${siteId}/airt/prompt-groups/${groupId}/order`, body, {}, index);
+            return { success: true, group_id: groupId, ...body };
+        }
+        case 'deleteAllPromptsInGroup': {
+            const groupId = this.getNodeParameter('groupId', index);
+            await apiRequest_1.apiRequest.call(this, 'DELETE', `/sites/${siteId}/airt/prompt-groups/${groupId}/keywords`, {}, {}, index);
+            return { success: true, emptied: true, group_id: groupId };
+        }
+        case 'movePromptsToGroup': {
+            const groupId = this.getNodeParameter('groupId', index);
+            const idsStr = this.getNodeParameter('k2siteLlmIds', index);
+            const ids = idsStr
+                .split(',')
+                .map((s) => parseInt(s.trim(), 10))
+                .filter((n) => !Number.isNaN(n));
+            if (ids.length === 0) {
+                throw new Error('Provide at least one k2site_llm_id');
+            }
+            await apiRequest_1.apiRequest.call(this, 'POST', `/sites/${siteId}/airt/prompt-groups/${groupId}/moveKeywords`, { k2site_llm_ids: ids }, {}, index);
+            return { success: true, group_id: groupId, moved: ids };
+        }
+        case 'moveAllPromptsBetweenGroups': {
+            const fromGroupId = this.getNodeParameter('fromGroupId', index);
+            const toGroupId = this.getNodeParameter('toGroupId', index);
+            if (fromGroupId === toGroupId) {
+                throw new Error('Source and Target Group ID must differ');
+            }
+            await apiRequest_1.apiRequest.call(this, 'POST', `/sites/${siteId}/airt/prompt-groups/moveGroupKeywords`, { from_group_id: fromGroupId, to_group_id: toGroupId }, {}, index);
+            return { success: true, from_group_id: fromGroupId, to_group_id: toGroupId };
+        }
+        default:
+            throw new Error(`Unknown AIRT Groups operation: ${operation}`);
+    }
+}

package/dist/nodes/SeRanking/projectApi/operations/ProjectManagementOperations.js

@@ -220,7 +220,7 @@ async function ProjectManagementOperations(index) {
                 const keywordsJson = this.getNodeParameter('recheckKeywords', index);
                 body.keywords = typeof keywordsJson === 'string' ? JSON.parse(keywordsJson) : keywordsJson;
             }
-            return await apiRequest_1.apiRequest.call(this, 'POST', `/api/sites/${siteId}/recheck`, body, {}, index);
+            return await apiRequest_1.apiRequest.call(this, 'POST', `/sites/${siteId}/recheck`, body, {}, index);
         }
         default:
             throw new Error(`Unknown Project Management operation: ${operation}`);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@seranking/n8n-nodes-seranking",
-    "version": "1.5.10",
+    "version": "1.5.13",
     "description": "n8n connector for SE Ranking API - AI Search, Backlinks, Domain Analysis, Keyword Research, Website Audit, Project Management, Project Groups, AI Result Tracker, Keyword Groups, Competitors, URL Tags, Analytics Traffic, Account System, Sub-Account Management, General Data, Marketing Plan, Backlink Checker, Search Volume",
     "license": "MIT",
     "homepage": "https://github.com/seranking/n8n-nodes-seranking",