feat(reddit): add reddit_subreddit target

feat(reddit): add reddit_subreddit target

Author: ChinchillaLover9000

README.md

@@ -94,7 +94,7 @@ Scrape Wikipedia and tell me who won the NBA in 2025.
 
 ## Parameters
 
-When used as an AI tool, the following parameters are inferred automatically from messages:
+When used as an AI tool, most parameters can be inferred automatically from messages, for example:
 
 | Parameter  | Description                                    | Example message                                                         |
 | ---------- | ---------------------------------------------- | ----------------------------------------------------------------------- |
@@ -103,7 +103,7 @@ When used as an AI tool, the following parameters are inferred automatically fro
 | `geo`      | The country name from which to scrape          | Scrape https://ip.decodo.com/json with United States geolocation.       |
 | `markdown` | Receive Markdown type responce instead of HTML | Scrape https://ip.decodo.com/json and return result in markdown format. |
 
-If used as an individual node, these parameters can be manually configured by double-clicking on the node.
+If used as an individual node, all parameters can be manually configured by double-clicking on the node.
 
 ## Development & releases
 

nodes/Decodo/constants.ts

@@ -3,12 +3,18 @@ export enum TARGET {
   GOOGLE_SEARCH = 'google_search',
   AMAZON = 'amazon',
   YOUTUBE_TRANSCRIPT = 'youtube_transcript',
+  REDDIT_SUBDREDDIT = 'reddit_subreddit',
 }
 
 export const URL_TARGETS = [TARGET.UNIVERSAL, TARGET.AMAZON];
 export const QUERY_TARGETS = [TARGET.GOOGLE_SEARCH];
 export const HEADLESS_TARGETS = [TARGET.UNIVERSAL, TARGET.GOOGLE_SEARCH];
-export const GEO_TARGETS = [TARGET.UNIVERSAL, TARGET.GOOGLE_SEARCH, TARGET.AMAZON];
+export const GEO_TARGETS = [
+  TARGET.UNIVERSAL,
+  TARGET.GOOGLE_SEARCH,
+  TARGET.AMAZON,
+  TARGET.REDDIT_SUBDREDDIT,
+];
 export const LOCALE_TARGETS = [TARGET.GOOGLE_SEARCH];
 export const MARKDOWN_TARGETS = [TARGET.UNIVERSAL, TARGET.GOOGLE_SEARCH];
 export const PARSE_TARGETS = [TARGET.GOOGLE_SEARCH, TARGET.AMAZON];

nodes/Decodo/properties/index.ts

@@ -10,3 +10,5 @@ export * from './limit.property';
 export * from './markdown.property';
 export * from './transcript-origin.property';
 export * from './language-code.property';
+export * from './subreddit.property';
+export * from './reddit-sort.property';

nodes/Decodo/properties/reddit-sort.property.ts

@@ -0,0 +1,22 @@
+import { INodeProperties } from 'n8n-workflow';
+import { TARGET } from '../constants';
+
+export class RedditSortProperty {
+  static property = {
+    displayName: 'Sort',
+    name: 'reddit_sort',
+    description: 'How to sort the posts of the chosen subreddit',
+    type: 'options',
+    default: '',
+    required: false,
+    options: [
+      { name: 'Best', value: 'best' },
+      { name: 'Default', value: '' },
+      { name: 'Hot', value: 'hot' },
+      { name: 'New', value: 'new' },
+      { name: 'Rising', value: 'rising' },
+      { name: 'Top', value: 'top' },
+    ],
+    displayOptions: { show: { target: [TARGET.REDDIT_SUBDREDDIT] } },
+  } satisfies INodeProperties;
+}

nodes/Decodo/properties/subreddit.property.ts

@@ -0,0 +1,16 @@
+import { INodeProperties } from 'n8n-workflow';
+import { TARGET } from '../constants';
+
+export class SubredditProperty {
+  static property = {
+    displayName: 'Subreddit',
+    name: 'subreddit',
+    description: "Name of the subreddit, example: 'nba'",
+    type: 'string',
+    default: '',
+    required: true,
+    displayOptions: {
+      show: { target: [TARGET.REDDIT_SUBDREDDIT] },
+    },
+  } satisfies INodeProperties;
+}

nodes/Decodo/properties/target.property.ts

@@ -27,6 +27,10 @@ export class TargetProperty {
         name: 'Youtube Transcript',
         value: TARGET.YOUTUBE_TRANSCRIPT,
       },
+      {
+        name: 'Reddit Subreddit',
+        value: TARGET.REDDIT_SUBDREDDIT,
+      },
     ],
   } satisfies INodeProperties;
 }

nodes/Decodo/services/parameter-transformer.ts

@@ -1,5 +1,6 @@
 import { INodeProperties } from 'n8n-workflow';
 import { ScraperApiParams } from '../types';
+import { Utils } from './utils';
 import {
   TargetProperty,
   UrlProperty,
@@ -13,6 +14,8 @@ import {
   VideoIdProperty,
   TranscriptOriginProperty,
   LanguageCodeProperty,
+  SubredditProperty,
+  RedditSortProperty,
 } from '../properties';
 
 export class PropertyHandler {
@@ -21,6 +24,7 @@ export class PropertyHandler {
     UrlProperty.property,
     QueryProperty.property,
     VideoIdProperty.property,
+    SubredditProperty.property,
     HeadlessProperty.property,
     ParseProperty.property,
     TranscriptOriginProperty.property,
@@ -29,6 +33,7 @@ export class PropertyHandler {
     LocaleProperty.property,
     LimitProperty.property,
     MarkdownProperty.property,
+    RedditSortProperty.property,
   ];
 
   static getParameters = (
@@ -49,6 +54,7 @@ export class PropertyHandler {
     return {
       target: params.target,
       ...(params.url && { url: params.url }),
+      ...(params.subreddit && { url: Utils.getSubredditUrl(params.subreddit, params.reddit_sort) }),
       ...(params.query && { query: params.query }),
       ...(params.video_id && { query: params.video_id }),
       ...(params.headless && { headless: 'html' }),

nodes/Decodo/services/utils.ts

@@ -0,0 +1,11 @@
+import { RedditSort } from '../types';
+
+export class Utils {
+  static getSubredditUrl = (subreddit: string, sort?: RedditSort) => {
+    const baseUrl = `https://www.reddit.com/r/${subreddit}`;
+    if (sort) {
+      return `${baseUrl}/${sort}`;
+    }
+    return baseUrl;
+  };
+}

nodes/Decodo/types.ts

@@ -1,5 +1,7 @@
 import { TARGET } from './constants';
 
+export type RedditSort = 'best' | 'hot' | 'new' | 'rising' | 'top';
+
 export type ScraperApiParams = {
   target?: TARGET;
   url?: string;
@@ -13,4 +15,6 @@ export type ScraperApiParams = {
   language_code?: string;
   results_limit?: string;
   markdown?: boolean;
+  subreddit?: string;
+  reddit_sort?: RedditSort;
 };