npx skills add https://github.com/jackwener/rdt-cli --skill rdt-cli二进制文件: rdt 凭证: 浏览器 cookies (通过 browser-cookie3 自动提取)
# 安装 (需要 Python 3.10+)
uv tool install rdt-cli
# 或者: pip install rdt-cli
# 升级
uv tool upgrade rdt-cli
对代理的重要提示:在执行任何需要认证的 rdt 命令之前,请检查凭证是否存在。
rdt status --json 2>/dev/null | jq -r '.data.authenticated' | grep -q true && echo "AUTH_OK" || echo "AUTH_NEEDED"
如果输出 AUTH_OK,则跳转到命令参考。如果输出 AUTH_NEEDED,则继续步骤 1。
确保用户已在支持的浏览器(Chrome、Firefox、Edge、Brave、Arc、Chromium、Opera、Vivaldi、Safari、LibreWolf)中登录 reddit.com。然后:
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
rdt login
使用以下命令验证:
rdt status
rdt whoami --json | jq '.data.name // .data._session.username'
| 症状 | 代理操作 |
|---|---|
No Reddit cookies found | 引导用户在浏览器中登录 reddit.com |
Session expired | 运行 rdt logout && rdt login |
database is locked | 关闭浏览器,然后重试 |
所有机器可读输出都使用 SCHEMA.md 中记录的封装格式。有效载荷位于 .data 下。
--json / --yaml → 显式指定格式--compact → 字段更少(对代理节省 token)--output file.json → 将结构化输出保存到文件rdt search X --json | jq .data)| 命令 | 描述 | 示例 |
|---|---|---|
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, bestrelevance, hot, top, new, commentshour, day, week, month, year, allbest, top, new, controversial, old, qa在 error.code 字段中返回的结构化错误代码(参见 SCHEMA.md):
not_authenticated — cookies 过期或缺失rate_limited — 请求过多not_found — 子版块/用户/帖子不存在forbidden — 私有子版块或被屏蔽的用户api_error — 上游 Reddit API 错误unknown_error — 意外错误rdt login 重新登录每周安装数
97
代码仓库
GitHub 星标数
298
首次出现
11 天前
安全审计
安装于
codex90
opencode89
github-copilot88
kimi-cli88
gemini-cli88
cursor88
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 |
| 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 |
| 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 |
| 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> |
| 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, commentsStructured 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 loginWeekly Installs
97
Repository
GitHub Stars
298
First Seen
11 days ago
Security Audits
Gen Agent Trust HubPassSocketPassSnykWarn
Installed on
codex90
opencode89
github-copilot88
kimi-cli88
gemini-cli88
cursor88
通过 LiteLLM 代理让 Claude Code 对接 GitHub Copilot 运行 | 高级变通方案指南
44,900 周安装
工作流编排器:Temporal、Camunda、Saga模式实现,构建可靠长时运行流程
111 周安装
FiveM vRP框架开发指南:Lua脚本、API函数与服务器架构详解
72 周安装
Docker Compose 生产环境部署模板 - 安全可靠可扩展的最佳实践配置
114 周安装
Google Ads策略构建器:从架构到优化的完整指南 | 提升广告支出回报率
112 周安装
Generic React UX Designer - React用户体验设计技能,提升前端开发效率与界面设计质量
112 周安装
英语日语中文文档写作规范指南:学术商务技术创意写作风格与格式
117 周安装
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 |
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 |
rdt export <query> |
| Export to CSV/JSON |
rdt export "ML" -n 50 -o results.csv |
| 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!" |
hour, day, week, month, year, allbest, top, new, controversial, old, qa