Initial commit with translated description

2026-03-29 14:30:40 +08:00
commit d1ffb0a997
4 changed files with 812 additions and 0 deletions
--- a/SKILL.md
+++ b/SKILL.md
@@ -0,0 +1,103 @@
+---
+name: reddit
+description: "浏览、搜索、发布和管理Reddit。无需身份验证即可只读；发布/管理需要OAuth设置。"
+metadata: {"clawdbot":{"emoji":"📣","requires":{"bins":["node"]}}}
+---
+
+# Reddit
+
+Browse, search, post to, and moderate subreddits. Read-only actions work without auth; posting/moderation requires OAuth setup.
+
+## Setup (for posting/moderation)
+
+1. Go to https://www.reddit.com/prefs/apps
+2. Click "create another app..."
+3. Select "script" type
+4. Set redirect URI to `http://localhost:8080`
+5. Note your client ID (under app name) and client secret
+6. Set environment variables:
+   ```bash
+   export REDDIT_CLIENT_ID="your_client_id"
+   export REDDIT_CLIENT_SECRET="your_client_secret"
+   export REDDIT_USERNAME="your_username"
+   export REDDIT_PASSWORD="your_password"
+   ```
+
+## Read Posts (no auth required)
+
+```bash
+# Hot posts from a subreddit
+node {baseDir}/scripts/reddit.mjs posts wallstreetbets
+
+# New posts
+node {baseDir}/scripts/reddit.mjs posts wallstreetbets --sort new
+
+# Top posts (day/week/month/year/all)
+node {baseDir}/scripts/reddit.mjs posts wallstreetbets --sort top --time week
+
+# Limit results
+node {baseDir}/scripts/reddit.mjs posts wallstreetbets --limit 5
+```
+
+## Search Posts
+
+```bash
+# Search within a subreddit
+node {baseDir}/scripts/reddit.mjs search wallstreetbets "YOLO"
+
+# Search all of Reddit
+node {baseDir}/scripts/reddit.mjs search all "stock picks"
+```
+
+## Get Comments on a Post
+
+```bash
+# By post ID or full URL
+node {baseDir}/scripts/reddit.mjs comments POST_ID
+node {baseDir}/scripts/reddit.mjs comments "https://reddit.com/r/subreddit/comments/abc123/..."
+```
+
+## Submit a Post (requires auth)
+
+```bash
+# Text post
+node {baseDir}/scripts/reddit.mjs submit yoursubreddit --title "Weekly Discussion" --text "What's on your mind?"
+
+# Link post
+node {baseDir}/scripts/reddit.mjs submit yoursubreddit --title "Great article" --url "https://example.com/article"
+```
+
+## Reply to a Post/Comment (requires auth)
+
+```bash
+node {baseDir}/scripts/reddit.mjs reply THING_ID "Your reply text here"
+```
+
+## Moderation (requires auth + mod permissions)
+
+```bash
+# Remove a post/comment
+node {baseDir}/scripts/reddit.mjs mod remove THING_ID
+
+# Approve a post/comment
+node {baseDir}/scripts/reddit.mjs mod approve THING_ID
+
+# Sticky a post
+node {baseDir}/scripts/reddit.mjs mod sticky POST_ID
+
+# Unsticky
+node {baseDir}/scripts/reddit.mjs mod unsticky POST_ID
+
+# Lock comments
+node {baseDir}/scripts/reddit.mjs mod lock POST_ID
+
+# View modqueue
+node {baseDir}/scripts/reddit.mjs mod queue yoursubreddit
+```
+
+## Notes
+
+- Read actions use Reddit's public JSON API (no auth needed)
+- Post/mod actions require OAuth - run `login` command once to authorize
+- Token stored at `~/.reddit-token.json` (auto-refreshes)
+- Rate limits: ~60 requests/minute for OAuth, ~10/minute for unauthenticated