n8n-nodes-geekflare-api 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +319 -0
- package/dist/credentials/GeekflareApi.credentials.d.ts +7 -0
- package/dist/credentials/GeekflareApi.credentials.js +25 -0
- package/dist/credentials/GeekflareApi.credentials.js.map +1 -0
- package/dist/index.d.ts +2 -0
- package/dist/index.js +8 -0
- package/dist/index.js.map +1 -0
- package/dist/nodes/Geekflare/Geekflare.node.d.ts +5 -0
- package/dist/nodes/Geekflare/Geekflare.node.js +882 -0
- package/dist/nodes/Geekflare/Geekflare.node.js.map +1 -0
- package/dist/nodes/Geekflare/favicon.svg +33 -0
- package/package.json +57 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Geekflare
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
ADDED
|
@@ -0,0 +1,319 @@
|
|
|
1
|
+
# n8n-nodes-geekflare-api
|
|
2
|
+
|
|
3
|
+
Official n8n community node for the [Geekflare API](https://geekflare.com/api/). Use Geekflare's web intelligence tools directly inside your n8n workflows — no code required.
|
|
4
|
+
|
|
5
|
+
## What you can do
|
|
6
|
+
|
|
7
|
+
- **Scrape** any webpage and get back clean HTML, Markdown, JSON, or LLM-ready text
|
|
8
|
+
- **Capture screenshots** with full-page, Retina, and CAPTCHA-bypass support
|
|
9
|
+
- **Search the web** with structured results and optional AI-grounded answers
|
|
10
|
+
- **Convert URLs to PDF** with full layout control
|
|
11
|
+
- **Run DNS, TLS, HTTP, and port diagnostics** on any domain
|
|
12
|
+
- **Audit performance** with Lighthouse, TTFB, and load time checks
|
|
13
|
+
- **Monitor uptime**, redirect chains, broken links, and mixed content
|
|
14
|
+
|
|
15
|
+
## Installation
|
|
16
|
+
|
|
17
|
+
In your n8n instance, go to **Settings → Community Nodes → Install** and enter:
|
|
18
|
+
|
|
19
|
+
```
|
|
20
|
+
n8n-nodes-geekflare-api
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## Get an API Key
|
|
24
|
+
|
|
25
|
+
Sign up at [geekflare.com/api](https://geekflare.com/api) and copy your API key from the dashboard.
|
|
26
|
+
|
|
27
|
+
## Credentials Setup
|
|
28
|
+
|
|
29
|
+
After installing the node:
|
|
30
|
+
|
|
31
|
+
1. Open any workflow and add a **Geekflare** node
|
|
32
|
+
2. Click **Create new credential** in the node panel
|
|
33
|
+
3. Paste your API key and save
|
|
34
|
+
|
|
35
|
+
## Operations
|
|
36
|
+
|
|
37
|
+
### Web Scraping
|
|
38
|
+
|
|
39
|
+
Scrape full page content from any URL. Returns HTML, Markdown, JSON, or LLM-optimised text.
|
|
40
|
+
|
|
41
|
+
| Parameter | Type | Default | Description |
|
|
42
|
+
| -------------- | --------------------- | -------------- | ---------------------------------------------------------------------------------------------------- |
|
|
43
|
+
| `url` \* | string | — | Target URL |
|
|
44
|
+
| `formats` | array | `["markdown"]` | Output formats (up to 3): `html`, `markdown`, `json`, `markdown-llm`, `html-llm`, `text`, `text-llm` |
|
|
45
|
+
| `device` | `desktop` \| `mobile` | `desktop` | Device to emulate |
|
|
46
|
+
| `proxyCountry` | string | — | Route through a country ISO code (e.g. `us`) |
|
|
47
|
+
| `renderJS` | boolean | `true` | Execute JavaScript before extracting. Disable for faster static scrapes |
|
|
48
|
+
| `fileOutput` | boolean | `false` | Return a download URL instead of inline content |
|
|
49
|
+
| `blockAds` | boolean | `true` | Block ads during scrape |
|
|
50
|
+
| `stealth` | boolean | `false` | Bypass CAPTCHAs (slower) |
|
|
51
|
+
|
|
52
|
+
---
|
|
53
|
+
|
|
54
|
+
### Meta Scraping
|
|
55
|
+
|
|
56
|
+
Scrape meta tags — title, description, Open Graph, Twitter cards, and more.
|
|
57
|
+
|
|
58
|
+
| Parameter | Type | Default | Description |
|
|
59
|
+
| -------------- | --------------------- | --------- | ---------------- |
|
|
60
|
+
| `url` \* | string | — | Target URL |
|
|
61
|
+
| `format` | `json` \| `markdown` | `json` | Output format |
|
|
62
|
+
| `device` | `desktop` \| `mobile` | `desktop` | |
|
|
63
|
+
| `proxyCountry` | string | — | Country ISO code |
|
|
64
|
+
| `renderJS` | boolean | `true` | |
|
|
65
|
+
| `fileOutput` | boolean | `false` | |
|
|
66
|
+
| `blockAds` | boolean | `true` | |
|
|
67
|
+
|
|
68
|
+
---
|
|
69
|
+
|
|
70
|
+
### Screenshot
|
|
71
|
+
|
|
72
|
+
Capture a screenshot of any website. Supports full-page, Retina, and AI-friendly link highlighting.
|
|
73
|
+
|
|
74
|
+
| Parameter | Type | Default | Description |
|
|
75
|
+
| ---------------- | ------------------------- | --------- | -------------------------------------------------------------- |
|
|
76
|
+
| `url` \* | string | — | Target URL |
|
|
77
|
+
| `device` | `desktop` \| `mobile` | `desktop` | |
|
|
78
|
+
| `type` | `png` \| `jpeg` \| `webp` | `png` | |
|
|
79
|
+
| `proxyCountry` | string | — | Country ISO code |
|
|
80
|
+
| `fullPage` | boolean | `false` | |
|
|
81
|
+
| `blockAds` | boolean | `true` | |
|
|
82
|
+
| `hideCookie` | boolean | `true` | Remove cookie banners |
|
|
83
|
+
| `skipCaptcha` | boolean | `true` | Bypass Cloudflare / reCAPTCHA |
|
|
84
|
+
| `addTimestamp` | boolean | `false` | |
|
|
85
|
+
| `highlightLinks` | boolean | `false` | Draw borders around links/buttons — great for AI vision models |
|
|
86
|
+
| `pageHeight` | number | — | Custom page height (px) |
|
|
87
|
+
| `viewportWidth` | number | — | Viewport width (px, default 1366) |
|
|
88
|
+
| `viewportHeight` | number | — | Viewport height (px, default 768) |
|
|
89
|
+
| `delay` | number | — | Seconds to wait after page load |
|
|
90
|
+
| `quality` | number | `90` | Image quality 1–100 |
|
|
91
|
+
| `scaleFactor` | number | — | Device pixel ratio (use 2–3 for Retina) |
|
|
92
|
+
|
|
93
|
+
---
|
|
94
|
+
|
|
95
|
+
### Search
|
|
96
|
+
|
|
97
|
+
Search the web and return clean, structured results. Supports web, news, and image search with optional AI-grounded answers.
|
|
98
|
+
|
|
99
|
+
| Parameter | Type | Default | Description |
|
|
100
|
+
| ---------------- | --------------------------------- | ------- | -------------------------------------------------- |
|
|
101
|
+
| `query` \* | string | — | Search query |
|
|
102
|
+
| `limit` | number | `10` | Number of results |
|
|
103
|
+
| `time` | string | — | Time filter: `any`, `d`, `w`, `m`, `y`, `d7`, `h6` |
|
|
104
|
+
| `location` | string | — | Country ISO code to localise results |
|
|
105
|
+
| `source` | `web` \| `news` \| `images` | `web` | |
|
|
106
|
+
| `category` | `general` \| `code` \| `research` | — | |
|
|
107
|
+
| `format` | `json` \| `markdown` \| `html` | `json` | |
|
|
108
|
+
| `includeDomains` | string | — | Comma-separated domains to include |
|
|
109
|
+
| `excludeDomains` | string | — | Comma-separated domains to exclude |
|
|
110
|
+
| `groundedAnswer` | boolean | `false` | Generate an AI answer synthesised from results |
|
|
111
|
+
| `scrape` | boolean | `false` | Also scrape top result pages |
|
|
112
|
+
| `scrapeLimit` | number | — | How many pages to scrape (requires `scrape: true`) |
|
|
113
|
+
|
|
114
|
+
---
|
|
115
|
+
|
|
116
|
+
### URL to PDF
|
|
117
|
+
|
|
118
|
+
Convert any URL to a downloadable PDF.
|
|
119
|
+
|
|
120
|
+
| Parameter | Type | Default | Description |
|
|
121
|
+
| -------------- | ---------------------------------------------- | ---------- | --------------------------------- |
|
|
122
|
+
| `url` \* | string | — | Target URL |
|
|
123
|
+
| `device` | `desktop` \| `mobile` | `desktop` | |
|
|
124
|
+
| `format` | `a4` `a3` `a5` `a6` `letter` `legal` `a0`–`a2` | `a4` | Paper size |
|
|
125
|
+
| `orientation` | `portrait` \| `landscape` | `portrait` | |
|
|
126
|
+
| `proxyCountry` | string | — | Country ISO code |
|
|
127
|
+
| `scale` | number | — | Zoom level (e.g. `0.8` to shrink) |
|
|
128
|
+
| `marginTop` | number | `25` | Top margin (mm) |
|
|
129
|
+
| `marginBottom` | number | `25` | Bottom margin (mm) |
|
|
130
|
+
| `marginLeft` | number | `25` | Left margin (mm) |
|
|
131
|
+
| `marginRight` | number | `25` | Right margin (mm) |
|
|
132
|
+
| `hideCookie` | boolean | `true` | Remove cookie banners |
|
|
133
|
+
| `skipCaptcha` | boolean | `true` | Bypass anti-bot challenges |
|
|
134
|
+
| `addTimestamp` | boolean | `false` | |
|
|
135
|
+
|
|
136
|
+
---
|
|
137
|
+
|
|
138
|
+
### DNS Record Lookup
|
|
139
|
+
|
|
140
|
+
Look up DNS records for a domain.
|
|
141
|
+
|
|
142
|
+
| Parameter | Type | Default |
|
|
143
|
+
| --------- | ------------------------------------------------------------- | ------------------------------------ |
|
|
144
|
+
| `url` \* | string | — |
|
|
145
|
+
| `types` | array of `A` `AAAA` `CNAME` `MX` `NS` `SOA` `TXT` `CAA` `SRV` | `["A", "AAAA", "CNAME", "MX", "NS"]` |
|
|
146
|
+
|
|
147
|
+
---
|
|
148
|
+
|
|
149
|
+
### Site Up Check
|
|
150
|
+
|
|
151
|
+
Check if a site is up or down.
|
|
152
|
+
|
|
153
|
+
| Parameter | Type | Default |
|
|
154
|
+
| ---------------- | ------- | ------- |
|
|
155
|
+
| `url` \* | string | — |
|
|
156
|
+
| `proxyCountry` | string | — |
|
|
157
|
+
| `followRedirect` | boolean | `false` |
|
|
158
|
+
|
|
159
|
+
---
|
|
160
|
+
|
|
161
|
+
### Redirect Chain Check
|
|
162
|
+
|
|
163
|
+
Trace the full redirect chain of a URL.
|
|
164
|
+
|
|
165
|
+
| Parameter | Type |
|
|
166
|
+
| -------------- | ------ |
|
|
167
|
+
| `url` \* | string |
|
|
168
|
+
| `proxyCountry` | string |
|
|
169
|
+
|
|
170
|
+
---
|
|
171
|
+
|
|
172
|
+
### Broken Link Check
|
|
173
|
+
|
|
174
|
+
Find all broken links on a webpage.
|
|
175
|
+
|
|
176
|
+
| Parameter | Type | Default |
|
|
177
|
+
| ---------------- | ------- | ------- |
|
|
178
|
+
| `url` \* | string | — |
|
|
179
|
+
| `proxyCountry` | string | — |
|
|
180
|
+
| `followRedirect` | boolean | `false` |
|
|
181
|
+
|
|
182
|
+
---
|
|
183
|
+
|
|
184
|
+
### Open Port Scan
|
|
185
|
+
|
|
186
|
+
Scan open ports on a host.
|
|
187
|
+
|
|
188
|
+
| Parameter | Type | Description |
|
|
189
|
+
| ------------ | ------------------------------ | ------------------------------------- |
|
|
190
|
+
| `url` \* | string | Target URL or hostname |
|
|
191
|
+
| `topPorts` | `50` `100` `500` `1000` `5000` | Scan top N common ports |
|
|
192
|
+
| `portRanges` | string | Custom ranges e.g. `80,443,1000-1010` |
|
|
193
|
+
|
|
194
|
+
---
|
|
195
|
+
|
|
196
|
+
### TLS/SSL Scan
|
|
197
|
+
|
|
198
|
+
Inspect TLS/SSL configuration — protocols, ciphers, certificate details.
|
|
199
|
+
|
|
200
|
+
| Parameter | Type |
|
|
201
|
+
| --------- | ------ |
|
|
202
|
+
| `url` \* | string |
|
|
203
|
+
|
|
204
|
+
---
|
|
205
|
+
|
|
206
|
+
### Lighthouse Audit
|
|
207
|
+
|
|
208
|
+
Run a full Lighthouse audit — performance, SEO, accessibility, and best practices.
|
|
209
|
+
|
|
210
|
+
| Parameter | Type | Default | Description |
|
|
211
|
+
| ---------------- | --------------------- | --------- | --------------------------------------------------------- |
|
|
212
|
+
| `url` \* | string | — | |
|
|
213
|
+
| `device` | `desktop` \| `mobile` | `desktop` | |
|
|
214
|
+
| `proxyCountry` | string | — | Country ISO code |
|
|
215
|
+
| `followRedirect` | boolean | `false` | |
|
|
216
|
+
| `parameters` | string | — | Extra Lighthouse CLI flags (e.g. `--only-categories=seo`) |
|
|
217
|
+
|
|
218
|
+
---
|
|
219
|
+
|
|
220
|
+
### Load Time
|
|
221
|
+
|
|
222
|
+
Measure full page load time from any location.
|
|
223
|
+
|
|
224
|
+
| Parameter | Type | Default |
|
|
225
|
+
| ---------------- | ------- | ------- |
|
|
226
|
+
| `url` \* | string | — |
|
|
227
|
+
| `proxyCountry` | string | — |
|
|
228
|
+
| `followRedirect` | boolean | `false` |
|
|
229
|
+
|
|
230
|
+
---
|
|
231
|
+
|
|
232
|
+
### TTFB Measurement
|
|
233
|
+
|
|
234
|
+
Measure Time To First Byte (TTFB).
|
|
235
|
+
|
|
236
|
+
| Parameter | Type | Default |
|
|
237
|
+
| ---------------- | ------- | ------- |
|
|
238
|
+
| `url` \* | string | — |
|
|
239
|
+
| `followRedirect` | boolean | `false` |
|
|
240
|
+
|
|
241
|
+
---
|
|
242
|
+
|
|
243
|
+
### HTTP Header Inspect
|
|
244
|
+
|
|
245
|
+
Retrieve HTTP response headers for a URL.
|
|
246
|
+
|
|
247
|
+
| Parameter | Type | Default |
|
|
248
|
+
| ---------------- | ------- | ------- |
|
|
249
|
+
| `url` \* | string | — |
|
|
250
|
+
| `proxyCountry` | string | — |
|
|
251
|
+
| `followRedirect` | boolean | `false` |
|
|
252
|
+
|
|
253
|
+
---
|
|
254
|
+
|
|
255
|
+
### HTTP Protocol Check
|
|
256
|
+
|
|
257
|
+
Check which HTTP protocol versions (HTTP/1.1, HTTP/2, HTTP/3) a server supports.
|
|
258
|
+
|
|
259
|
+
| Parameter | Type | Default |
|
|
260
|
+
| ---------------- | ------- | ------- |
|
|
261
|
+
| `url` \* | string | — |
|
|
262
|
+
| `followRedirect` | boolean | `false` |
|
|
263
|
+
|
|
264
|
+
---
|
|
265
|
+
|
|
266
|
+
### Mixed Content Check
|
|
267
|
+
|
|
268
|
+
Detect mixed content issues (HTTP resources on HTTPS pages).
|
|
269
|
+
|
|
270
|
+
| Parameter | Type | Default |
|
|
271
|
+
| ---------------- | ------- | ------- |
|
|
272
|
+
| `url` \* | string | — |
|
|
273
|
+
| `proxyCountry` | string | — |
|
|
274
|
+
| `followRedirect` | boolean | `false` |
|
|
275
|
+
|
|
276
|
+
---
|
|
277
|
+
|
|
278
|
+
### DNSSEC Check
|
|
279
|
+
|
|
280
|
+
Check if DNSSEC is enabled and properly configured for a domain.
|
|
281
|
+
|
|
282
|
+
| Parameter | Type |
|
|
283
|
+
| --------- | ------ |
|
|
284
|
+
| `url` \* | string |
|
|
285
|
+
|
|
286
|
+
---
|
|
287
|
+
|
|
288
|
+
### MTR Trace
|
|
289
|
+
|
|
290
|
+
Run an MTR (My Traceroute) network diagnostic test.
|
|
291
|
+
|
|
292
|
+
| Parameter | Type | Default |
|
|
293
|
+
| ---------------- | ------- | ------- |
|
|
294
|
+
| `url` \* | string | — |
|
|
295
|
+
| `proxyCountry` | string | — |
|
|
296
|
+
| `followRedirect` | boolean | `false` |
|
|
297
|
+
|
|
298
|
+
---
|
|
299
|
+
|
|
300
|
+
### Ping
|
|
301
|
+
|
|
302
|
+
Ping a host and return latency.
|
|
303
|
+
|
|
304
|
+
| Parameter | Type |
|
|
305
|
+
| --------- | ------ |
|
|
306
|
+
| `url` \* | string |
|
|
307
|
+
|
|
308
|
+
---
|
|
309
|
+
|
|
310
|
+
## Links
|
|
311
|
+
|
|
312
|
+
- [Geekflare API](https://geekflare.com/api/)
|
|
313
|
+
- [API Documentation](https://docs.geekflare.com/api/intro)
|
|
314
|
+
- [Dashboard](https://dash.geekflare.com/)
|
|
315
|
+
- [Report Issues](https://geekflare.com/contact/?product=api&topic=bug)
|
|
316
|
+
|
|
317
|
+
## License
|
|
318
|
+
|
|
319
|
+
MIT
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.GeekflareApi = void 0;
|
|
4
|
+
class GeekflareApi {
|
|
5
|
+
constructor() {
|
|
6
|
+
this.name = "geekflareApi";
|
|
7
|
+
this.displayName = "Geekflare API";
|
|
8
|
+
this.documentationUrl = "https://docs.geekflare.com/api/intro";
|
|
9
|
+
this.properties = [
|
|
10
|
+
{
|
|
11
|
+
displayName: "API Key",
|
|
12
|
+
name: "apiKey",
|
|
13
|
+
type: "string",
|
|
14
|
+
typeOptions: {
|
|
15
|
+
password: true,
|
|
16
|
+
},
|
|
17
|
+
default: "",
|
|
18
|
+
required: true,
|
|
19
|
+
description: "Your Geekflare API key. Find it in your Geekflare dashboard.",
|
|
20
|
+
},
|
|
21
|
+
];
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
exports.GeekflareApi = GeekflareApi;
|
|
25
|
+
//# sourceMappingURL=GeekflareApi.credentials.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"GeekflareApi.credentials.js","sourceRoot":"","sources":["../../credentials/GeekflareApi.credentials.ts"],"names":[],"mappings":";;;AAEA,MAAa,YAAY;IAAzB;QACE,SAAI,GAAG,cAAc,CAAC;QACtB,gBAAW,GAAG,eAAe,CAAC;QAC9B,qBAAgB,GAAG,sCAAsC,CAAC;QAC1D,eAAU,GAAsB;YAC9B;gBACE,WAAW,EAAE,SAAS;gBACtB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE;oBACX,QAAQ,EAAE,IAAI;iBACf;gBACD,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EACT,8DAA8D;aACjE;SACF,CAAC;IACJ,CAAC;CAAA;AAlBD,oCAkBC"}
|
package/dist/index.d.ts
ADDED
package/dist/index.js
ADDED
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.Geekflare = exports.GeekflareApi = void 0;
|
|
4
|
+
var GeekflareApi_credentials_1 = require("./credentials/GeekflareApi.credentials");
|
|
5
|
+
Object.defineProperty(exports, "GeekflareApi", { enumerable: true, get: function () { return GeekflareApi_credentials_1.GeekflareApi; } });
|
|
6
|
+
var Geekflare_node_1 = require("./nodes/Geekflare/Geekflare.node");
|
|
7
|
+
Object.defineProperty(exports, "Geekflare", { enumerable: true, get: function () { return Geekflare_node_1.Geekflare; } });
|
|
8
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;AAAA,mFAAsE;AAA7D,wHAAA,YAAY,OAAA;AACrB,mEAA6D;AAApD,2GAAA,SAAS,OAAA"}
|