Reddit Subreddit Post & Comment Harvester: MCP config, n8n workflow and API

{
  "subreddits": [
    "python"
  ],
  "maxPosts": 25,
  "maxItems": 10000,
  "sort": "new",
  "timeFilter": "day",
  "includeComments": false,
  "maxCommentsPerPost": 0,
  "commentSort": "confidence",
  "includeNSFW": false,
  "onlyWithFlair": false,
  "excludeStickied": false,
  "excludeCrossposts": false,
  "excludeSpoilers": false,
  "excludeDeletedAuthor": false,
  "fullSubreddit": false
}

---
name: reddit-subreddit-post-and-comment-harvester
description: "Reddit subreddit posts with score, flair, selftext, images, galleries, video, polls and crosspost context, plus optional nested comment threads. Runs the Apify Actor vexaloom-labs/reddit-subreddit-post-and-comment-harvester. Use when the user needs Reddit data with fields such as subreddit_prefixed, title, author, score, upvote_ratio, num_comments 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: "vexaloom-labs/reddit-subreddit-post-and-comment-harvester"
  store-url: "https://apify.com/vexaloom-labs/reddit-subreddit-post-and-comment-harvester"
---

# Reddit Subreddit Post & Comment Harvester

Use this skill to fetch Reddit data with the Apify Actor `vexaloom-labs/reddit-subreddit-post-and-comment-harvester` 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 |
| --- | --- | --- |
| `subreddits` | array, required | List of subreddits to scrape. Accepts bare names (python), r/ prefixed (r/python) or full URLs (https://www.reddit.com/r/python/). |
| `maxPosts` | integer | Maximum number of posts to keep from each subreddit after filters. Reddit serves roughly 1,000 posts per hot/new listing and about 500 for top/controversial. |
| `maxItems` | integer | Global safety cap on the total number of records pushed for the whole run (posts and comments combined). |
| `sort` | one of `hot`, `new`, `top`, `rising`, `controversial`, `best` | How to sort posts in the subreddit. Reddit serves roughly 1,000 posts per hot/new listing and about 500 for top/controversial. |
| `timeFilter` | one of `hour`, `day`, `week`, `month`, `year`, `all` | Time filter when sorting by 'top' or 'controversial'. |
| `includeComments` | boolean | When enabled, the full comment thread (including nested replies) is collected for every scraped post. Significantly increases run time and output. |
| `maxCommentsPerPost` | integer | Maximum number of comments to scrape per post (only used when 'Include comments' is enabled). |
| `commentSort` | one of `confidence`, `top`, `new`, `controversial`, `old`, `qa` | How to sort the comment threads. |
| `includeNSFW` | boolean | Include posts Reddit explicitly flags as NSFW. Posts in 18+ communities are served by the actor's adult-content cookie and are not distinguishable at community level. |
| `onlyWithFlair` | boolean | When enabled, posts without a flair tag are dropped from the results. |
| `excludeStickied` | boolean | When enabled, posts pinned/stickied by moderators (e.g. rules, weekly threads) are dropped from the results. |
| `excludeCrossposts` | boolean | When enabled, posts that are crossposts from another subreddit are dropped from the results, keeping only original submissions to the scraped subreddit. |
| `excludeSpoilers` | boolean | When enabled, posts marked as a spoiler by their author are dropped from the results. |
| `excludeDeletedAuthor` | boolean | When enabled, posts whose author account was deleted (shown as [deleted]/[removed]) are dropped from the results. |

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

```json
{
  "subreddits": [
    "python"
  ],
  "maxPosts": 25,
  "maxItems": 10000,
  "sort": "new",
  "timeFilter": "day",
  "includeComments": false,
  "maxCommentsPerPost": 0,
  "commentSort": "confidence",
  "includeNSFW": false,
  "onlyWithFlair": false,
  "excludeStickied": false,
  "excludeCrossposts": false,
  "excludeSpoilers": false,
  "excludeDeletedAuthor": false,
  "fullSubreddit": false
}
```

## Run

```bash
curl -sS -X POST "https://api.apify.com/v2/acts/vexaloom-labs~reddit-subreddit-post-and-comment-harvester/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/vexaloom-labs~reddit-subreddit-post-and-comment-harvester/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: `subreddit_prefixed`, `title`, `author`, `score`, `upvote_ratio`, `num_comments`, `post_type`, `created_at`, `link_flair`, `url`.

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