reddit-explore✓ ناجح

محتوى SKILL.md

---
name: reddit-explore
description: |
  This skill should be used when the user asks to "search Reddit", "explore Reddit posts", "find Reddit discussions about", "summarize Reddit opinions on", "what does Reddit think about", or wants to gather and summarize community opinions from Reddit on a specific topic.
disable-model-invocation: true
metadata:
  {
    "openclaw":
      {
        "emoji": "🔍",
        "requires": { "bins": ["python3"], "env": ["APIFY_TOKEN"] },
        "primaryEnv": "APIFY_TOKEN",
      },
  }
---

# Reddit Explore

Search Reddit for posts on any topic using the Apify `trudax/reddit-scraper-lite` actor and produce a structured summary of community sentiment.

## Prerequisites

Before running, verify:

1. **apify-client** is installed: `pip3 install apify-client`
2. **APIFY_TOKEN** is set as an environment variable

If either is missing, refer the user to `references/apify-setup.md` in this skill's directory for setup instructions.

## Workflow

### Step 1: Determine the search topic

The search topic comes from `$ARGUMENTS`. If `$ARGUMENTS` is empty or missing, ask the user what topic they want to search Reddit for.

### Step 2: Run the Reddit search script

Execute the search script with the user's topic:

```bash
python3 ~/.agents/skills/reddit-explore/scripts/reddit_search.py --query "$ARGUMENTS" --max-items 30
```

The script outputs JSON results to stdout. If it fails:
- **"APIFY_TOKEN not found"**: Guide the user through setting up their token (see `references/apify-setup.md`)
- **"apify-client not installed"**: Run `pip3 install apify-client`
- **Other errors**: Show the error message and help troubleshoot

### Step 3: Analyze and summarize results

Read the JSON output. Each item contains:
- `title` - Post title
- `communityName` - Subreddit name
- `upVotes` - Score
- `numberOfComments` - Comment count
- `url` - Link to the post
- `body` - Post text content
- `createdAt` - When it was posted

### Step 4: Produce a structured summary

Present findings in this format:

#### Overview
Brief 2-3 sentence summary of what Reddit thinks about the topic.

#### Community Sentiment
- **Overall tone**: Positive / Mixed / Negative
- **Key subreddits**: List the most active communities discussing this

#### Key Themes

**Positives / Pros:**
- Bullet points of praised aspects, with post references

**Negatives / Cons:**
- Bullet points of criticized aspects, with post references

**Neutral / Informational:**
- Notable factual observations from the community

#### Notable Posts
List 3-5 of the most relevant/upvoted posts with:
- Title, subreddit, score
- Brief summary of the post content
- Link to the post

#### Summary
A concise takeaway of the community consensus.

## Tips

- For broad topics, the script searches with the exact query provided. If results are sparse, suggest the user try alternative phrasings.
- Posts are sorted by relevance by default.
- The script deduplicates results by URL automatically.
- Apify free tier provides $5/month in credits; each search typically costs a few cents.

الترخيص

الترخيص المُعلن: MIT

MIT License

Copyright (c) 2026 openclaw

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

عرض الترخيص في المستودع المصدري — النسخة المنشورة هناك هي المرجع.