n8n-nodes-seoscoreapi 1.0.0

package/README.md

@@ -0,0 +1,46 @@
+# n8n-nodes-seoscoreapi
+
+[n8n](https://n8n.io/) community node for [SEO Score API](https://seoscoreapi.com) — audit any URL for SEO issues in your automation workflows.
+
+## Operations
+
+| Operation | Description |
+|-----------|-------------|
+| **Audit URL** | Run a full 28-check SEO audit on any URL |
+| **Batch Audit** | Audit up to 10 URLs in one call (paid plans) |
+| **Check Usage** | View your API usage and limits |
+
+## Setup
+
+1. Get a free API key at [seoscoreapi.com](https://seoscoreapi.com) (no credit card needed)
+2. Install this node: **Settings → Community Nodes → Install → `n8n-nodes-seoscoreapi`**
+3. Add your API key in the credentials
+
+## Example Workflows
+
+### Scheduled SEO Monitoring
+**Cron (weekly)** → **SEO Score API (Audit)** → **IF (score < 80)** → **Slack/Email alert**
+
+### Bulk Client Audits
+**Spreadsheet (client URLs)** → **SEO Score API (Audit)** → **Google Sheets (write results)**
+
+### CI/CD Quality Gate
+**Webhook (deploy event)** → **SEO Score API (Audit)** → **IF (score < 70)** → **Slack alert**
+
+## Output
+
+The Audit operation returns:
+- `score` (0-100)
+- `grade` (A+ to F)
+- `checks` (28 individual check results)
+- `priorities` (top issues to fix, with severity)
+
+## Links
+
+- [SEO Score API](https://seoscoreapi.com)
+- [API Docs](https://seoscoreapi.com/docs)
+- [GitHub](https://github.com/SeoScoreAPI/n8n-nodes-seoscoreapi)
+
+## License
+
+MIT

package/credentials/SeoScoreApi.credentials.js

@@ -0,0 +1,22 @@
+"use strict";
+
+class SeoScoreApiCredentials {
+  constructor() {
+    this.name = "seoScoreApi";
+    this.displayName = "SEO Score API";
+    this.documentationUrl = "https://seoscoreapi.com/docs";
+    this.properties = [
+      {
+        displayName: "API Key",
+        name: "apiKey",
+        type: "string",
+        typeOptions: { password: true },
+        default: "",
+        required: true,
+        description: "Your SEO Score API key. Get one free at https://seoscoreapi.com",
+      },
+    ];
+  }
+}
+
+module.exports = { SeoScoreApiCredentials };

package/index.js

@@ -0,0 +1,4 @@
+"use strict";
+const { SeoScoreApiCredentials } = require("./credentials/SeoScoreApi.credentials");
+const { nodeClass: SeoScoreApi } = require("./nodes/SeoScoreApi/SeoScoreApi.node");
+module.exports = { SeoScoreApiCredentials, SeoScoreApi };

package/nodes/SeoScoreApi/SeoScoreApi.node.js

@@ -0,0 +1,121 @@
+"use strict";
+
+class SeoScoreApi {
+  constructor() {
+    this.description = {
+      displayName: "SEO Score API",
+      name: "seoScoreApi",
+      icon: "file:seoscoreapi.svg",
+      group: ["transform"],
+      version: 1,
+      subtitle: '={{$parameter["operation"]}}',
+      description: "Audit any URL for SEO issues — 28 checks, scored JSON response",
+      defaults: { name: "SEO Score API" },
+      inputs: ["main"],
+      outputs: ["main"],
+      credentials: [
+        {
+          name: "seoScoreApi",
+          required: true,
+        },
+      ],
+      properties: [
+        {
+          displayName: "Operation",
+          name: "operation",
+          type: "options",
+          noDataExpression: true,
+          options: [
+            {
+              name: "Audit URL",
+              value: "audit",
+              description: "Run a full SEO audit on a URL",
+              action: "Audit a URL",
+            },
+            {
+              name: "Batch Audit",
+              value: "batchAudit",
+              description: "Audit multiple URLs at once (paid plans only)",
+              action: "Batch audit URLs",
+            },
+            {
+              name: "Check Usage",
+              value: "usage",
+              description: "Check your API usage and limits",
+              action: "Check usage",
+            },
+          ],
+          default: "audit",
+        },
+        {
+          displayName: "URL",
+          name: "url",
+          type: "string",
+          default: "",
+          required: true,
+          displayOptions: { show: { operation: ["audit"] } },
+          placeholder: "https://example.com",
+          description: "The URL to audit for SEO issues",
+        },
+        {
+          displayName: "URLs",
+          name: "urls",
+          type: "string",
+          default: "",
+          required: true,
+          displayOptions: { show: { operation: ["batchAudit"] } },
+          placeholder: "https://example.com, https://example.org",
+          description: "Comma-separated list of URLs to audit (max 10)",
+        },
+      ],
+    };
+  }
+
+  async execute() {
+    const items = this.getInputData();
+    const operation = this.getNodeParameter("operation", 0);
+    const credentials = await this.getCredentials("seoScoreApi");
+    const returnData = [];
+
+    for (let i = 0; i < items.length; i++) {
+      let response;
+
+      if (operation === "audit") {
+        const url = this.getNodeParameter("url", i);
+        response = await this.helpers.request({
+          method: "GET",
+          url: `https://seoscoreapi.com/audit`,
+          qs: { url },
+          headers: { "X-API-Key": credentials.apiKey },
+          json: true,
+        });
+      } else if (operation === "batchAudit") {
+        const urlsStr = this.getNodeParameter("urls", i);
+        const urls = urlsStr.split(",").map((u) => u.trim()).filter(Boolean);
+        response = await this.helpers.request({
+          method: "POST",
+          url: "https://seoscoreapi.com/audit/batch",
+          headers: {
+            "X-API-Key": credentials.apiKey,
+            "Content-Type": "application/json",
+          },
+          body: { urls },
+          json: true,
+        });
+      } else if (operation === "usage") {
+        response = await this.helpers.request({
+          method: "GET",
+          url: "https://seoscoreapi.com/usage",
+          headers: { "X-API-Key": credentials.apiKey },
+          json: true,
+        });
+      }
+
+      returnData.push({ json: response });
+    }
+
+    return [returnData];
+  }
+}
+
+module.exports = { nodeClass: SeoScoreApi };

package/nodes/SeoScoreApi/seoscoreapi.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" fill="none">
+  <rect width="64" height="64" rx="12" fill="#2563eb"/>
+  <text x="32" y="28" text-anchor="middle" font-family="Arial,sans-serif" font-weight="bold" font-size="16" fill="white">SEO</text>
+  <text x="32" y="46" text-anchor="middle" font-family="Arial,sans-serif" font-weight="bold" font-size="12" fill="#93c5fd">SCORE</text>
+</svg>

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "n8n-nodes-seoscoreapi",
+  "version": "1.0.0",
+  "description": "n8n node for SEO Score API — audit any URL for SEO issues with 28 checks",
+  "keywords": ["n8n-community-node-package", "n8n", "seo", "audit", "seo-score"],
+  "license": "MIT",
+  "homepage": "https://seoscoreapi.com",
+  "author": {
+    "name": "SEO Score API",
+    "email": "info@seoscoreapi.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SeoScoreAPI/n8n-nodes-seoscoreapi"
+  },
+  "main": "index.js",
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": ["credentials/SeoScoreApi.credentials.js"],
+    "nodes": ["nodes/SeoScoreApi/SeoScoreApi.node.js"]
+  },
+  "files": ["nodes", "credentials", "index.js"]
+}