n8n-nodes-crawlora 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Crawlora
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,72 @@
+# n8n-nodes-crawlora
+
+An [n8n](https://n8n.io) community node for [Crawlora](https://crawlora.net) — get structured web
+data from the public web (search, maps, e‑commerce, social, finance, page content, and more) without
+maintaining your own parsers.
+
+This node exposes the Crawlora API as n8n **Resources** (one per data source — Web, Google, Amazon,
+YouTube, Maps, Finance, …) and **Operations** (the endpoints under each). It is generated from the
+Crawlora OpenAPI spec, so it stays in sync with the API.
+
+## Installation
+
+In n8n: **Settings → Community Nodes → Install**, then enter `n8n-nodes-crawlora`.
+
+(Self-hosted manual install and local development are covered under "Development" below.)
+
+## Credentials
+
+Create a **Crawlora API** credential and paste your API key. It is sent as the `x-api-key` header on
+every request. Get a key from your [Crawlora dashboard](https://crawlora.net/app/api-keys) — new
+accounts include a free monthly credit allowance, no card required.
+
+## Usage
+
+1. Add the **Crawlora** node to a workflow.
+2. Pick a **Resource** (the data source) and an **Operation** (the endpoint).
+3. Fill in the fields and run.
+
+The node is also **usable as a tool** inside the n8n **AI Agent**, so an agent can call Crawlora
+operations directly.
+
+> Prefer MCP? Crawlora also ships a hosted MCP server with the full catalog — use n8n's **MCP Client**
+> node to call every Crawlora tool from an AI Agent workflow. See https://docs.crawlora.net.
+
+## Development
+
+The node's properties are **generated at build time** from the Crawlora OpenAPI spec and committed as
+`nodes/Crawlora/properties.json`, so the published package has **no runtime dependencies**.
+
+```bash
+npm install
+SWAGGER_PATH=<file-or-url> npm run gen   # regenerate properties.json from the Crawlora API spec
+npm run build                            # tsc + copy assets into dist/
+npm run smoke                            # load the built node and print resource/operation counts
+```
+
+`npm run gen` loads the Crawlora OpenAPI/Swagger spec from `SWAGGER_PATH` (a file path or URL),
+converts it to OpenAPI 3.0, drops internal/account endpoints, and rebuilds the node properties.
+
+## Publishing
+
+CI builds and smoke-tests on every push/PR. To release, push a `v*` tag — the **Publish** workflow
+publishes to npm with [provenance](https://docs.npmjs.com/generating-provenance-statements) (required
+for n8n community-node verification since 2026-05-01):
+
+```bash
+npm version <patch|minor>   # creates the v* tag
+git push --follow-tags
+```
+
+One-time: add an automation npm token as the `NPM_TOKEN` repository secret. Lint the package against
+n8n's guidelines with `npx @n8n/scan-community-package .`, then submit it for the verified badge per
+the [n8n community-node docs](https://docs.n8n.io/integrations/creating-nodes/deploy/submit-community-nodes/).
+
+## Links
+
+- API documentation: https://docs.crawlora.net
+- Crawlora: https://crawlora.net
+
+## License
+
+[MIT](./LICENSE)

package/dist/credentials/CrawloraApi.credentials.d.ts

@@ -0,0 +1,9 @@
+import { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class CrawloraApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}

package/dist/credentials/CrawloraApi.credentials.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CrawloraApi = void 0;
+class CrawloraApi {
+    constructor() {
+        this.name = 'crawloraApi';
+        this.displayName = 'Crawlora API';
+        this.documentationUrl = 'https://docs.crawlora.net';
+        this.properties = [
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                required: true,
+                description: 'Your Crawlora API key. Find it at https://crawlora.net/app/api-keys (new accounts include a free monthly credit allowance).',
+            },
+        ];
+        // Crawlora authenticates with the x-api-key header (not a Bearer token).
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    'x-api-key': '={{$credentials.apiKey}}',
+                },
+            },
+        };
+        // Cheap, key-only request to validate the credential.
+        this.test = {
+            request: {
+                baseURL: 'https://api.crawlora.net/api/v1',
+                url: '/google/suggest',
+                qs: { q: 'crawlora' },
+            },
+        };
+    }
+}
+exports.CrawloraApi = CrawloraApi;

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

@@ -0,0 +1,4 @@
+import { INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class Crawlora implements INodeType {
+    description: INodeTypeDescription;
+}

package/dist/nodes/Crawlora/Crawlora.node.js

@@ -0,0 +1,47 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Crawlora = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+// Properties are GENERATED AT BUILD TIME from the Crawlora OpenAPI spec
+// (`npm run gen`) and committed as properties.json, so the published node has
+// NO runtime dependencies (an n8n verification requirement). Re-run `npm run gen`
+// whenever the API changes to keep the node in sync.
+const properties_json_1 = __importDefault(require("./properties.json"));
+class Crawlora {
+    constructor() {
+        this.description = {
+            displayName: 'Crawlora',
+            name: 'crawlora',
+            icon: 'file:crawlora.svg',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
+            description: 'Get structured web data from the public web via the Crawlora API',
+            defaults: {
+                name: 'Crawlora',
+            },
+            // Make the node usable as a tool inside the n8n AI Agent.
+            usableAsTool: true,
+            inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            credentials: [
+                {
+                    name: 'crawloraApi',
+                    required: true,
+                },
+            ],
+            requestDefaults: {
+                headers: {
+                    Accept: 'application/json',
+                    'Content-Type': 'application/json',
+                },
+                baseURL: 'https://api.crawlora.net/api/v1',
+            },
+            properties: properties_json_1.default,
+        };
+    }
+}
+exports.Crawlora = Crawlora;

package/dist/nodes/Crawlora/crawlora.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64">
+  <rect width="64" height="64" rx="14" fill="#0B5FFF"/>
+  <path d="M41 24.5a12 12 0 1 0 0 15" fill="none" stroke="#fff" stroke-width="5" stroke-linecap="round"/>
+  <circle cx="44" cy="32" r="4" fill="#fff"/>
+</svg>