Xpersona
R

Reddit (read only - no auth)

CLAWHUB · Unverified

Browse and search Reddit in read-only mode using public JSON endpoints. Use when the user asks to browse subreddits, search for posts by topic, inspect comment threads, or build a shortlist of links to review and reply to manually. Skill: Reddit (read only - no auth) Owner: buksan1950 Summary: Browse and search Reddit in read-only mode using public JSON endpoints. Use when the user asks to browse subreddits, search for posts by topic, inspect comment threads, or build a shortlist of links to review and reply to manually. Tags: latest:1.0.0 Version history: v1.0.0 | 2026-02-02T16:41:42.449Z | user - Initial public release. - Enables read-only br

62
Rank
84
Safety
20k
Downloads

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 20.1K downloads reported by the source. Last updated 11/16/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Install and run

Setup complexity: low.

clawhub skill install s17cze1nkwbyn4te0k1zanqrws884592:reddit-readonly
  1. Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
  2. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-buksan1950-reddit-readonly-readonly-2/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

7,609 characters of source documentation, loaded on request.

Extracted files

4 files captured from the source.

SKILL.md

---
name: reddit-readonly
description: >-
  Browse and search Reddit in read-only mode using public JSON endpoints.
  Use when the user asks to browse subreddits, search for posts by topic,
  inspect comment threads, or build a shortlist of links to review and reply to manually.
metadata: {"clawdbot":{"emoji":"🔎","requires":{"bins":["node"]}}}
---

# Reddit Readonly

Read-only Reddit browsing for Clawdbot.

## What this skill is for

- Finding posts in one or more subreddits (hot/new/top/controversial/rising)
- Searching for posts by query (within a subreddit or across all)
- Pulling a comment thread for context
- Producing a *shortlist of permalinks* so the user can open Reddit and reply manually

## Hard rules

- **Read-only only.** This skill never posts, replies, votes, or moderates.
- Be polite with requests:
  - Prefer small limits (5–10) first.
  - Expand only if needed.
- When returning results to the user, always include **permalinks**.

## Output format

All commands print JSON to stdout.

- Success: `{ "ok": true, "data": ... }`
- Failure: `{ "ok": false, "error": { "message": "...", "details": "..." } }`

## Commands

### 1) List posts in a subreddit

```bash
node {baseDir}/scripts/reddit-readonly.mjs posts <subreddit> \
  --sort hot|new|top|controversial|rising \
  --time day|week|month|year|all \
  --limit 10 \
  --after <token>
```

### 2) Search posts

```bash
# Search within a subreddit
node {baseDir}/scripts/reddit-readonly.mjs search <subreddit> "<query>" --limit 10

# Search all of Reddit
node {baseDir}/scripts/reddit-readonly.mjs search all "<query>" --limit 10
```

### 3) Get comments for a post

```bash
# By post id or URL
node {baseDir}/scripts/reddit-readonly.mjs comments <post_id|url> --limit 50 --depth 6
```

### 4) Recent comments across a subreddit

```bash
node {baseDir}/scripts/reddit-readonly.mjs recent-comments <subreddit> --limit 25
```

### 5) Thread bundle (post + comments)

```bash
node {baseDir}/scripts/reddit-readonly.mjs thread <post_id|url> --commentLimit 50 --depth 6
```

### 6) Find opportunities (multi-subreddit helper)

Use this when the user describes criteria like:
"Find posts about X in r/a, r/b, and r/c posted in the last 48 hours, excluding Y".

```bash
node {baseDir}/scripts/reddit-readonly.mjs find \
  --subreddits "python,learnpython" \
  --query "fastapi deployment" \
  --include "docker,uvicorn,nginx" \
  --exclude "homework,beginner" \
  --minScore 2 \
  --maxAgeHours 48 \
  --perSubredditLimit 25 \
  --maxResults 10 \
  --rank new
```

## Suggested agent workflow

1. **Clarify scope** if needed: subreddits + topic keywords + timeframe.
2. Start with `find` (or `posts`/`search`) using small limits.
3. For 1–3 promising items, fetch context via `thread`.
4. Present the user a shortlist:
   - title, subreddit, score, created time
   - permalink
   - a brief reason why it matched
5. If asked, propose *draft reply ideas* in natural language, but remind the user to post manually.

## Troubleshoo

_meta.json

{
  "ownerId": "kn7dd2xz8ewy2961ewwgs7cy8580cpwz",
  "slug": "reddit-readonly",
  "version": "1.0.0",
  "publishedAt": 1770050502449
}

references/OUTPUT_SCHEMA.md

# Output schema (informal)

All commands return JSON: `{ ok, data | error }`.

## Post object

```json
{
  "id": "abc123",
  "fullname": "t3_abc123",
  "subreddit": "python",
  "title": "...",
  "author": "...",
  "score": 123,
  "num_comments": 45,
  "created_utc": 1737060000,
  "created_iso": "2026-01-16T12:00:00.000Z",
  "permalink": "https://www.reddit.com/r/python/comments/abc123/.../",
  "url": "https://...",
  "selftext_snippet": "...",
  "flair": "..."
}
```

## Comment object (flattened)

```json
{
  "id": "def456",
  "fullname": "t1_def456",
  "author": "...",
  "score": 10,
  "created_utc": 1737060100,
  "created_iso": "2026-01-16T12:01:40.000Z",
  "depth": 2,
  "parent_fullname": "t1_...",
  "permalink": "https://www.reddit.com/r/python/comments/abc123/.../def456/",
  "body_snippet": "..."
}
```

skill-card.md

## Description:

Browse and search Reddit in read-only mode using public JSON endpoints.

This skill is ready for commercial/non-commercial use.

## Publisher:

[buksan1950](https://clawhub.ai/user/buksan1950)

### License/Terms of Use:


## Use Case:

Agents and their users use this skill to find Reddit posts, inspect public comment threads, and prepare shortlists of permalinks for manual review or reply drafting.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: The skill can retrieve user-specified public Reddit content, which may include low-quality, offensive, or misleading material.

Mitigation: Keep searches scoped to relevant subreddits and small result limits, then review selected posts and comments before using them.

Risk: Draft reply ideas based on retrieved Reddit content could be inaccurate or inappropriate for the thread context.

Mitigation: Use generated reply ideas only as drafts and post manually after human review.

Risk: Large or repeated requests may trigger Reddit rate limits or return incomplete thread context.

Mitigation: Use the documented small limits and slower pacing environment variables when requests fail or Reddit returns HTML.

## Reference(s):

- [ClawHub skill page](https://clawhub.ai/buksan1950/skills/reddit-readonly)
- [Output schema](references/OUTPUT_SCHEMA.md)
- [Reddit public website](https://www.reddit.com)

## Skill Output:

**Output Type(s):** [text, markdown, shell commands, configuration, guidance]

**Output Format:** [JSON command output with concise Markdown summaries and optional shell command examples]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Read-only public Reddit data; commands return { ok, data } or { ok, error } envelopes and include permalinks.]

## Skill Version(s):

1.0.0 (source: server release metadata)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Sponsored

Ads related to Reddit (read only - no auth) and adjacent AI workflows.