Reddit Scraper

核心用法

Reddit Scraper Skill 是一款轻量级 Reddit 内容读取工具，通过调用 Reddit 官方公开的 JSON API（old.reddit.com 及 www.reddit.com）获取公开帖子数据。用户可通过命令行参数指定目标 subreddit、搜索关键词、排序方式（hot/new/top/rising 等）及时间范围，快速获取帖子标题、作者、点赞数、评论数、链接等结构化信息。支持纯文本和 JSON 两种输出格式，便于直接阅读或后续数据处理。

显著优点

• 零配置接入：无需 Reddit API 密钥或 OAuth 授权，开箱即用，降低了使用门槛
• 功能聚焦单一：仅实现读取和搜索，不涉及发帖、评论、投票等操作，攻击面极小
• 输出结构化：JSON 格式包含完整的帖子元数据（upvote_ratio、created_utc 等），便于自动化分析
• 隐私友好：不收集用户敏感信息，不访问环境变量，符合 GDPR 数据最小化原则
• 依赖精简：仅使用 Python 标准库和 requests，供应链攻击风险低

潜在缺点与局限性

• T3 来源可信度：由社区开发者维护（javicasper），非知名组织或顶级开源基金会背书，长期维护存在不确定性
• 功能受限：纯只读模式，无法获取需要登录的私有内容或受限社区；无法获取评论详情（仅帖子）
• API 稳定性风险：Reddit 官方未承诺公共 JSON API 的长期稳定性，可能随时变更或限流
• 缺少许可证声明：当前未明确开源许可证，存在使用权限模糊的问题
• 文档路径硬编码：示例中使用绝对路径 /root/clawd/skills/reddit/...，对用户环境不具普适性

适合人群

• 研究人员与分析师：需要批量获取 Reddit 公开数据进行舆情监测或趋势分析
• 开发者：希望快速集成 Reddit 数据源到自动化工作流，无需处理复杂的 OAuth 流程
• 内容创作者：追踪特定社区（如 LocalLLaMA、ClaudeAI）的技术讨论热点

常规风险

• 速率限制：Reddit 可能对高频请求进行 IP 级别的限流或临时封禁
• 内容合规：Reddit 用户生成内容（UGC）可能包含不当信息，下游使用需自行过滤
• API 变更：Reddit 近年频繁调整 API 政策，公共 JSON 接口未来可能受限或收费
• 网络依赖：完全依赖 Reddit 官方服务可用性，无本地缓存或离线能力

核心用法

Reddit Skill 是一款基于 Python 的 Reddit 内容读取工具，通过调用 Reddit 公开 JSON API（无需 API 密钥）实现对指定 subreddit 的帖子浏览与关键词搜索。用户可通过命令行参数灵活配置：指定社区（-s/--subreddit）、搜索关键词（-q/--search）、排序方式（hot/new/top/rising 等）、时间范围（-t/--time）及返回数量（-n/--limit，上限 100 条）。输出支持友好的文本预览或原始 JSON 格式，便于后续数据处理。

典型场景：

• 监控技术社区（如 r/LocalLLaMA、r/ClaudeAI）的最新动态
• 追踪特定话题（如 "machine learning"、"docker self-hosted"）的讨论热度
• 采集公开数据用于舆情分析或趋势研究

---

显著优点

| 维度 | 优势 |

|------|------|

| **零配置接入** | 无需 Reddit 账号或 API Key，开箱即用 |

| **轻量纯净** | 仅依赖 Python 标准库 + requests，无臃肿依赖 |

| **隐私合规** | 只读公开数据，不采集用户信息，符合 GDPR/CCPA 数据最小化原则 |

| **输出结构化** | JSON 输出包含标题、作者、投票数、评论数、时间戳等完整字段 |

| **安全可控** | 无危险函数（eval/exec/system），无文件写入，无进程创建 |

---

潜在缺点与局限性

功能层面

• 只读限制：无法发帖、评论、投票或访问需登录的私密社区
• 内容边界：部分 subreddit 可能因 NSFW 标记或地域限制而不可见

稳定性风险

• API 限流：未认证请求约 60 次/分钟，高频调用易触发 429 错误
• 服务依赖：完全依赖 Reddit 公开 API，若接口变更或服务中断，Skill 将失效
• User-Agent 识别：固定声明为 'Clawdbot/1.0'，可能被 Reddit 针对性限流

维护层面

• T3 级来源：个人开发者维护，长期更新与安全响应无法保证

---

适合人群

• AI/开发者社区运营者：监控 r/LocalLLaMA、r/machinelearning 等前沿技术讨论
• 舆情分析人员：低成本采集公开社交数据，辅助趋势判断
• 自动化工作流搭建者：结合 --json 输出对接后续数据处理管道
• 隐私敏感用户：无需账号即可获取信息，降低数据泄露风险

---

常规风险

| 风险类型 | 等级 | 说明 |

|---------|------|------|

| 外部 API 可用性 | 🟡 中 | Reddit 服务中断或接口变更将导致功能失效 |

| 速率限制 | 🟡 中 | 高频请求触发限流，建议添加延迟与重试机制 |

| 来源可信度 | 🔵 低 | T3 级维护者，需关注上游更新动态 |

| 代码执行 |  极低 | 无动态代码执行，无文件系统写入 |

| 隐私泄露 | 🟢 极低 | 不采集敏感信息，HTTPS 加密传输 |

使用建议：生产环境部署时建议添加指数退避重试、请求频率控制（time.sleep），并定期复查代码更新。