Reddit Keyword Search with Advanced Filters: MCP config, n8n workflow and API

What a run costs

Every run pays a start fee plus a price per result. On the Free plan this Actor's start fee is $0.10 (the start event, $0.10 per GB, times its default 1 GB of memory), $0.03 on Business; results cost $0.99 per 1,000 results (pay per event). Checked 2026-11-12.

Plus Apify platform usage for the run, which the caller pays. A smaller memory setting lowers the start fee if the Actor still finishes. Prices can change; the Store pricing tab is the source of truth.

MCP config

One URL works in every client: https://mcp.apify.com/?tools=fetch-actor-details,nimbryxo-studio/reddit-keyword-search-with-advanced-filters. It exposes this Actor as a tool, plus fetch-actor-details so the agent can read the input schema before calling it. Pick your client:

claude mcp add --transport http reddit-keyword-search-with-advanced-filters "https://mcp.apify.com/?tools=fetch-actor-details,nimbryxo-studio/reddit-keyword-search-with-advanced-filters"

{
  "mcpServers": {
    "reddit-keyword-search-with-advanced-filters": {
      "command": "npx",
      "args": [
        "-y",
        "@apify/actors-mcp-server",
        "--tools",
        "fetch-actor-details,nimbryxo-studio/reddit-keyword-search-with-advanced-filters"
      ],
      "env": {
        "APIFY_TOKEN": "YOUR_APIFY_TOKEN"
      }
    }
  }
}

{
  "mcpServers": {
    "reddit-keyword-search-with-advanced-filters": {
      "url": "https://mcp.apify.com/?tools=fetch-actor-details,nimbryxo-studio/reddit-keyword-search-with-advanced-filters",
      "headers": {
        "Authorization": "Bearer ${env:APIFY_TOKEN}"
      }
    }
  }
}

{
  "inputs": [
    {
      "type": "promptString",
      "id": "apify-token",
      "description": "Apify API token",
      "password": true
    }
  ],
  "servers": {
    "reddit-keyword-search-with-advanced-filters": {
      "type": "http",
      "url": "https://mcp.apify.com/?tools=fetch-actor-details,nimbryxo-studio/reddit-keyword-search-with-advanced-filters",
      "headers": {
        "Authorization": "Bearer ${input:apify-token}"
      }
    }
  }
}

https://mcp.apify.com/?tools=fetch-actor-details,nimbryxo-studio/reddit-keyword-search-with-advanced-filters

[mcp_servers.reddit-keyword-search-with-advanced-filters]
url = "https://mcp.apify.com/?tools=fetch-actor-details,nimbryxo-studio/reddit-keyword-search-with-advanced-filters"
bearer_token_env_var = "APIFY_TOKEN"

gemini mcp add -t http -s user -H "Authorization: Bearer $APIFY_TOKEN" reddit-keyword-search-with-advanced-filters "https://mcp.apify.com/?tools=fetch-actor-details,nimbryxo-studio/reddit-keyword-search-with-advanced-filters"

https://mcp.apify.com/?tools=fetch-actor-details,nimbryxo-studio/reddit-keyword-search-with-advanced-filters

n8n workflow

A manual and a daily trigger call the Actor through the HTTP Request node with your Apify token, then hand each record to the destination you pick. The Actor input sits in the request body, already filled with the example below.

• Run by hand
• Every day
• Run Apify Actor

{
  "name": "Reddit Keyword Search with Advanced Filters to n8n only",
  "nodes": [
    {
      "id": "0f7aa5e6-e470-4933-a82e-9992b5b61f7b",
      "name": "Run by hand",
      "type": "n8n-nodes-base.manualTrigger",
      "typeVersion": 1,
      "position": [
        0,
        0
      ],
      "parameters": {}
    },
    {
      "id": "f910156e-2477-40d5-aca2-a788115be6f3",
      "name": "Every day",
      "type": "n8n-nodes-base.scheduleTrigger",
      "typeVersion": 1.2,
      "position": [
        0,
        200
      ],
      "parameters": {
        "rule": {
          "interval": [
            {
              "triggerAtHour": 8
            }
          ]
        }
      },
      "notes": "Activate the workflow to run on this schedule."
    },
    {
      "id": "bf39dc22-c0e4-4d4a-aa1d-baeb27a5a9a3",
      "name": "Run Apify Actor",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        260,
        100
      ],
      "parameters": {
        "method": "POST",
        "url": "https://api.apify.com/v2/actors/nimbryxo-studio~reddit-keyword-search-with-advanced-filters/run-sync-get-dataset-items",
        "authentication": "genericCredentialType",
        "genericAuthType": "httpHeaderAuth",
        "sendBody": true,
        "specifyBody": "json",
        "jsonBody": "{\n  \"keywords\": [\n    \"python programming\"\n  ],\n  \"onlyNew\": false,\n  \"searchComments\": false,\n  \"excludeNsfw\": false,\n  \"keywordRequireAll\": false,\n  \"includeArchive\": true,\n  \"resolveChallenges\": true\n}",
        "options": {
          "timeout": 310000
        }
      },
      "notes": "Actor: nimbryxo-studio/reddit-keyword-search-with-advanced-filters. Select a Header Auth credential: name Authorization, value Bearer + your Apify token. Edit the JSON body to change the input.",
      "notesInFlow": false
    },
    {
      "id": "0453259e-3dd3-4f75-a146-72c40036baab",
      "name": "Setup",
      "type": "n8n-nodes-base.stickyNote",
      "typeVersion": 1,
      "position": [
        0,
        -370
      ],
      "parameters": {
        "content": "## Reddit Keyword Search with Advanced Filters\n\nSource: [nimbryxo-studio/reddit-keyword-search-with-advanced-filters](https://apify.com/nimbryxo-studio/reddit-keyword-search-with-advanced-filters) on Apify.\n\n1. In **Run Apify Actor**, create a Header Auth credential: name `Authorization`, value `Bearer YOUR_APIFY_TOKEN` with your token.\n2. Click **Execute workflow**. Each record arrives as one n8n item.\n3. Edit the JSON body of **Run Apify Actor** to change the input.\n\nGenerated by recipeforagents.com. Validated, not executed: runs are billed to your Apify account.",
        "height": 340,
        "width": 460,
        "color": 6
      }
    }
  ],
  "connections": {
    "Run by hand": {
      "main": [
        [
          {
            "node": "Run Apify Actor",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Every day": {
      "main": [
        [
          {
            "node": "Run Apify Actor",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  },
  "pinData": {},
  "active": false,
  "settings": {
    "executionOrder": "v1"
  },
  "meta": {
    "templateCredsSetupCompleted": false
  },
  "tags": []
}

All 7 destination variants pass the same checks at build time. Built-in nodes only, at versions n8n has shipped since 1.80: they import on n8n Cloud and older self-hosted instances without community nodes. Prefer Apify's own node? The verified community node @apify/n8n-nodes-apify runs the same Actor with OAuth sign-in on n8n Cloud.

Call it from code

Run the Actor from a script or your own agent framework with the Apify API. The call waits for the run to finish and returns the records. The input is the example below.

curl -X POST "https://api.apify.com/v2/actors/nimbryxo-studio~reddit-keyword-search-with-advanced-filters/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"keywords":["python programming"],"onlyNew":false,"searchComments":false,"excludeNsfw":false,"keywordRequireAll":false,"includeArchive":true,"resolveChallenges":true}'

import os
from apify_client import ApifyClient

client = ApifyClient(os.environ["APIFY_TOKEN"])
run_input = {
    "keywords": [
        "python programming",
    ],
    "onlyNew": False,
    "searchComments": False,
    "excludeNsfw": False,
    "keywordRequireAll": False,
    "includeArchive": True,
    "resolveChallenges": True,
}

run = client.actor("nimbryxo-studio/reddit-keyword-search-with-advanced-filters").call(run_input=run_input)
if run is None:
    raise RuntimeError("The Actor run could not be started")
print(run.status, "dataset", run.default_dataset_id)
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

import { ApifyClient } from "apify-client";

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const input = {
  "keywords": [
    "python programming"
  ],
  "onlyNew": false,
  "searchComments": false,
  "excludeNsfw": false,
  "keywordRequireAll": false,
  "includeArchive": true,
  "resolveChallenges": true
};

const run = await client.actor("nimbryxo-studio/reddit-keyword-search-with-advanced-filters").call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.length, items[0]);

Example input

These values come from the Actor's Store prefill and required defaults. Change the search, URL or limit before your first run.

{
  "keywords": [
    "python programming"
  ],
  "onlyNew": false,
  "searchComments": false,
  "excludeNsfw": false,
  "keywordRequireAll": false,
  "includeArchive": true,
  "resolveChallenges": true
}

15 more optional fields on the Store input tab.

What your agent receives

Each run returns a list of records. The Actor publishes 13 fields, starting with title, author, subreddit_prefixed, score.

Agent skill

A SKILL.md in the open Agent Skills format. It teaches Claude Code, Codex and other skill-aware agents when to call this Actor, how to build the input and how to read the result, using the API directly.

---
name: reddit-keyword-search-with-advanced-filters
description: "Reddit posts and optional keyword-matched comments with score, subreddit, author, timestamps, source provenance, and data freshness, after subreddit/score/date/NSFW/author filtering. Runs the Apify Actor nimbryxo-studio/reddit-keyword-search-with-advanced-filters. Use when the user needs Reddit data with fields such as recordType, keyword, title, author, subreddit_prefixed, score and an Apify token is available."
compatibility: "Needs network access, curl, and an APIFY_TOKEN environment variable. Runs are billed to the token owner's Apify account."
metadata:
  actor: "nimbryxo-studio/reddit-keyword-search-with-advanced-filters"
  store-url: "https://apify.com/nimbryxo-studio/reddit-keyword-search-with-advanced-filters"
---

# Reddit Keyword Search with Advanced Filters

Use this skill to fetch Reddit data with the Apify Actor `nimbryxo-studio/reddit-keyword-search-with-advanced-filters` and work with the returned rows.

## Before running

1. Check that `APIFY_TOKEN` is set in the environment. Never print it or write it to a file.
2. Build `input.json` from the user's request using the fields below. Keep limits small for a first run.
3. Confirm the search terms or URLs with the user if the request is ambiguous.

## Input fields

| Field | Type | Meaning |
| --- | --- | --- |
| `keywords` | array, required | List of keywords to search. Each runs as a separate search. |
| `onlyNew` | boolean | Emit only records newer than the stored watermark for this monitorId. Requires a stable monitorId for scheduled runs. |
| `searchComments` | boolean | Also search comment bodies via Redlib, with RSS parent-post discovery + hydration as fallback. Emits recordType=comment records. |
| `excludeNsfw` | boolean | Drop NSFW records. When the available source cannot expose a per-post NSFW flag, unknown rows are not emitted as safe; the run reports nsfw_status_unavailable. |
| `keywordRequireAll` | boolean | When multiple keywords are given, keep only records whose title/content contains ALL of them. Default: each keyword runs independently (OR). |
| `includeArchive` | boolean | Use Arctic Shift for subreddit-scoped backfill and comment hydration when live sources fail. Archive metrics are snapshots, not live. |
| `resolveChallenges` | boolean | Allow a best-effort Playwright browser solve when a Redlib instance returns an Anubis challenge. Disable to keep runs HTTP-only. |

Example `input.json` (the Actor's published prefill):

```json
{
  "keywords": [
    "python programming"
  ],
  "onlyNew": false,
  "searchComments": false,
  "excludeNsfw": false,
  "keywordRequireAll": false,
  "includeArchive": true,
  "resolveChallenges": true
}
```

## Run

```bash
curl -sS -X POST "https://api.apify.com/v2/acts/nimbryxo-studio~reddit-keyword-search-with-advanced-filters/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d @input.json > results.json
```

The call waits for the run to finish and returns the dataset items as a JSON array. If the run needs more than 300 seconds the API answers with HTTP 408; then start the run with `POST /v2/acts/nimbryxo-studio~reddit-keyword-search-with-advanced-filters/runs`, poll `GET /v2/actor-runs/{runId}` until `SUCCEEDED`, and read `GET /v2/datasets/{defaultDatasetId}/items`.

## Output

Each item is one record. Published fields include: `recordType`, `keyword`, `title`, `author`, `subreddit_prefixed`, `score`, `num_comments`, `upvote_ratio`, `source`, `dataFreshness`, `url`, `created_at`, `link_flair`.

Summarise what was found, cite the record URLs when present, and say how many items came back. Do not invent values for empty fields.

• Claude Code: save it as ~/.claude/skills/reddit-keyword-search-with-advanced-filters/SKILL.md, or .claude/skills/reddit-keyword-search-with-advanced-filters/SKILL.md in a project.
• Codex and other agents: ~/.agents/skills/reddit-keyword-search-with-advanced-filters/SKILL.md, or .agents/skills/reddit-keyword-search-with-advanced-filters/ in a project.
• Or let the skills CLI place it for your agent: npx skills add https://recipeforagents.com --skill reddit-keyword-search-with-advanced-filters
• Set APIFY_TOKEN in the agent's environment.

Good jobs for this Actor

• Collect discussions from selected communities with subredditFilter and retain title, author and url for review.
• Enable searchComments to include matching comments and distinguish them from posts through recordType.
• Build scheduled monitors with onlyNew and a stable monitorId to emit records newer than the stored watermark.
• Filter discussions with dateFrom and dateTo, then organize results by created_at and subreddit_prefixed.

Prompts to try

• Set keywords to 'python programming' and subredditFilter to Python and learnpython, then return title, score, num_comments and url.
• Search with keywords set to 'python programming', enable searchComments and excludeNsfw, and include recordType, author and url in the results.
• Configure a recurring search with keywords set to 'python programming', onlyNew enabled and monitorId set to python-discussions, keeping that monitorId unchanged on later runs.

Recipes with this Actor

• Reddit mentions to Slack

  Monitor public Reddit posts for a keyword and send only the posts you have not seen before to a Slack channel.

  RedditSlack

• Reddit posts to Google Sheets

  Collect public posts and comments from a subreddit into a Sheet for research, with duplicate protection and a source…

  RedditGoogle Sheets

• Reddit keyword monitor to Discord

  Watch a public keyword across Reddit and drop new matches into a Discord channel through a webhook.

  RedditDiscord

• Reddit weekly digest to email

  Build a weekly digest of public subreddit posts and email it to yourself or a team inbox.

  RedditEmail

Troubleshooting

Every fix in one place