reddit-cli

Fetch Reddit posts, searches, and subreddit metadata using browser session cookies.

Updated Aug 23, 2026

Search Tags:#cli #search #reddit #nodejs #web-scraping #cookies #subreddit

Ready to run

npx skills add https://github.com/MagicWifiMoney/openclaw-starter-kit --skill reddit-cli

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: reddit-cli
Source: https://github.com/MagicWifiMoney/openclaw-starter-kit/tree/main/skills-custom/extras/reddit-cli
Command: npx skills add https://github.com/MagicWifiMoney/openclaw-starter-kit --skill reddit-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Many useful Reddit endpoints require authentication or API keys, which adds friction for quick personal research or automation; this Skill lets you access Reddit content using your browser session cookies so you can read, search, and inspect subreddits without registering an app.

Core Features & Use Cases

Fetch hot, new, top, or rising posts from any subreddit with simple paging and sorting options.
Search across Reddit or within a specific subreddit and return compact, readable results including titles, authors, scores, and permalinks.
Retrieve subreddit metadata such as subscriber counts, active users, and descriptions for monitoring or reporting.
Use Case: Quickly gather top posts from a niche community for market research or curate links for a newsletter without setting up OAuth.

Quick Start

Run the reddit-cli posts command with a subreddit name and optional limit and sort to fetch formatted posts using your session cookies.

Frequently Asked Questions about reddit-cli

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

FAQPage Schema

How do I access Reddit data without an API key or OAuth setup?▼

You can access Reddit data without an API key by using your browser session cookies. This command-line utility authenticates requests using environment variables for your reddit_session to fetch subreddit posts and metadata.

How do I fetch top posts from a subreddit using Node.js?▼

You can fetch top posts by running the reddit-cli posts command with a subreddit name and sort option. It performs GET requests to reddit.com JSON endpoints using your browser cookies to return formatted post data.

Can I search within a specific subreddit without registering an app?▼

Yes, you can search across Reddit or within a specific subreddit without registering an app. The utility uses your session cookies to return compact results including titles, authors, scores, and permalinks.

What session cookies do I need to scrape Reddit JSON endpoints?▼

You need to set environment variables for reddit_session and optionally token_v2 to scrape Reddit JSON endpoints. These browser session cookies replace the need for traditional OAuth credentials or API keys.

Does this CLI tool support retrieving subreddit metadata like subscriber counts?▼

Yes, the CLI tool supports retrieving subreddit metadata such as subscriber counts, active users, and descriptions. It queries reddit.com JSON endpoints using your session cookies for monitoring or reporting tasks.