domains / marketing / reddit-content-and-api / reddit

reddit

Skill card

combined

The three copies cover different, non-overlapping procedures. The first is a copywriting guide for creating Reddit posts and comments. The second is a read-only API client for retrieving posts, comments, and user data. The third is a full-featured client that includes posting, replying, and moderation capabilities via OAuth. No single copy contains the steps or constraints of the others, so crowning one would hide the other two distinct use cases.

Repositories

Other copies

Combined skill

---
name: reddit
description: Create Reddit content, retrieve data via API, and manage posts/comments with moderation.
---

# Reddit Skill

This skill covers three distinct workflows: creating marketing copy, retrieving data via the public API, and managing content via authenticated actions.

## 1. Content Creation (Marketing)
Use this section when generating publish-ready posts or comments.

### Core Rules
- **90/10 Principle**: 90% value, 10% promotional.
- **Self-Promotion**: Max 1 in 6 posts promotional.
- **Subreddit Rules**: Always check the sidebar before posting.
- **Flair**: Required by many subs; wrong flair leads to removal.

### Post Structure
- **Title**: Concise, specific, accurate. Match subreddit format (e.g., [Discussion]).
- **Body**: Value-first, casual tone, open-ended questions for engagement.
- **Formatting**: Use Markdown (bold, lists, links).

### Output Format
1. Title (subreddit-appropriate)
2. Body (value-driven, formatted)
3. Suggested flair
4. Reminder: "Verify rules before posting"

## 2. Data Retrieval (Read-Only API)
Use this section to fetch posts, comments, and user info. No API key is required.

### Python Scripts (ReScienceLab)
Run from the skill directory:
- **Subreddit Posts**: `python3 scripts/get_posts.py <subreddit> --limit 20 --sort hot`
- **Search Posts**: `python3 scripts/search_posts.py "query" --subreddit <sub> --limit 10`
- **Subreddit Info**: `python3 scripts/get_subreddit.py <subreddit>`
- **Post & Comments**: `python3 scripts/get_post.py <post_id> --comments 50`
- **User Profile**: `python3 scripts/get_user.py <username> --posts 10`

### Node.js Scripts (LeoYeAI)
- **Hot Posts**: `node {baseDir}/scripts/reddit.mjs posts <subreddit>`
- **Search**: `node {baseDir}/scripts/reddit.mjs search <subreddit> "query"`
- **Comments**: `node {baseDir}/scripts/reddit.mjs comments <post_id>`

## 3. Posting & Moderation (Authenticated)
Use this section to submit posts, reply, or moderate. Requires OAuth setup.

### Setup
1. Create a script app at https://www.reddit.com/prefs/apps.
2. Set redirect URI to `http://localhost:8080`.
3. Export environment variables: `REDDIT_CLIENT_ID`, `REDDIT_CLIENT_SECRET`, `REDDIT_USERNAME`, `REDDIT_PASSWORD`.

### Actions (Node.js)
- **Submit Post**: `node {baseDir}/scripts/reddit.mjs submit <subreddit> --title "Title" --text "Body"`
- **Reply**: `node {baseDir}/scripts/reddit.mjs reply <thing_id> "Reply text"`
- **Moderation**: `node {baseDir}/scripts/reddit.mjs mod remove <thing_id>` (also supports approve, sticky, lock, queue).

## Conflicts
- **Repository**: kostja94/marketing-skills vs. ReScienceLab/opc-skills vs. LeoYeAI/openclaw-master-skills
- **Step**: The first copy is a writing guide, while the other two are API clients. The second is read-only Python, while the third is a read/write Node.js CLI. Use the appropriate section based on the task (writing vs. reading vs. managing).