Reddit (Agent-First)
by @yahavf6
Reddit intelligence CLI for AI agents. Use when working with reddit posts, subreddit research, comments, user profiles, wiki pages, domain mentions, marketin...
clawhub install reddit-reddgrowπ About This Skill
name: reddgrow version: 0.1.6 description: "Reddit intelligence CLI for AI agents. Use when working with reddit posts, subreddit research, comments, user profiles, wiki pages, domain mentions, marketing, community rules, or URL checking." metadata: {"openclaw":{"emoji":"π΄","homepage":"https://reddgrow.ai","requires":{"bins":["reddgrow"],"env":["REDDGROW_API_KEY"]},"install":[{"id":"npm","kind":"node","package":"@reddgrow/cli","bins":["reddgrow"],"label":"Install via npm"}],"primaryEnv":"REDDGROW_API_KEY"}}
ReddGrow β Reddit Intelligence for AI Agents
Reddit API access for AI agents. All commands output JSON to stdout. Errors go to stderr with exit code 1.
Setup
# Install
npm install -g @reddgrow/cliAuthenticate (one-time)
reddgrow auth login rg_your_api_key_hereOr use environment variable
export REDDGROW_API_KEY=rg_your_api_key_here
Commands
Subreddits
reddgrow subreddits search "" [--limit N] # (3 cr)
reddgrow subreddits about # (1 cr)
reddgrow subreddits rules # (1 cr)
reddgrow subreddits wiki # list wiki pages (5 cr)
reddgrow subreddits wiki-page # read wiki page (5 cr)
reddgrow subreddits posts [--sort hot|new|top|rising|controversial] [--time hour|day|week|month|year|all] [--limit N] # (2 cr)
reddgrow subreddits comments [--limit N] # comment stream (2 cr)
reddgrow subreddits check-url "" # check if URL submitted (3 cr)
reddgrow subreddits traffic # traffic stats (1 cr)
reddgrow subreddits widgets # sidebar widgets (1 cr)
Posts
reddgrow posts search "" [--subreddit ] [--sort relevance|hot|top|new|comments] [--limit N] # (3 cr)
reddgrow posts comments [--sort best|top|new|controversial] [--limit N] # (2 cr)
reddgrow posts duplicates # (5 cr)
reddgrow posts batch # (5 cr)
Users
reddgrow users profile # karma, account age, activity (1 cr)
reddgrow users posts [--limit N] # post history (2 cr)
reddgrow users comments [--limit N] # comment history (2 cr)
Domains
reddgrow domains mentions [--limit N] # all posts linking to domain (5 cr)
Auth
reddgrow auth whoami # identity & credits remaining (1 cr)
reddgrow auth status # connection status
reddgrow auth login # save API key (run once)
Workflows
Before posting to a subreddit
1. Read rules: reddgrow subreddits rules β rule violations get posts removed instantly
2. Check community type: reddgrow subreddits about β if subreddit_type is restricted or private, stop; if submission_type is link or self, respect it
3. Check URL not already submitted: reddgrow subreddits check-url
4. Read wiki for extra guidelines: reddgrow subreddits wiki-page
5. Post only after all checks pass
Research a subreddit
1. Find communities: reddgrow subreddits search "
2. Inspect details: reddgrow subreddits about β size, type, activity
3. Browse content: reddgrow subreddits posts
4. Check activity: reddgrow subreddits traffic
5. Discover guidelines: reddgrow subreddits wiki then wiki-page
Monitor a domain / brand
1. Discover mentions: reddgrow domains mentions
2. Read discussion: reddgrow posts comments
3. Check for duplicates: reddgrow subreddits check-url before re-sharing
Analyze a Reddit user
1. Get overview: reddgrow users profile β karma, age, verified status
2. Review posts: reddgrow users posts
3. Review comments: reddgrow users comments
Rules
1. ALWAYS run reddgrow subreddits rules before posting β rule violations get posts removed
2. ALWAYS run reddgrow subreddits check-url before sharing any link β duplicate posts are banned
3. Read wiki (wiki-page ) when rules reference additional guidelines
4. Respect subreddit_type: restricted or private means posting is not allowed
5. Respect submission_type: some subreddits only accept links or only text posts
6. ALWAYS check reddgrow auth whoami before large batch operations to avoid credit exhaustion
7. Never post promotional content to communities that explicitly prohibit self-promotion
Configuration
| Variable | Description | Default |
|----------|-------------|---------|
| REDDGROW_API_KEY | API key (overrides saved key) | β |
| REDDGROW_API_URL | API base URL | https://api.reddgrow.ai |
| REDDGROW_MODE | Output mode (human or json) | json |
βοΈ Configuration
| Variable | Description | Default |
|----------|-------------|---------|
| REDDGROW_API_KEY | API key (overrides saved key) | β |
| REDDGROW_API_URL | API base URL | https://api.reddgrow.ai |
| REDDGROW_MODE | Output mode (human or json) | json |
π Constraints
1. ALWAYS run reddgrow subreddits rules before posting β rule violations get posts removed
2. ALWAYS run reddgrow subreddits check-url before sharing any link β duplicate posts are banned
3. Read wiki (wiki-page ) when rules reference additional guidelines
4. Respect subreddit_type: restricted or private means posting is not allowed
5. Respect submission_type: some subreddits only accept links or only text posts
6. ALWAYS check reddgrow auth whoami before large batch operations to avoid credit exhaustion
7. Never post promotional content to communities that explicitly prohibit self-promotion