rdt-cli：Reddit 命令行工具，自动化浏览、搜索与交互，提升效率

rdt-cli by jackwener/rdt-cli

120 周安装量

312 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/jackwener/rdt-cli --skill rdt-cli

社交网络自动化命令行工具

🇨🇳中文介绍

rdt-cli — Reddit 命令行工具

二进制文件: rdt 凭证: 浏览器 cookies (通过 browser-cookie3 自动提取)

安装

# 安装 (需要 Python 3.10+)
uv tool install rdt-cli
# 或者: pip install rdt-cli

# 升级
uv tool upgrade rdt-cli

认证

对代理的重要提示：在执行任何需要认证的 rdt 命令之前，请检查凭证是否存在。

步骤 0：检查是否已认证

rdt status --json 2>/dev/null | jq -r '.data.authenticated' | grep -q true && echo "AUTH_OK" || echo "AUTH_NEEDED"

如果输出 AUTH_OK，则跳转到命令参考。如果输出 AUTH_NEEDED，则继续步骤 1。

步骤 1：引导用户进行认证

确保用户已在支持的浏览器（Chrome、Firefox、Edge、Brave、Arc、Chromium、Opera、Vivaldi、Safari、LibreWolf）中登录 reddit.com。然后：

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

步骤 2：处理常见认证问题

症状	代理操作
`No Reddit cookies found`	引导用户在浏览器中登录 reddit.com
`Session expired`	运行 `rdt logout && rdt login`
`database is locked`	关闭浏览器，然后重试

所有机器可读输出都使用 SCHEMA.md 中记录的封装格式。有效载荷位于 .data 下。

非 TTY 标准输出 → 自动转为 YAML
--json / --yaml → 显式指定格式
--compact → 字段更少（对代理节省 token）
--output file.json → 将结构化输出保存到文件
富文本输出 → 标准错误输出（管道操作安全：rdt search X --json | jq .data）
大多数读取命令无需认证即可工作（使用 Reddit 公共 JSON API）
写入操作（点赞、保存、订阅）需要认证 + 内置 1.5-4 秒延迟

命令	描述	示例
`rdt feed`	浏览首页动态（需要登录）	`rdt feed -n 10 --json`
`rdt feed --subs-only`	仅显示订阅的社区动态（无算法，按时间排序）	`rdt feed --subs-only -n 5 --json`
`rdt popular`	浏览 /r/popular	`rdt popular -n 5 --json`
`rdt all`	浏览 /r/all	`rdt all -n 10 --compact --json`
`rdt sub <name>`	浏览指定子版块	`rdt sub python -s top -t week`
`rdt sub-info <name>`	查看子版块信息	`rdt sub-info rust --json`
`rdt user <name>`	查看用户资料	`rdt user spez --json`
`rdt user-posts <name>`	查看用户的帖子	`rdt user-posts spez -n 5 --json`
`rdt user-comments <name>`	查看用户的评论	`rdt user-comments spez -n 5 --json`
`rdt saved`	查看你保存的项目	`rdt saved -n 10 --json`
`rdt upvoted`	查看你点赞的帖子	`rdt upvoted -n 10 --json`
`rdt open <id_or_index>`	在浏览器中打开帖子	`rdt open 3`

命令	描述	示例
`rdt read <post_id>`	阅读帖子及评论	`rdt read 1abc123 --json`
`rdt read <post_id> --expand-more`	展开顶层的 `更多评论`	`rdt read 1abc123 --expand-more --json`
`rdt show <index>`	通过短索引阅读	`rdt show 3`
`rdt show <index> --expand-more`	从缓存结果中展开 `更多评论`	`rdt show 3 --expand-more --json`
`rdt whoami`	查看你的个人资料（karma，账号年龄）	`rdt whoami --json`

命令	描述	示例
`rdt search <query>`	搜索帖子	`rdt search "python async" -s top -t year`
`rdt search <query> -r <sub>`	在子版块内搜索	`rdt search "error" -r rust --json`
`rdt search <query> -o f.json`	搜索并保存到文件	`rdt search "ML" -n 50 -o results.json`
`rdt export <query>`	导出为 CSV/JSON	`rdt export "ML" -n 50 -o results.csv`

交互操作（需要认证）

命令	描述	示例
`rdt upvote <id_or_index>`	点赞	`rdt upvote 3`
`rdt upvote <id> --down`	点踩	`rdt upvote 3 --down`
`rdt upvote <id> --undo`	取消投票	`rdt upvote 3 --undo`
`rdt save <id_or_index>`	保存帖子	`rdt save 3`
`rdt save <id> --undo`	取消保存	`rdt save 3 --undo`
`rdt subscribe <sub>`	订阅	`rdt subscribe python`
`rdt subscribe <sub> --undo`	取消订阅	`rdt subscribe python --undo`
`rdt comment <id> <text>`	发表评论	`rdt comment 3 "Great post!"`

命令	描述
`rdt login`	从浏览器提取 cookies
`rdt logout`	清除缓存的 cookies
`rdt status`	检查认证状态
`rdt whoami`	查看详细的个人资料信息

所有列表命令（feed, popular, all, sub, user-posts, user-comments, saved, upvoted, search）都支持：

标志	描述
`--json`	JSON 输出（带 SCHEMA 封装）
`--yaml`	YAML 输出（带 SCHEMA 封装）
`-o, --output FILE`	将结构化输出保存到文件
`--full-text`	显示完整标题（不截断）
`-c, --compact`	代理友好的紧凑输出（字段更少）

标志	描述
`--subs-only`	仅显示来自已订阅子版块的帖子（按时间排序，无算法）
`--max-subs N`	最大订阅数（默认：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, best
搜索排序：relevance, hot, top, new, comments
时间筛选（用于 top/controversial）：hour, day, week, month, year, all
评论排序：best, top, new, controversial, old, qa

在 error.code 字段中返回的结构化错误代码（参见 SCHEMA.md）：

not_authenticated — cookies 过期或缺失
rate_limited — 请求过多
not_found — 子版块/用户/帖子不存在
forbidden — 私有子版块或被屏蔽的用户
api_error — 上游 Reddit API 错误
unknown_error — 意外错误

无私信功能 — 无法访问私人消息
无实时/流式功能 — 不支持实时功能
无媒体下载 — 无法下载图片/视频
单账户 — 一次只能使用一组 cookies
速率限制 — 请求间内置高斯抖动（约 1 秒）
仅限公共 API — 使用 .json 后缀 API，而非 OAuth 端点

给代理的反检测注意事项

请勿并行化请求 — 内置的速率限制延迟是为了账户安全
写入操作延迟：每次写入操作（点赞/保存/订阅/评论）后有 1.5-4 秒的随机延迟
批量操作：在执行批量工作时，请在 CLI 调用之间添加延迟
Chrome 133 指纹：所有请求使用一致的浏览器身份
指数退避：429/5xx 错误会自动重试并采用退避策略

不要要求用户在聊天记录中分享原始 cookie 值
优先使用浏览器 cookie 提取，而非手动复制/粘贴密钥
如果认证失败，请要求用户通过 rdt login 重新登录
内置的速率限制延迟保护账户；请勿绕过它

🇺🇸English

rdt-cli — Reddit CLI Tool

Binary: rdt Credentials: browser cookies (auto-extracted via browser-cookie3)

Setup

# Install (requires Python 3.10+)
uv tool install rdt-cli
# Or: pip install rdt-cli

# Upgrade
uv tool upgrade rdt-cli

Authentication

IMPORTANT FOR AGENTS : Before executing ANY rdt command that requires auth, check if credentials exist.

Step 0: Check if already authenticated

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.

Step 1: Guide user to authenticate

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'

Step 2: Handle common auth issues

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

Agent Defaults

All machine-readable output uses the envelope documented in SCHEMA.md. Payloads live under .data.

Non-TTY stdout → auto YAML
--json / --yaml → explicit format
--compact → fewer fields (agent token-efficient)
--output file.json → save structured output to file
Rich output → stderr (safe for pipes: rdt search X --json | jq .data)
Most read commands work without auth (public Reddit JSON API)
Write actions (upvote, save, subscribe) require auth + built-in 1.5-4s delay

Command Reference

Browsing

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`

Reading

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`

Search & Export

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`

Interactions (require auth)

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>`

Account

Command	Description
`rdt login`	Extract cookies from browser
`rdt logout`	Clear cached cookies
`rdt status`	Check authentication status
`rdt whoami`	View detailed profile info

Listing Options

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)

Feed-specific Options

Flag	Description
`--subs-only`	Show only posts from subscribed subreddits (sorted by time, no algorithm)
`--max-subs N`	Max subscriptions to fetch (default: 20)

Agent Workflow Examples

Browse → Read → Upvote pipeline

rdt sub python -s top -t week -n 5
rdt show 1 --expand-more
rdt upvote 1

Search → Export pipeline (structured)

rdt search "machine learning" -s top --compact --json | jq '.data'
rdt export "machine learning" -n 100 -o ml_posts.csv

Search → Save to file

rdt search "rust async" -n 50 -o results.json
rdt search "python tips" -n 20 --compact -o tips.json

User research

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

Saved / Upvoted review

rdt saved -n 20 --compact --json
rdt upvoted -n 20 --compact --json

Subscriptions-only monitoring

rdt feed --subs-only -n 5 --compact --json
rdt feed --subs-only --max-subs 10 -o subs_feed.json

Subreddit discovery

rdt sub-info python --json | jq '.data | {subscribers, accounts_active}'
rdt sub python -s top -t month -n 5 --full-text

Sort Options

Listing sort : hot, new, top, rising, controversial, best
Search sort : relevance, hot, top, new, comments

Error Codes

Structured error codes returned in the error.code field (see SCHEMA.md):

not_authenticated — cookies expired or missing
rate_limited — too many requests
not_found — subreddit/user/post does not exist
forbidden — private subreddit or blocked user
api_error — upstream Reddit API error
unknown_error — unexpected error

Limitations

No DMs — cannot access private messages
No live/streaming — live features not supported
No media download — cannot download images/videos
Single account — one set of cookies at a time
Rate limited — built-in Gaussian jitter (~1s) between requests
Public API only — uses .json suffix API, not OAuth endpoints

Anti-Detection Notes for Agents

Do NOT parallelize requests — the built-in rate-limit delay is for account safety
Write operation delay : 1.5-4s random delay after each write (upvote/save/subscribe/comment)
Batch operations : add delays between CLI calls when doing bulk work
Chrome 133 fingerprint : all requests use consistent browser identity
Exponential backoff : 429/5xx errors are auto-retried with backoff

Safety Notes

Do not ask users to share raw cookie values in chat logs
Prefer browser cookie extraction over manual secret copy/paste
If auth fails, ask the user to re-login via rdt login
Built-in rate-limit delay protects accounts; do not bypass it

Weekly Installs

Repository

jackwener/rdt-cli

GitHub Stars

298

First Seen

11 days ago

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

codex90

opencode89

github-copilot88

kimi-cli88

gemini-cli88

cursor88

通过 LiteLLM 代理让 Claude Code 对接 GitHub Copilot 运行 | 高级变通方案指南

44,900 周安装

Time filter (for top/controversial): hour, day, week, month, year, all

Comment sort : best, top, new, controversial, old, qa