n8n-nodes-recentreborn 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 RecentReborn
+
+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,49 @@
+# n8n-nodes-recentreborn
+
+Community node for [RecentReborn](https://recentreborn.com), a chronological search engine for Instagram, TikTok, and YouTube. Search recent posts by hashtag, query, or location, or trigger a workflow the moment a new one appears.
+
+This package includes two nodes:
+
+- **RecentReborn** — an action node with four operations: Search Hashtag (Instagram), Search Query (TikTok/YouTube), Search Location (Instagram), and Look Up Locations (Instagram, to find a `location_id`).
+- **RecentReborn Trigger** — a polling trigger that watches a hashtag, query, or location and emits each new post once, in the order it happened.
+
+## Setup
+
+1. Install dependencies:
+   ```bash
+   npm install
+   ```
+2. Run locally with hot reload (this uses the built-in n8n instance from `@n8n/node-cli`, no global n8n install needed):
+   ```bash
+   npm run dev
+   ```
+3. In the n8n editor, add a **RecentReborn API** credential. Get your API key from **API Key** in the RecentReborn dashboard, and paste it in (it's sent as `Authorization: Bearer <key>`, so no need to type "Bearer" yourself).
+4. Add the **RecentReborn** or **RecentReborn Trigger** node to a workflow and pick your credential.
+
+## Notes on the API this wraps
+
+- **Base URL**: `https://app.recentreborn.com/api/v1`
+- **Auth**: bearer token, one live key per account, no separate sandbox key. Calls through this node count against your normal daily search quota, same as dashboard searches.
+- **Rate limit**: 20 requests/minute per key, on top of your daily quota. If you're running the trigger on a tight interval across several watched hashtags, keep an eye on `X-RateLimit-Remaining` (returned on every response) so you don't get a `429`.
+- **Pagination**: the action node's "Return All" option follows `next_pagination_token` until the API stops returning one. Leave it off and set a "Limit" if you only want the first page or two.
+- **Location search is Instagram-only.** Use "Look Up Locations" first to turn a place name into a numeric `location_id`, then feed that into "Search Location" or the trigger.
+- **`upload_date` only applies to YouTube** queries, and the API defaults it to `hour` if you don't set it, which is usually too narrow for a scheduled job. Both nodes default it to `today` instead.
+
+## How the trigger avoids duplicates
+
+RecentReborn returns posts newest-first. On each poll, the trigger node remembers the `posted_at` of the newest post it has already emitted (stored in the node's static workflow data) and only emits posts newer than that, oldest-first. On the very first poll it doesn't emit anything (there's no "last seen" yet, so everything would look new) except when you're manually testing the node in the editor, so you can see a real result shape immediately.
+
+This means: don't run two separate workflows watching the *same* hashtag/query/location with the same credential unless you're fine with each one independently tracking its own "last seen" post.
+
+## Ideas for what to build with this
+
+- Poll a niche hashtag with the trigger, and drop each new post into a Google Sheet, Airtable base, or CRM as a lead/prospect list.
+- Chain **Look Up Locations → Search Location** to monitor a city or neighborhood for real-time posts (events, local business mentions, etc.).
+- Pair the trigger with an AI node (e.g. an LLM step) to auto-draft a comment or DM for each new post, then hold for manual approval before sending.
+- Use the action node's `hashtags`, `caption`, and `author` fields as input to a scoring step, then only route "good fit" authors onward.
+
+## Limitations to flag to users
+
+- This node calls the public RecentReborn API as documented; it does not expose Discovered Profiles (fetch/export), since those aren't part of the public API today.
+- All error handling assumes the standard RecentReborn error shape (`{ "error": { "code", "message" } }`) for `400`, `401`, `403`, `429`, `500`, and `503`.
+# RecentReborn-n8n

package/dist/src/credentials/RecentRebornApi.credentials.d.ts

@@ -0,0 +1,10 @@
+import type { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class RecentRebornApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    icon: "file:recentreborn.svg";
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}

package/dist/src/credentials/RecentRebornApi.credentials.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RecentRebornApi = void 0;
+class RecentRebornApi {
+    constructor() {
+        this.name = 'recentRebornApi';
+        this.displayName = 'RecentReborn API';
+        this.icon = 'file:recentreborn.svg';
+        this.documentationUrl = 'https://recentreborn.com/api-docs';
+        this.properties = [
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                required: true,
+                description: 'Your RecentReborn API key (starts with "rr_live_"). Generate one from the API Key section of your RecentReborn dashboard. Sent as a bearer token, and calls made with it count against your normal daily search quota.',
+            },
+        ];
+        // RecentReborn expects "Authorization: Bearer <key>" on every request.
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '=Bearer {{$credentials.apiKey}}',
+                },
+            },
+        };
+        // A cheap, always-available call used by the "Test" button in the credential UI.
+        this.test = {
+            request: {
+                baseURL: 'https://app.recentreborn.com/api/v1',
+                url: '/locations',
+                qs: {
+                    query: 'Berlin, Germany',
+                },
+            },
+        };
+    }
+}
+exports.RecentRebornApi = RecentRebornApi;

package/dist/src/credentials/recentreborn.svg

@@ -0,0 +1,15 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="1024" height="1024" viewBox="0 0 1024 1024">
+  <defs>
+    <linearGradient id="linear-gradient" y1="1" x2="1" gradientUnits="objectBoundingBox">
+      <stop offset="0" stop-color="#c6c6f1"/>
+      <stop offset="1" stop-color="#f0d7d6"/>
+    </linearGradient>
+  </defs>
+  <g id="Group_14" data-name="Group 14" transform="translate(-33 -17)">
+    <rect id="Rectangle_15" data-name="Rectangle 15" width="1024" height="1024" rx="512" transform="translate(33 17)" fill="url(#linear-gradient)"/>
+    <g id="Group_13" data-name="Group 13" transform="translate(241.174 277.218)">
+      <path id="Path_14" data-name="Path 14" d="M644.262,648c-.1,80.906-.161,160.778-.247,240.651-.019,16.193-1.854,17.879-17.91,16.815-30.435-2.017-60.9-.8-91.352-.681-8.375.034-11.943-1.438-11.9-10.8.384-88.046-.731-176.114.791-264.137,1.121-64.842,28.842-118.8,75.282-163.53a263.707,263.707,0,0,1,54.369-40.425c28.521-15.967,59.219-23.481,91.714-23.8,26.745-.263,53.5.173,80.245-.087,8.372-.082,11.439,2.182,11.283,11.473-.658,39.369-.286,78.755-.355,118.135-.023,13.655-.642,14.1-14.553,14.283-25.96.334-52.078-.921-77.844,1.516C693.816,552.135,648.906,598.209,644.262,648Z" transform="translate(-522.811 -401.999)"/>
+      <path id="Path_15" data-name="Path 15" d="M644.262,648c-.1,80.906-.161,160.778-.247,240.651-.019,16.193-1.854,17.879-17.91,16.815-30.435-2.017-60.9-.8-91.352-.681-8.375.034-11.943-1.438-11.9-10.8.384-88.046-.731-176.114.791-264.137,1.121-64.842,28.842-118.8,75.282-163.53a263.707,263.707,0,0,1,54.369-40.425c28.521-15.967,59.219-23.481,91.714-23.8,26.745-.263,53.5.173,80.245-.087,8.372-.082,11.439,2.182,11.283,11.473-.658,39.369-.286,78.755-.355,118.135-.023,13.655-.642,14.1-14.553,14.283-25.96.334-52.078-.921-77.844,1.516C693.816,552.135,648.906,598.209,644.262,648Z" transform="translate(-209.082 -401.999)"/>
+    </g>
+  </g>
+</svg>

package/dist/src/nodes/RecentReborn/RecentReborn.node.d.ts

@@ -0,0 +1,5 @@
+import type { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class RecentReborn implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/dist/src/nodes/RecentReborn/RecentReborn.node.js

@@ -0,0 +1,267 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RecentReborn = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const BASE_URL = 'https://app.recentreborn.com/api/v1';
+/**
+ * Calls a RecentReborn GET endpoint, following next_pagination_token until
+ * either there are no more pages or the requested item limit is reached.
+ */
+async function fetchAllPages(ctx, path, qs, returnAll, limit) {
+    const results = [];
+    let paginationToken;
+    do {
+        const query = {};
+        for (const [key, value] of Object.entries(qs)) {
+            if (value !== undefined && value !== '')
+                query[key] = value;
+        }
+        if (paginationToken)
+            query.pagination_token = paginationToken;
+        const options = {
+            method: 'GET',
+            url: `${BASE_URL}${path}`,
+            qs: query,
+            json: true,
+        };
+        const response = (await ctx.helpers.httpRequestWithAuthentication.call(ctx, 'recentRebornApi', options));
+        results.push(...(response.results ?? []));
+        paginationToken = response.next_pagination_token;
+        if (!returnAll && results.length >= limit) {
+            return results.slice(0, limit);
+        }
+    } while (paginationToken && (returnAll || results.length < limit));
+    return results;
+}
+class RecentReborn {
+    constructor() {
+        this.description = {
+            displayName: 'RecentReborn',
+            name: 'recentReborn',
+            icon: 'file:recentreborn.svg',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["operation"]}}',
+            description: 'Chronological, real-time search across Instagram, TikTok, and YouTube. Search recent posts by hashtag, query, or location.',
+            defaults: {
+                name: 'RecentReborn',
+            },
+            usableAsTool: true,
+            inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            credentials: [
+                {
+                    name: 'recentRebornApi',
+                    required: true,
+                },
+            ],
+            properties: [
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    default: 'searchHashtag',
+                    options: [
+                        {
+                            name: 'Search Hashtag',
+                            value: 'searchHashtag',
+                            description: 'Search recent Instagram posts using a hashtag',
+                            action: 'Search recent instagram posts by hashtag',
+                        },
+                        {
+                            name: 'Search Query',
+                            value: 'searchQuery',
+                            description: 'Search recent TikTok or YouTube posts matching a free-text query',
+                            action: 'Search recent tiktok or youtube posts by query',
+                        },
+                        {
+                            name: 'Search Location',
+                            value: 'searchLocation',
+                            description: 'Search recent Instagram posts tagged at a location',
+                            action: 'Search recent instagram posts by location',
+                        },
+                        {
+                            name: 'Look Up Locations',
+                            value: 'lookupLocations',
+                            description: 'Find an Instagram location_id by name, for use with Search Location',
+                            action: 'Look up instagram locations by name',
+                        },
+                    ],
+                },
+                // --- Search Hashtag ---
+                {
+                    displayName: 'Hashtag',
+                    name: 'tag',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    placeholder: 'coffee',
+                    description: 'Hashtag to search, without the # symbol',
+                    displayOptions: { show: { operation: ['searchHashtag'] } },
+                },
+                {
+                    displayName: 'Feed Type',
+                    name: 'feedType',
+                    type: 'options',
+                    default: 'posts',
+                    options: [
+                        { name: 'Posts', value: 'posts' },
+                        { name: 'Reels', value: 'reels' },
+                    ],
+                    displayOptions: { show: { operation: ['searchHashtag'] } },
+                },
+                // --- Search Query ---
+                {
+                    displayName: 'Query',
+                    name: 'q',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    placeholder: 'matcha latte',
+                    description: 'Search term to match against captions and titles',
+                    displayOptions: { show: { operation: ['searchQuery'] } },
+                },
+                {
+                    displayName: 'Platform',
+                    name: 'platform',
+                    type: 'options',
+                    default: 'tiktok',
+                    options: [
+                        { name: 'TikTok', value: 'tiktok' },
+                        { name: 'YouTube', value: 'youtube' },
+                    ],
+                    displayOptions: { show: { operation: ['searchQuery'] } },
+                },
+                {
+                    displayName: 'Upload Date',
+                    name: 'uploadDate',
+                    type: 'options',
+                    default: 'today',
+                    description: 'How far back to look. YouTube only. The API defaults to "hour" if omitted, which is usually too narrow for a scheduled workflow.',
+                    options: [
+                        { name: 'Past Hour', value: 'hour' },
+                        { name: 'Today', value: 'today' },
+                        { name: 'Past Week', value: 'week' },
+                        { name: 'Past Month', value: 'month' },
+                        { name: 'Past Year', value: 'year' },
+                    ],
+                    displayOptions: { show: { operation: ['searchQuery'], platform: ['youtube'] } },
+                },
+                // --- Look Up Locations ---
+                {
+                    displayName: 'Location Name',
+                    name: 'locationQuery',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    placeholder: 'Berlin, Germany',
+                    description: 'Location name to search for, to find its location_id',
+                    displayOptions: { show: { operation: ['lookupLocations'] } },
+                },
+                // --- Search Location ---
+                {
+                    displayName: 'Location ID',
+                    name: 'locationId',
+                    type: 'number',
+                    default: 0,
+                    required: true,
+                    description: 'Instagram location ID. Get this from the "Look Up Locations" operation first.',
+                    displayOptions: { show: { operation: ['searchLocation'] } },
+                },
+                // --- Shared pagination controls (search operations only) ---
+                {
+                    displayName: 'Return All',
+                    name: 'returnAll',
+                    type: 'boolean',
+                    default: false,
+                    description: 'Whether to follow next_pagination_token and return all results, or stop at a limit',
+                    displayOptions: {
+                        show: { operation: ['searchHashtag', 'searchQuery', 'searchLocation'] },
+                    },
+                },
+                {
+                    displayName: 'Limit',
+                    name: 'limit',
+                    type: 'number',
+                    default: 50,
+                    typeOptions: { minValue: 1 },
+                    description: 'Max number of posts to return',
+                    displayOptions: {
+                        show: {
+                            operation: ['searchHashtag', 'searchQuery', 'searchLocation'],
+                            returnAll: [false],
+                        },
+                    },
+                },
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        const operation = this.getNodeParameter('operation', 0);
+        for (let i = 0; i < items.length; i++) {
+            try {
+                if (operation === 'lookupLocations') {
+                    const query = this.getNodeParameter('locationQuery', i);
+                    const options = {
+                        method: 'GET',
+                        url: `${BASE_URL}/locations`,
+                        qs: { query },
+                        json: true,
+                    };
+                    const response = (await this.helpers.httpRequestWithAuthentication.call(this, 'recentRebornApi', options));
+                    for (const location of response.locations ?? []) {
+                        returnData.push({ json: location, pairedItem: i });
+                    }
+                    continue;
+                }
+                const returnAll = this.getNodeParameter('returnAll', i, false);
+                const limit = this.getNodeParameter('limit', i, 50);
+                let path;
+                let qs;
+                if (operation === 'searchHashtag') {
+                    path = '/search/hashtag';
+                    qs = {
+                        tag: this.getNodeParameter('tag', i),
+                        feed_type: this.getNodeParameter('feedType', i),
+                    };
+                }
+                else if (operation === 'searchQuery') {
+                    const platform = this.getNodeParameter('platform', i);
+                    path = '/search/query';
+                    qs = {
+                        q: this.getNodeParameter('q', i),
+                        platform,
+                        upload_date: platform === 'youtube' ? this.getNodeParameter('uploadDate', i) : undefined,
+                    };
+                }
+                else if (operation === 'searchLocation') {
+                    path = '/search/location';
+                    qs = {
+                        location_id: this.getNodeParameter('locationId', i),
+                    };
+                }
+                else {
+                    throw new n8n_workflow_1.NodeApiError(this.getNode(), {
+                        message: `Unknown operation: ${operation}`,
+                    });
+                }
+                const posts = await fetchAllPages(this, path, qs, returnAll, limit);
+                for (const post of posts) {
+                    returnData.push({ json: post, pairedItem: i });
+                }
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    returnData.push({ json: { error: error.message }, pairedItem: i });
+                    continue;
+                }
+                throw new n8n_workflow_1.NodeApiError(this.getNode(), error);
+            }
+        }
+        return [returnData];
+    }
+}
+exports.RecentReborn = RecentReborn;

package/dist/src/nodes/RecentReborn/recentreborn.svg

@@ -0,0 +1,15 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="1024" height="1024" viewBox="0 0 1024 1024">
+  <defs>
+    <linearGradient id="linear-gradient" y1="1" x2="1" gradientUnits="objectBoundingBox">
+      <stop offset="0" stop-color="#c6c6f1"/>
+      <stop offset="1" stop-color="#f0d7d6"/>
+    </linearGradient>
+  </defs>
+  <g id="Group_14" data-name="Group 14" transform="translate(-33 -17)">
+    <rect id="Rectangle_15" data-name="Rectangle 15" width="1024" height="1024" rx="512" transform="translate(33 17)" fill="url(#linear-gradient)"/>
+    <g id="Group_13" data-name="Group 13" transform="translate(241.174 277.218)">
+      <path id="Path_14" data-name="Path 14" d="M644.262,648c-.1,80.906-.161,160.778-.247,240.651-.019,16.193-1.854,17.879-17.91,16.815-30.435-2.017-60.9-.8-91.352-.681-8.375.034-11.943-1.438-11.9-10.8.384-88.046-.731-176.114.791-264.137,1.121-64.842,28.842-118.8,75.282-163.53a263.707,263.707,0,0,1,54.369-40.425c28.521-15.967,59.219-23.481,91.714-23.8,26.745-.263,53.5.173,80.245-.087,8.372-.082,11.439,2.182,11.283,11.473-.658,39.369-.286,78.755-.355,118.135-.023,13.655-.642,14.1-14.553,14.283-25.96.334-52.078-.921-77.844,1.516C693.816,552.135,648.906,598.209,644.262,648Z" transform="translate(-522.811 -401.999)"/>
+      <path id="Path_15" data-name="Path 15" d="M644.262,648c-.1,80.906-.161,160.778-.247,240.651-.019,16.193-1.854,17.879-17.91,16.815-30.435-2.017-60.9-.8-91.352-.681-8.375.034-11.943-1.438-11.9-10.8.384-88.046-.731-176.114.791-264.137,1.121-64.842,28.842-118.8,75.282-163.53a263.707,263.707,0,0,1,54.369-40.425c28.521-15.967,59.219-23.481,91.714-23.8,26.745-.263,53.5.173,80.245-.087,8.372-.082,11.439,2.182,11.283,11.473-.658,39.369-.286,78.755-.355,118.135-.023,13.655-.642,14.1-14.553,14.283-25.96.334-52.078-.921-77.844,1.516C693.816,552.135,648.906,598.209,644.262,648Z" transform="translate(-209.082 -401.999)"/>
+    </g>
+  </g>
+</svg>

package/dist/src/nodes/RecentRebornTrigger/RecentRebornTrigger.node.d.ts

@@ -0,0 +1,5 @@
+import type { INodeExecutionData, INodeType, INodeTypeDescription, IPollFunctions } from 'n8n-workflow';
+export declare class RecentRebornTrigger implements INodeType {
+    description: INodeTypeDescription;
+    poll(this: IPollFunctions): Promise<INodeExecutionData[][] | null>;
+}

package/dist/src/nodes/RecentRebornTrigger/RecentRebornTrigger.node.js

@@ -0,0 +1,167 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RecentRebornTrigger = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const BASE_URL = 'https://app.recentreborn.com/api/v1';
+class RecentRebornTrigger {
+    constructor() {
+        this.description = {
+            displayName: 'RecentReborn Trigger',
+            name: 'recentRebornTrigger',
+            icon: 'file:recentreborn.svg',
+            group: ['trigger'],
+            version: 1,
+            subtitle: '={{$parameter["searchType"]}}',
+            description: 'Polls RecentReborn on a schedule and starts a workflow the moment a new hashtag, query, or location post appears',
+            defaults: {
+                name: 'RecentReborn Trigger',
+            },
+            polling: true,
+            inputs: [],
+            outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            credentials: [
+                {
+                    name: 'recentRebornApi',
+                    required: true,
+                },
+            ],
+            properties: [
+                {
+                    displayName: 'Search Type',
+                    name: 'searchType',
+                    type: 'options',
+                    noDataExpression: true,
+                    default: 'hashtag',
+                    options: [
+                        { name: 'Hashtag (Instagram)', value: 'hashtag' },
+                        { name: 'Query (TikTok / YouTube)', value: 'query' },
+                        { name: 'Location (Instagram)', value: 'location' },
+                    ],
+                },
+                {
+                    displayName: 'Hashtag',
+                    name: 'tag',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    placeholder: 'coffee',
+                    description: 'Hashtag to watch, without the # symbol',
+                    displayOptions: { show: { searchType: ['hashtag'] } },
+                },
+                {
+                    displayName: 'Feed Type',
+                    name: 'feedType',
+                    type: 'options',
+                    default: 'posts',
+                    options: [
+                        { name: 'Posts', value: 'posts' },
+                        { name: 'Reels', value: 'reels' },
+                    ],
+                    displayOptions: { show: { searchType: ['hashtag'] } },
+                },
+                {
+                    displayName: 'Query',
+                    name: 'q',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    placeholder: 'matcha latte',
+                    description: 'Search term to watch, matched against captions and titles',
+                    displayOptions: { show: { searchType: ['query'] } },
+                },
+                {
+                    displayName: 'Platform',
+                    name: 'platform',
+                    type: 'options',
+                    default: 'tiktok',
+                    options: [
+                        { name: 'TikTok', value: 'tiktok' },
+                        { name: 'YouTube', value: 'youtube' },
+                    ],
+                    displayOptions: { show: { searchType: ['query'] } },
+                },
+                {
+                    displayName: 'Upload Date',
+                    name: 'uploadDate',
+                    type: 'options',
+                    default: 'today',
+                    description: 'How far back each poll looks on YouTube. Keep this wider than your polling interval so no post is missed between polls; the node still filters out anything it has already emitted.',
+                    options: [
+                        { name: 'Past Hour', value: 'hour' },
+                        { name: 'Today', value: 'today' },
+                        { name: 'Past Week', value: 'week' },
+                    ],
+                    displayOptions: { show: { searchType: ['query'], platform: ['youtube'] } },
+                },
+                {
+                    displayName: 'Location ID',
+                    name: 'locationId',
+                    type: 'number',
+                    default: 0,
+                    required: true,
+                    description: 'Instagram location ID to watch. Use the RecentReborn node\'s "Look Up Locations" operation to find it.',
+                    displayOptions: { show: { searchType: ['location'] } },
+                },
+            ],
+        };
+    }
+    async poll() {
+        const searchType = this.getNodeParameter('searchType');
+        let path;
+        const qs = {};
+        if (searchType === 'hashtag') {
+            path = '/search/hashtag';
+            qs.tag = this.getNodeParameter('tag');
+            qs.feed_type = this.getNodeParameter('feedType');
+        }
+        else if (searchType === 'query') {
+            const platform = this.getNodeParameter('platform');
+            path = '/search/query';
+            qs.q = this.getNodeParameter('q');
+            qs.platform = platform;
+            if (platform === 'youtube') {
+                qs.upload_date = this.getNodeParameter('uploadDate');
+            }
+        }
+        else {
+            path = '/search/location';
+            qs.location_id = this.getNodeParameter('locationId');
+        }
+        const options = {
+            method: 'GET',
+            url: `${BASE_URL}${path}`,
+            qs,
+            json: true,
+        };
+        const response = (await this.helpers.httpRequestWithAuthentication.call(this, 'recentRebornApi', options));
+        // RecentReborn returns newest-first. Keep only posts newer than the last
+        // one we've already emitted, then flip to chronological (oldest-first)
+        // order so downstream nodes process them in the order they happened.
+        const posts = response.results ?? [];
+        const staticData = this.getWorkflowStaticData('node');
+        const lastPostedAt = staticData.lastPostedAt;
+        const newPosts = lastPostedAt
+            ? posts.filter((post) => post.posted_at > lastPostedAt)
+            : posts;
+        if (posts.length > 0) {
+            // posts[0] is the newest, since results come back newest-first.
+            staticData.lastPostedAt = posts[0].posted_at;
+        }
+        // On the very first poll there's nothing to compare against yet, so
+        // don't flood the workflow with everything that already exists. Emit
+        // data only when the user is manually testing the node, so they can
+        // see the shape of a real result.
+        if (!lastPostedAt && this.getMode() !== 'manual') {
+            return null;
+        }
+        if (newPosts.length === 0) {
+            return null;
+        }
+        const ordered = [...newPosts].reverse();
+        const returnData = ordered.map((post) => ({
+            json: post,
+        }));
+        return [returnData];
+    }
+}
+exports.RecentRebornTrigger = RecentRebornTrigger;

package/dist/src/nodes/RecentRebornTrigger/recentreborn.svg

@@ -0,0 +1,15 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="1024" height="1024" viewBox="0 0 1024 1024">
+  <defs>
+    <linearGradient id="linear-gradient" y1="1" x2="1" gradientUnits="objectBoundingBox">
+      <stop offset="0" stop-color="#c6c6f1"/>
+      <stop offset="1" stop-color="#f0d7d6"/>
+    </linearGradient>
+  </defs>
+  <g id="Group_14" data-name="Group 14" transform="translate(-33 -17)">
+    <rect id="Rectangle_15" data-name="Rectangle 15" width="1024" height="1024" rx="512" transform="translate(33 17)" fill="url(#linear-gradient)"/>
+    <g id="Group_13" data-name="Group 13" transform="translate(241.174 277.218)">
+      <path id="Path_14" data-name="Path 14" d="M644.262,648c-.1,80.906-.161,160.778-.247,240.651-.019,16.193-1.854,17.879-17.91,16.815-30.435-2.017-60.9-.8-91.352-.681-8.375.034-11.943-1.438-11.9-10.8.384-88.046-.731-176.114.791-264.137,1.121-64.842,28.842-118.8,75.282-163.53a263.707,263.707,0,0,1,54.369-40.425c28.521-15.967,59.219-23.481,91.714-23.8,26.745-.263,53.5.173,80.245-.087,8.372-.082,11.439,2.182,11.283,11.473-.658,39.369-.286,78.755-.355,118.135-.023,13.655-.642,14.1-14.553,14.283-25.96.334-52.078-.921-77.844,1.516C693.816,552.135,648.906,598.209,644.262,648Z" transform="translate(-522.811 -401.999)"/>
+      <path id="Path_15" data-name="Path 15" d="M644.262,648c-.1,80.906-.161,160.778-.247,240.651-.019,16.193-1.854,17.879-17.91,16.815-30.435-2.017-60.9-.8-91.352-.681-8.375.034-11.943-1.438-11.9-10.8.384-88.046-.731-176.114.791-264.137,1.121-64.842,28.842-118.8,75.282-163.53a263.707,263.707,0,0,1,54.369-40.425c28.521-15.967,59.219-23.481,91.714-23.8,26.745-.263,53.5.173,80.245-.087,8.372-.082,11.439,2.182,11.283,11.473-.658,39.369-.286,78.755-.355,118.135-.023,13.655-.642,14.1-14.553,14.283-25.96.334-52.078-.921-77.844,1.516C693.816,552.135,648.906,598.209,644.262,648Z" transform="translate(-209.082 -401.999)"/>
+    </g>
+  </g>
+</svg>

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "n8n-nodes-recentreborn",
+  "version": "0.1.0",
+  "description": "n8n community node for RecentReborn, chronological search for Instagram, TikTok, and YouTube. Search hashtags, queries, and locations, and trigger workflows the moment new posts appear.",
+  "keywords": [
+    "n8n-community-node-package",
+    "recentreborn",
+    "instagram",
+    "tiktok",
+    "youtube",
+    "hashtag search"
+  ],
+  "license": "MIT",
+  "homepage": "https://recentreborn.com",
+  "author": {
+    "name": "RecentReborn",
+    "email": "felix@recentreborn.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/takkbbl/RecentReborn-n8n.git"
+  },
+  "bugs": {
+    "url": "https://github.com/takkbbl/RecentReborn-n8n/issues"
+  },
+  "main": "index.js",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "dev": "n8n-node dev",
+    "build": "n8n-node build",
+    "build:watch": "tsc --watch",
+    "lint": "n8n-node lint",
+    "lint:fix": "n8n-node lint --fix",
+    "release": "n8n-node release",
+    "prepublishOnly": "n8n-node prerelease",
+    "test": "vitest run"
+  },
+  "files": [
+    "dist"
+  ],
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "strict": true,
+    "credentials": [
+      "dist/src/credentials/RecentRebornApi.credentials.js"
+    ],
+    "nodes": [
+      "dist/src/nodes/RecentReborn/RecentReborn.node.js",
+      "dist/src/nodes/RecentRebornTrigger/RecentRebornTrigger.node.js"
+    ]
+  },
+  "devDependencies": {
+    "@n8n/node-cli": "^0.47.1",
+    "typescript": "^5.9.2",
+    "vitest": "^3.0.0"
+  },
+  "peerDependencies": {
+    "n8n-workflow": "*"
+  }
+}