reddit

Automate Reddit browsing, searching, posting, and moderation via OAuth.

Updated Feb 6, 2026
One-click install
npx skills add https://github.com/Nutopia13/geo-intelligence-vault --skill reddit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reddit
Source: https://github.com/Nutopia13/geo-intelligence-vault/tree/main/skills/reddit
Command: npx skills add https://github.com/Nutopia13/geo-intelligence-vault --skill reddit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill enables an AI agent to interact with Reddit programmatically—browsing, searching, posting, and moderating content across subreddits.

Core Features & Use Cases

  • Read-only browsing: Retrieve hot/new/top posts from any subreddit without authentication.
  • Search and discovery: Query posts across a subreddit or all of Reddit and surface results for downstream actions.
  • Post and moderation (with OAuth): Create text or link posts, reply to comments, and manage moderation tasks after authenticating via the local OAuth flow.
  • Use Case: An automation workflow could fetch the top posts from a niche subreddit and auto-suggest replies or moderation actions.

Quick Start

node {baseDir}/scripts/reddit.mjs posts wallstreetbets node {baseDir}/scripts/reddit.mjs search wallstreetbets "stock picks" node {baseDir}/scripts/reddit.mjs login node {baseDir}/scripts/reddit.mjs submit wallstreetbets --title "Weekly Update" --text "Here's the latest..."

Frequently Asked Questions about reddit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate browsing and searching Reddit posts from an AI agent?

You can automate browsing and searching Reddit by running a Node CLI that hits Reddit's public API endpoints. The agent retrieves hot, new, or top posts from any subreddit without authentication, surfacing results for downstream actions.

Do I need OAuth authentication to read subreddit posts?

You do not need OAuth for read-only browsing and searching. The CLI retrieves posts across subreddits using public API endpoints, but OAuth is required for write and moderation actions like submitting posts or managing mod queues.

How do I set up OAuth to moderate a subreddit via a CLI?

To moderate a subreddit via the CLI, run the local OAuth login flow to generate and store an access token at ~/.reddit-token.json. Once authenticated, the agent can submit text posts, reply to comments, and manage moderation tasks.

Can I automate submitting text and link posts to multiple subreddits?

Yes, after completing the local OAuth flow, the CLI can submit text or link posts to subreddits. You provide the subreddit name, title, and text via command-line arguments, and the token authorizes the write action.

What's the best way to fetch top posts from a niche subreddit for automated reply suggestions?

Use the CLI's posts command to fetch top posts from a target subreddit without authentication. The retrieved data can then be passed to an automation workflow that auto-suggests replies or moderation actions based on the content.

Are there limitations when using Reddit's public API for automation without authentication?

Without authentication, the CLI is limited to read-only operations like browsing and searching. Any write actions, including posting, replying, or managing mod queues, require the local OAuth token to be generated and stored.