@seranking/n8n-nodes-seranking 1.2.3 → 1.3.1

package/README.md

@@ -58,7 +58,7 @@ npm install n8n -g
 **Option A: From .tgz file**
 
 ```bash
-npm install -g n8n-nodes-seranking-1.2.0.tgz
+npm install -g seranking-n8n-nodes-seranking-1.3.0.tgz
 ```
 
 **Option B: From GitHub**
@@ -122,17 +122,23 @@ docker run -it --rm \
 
 ### Updating
 
+**From npm:**
+
+```bash
+npm update @seranking/n8n-nodes-seranking
+```
+
 **From .tgz:**
 
 ```bash
-npm uninstall -g n8n-nodes-seranking
-npm install -g n8n-nodes-seranking-NEW-VERSION.tgz
+npm uninstall -g seranking-n8n-nodes-seranking
+npm install -g seranking-n8n-nodes-seranking-NEW-VERSION.tgz
 ```
 
 **From GitHub:**
 
 ```bash
-npm update -g n8n-nodes-seranking
+npm install -g git+https://github.com/seranking/n8n-nodes-seranking.git
 ```
 
 **From source:**
@@ -174,7 +180,7 @@ The node will automatically test your credentials by making a test request to th
 
 ## Operations
 
-This node provides access to 5 SE Ranking resources with 54 total operations:
+This node provides access to 6 SE Ranking resources with 59 total operations:
 
 ### AI Search (4 operations)
 
@@ -247,6 +253,13 @@ This node provides access to 5 SE Ranking resources with 54 total operations:
 - Recheck Standard Audit - Re-run HTML audit
 - Recheck Advanced Audit - Re-run JS audit
 
+### SERP Classic (5 operations)
+
+- Add Tasks - Create SERP tasks for keywords (up to 1,000 per request)
+- Get Results - Get standard SERP results for a task
+- List Tasks - List recent SERP tasks (last 24 hours)
+- Get Advanced Results - Retrieve detailed SERP results with all features
+- Get Locations - Get available location IDs for SERP queries
 
 ## Usage Examples
 
@@ -256,30 +269,22 @@ Ready-to-use workflows demonstrating real-world applications of the SE Ranking n
 
 ### 🤖 Example 1: AI Search Visibility Tracker
 
-**Track your brand's presence across ChatGPT, Perplexity, and Gemini**
+**Track your brand's presence and competitive gaps across ChatGPT, Perplexity, and Gemini**
 
-Monitor how often your brand appears in AI-powered search engines with automated historical tracking.
+Two comprehensive workflows for monitoring AI visibility and identifying content opportunities.
 
-**What You'll Get:**
+**Workflow 1: AI Search Visibility Tracker**
+
+Monitor how often your brand appears in AI-powered search engines with automated historical tracking.
 
 - Link presence count across multiple AI engines
 - Average position tracking in AI citations
 - AI opportunity traffic estimates
 - Period-over-period comparison metrics
 
-**Best For:** Marketing teams tracking AI SEO performance, Brand managers monitoring AI visibility
+**Workflow 2: Competitor Topic Gap Analysis**
 
-📂 [View Full Guide & Download Workflow →](./Usage-Examples/AI-Search)
-
----
-
-### 🎯 Example 2: Competitor Topic Gap Analysis
-
-**Identify content opportunities by analyzing where competitors outrank you in AI search and traditional SEO**
-
-Comprehensive competitive analysis combining AI visibility gaps with traditional SEO keyword gaps.
-
-**What You'll Get:**
+Identify content opportunities by analyzing where competitors outrank you in AI search and traditional SEO.
 
 - AI visibility gaps across ChatGPT, Perplexity, and Gemini
 - Keyword gaps with search volume and difficulty
@@ -287,13 +292,13 @@ Comprehensive competitive analysis combining AI visibility gaps with traditional
 - Prioritized opportunities with HIGH/MEDIUM/LOW scoring
 - Actionable recommendations for each gap
 
-**Best For:** Content strategists planning editorial calendars, SEO teams doing competitive intelligence
+**Best For:** Marketing teams tracking AI SEO performance, Content strategists planning editorial calendars, SEO teams doing competitive intelligence
 
 📂 [View Full Guide & Download Workflow →](./Usage-Examples/AI-Search)
 
 ---
 
-### 🔗 Example 3: Backlinks Monitoring & Analysis
+### 🔗 Example 2: Backlinks Monitoring & Analysis
 
 **Track new/lost backlinks, monitor domain authority, and analyze anchor text distribution**
 
@@ -309,11 +314,11 @@ Automatically monitor backlink portfolio health with daily tracking and alerts f
 
 **Best For:** SEO agencies managing client backlink portfolios, In-house SEO teams tracking link-building campaigns
 
-📂 [View Full Guide & Download Workflow →](./Usage-Examples/Backlinks)
+📂 [View Full Guide & Download Workflow →](./Usage-Examples/SERP-Classic)
 
 ---
 
-### 📊 Example 4: Domain Analysis Data Processor
+### 📊 Example 3: Domain Analysis Data Processor
 
 **Transform SE Ranking API data into structured Google Sheets reports**
 
@@ -333,7 +338,7 @@ Automatically process and organize domain analysis data with intelligent type de
 
 ---
 
-### 🔍 Example 5: Keyword Research Automation
+### 🔍 Example 4: Keyword Research Automation
 
 **Automate comprehensive keyword research with trend analysis**
 
@@ -352,7 +357,7 @@ Build an automated keyword intelligence pipeline with historical tracking and SE
 
 ---
 
-### 🔧 Example 6: Website Audit Automation
+### 🔧 Example 5: Website Audit Automation
 
 **Automatically crawl sites, detect issues, and generate reports**
 
@@ -371,6 +376,26 @@ Schedule regular technical SEO audits and get alerts when critical issues are de
 
 ---
 
+### 📍 Example 6: SERP Classic Tracking
+
+**Track keyword rankings and analyze SERP features across search engines**
+
+Monitor keyword positions, SERP features, and competitor visibility with automated rank tracking.
+
+**What You'll Get:**
+
+- Keyword position tracking across multiple locations
+- SERP features analysis (featured snippets, local pack, etc.)
+- Competitor ranking visibility
+- Device-specific rankings (desktop, mobile, tablet)
+- Historical rank tracking
+
+**Best For:** SEO teams tracking keyword performance, Local businesses monitoring location-based rankings, Agencies managing multi-client SERP tracking
+
+📂 [View Full Guide & Download Workflow →](./Usage-Examples/SERP-Classic)
+
+---
+
 ### 🚀 Quick Start
 
 1. **Browse** the example that matches your use case
@@ -392,6 +417,7 @@ This node implements the following SE Ranking APIs:
 - [Domain Analysis API](https://seranking.com/api/data/domain-analysis/)
 - [Keyword Research API](https://seranking.com/api/data/keyword-research/)
 - [Website Audit API](https://seranking.com/api/data/website-audit/)
+- [SERP API](https://seranking.com/api/data/serp/)
 
 For detailed API specifications, visit [SE Ranking API Documentation](https://seranking.com/api.html).
 
@@ -399,7 +425,27 @@ For detailed API specifications, visit [SE Ranking API Documentation](https://se
 
 ## Version History
 
-### v1.2.3 (Current)
+### v1.3.0 (Current)
+
+- ✅ Complete AI Search resource (4 operations)
+- ✅ Complete Backlinks resource (25 operations)
+- ✅ Enhanced Domain Analysis resource (8 operations - added History, Comparison, Paid Ads)
+- ✅ Complete Keyword Research resource (5 operations)
+- ✅ Complete Website Audit resource (14 operations)
+- ✅ **NEW: Complete SERP Classic resource (5 operations)**
+- ✅ **Total: 59 operations across 6 resources**
+- ✅ Comprehensive error handling with detailed messages
+- ✅ Full TypeScript support
+- ✅ Input validation (domains, sources, dates)
+- ✅ Pagination support (offset/limit)
+- ✅ Advanced filtering options
+- ✅ Multi-keyword support (up to 1,000 keywords for SERP tasks)
+- ✅ Backlink export and bulk operations
+- ✅ Website audit creation and management
+- ✅ **NEW: SERP rank tracking and analysis**
+- ✅ **NEW: Multi-location SERP data retrieval**
+
+### v1.2.3
 
 - ✅ Complete AI Search resource (4 operations)
 - ✅ **NEW: Complete Backlinks resource (25 operations)**
@@ -433,18 +479,30 @@ For detailed API specifications, visit [SE Ranking API Documentation](https://se
 
 ## Features
 
-✅ **54 Operations** - Comprehensive coverage across 5 major resources  
+✅ **59 Operations** - Comprehensive coverage across 6 major resources  
+
 ✅ **Type Safety** - Full TypeScript implementation with strict typing  
+
 ✅ **Error Handling** - Detailed error messages with troubleshooting hints  
+
 ✅ **Pagination** - Efficient handling of large datasets  
+
 ✅ **Advanced Filtering** - Volume, position, CPC, difficulty filters  
+
 ✅ **Validation** - Input validation for domains, country codes, and parameters  
+
 ✅ **Authentication** - Automatic credential management and testing  
+
 ✅ **Rate Limiting** - Built-in rate limit handling with retry logic  
+
 ✅ **Batch Operations** - Support for multiple keywords/domains  
+
 ✅ **Backlink Monitoring** - Complete backlink analysis and tracking  
+
 ✅ **Website Auditing** - Technical SEO audits with issue detection
 
+✅ **SERP Tracking** - Keyword ranking and SERP features analysis
+
 ---
 
 ## Limitations
@@ -711,13 +769,15 @@ n8n-nodes-seranking/
 │       │   │   ├── BacklinksOperations.ts                        # Backlinks operations logic
 │       │   │   ├── DomainAnalysisOperations.ts                   # Domain Analysis operations logic
 │       │   │   ├── KeywordResearchOperations.ts                  # Keyword Research operations logic
-│       │   │   └── WebsiteAuditOperations.ts                     # Website Audit operations logic
+│       │   │   ├── WebsiteAuditOperations.ts                     # Website Audit operations logic
+│       │   │   └── SerpClassicOperations.ts                      # SERP Classic operations logic
 │       │   └── descriptions/
 │       │       ├── AiSearchDescription.ts                        # AI Search UI definitions
 │       │       ├── BacklinksDescription.ts                       # Backlinks UI definitions
 │       │       ├── DomainAnalysisDescription.ts                  # Domain Analysis UI definitions
 │       │       ├── KeywordResearchDescription.ts                 # Keyword Research UI definitions
-│       │       └── WebsiteAuditDescription.ts                    # Website Audit UI definitions
+│       │       ├── WebsiteAuditDescription.ts                    # Website Audit UI definitions
+│       │       └── SerpClassicDescription.ts                     # SERP Classic UI definitions
 │       └── utils/
 │           ├── validators.ts                                     # Input validators
 │           └── apiRequest.ts                                     # API request handler
@@ -765,9 +825,14 @@ n8n-nodes-seranking/
 │   │   ├── Get_Longtail_Keywords.jpg                             # Screenshot: Longtail Keywords
 │   │   └── README.md                                             # Keyword Research workflow documentation
 │   │
-│   └── Website-Audit/
-│       ├── Website-Audit-Technical-SEO-Monitor.json              # Website audit workflow
-│       └── README.md                                             # Website Audit workflow documentation
+│   ├── Website-Audit/
+│   │   ├── Website-Audit-Technical-SEO-Monitor.json              # Website audit workflow
+│   │   └── README.md                                             # Website Audit workflow documentation
+│   │
+│   └── SERP-Classic/
+│       ├── Gelato-Small-Towns-Amsterdam-Area.json                # SERP tracking workflow
+│       ├── Gelato Small Towns Amsterdam Area.xlsx                # Workflow results
+│       └── README.md                                             # SERP Classic workflow documentation
 │
 ├── package.json
 ├── package-lock.json

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

@@ -7,11 +7,13 @@ const DomainAnalysisDescription_1 = require("./dataApi/descriptions/DomainAnalys
 const KeywordResearchDescription_1 = require("./dataApi/descriptions/KeywordResearchDescription");
 const BacklinksDescription_1 = require("./dataApi/descriptions/BacklinksDescription");
 const WebsiteAuditDescription_1 = require("./dataApi/descriptions/WebsiteAuditDescription");
+const SerpClassicDescription_1 = require("./dataApi/descriptions/SerpClassicDescription");
 const AiSearchOperations_1 = require("./dataApi/operations/AiSearchOperations");
 const DomainAnalysisOperations_1 = require("./dataApi/operations/DomainAnalysisOperations");
 const KeywordResearchOperations_1 = require("./dataApi/operations/KeywordResearchOperations");
 const BacklinksOperations_1 = require("./dataApi/operations/BacklinksOperations");
 const WebsiteAuditOperations_1 = require("./dataApi/operations/WebsiteAuditOperations");
+const SerpClassicOperations_1 = require("./dataApi/operations/SerpClassicOperations");
 class SeRanking {
     constructor() {
         this.description = {
@@ -25,8 +27,9 @@ class SeRanking {
             defaults: {
                 name: 'SE Ranking',
             },
-            inputs: ['main'],
-            outputs: ['main'],
+            usableAsTool: true,
+            inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
             credentials: [
                 {
                     name: 'seRankingApi',
@@ -60,6 +63,11 @@ class SeRanking {
                             value: 'keywordResearch',
                             description: 'Keyword metrics, volume, CPC, and related keywords',
                         },
+                        {
+                            name: 'SERP Classic',
+                            value: 'serpClassic',
+                            description: 'SERP tracking and results retrieval',
+                        },
                         {
                             name: 'Website Audit',
                             value: 'websiteAudit',
@@ -76,6 +84,8 @@ class SeRanking {
                 ...DomainAnalysisDescription_1.domainAnalysisFields,
                 ...KeywordResearchDescription_1.keywordResearchOperations,
                 ...KeywordResearchDescription_1.keywordResearchFields,
+                ...SerpClassicDescription_1.serpClassicOperations,
+                ...SerpClassicDescription_1.serpClassicFields,
                 ...WebsiteAuditDescription_1.websiteAuditOperations,
                 ...WebsiteAuditDescription_1.websiteAuditFields,
             ],
@@ -101,6 +111,9 @@ class SeRanking {
                     case 'keywordResearch':
                         responseData = await KeywordResearchOperations_1.KeywordResearchOperations.call(this, i);
                         break;
+                    case 'serpClassic':
+                        responseData = await SerpClassicOperations_1.SerpClassicOperations.call(this, i);
+                        break;
                     case 'websiteAudit':
                         responseData = await WebsiteAuditOperations_1.WebsiteAuditOperations.call(this, i);
                         break;

package/dist/nodes/SeRanking/dataApi/descriptions/SerpClassicDescription.d.ts

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

package/dist/nodes/SeRanking/dataApi/descriptions/SerpClassicDescription.js

@@ -0,0 +1,231 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serpClassicFields = exports.serpClassicOperations = void 0;
+exports.serpClassicOperations = [
+    {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        noDataExpression: true,
+        displayOptions: {
+            show: {
+                resource: ['serpClassic'],
+            },
+        },
+        options: [
+            {
+                name: 'Add Tasks',
+                value: 'addTasks',
+                description: 'Create SERP tasks for keywords (returns task IDs)',
+                action: 'Add SERP tasks',
+            },
+            {
+                name: 'Get Results (standard)',
+                value: 'getResults',
+                description: 'Get status or standard SERP results for a task',
+                action: 'Get SERP results',
+            },
+            {
+                name: 'List Tasks',
+                value: 'listTasks',
+                description: 'List recent SERP tasks (last 24 hours)',
+                action: 'List SERP tasks',
+            },
+            {
+                name: 'Get Advanced Results',
+                value: 'getAdvancedResults',
+                description: 'Retrieve advanced (detailed) SERP results',
+                action: 'Get advanced SERP results',
+            },
+            {
+                name: 'Get Locations',
+                value: 'getLocations',
+                description: 'Get available location IDs for SERP queries',
+                action: 'Get SERP locations',
+            },
+        ],
+        default: 'addTasks',
+    },
+];
+exports.serpClassicFields = [
+    {
+        displayName: 'Search Engine',
+        name: 'searchEngine',
+        type: 'string',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['serpClassic'],
+                operation: ['addTasks'],
+            },
+        },
+        default: 'google',
+        placeholder: 'google',
+        description: 'Search engine name (e.g., google, bing). See "Supported Engine IDs by Country" in docs — classic uses engine names like "google".',
+    },
+    {
+        displayName: 'Device',
+        name: 'device',
+        type: 'options',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['serpClassic'],
+                operation: ['addTasks'],
+            },
+        },
+        options: [
+            { name: 'Desktop', value: 'desktop' },
+            { name: 'Mobile', value: 'mobile' },
+            { name: 'Tablet', value: 'tablet' },
+        ],
+        default: 'desktop',
+        description: 'Search device type (desktop, mobile, tablet).',
+    },
+    {
+        displayName: 'Language Code',
+        name: 'languageCode',
+        type: 'string',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['serpClassic'],
+                operation: ['addTasks'],
+            },
+        },
+        default: 'en',
+        placeholder: 'en',
+        description: 'Language code for the search results (e.g., en, fr).',
+    },
+    {
+        displayName: 'Location ID',
+        name: 'locationId',
+        type: 'number',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['serpClassic'],
+                operation: ['addTasks'],
+            },
+        },
+        default: 0,
+        placeholder: '31808',
+        description: 'Location identifier (integer) — retrieve IDs from the Get Locations endpoint.',
+    },
+    {
+        displayName: 'Keywords',
+        name: 'keywords',
+        type: 'string',
+        typeOptions: {
+            rows: 6,
+        },
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['serpClassic'],
+                operation: ['addTasks'],
+            },
+        },
+        default: '',
+        placeholder: 'avocado\ninterstellar',
+        description: 'Keywords — one per line or comma-separated. Max 1,000 keywords; each ≤ 255 chars.',
+    },
+    {
+        displayName: 'Optional: Tag',
+        name: 'tag',
+        type: 'string',
+        required: false,
+        displayOptions: {
+            show: {
+                resource: ['serpClassic'],
+                operation: ['addTasks'],
+            },
+        },
+        default: '',
+        placeholder: 'campaign-1',
+        description: 'Optional: tag to group tasks.',
+    },
+    {
+        displayName: 'Task ID',
+        name: 'taskId',
+        type: 'string',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['serpClassic'],
+                operation: ['getResults'],
+            },
+        },
+        default: '',
+        placeholder: '14',
+        description: 'Task ID returned by Add Tasks. Example: 14',
+    },
+    {
+        displayName: 'List Filters',
+        name: 'listFilters',
+        type: 'collection',
+        placeholder: 'Add Filter',
+        default: {},
+        displayOptions: {
+            show: {
+                resource: ['serpClassic'],
+                operation: ['listTasks'],
+            },
+        },
+        options: [
+            {
+                displayName: 'Limit',
+                name: 'limit',
+                type: 'number',
+                default: 100,
+                description: 'Max tasks to return (UI-level).',
+                typeOptions: { minValue: 1, maxValue: 1000 },
+            },
+        ],
+    },
+    {
+        displayName: 'Task ID',
+        name: 'taskId',
+        type: 'string',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['serpClassic'],
+                operation: ['getAdvancedResults'],
+            },
+        },
+        default: '',
+        placeholder: '14',
+        description: 'Task ID to fetch advanced results for. The advanced results endpoint expects a single task_id parameter.',
+    },
+    {
+        displayName: 'Country Code',
+        name: 'countryCode',
+        type: 'string',
+        required: false,
+        displayOptions: {
+            show: {
+                resource: ['serpClassic'],
+                operation: ['getLocations'],
+            },
+        },
+        default: '',
+        placeholder: 'US',
+        description: 'Filter by country code (optional).',
+    },
+    {
+        displayName: 'Query (city / name)',
+        name: 'q',
+        type: 'string',
+        required: false,
+        displayOptions: {
+            show: {
+                resource: ['serpClassic'],
+                operation: ['getLocations'],
+            },
+        },
+        default: '',
+        placeholder: 'New York',
+        description: 'Partial match parameter for location name (optional).',
+    },
+];

package/dist/nodes/SeRanking/dataApi/operations/BacklinksOperations.js

@@ -15,7 +15,7 @@ async function BacklinksOperations(index) {
     const operation = this.getNodeParameter('operation', index);
     let endpoint = '';
     const params = {};
-    let method = 'GET';
+    const method = 'GET';
     switch (operation) {
         case 'getSummary': {
             const target = this.getNodeParameter('target', index);

package/dist/nodes/SeRanking/dataApi/operations/DomainAnalysisOperations.js

@@ -7,7 +7,7 @@ async function DomainAnalysisOperations(index) {
     const operation = this.getNodeParameter('operation', index);
     let endpoint = '';
     const params = {};
-    let method = 'GET';
+    const method = 'GET';
     switch (operation) {
         case 'getOverviewDb': {
             const domain = this.getNodeParameter('domain', index);

package/dist/nodes/SeRanking/dataApi/operations/SerpClassicOperations.d.ts

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

package/dist/nodes/SeRanking/dataApi/operations/SerpClassicOperations.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SerpClassicOperations = SerpClassicOperations;
+const apiRequest_1 = require("../../utils/apiRequest");
+function parseKeywords(input) {
+    if (!input || input.trim() === '') {
+        throw new Error('Keywords cannot be empty');
+    }
+    const keywords = input
+        .split(/[,\n]/)
+        .map((k) => k.trim())
+        .filter((k) => k.length > 0);
+    if (keywords.length === 0)
+        throw new Error('Provide at least one keyword');
+    if (keywords.length > 1000)
+        throw new Error('Maximum 1000 keywords per request');
+    const tooLong = keywords.find((k) => k.length > 255);
+    if (tooLong)
+        throw new Error('Each keyword must be 255 characters or fewer');
+    return keywords;
+}
+function parseTaskIds(input) {
+    if (!input || input.trim() === '')
+        throw new Error('Task ID(s) required');
+    const items = input
+        .split(/[,\n]/)
+        .map((i) => i.trim())
+        .filter((i) => i.length > 0);
+    if (items.length === 0)
+        throw new Error('Provide at least one task ID');
+    return items;
+}
+async function SerpClassicOperations(index) {
+    const operation = this.getNodeParameter('operation', index);
+    let method = 'GET';
+    let endpoint = '';
+    const params = {};
+    const body = {};
+    switch (operation) {
+        case 'addTasks': {
+            method = 'POST';
+            endpoint = '/serp/classic/tasks';
+            const searchEngine = this.getNodeParameter('searchEngine', index);
+            const device = this.getNodeParameter('device', index);
+            const languageCode = this.getNodeParameter('languageCode', index);
+            const locationId = this.getNodeParameter('locationId', index);
+            const keywordsInput = this.getNodeParameter('keywords', index);
+            const tag = this.getNodeParameter('tag', index, '');
+            const keywords = parseKeywords(keywordsInput);
+            body.search_engine = searchEngine;
+            body.device = device;
+            body.language_code = languageCode;
+            if (typeof locationId !== 'number' || Number.isNaN(locationId)) {
+                throw new Error('locationId must be a valid integer');
+            }
+            body.location_id = Math.floor(locationId);
+            body.query = keywords;
+            if (tag && tag.trim() !== '')
+                body.tag = tag;
+            const response = await apiRequest_1.apiRequest.call(this, method, endpoint, body, params, index);
+            if (Array.isArray(response)) {
+                return response.map((id) => ({ task_id: id }));
+            }
+            return response;
+        }
+        case 'getResults': {
+            endpoint = '/serp/classic/tasks';
+            method = 'GET';
+            const taskId = this.getNodeParameter('taskId', index);
+            if (!taskId)
+                throw new Error('taskId is required');
+            params.task_id = taskId;
+            const response = await apiRequest_1.apiRequest.call(this, method, endpoint, {}, params, index);
+            if (response && response.status === 'processing') {
+                return { status: 'processing', raw: response };
+            }
+            return response;
+        }
+        case 'listTasks': {
+            endpoint = '/serp/classic/tasks';
+            method = 'GET';
+            const filters = this.getNodeParameter('listFilters', index, {});
+            if (filters.limit)
+                params.limit = filters.limit;
+            const response = await apiRequest_1.apiRequest.call(this, method, endpoint, {}, params, index);
+            return response;
+        }
+        case 'getAdvancedResults': {
+            endpoint = '/serp/classic/tasks/results_advanced';
+            method = 'GET';
+            const taskIdInput = this.getNodeParameter('taskId', index);
+            const taskIds = parseTaskIds(taskIdInput);
+            const aggregated = [];
+            for (const tid of taskIds) {
+                const localParams = { task_id: tid };
+                const resp = await apiRequest_1.apiRequest.call(this, method, endpoint, {}, localParams, index);
+                if (resp && resp.status === 'processing') {
+                    aggregated.push({ task_id: tid, status: 'processing' });
+                    continue;
+                }
+                if (resp && resp.request_metadata) {
+                    aggregated.push({ task_id: tid, ...resp });
+                }
+                else {
+                    aggregated.push({ task_id: tid, raw: resp });
+                }
+            }
+            return aggregated;
+        }
+        case 'getLocations': {
+            endpoint = '/serp/classic/locations';
+            method = 'GET';
+            const countryCode = this.getNodeParameter('countryCode', index, '');
+            const q = this.getNodeParameter('q', index, '');
+            if (countryCode && countryCode.trim() !== '')
+                params.country_code = countryCode;
+            if (q && q.trim() !== '')
+                params.q = q;
+            const response = await apiRequest_1.apiRequest.call(this, method, endpoint, {}, params, index);
+            if (response && response.data)
+                return response.data;
+            return response;
+        }
+        default:
+            throw new Error(`Unknown operation: ${operation}`);
+    }
+}

package/dist/nodes/SeRanking/seranking.svg

@@ -1,4 +1,6 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" width="100" height="100">
-  <rect width="100" height="100" rx="15" fill="#4A90E2"/>
-  <text x="50" y="60" font-family="Arial, sans-serif" font-size="48" font-weight="bold" fill="white" text-anchor="middle">SE</text>
-</svg>
+<?xml version="1.0" encoding="UTF-8"?>
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" width="100" height="100">
+<path d="M0 0 C33 0 66 0 100 0 C100 33 100 66 100 100 C67 100 34 100 0 100 C0 67 0 34 0 0 Z " fill="#123AF8" transform="translate(0,0)"/>
+<path d="M0 0 C2.32849974 2.32849974 1.88976398 6.58005112 2.02441406 9.70385742 C1.7575027 17.04998613 -2.54423971 20.81482648 -7.66821289 25.60620117 C-13.12621684 30.43860935 -16.46675285 32.25875633 -23.953125 32.1953125 C-24.61334656 32.1924826 -25.27356812 32.18965271 -25.95379639 32.18673706 C-28.05271897 32.17558415 -30.15120742 32.15048946 -32.25 32.125 C-33.67707715 32.11496384 -35.10416102 32.1058391 -36.53125 32.09765625 C-40.02097328 32.07566111 -43.51044423 32.04116536 -47 32 C-41.76636873 25.76129422 -36.35356926 19.69382768 -30.74511719 13.79077148 C-29.66705845 12.64074469 -28.60462624 11.47586294 -27.55859375 10.29663086 C-19.11519234 0.80706239 -12.74587141 -2.12034308 0 0 Z " fill="#F9FAFE" transform="translate(65,15)"/>
+<path d="M0 0 C1.02150398 0.00636726 1.02150398 0.00636726 2.06364441 0.01286316 C4.22383334 0.02956265 6.38306517 0.06719563 8.54296875 0.10546875 C10.01365833 0.12052701 11.48436264 0.13421341 12.95507812 0.14648438 C16.54718232 0.17943661 20.13873201 0.23115702 23.73046875 0.29296875 C19.55764529 5.26870293 15.21519448 9.95601662 10.6171875 14.5390625 C9.96216751 15.19503922 9.30714752 15.85101593 8.63227844 16.52687073 C7.2612068 17.89861777 5.88889202 19.26912335 4.51538086 20.63842773 C2.40295774 22.74544132 0.29599267 24.85780901 -1.81054688 26.97070312 C-3.14681443 28.3063108 -4.48339166 29.64160874 -5.8203125 30.9765625 C-6.76865715 31.9279435 -6.76865715 31.9279435 -7.73616028 32.89854431 C-12.15454881 37.29296875 -12.15454881 37.29296875 -13.26953125 37.29296875 C-13.76453125 29.86796875 -13.76453125 29.86796875 -14.26953125 22.29296875 C-21.19953125 21.79796875 -21.19953125 21.79796875 -28.26953125 21.29296875 C-26.62453816 18.00298258 -25.65587716 16.42392127 -23.1875 13.9453125 C-22.58486328 13.34009766 -21.98222656 12.73488281 -21.36132812 12.11132812 C-20.73291016 11.49064453 -20.10449219 10.86996094 -19.45703125 10.23046875 C-18.84021484 9.60591797 -18.22339844 8.98136719 -17.58789062 8.33789062 C-16.98138672 7.73396484 -16.37488281 7.13003906 -15.75 6.5078125 C-14.92858521 5.68978149 -14.92858521 5.68978149 -14.09057617 4.85522461 C-9.40938514 0.83927858 -6.19087176 -0.07643052 0 0 Z " fill="#F6F7FE" transform="translate(58.26953125,47.70703125)"/>
+</svg>

package/dist/nodes/SeRanking/utils/apiRequest.js

@@ -30,9 +30,6 @@ async function apiRequest(method, endpoint, body = {}, query = {}, itemIndex = 0
             baseUrl = 'https://api.seranking.com/v1';
         }
         options.url = `${baseUrl}${endpoint}`;
-        options.headers = {
-            'Authorization': `Token ${credentials.apiToken}`,
-        };
         options.json = true;
     }
     if (Object.keys(query).length > 0) {
@@ -79,7 +76,7 @@ async function apiRequest(method, endpoint, body = {}, query = {}, itemIndex = 0
         }
     }
     try {
-        const response = await this.helpers.httpRequest(options);
+        const response = await this.helpers.httpRequestWithAuthentication.call(this, 'seRankingApi', options);
         return response;
     }
     catch (error) {
@@ -126,15 +123,6 @@ async function apiRequest(method, endpoint, body = {}, query = {}, itemIndex = 0
         else {
             errorMessage = (errorData === null || errorData === void 0 ? void 0 : errorData.message) || (errorData === null || errorData === void 0 ? void 0 : errorData.error) || error.message || 'Request failed';
         }
-        console.error('SE Ranking API Error:', {
-            status: statusCode,
-            message: errorMessage,
-            url: options.url,
-            method: options.method,
-            params: options.qs,
-            itemIndex,
-            errorData,
-        });
         throw new n8n_workflow_1.NodeOperationError(this.getNode(), `SE Ranking API Error: ${errorMessage}`, {
             itemIndex,
             description: errorDescription,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@seranking/n8n-nodes-seranking",
-    "version": "1.2.3",
+    "version": "1.3.1",
     "description": "n8n connector for SE Ranking API - AI Search, Backlinks, Domain Analysis, Keyword Research, and Website Audit",
     "license": "MIT",
     "homepage": "https://github.com/seranking/n8n-nodes-seranking",
@@ -18,6 +18,7 @@
     ],
     "keywords": [
         "n8n",
+        "n8n-community-nodes-package",
         "n8n-community-node-package",
         "n8n-nodes-seranking",
         "seranking",
@@ -26,9 +27,11 @@
         "backlinks",
         "domain-analysis",
         "ai-search",
+        "serp-task",
         "website-audit"
     ],
     "n8n": {
+        "n8nNodesApiVersion": 1,
         "nodes": [
             "dist/nodes/SeRanking/SeRanking.node.js"
         ],
@@ -50,10 +53,13 @@
         "@typescript-eslint/eslint-plugin": "^5.59.0",
         "@typescript-eslint/parser": "^5.59.0",
         "eslint": "^8.40.0",
-        "eslint-plugin-n8n-nodes-base": "^1.12.0",
+        "eslint-plugin-n8n-nodes-base": "^1.16.4",
         "n8n-workflow": "^1.17.0",
         "prettier": "^2.8.8",
-        "typescript": "^5.0.4"
+        "typescript": "^5.9.3"
+    },
+    "peerDependencies": {
+        "n8n-workflow": "*"
     },
     "engines": {
         "node": ">=18.0.0"