القائمة
Use rdt-cli for ALL Reddit operations — browsing feeds, reading posts, searching, viewing users, upvoting, saving, and subscribing. Invoke whenever the user requests any Reddit interaction.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | rdt-cli |
| description | Use rdt-cli for ALL Reddit operations — browsing feeds, reading posts, searching, viewing users, upvoting, saving, and subscribing. Invoke whenever the user requests any Reddit interaction. |
| author | jackwener |
| version | 0.4.0 |
| tags | ["reddit","rdt","social-media","cli"] |
Binary: rdt
Credentials: browser cookies (auto-extracted via browser-cookie3)
# Install (requires Python 3.10+)
uv tool install rdt-cli
# Or: pip install rdt-cli
# Upgrade
uv tool upgrade rdt-cli
IMPORTANT FOR AGENTS: Before executing ANY rdt command that requires auth, check if credentials exist.
rdt status --json 2>/dev/null | jq -r '.data.authenticated' | grep -q true && echo "AUTH_OK" || echo "AUTH_NEEDED"
If AUTH_OK, skip to Command Reference.
If AUTH_NEEDED, proceed to Step 1.
Ensure user is logged into reddit.com in a supported browser (Chrome, Firefox, Edge, Brave, Arc, Chromium, Opera, Vivaldi, Safari, LibreWolf). Then:
rdt login
Verify with:
rdt status
rdt whoami --json | jq '.data.name // .data._session.username'
| Symptom | Agent action |
|---|---|
No Reddit cookies found | Guide user to login to reddit.com in browser |
Session expired | Run rdt logout && rdt login |
database is locked | Close browser, then retry |
All machine-readable output uses the envelope documented in SCHEMA.md.
Payloads live under .data.
--json / --yaml → explicit format--compact → fewer fields (agent token-efficient)--output file.json → save structured output to filerdt search X --json | jq .data)| Command | Description | Example |
|---|---|---|
rdt feed | Browse home feed (requires login) | rdt feed -n 10 --json |
rdt feed --subs-only | Subscriptions-only feed (no algorithm, sorted by time) | rdt feed --subs-only -n 5 --json |
rdt popular | Browse /r/popular | rdt popular -n 5 --json |
rdt all | Browse /r/all | rdt all -n 10 --compact --json |
rdt sub <name> | Browse a subreddit | rdt sub python -s top -t week |
rdt sub-info <name> | View subreddit info | rdt sub-info rust --json |
rdt user <name> | View user profile | rdt user spez --json |
rdt user-posts <name> | View user's posts | rdt user-posts spez -n 5 --json |
rdt user-comments <name> | View user's comments | rdt user-comments spez -n 5 --json |
rdt saved | View your saved items | rdt saved -n 10 --json |
rdt upvoted | View your upvoted posts | rdt upvoted -n 10 --json |
rdt open <id_or_index> | Open post in browser | rdt open 3 |
| Command | Description | Example |
|---|---|---|
rdt read <post_id> | Read a post + comments | rdt read 1abc123 --json |
rdt read <post_id> --expand-more | Expand top-level more comments | rdt read 1abc123 --expand-more --json |
rdt show <index> | Read by short-index | rdt show 3 |
rdt show <index> --expand-more | Expand more comments from cached result | rdt show 3 --expand-more --json |
rdt whoami | View your profile (karma, age) | rdt whoami --json |
| Command | Description | Example |
|---|---|---|
rdt search <query> | Search posts | rdt search "python async" -s top -t year |
rdt search <query> -r <sub> | Search in subreddit | rdt search "error" -r rust --json |
rdt search <query> -o f.json | Search + save to file | rdt search "ML" -n 50 -o results.json |
rdt export <query> | Export to CSV/JSON | rdt export "ML" -n 50 -o results.csv |
| Command | Description | Example |
|---|---|---|
rdt upvote <id_or_index> | Upvote | rdt upvote 3 |
rdt upvote <id> --down | Downvote | rdt upvote 3 --down |
rdt upvote <id> --undo | Remove vote | rdt upvote 3 --undo |
rdt save <id_or_index> | Save post | rdt save 3 |
rdt save <id> --undo | Unsave | rdt save 3 --undo |
rdt subscribe <sub> | Subscribe | rdt subscribe python |
rdt subscribe <sub> --undo | Unsubscribe | rdt subscribe python --undo |
rdt comment <id> <text> | Post a comment | rdt comment 3 "Great post!" |
| Command | Description |
|---|---|
rdt login | Extract cookies from browser |
rdt logout | Clear cached cookies |
rdt status | Check authentication status |
rdt whoami | View detailed profile info |
All listing commands (feed, popular, all, sub, user-posts, user-comments, saved, upvoted, search) support:
| Flag | Description |
|---|---|
--json | JSON output (with SCHEMA envelope) |
--yaml | YAML output (with SCHEMA envelope) |
-o, --output FILE | Save structured output to file |
--full-text | Show full title without truncation |
-c, --compact | Agent-friendly compact output (fewer fields) |
| Flag | Description |
|---|---|
--subs-only | Show only posts from subscribed subreddits (sorted by time, no algorithm) |
--max-subs N | Max subscriptions to fetch (default: 20) |
rdt sub python -s top -t week -n 5
rdt show 1 --expand-more
rdt upvote 1
rdt search "machine learning" -s top --compact --json | jq '.data'
rdt export "machine learning" -n 100 -o ml_posts.csv
rdt search "rust async" -n 50 -o results.json
rdt search "python tips" -n 20 --compact -o tips.json
rdt user spez --json | jq '.data | {name, link_karma, comment_karma}'
rdt user-posts spez -n 10 --compact --json
rdt user-comments spez -n 10 --compact --json
rdt saved -n 20 --compact --json
rdt upvoted -n 20 --compact --json
rdt feed --subs-only -n 5 --compact --json
rdt feed --subs-only --max-subs 10 -o subs_feed.json
rdt sub-info python --json | jq '.data | {subscribers, accounts_active}'
rdt sub python -s top -t month -n 5 --full-text
hot, new, top, rising, controversial, bestrelevance, hot, top, new, commentshour, day, week, month, year, allbest, top, new, controversial, old, qaStructured error codes returned in the error.code field (see SCHEMA.md):
not_authenticated — cookies expired or missingrate_limited — too many requestsnot_found — subreddit/user/post does not existforbidden — private subreddit or blocked userapi_error — upstream Reddit API errorunknown_error — unexpected errorrdt login