reddit-research

Reddit 研究

查询 subreddit 帖子和评论、单个帖子的完整评论串、 关键词搜索结果、公开用户的发帖／评论历史，以及 热门／最新／上升／顶级趋势——所有数据均来自 Crawlora API 的标准化 JSON，无需抓取 Reddit 内容或使用非官方客户端库。

工具范围和数据流

可选的 shell 辅助脚本是此技能要求运行的唯一命令。它只会向文档明确列出且已加入允许列表的 Crawlora 路由发送 GET 请求。调用时，它会读取 CRAWLORA_API_KEY，并通过 HTTPS 将其作为 x-api-key 标头发送至 api.crawlora.net；不会将密钥发送给 Reddit。它会在 TMPDIR 下短暂写入权限为 600 的 curl 配置文件，并在命令退出时将其删除。 它不会检查其他环境变量、枚举文件、安装软件或以提升的权限运行。查询、subreddit／用户标识符和 所请求的帖子目标会发送至 Crawlora API；请避免使用机密或敏感的调查词语。

/reddit/leads 路由是一个独立的、由用户请求的工作流：它按产品／服务购买意向为 公开帖子评分排序。仅在用户要求发现潜在客户时使用，并在输出中说明此帖子级评分；不得推断敏感特征，也不得按高影响决策对个人进行排名。

何时使用此技能

-“ 现在在讨论什么？” -“获取这篇 Reddit 帖子／讨论串的评论。” -“在 Reddit 上搜索有关 <主题／产品／品牌> 的帖子。” -“ 最近发了哪些帖子或评论？” -“今天 Reddit 上有什么热门趋势？”或“r/ 上的情绪倾向如何？”

• 在 Reddit 上监控品牌提及、研究社群或追踪竞争对手情绪倾向。
• 如需研究与匹配市场时段相关的特定股票 Reddit 讨论，请在已安装时使用 reddit-stock-sentiment-research。

设置（仅需一次）

• 在 https://crawlora.net 获取免费的 Crawlora API 密钥（每月 2,000 点数，无需银行卡）。
• 运行辅助脚本前，在环境中设置 CRAWLORA_API_KEY。
• 辅助脚本会从环境中读取 CRAWLORA_API_KEY，并向 https://api.crawlora.net/api/v1 发送请求。密钥缺失／无效时会返回 401。

工作原理

1. 搜索 — 使用 /reddit/search 搜索关键词匹配的帖子，可选 限定在某个 subreddit 中。
2. 单篇帖子及其讨论串 — 使用 /reddit/post/{id} 获取帖子本身， 使用 /reddit/comments/{id} 获取其公开评论（在任一路由上添加 include_metrics=true 可获取净分数／赞成票比例／奖励数据，费用为 3 点而非 1 点）。
3. 浏览 subreddit — 使用 /reddit/subreddit/{subreddit}/posts（热门／最新／ 顶级／上升）、/reddit/subreddit/{subreddit}/comments（最新的平铺 评论动态），以及 /reddit/subreddit/{subreddit}/about 获取元数据和示例帖子。
4. 多个 subreddit 的动态 — 使用 /reddit/subreddits/posts，并传入 以逗号分隔的 subreddits 列表（最多 10 个），获取合并后的热门／最新／顶级动态。
5. 用户历史记录 — 使用 /reddit/user/{username}/posts 和 /reddit/user/{username}/comments 获取公开用户的发帖／评论动态。
6. 域名提及 — 使用 /reddit/domain/{domain}/posts 获取链接到指定主机名的公开帖子。
7. 趋势 — 使用 /reddit/trends 获取广泛的热门／最新／上升／顶级动态；如需查看单个 subreddit 的趋势，请改用 /reddit/subreddit/{subreddit}/posts，并设置 sort=hot|new|rising|top。

完整的端点列表、方法和参数：reference/endpoints.md。

调用 API

# Search + subreddit browse:
scripts/crawlora.sh /reddit/search q="web scraping" | jq '.'
scripts/crawlora.sh /reddit/subreddit/programming/posts sort=top time=week | jq '.'

# Post + comment thread:
scripts/crawlora.sh /reddit/post/1abcxyz include_metrics=true | jq '.'
scripts/crawlora.sh /reddit/comments/1abcxyz sort=top limit=50 | jq '.'

# User history + trends:
scripts/crawlora.sh /reddit/user/spez/posts | jq '.'
scripts/crawlora.sh /reddit/trends sort=rising | jq '.'

# Explicit buying-intent lead discovery from public posts:
scripts/crawlora.sh /reddit/leads q="looking for a project management tool" | jq '.'

所有请求都使用 scripts/crawlora.sh；它不会将 API 密钥暴露在命令行参数中。

端点参考

此技能使用的所有 Reddit 端点，请参见 reference/endpoints.md。

示例

• 社区情绪研究： 对与主题相关的 subreddit，调用 /reddit/subreddit/{subreddit}/posts + /reddit/subreddit/{subreddit}/comments，扫描帖子标题和评论文本，找出反复出现的情绪和痛点。
• 深入分析帖子串： 调用 /reddit/post/{id} 获取原帖，再调用 /reddit/comments/{id}?include_metrics=true 获取包含净得分和获奖次数的完整讨论，以总结热门帖子串。
• 品牌提及全面检索： 使用 /reddit/search q="<brand>" 搜索整个 Reddit，也可通过 subreddit= 限定范围； 使用返回的 after 令牌分页，统计并阅读每一条公开提及。

注意事项与限制

• 额度 / 成功后计费： 仅在返回 2xx 时计费；免费套餐每月提供 2,000 个额度。 请在 https://crawlora.net 获取密钥。
• 仅限公开数据 —— 公开帖子、评论和 subreddit；无需登录，不含私密内容。 请遵守 Reddit 的条款。
• 安全性： 密钥仅存放在 CRAWLORA_API_KEY 中，切勿将其硬编码、放入查询参数或提交到代码库。
• 匿名页面限制： /reddit/subreddit/{subreddit}/about 不会返回订阅者数量、图标和横幅 （这些信息在 Reddit 匿名页面上不可用）；若不设置 include_metrics=true，精确的赞成票/反对票总数、赞成票比例以及分享/转发/ 浏览次数将通过估算得出或无法获取；即便设置了该参数，Reddit 也会模糊投票数据，因此数值仅为近似值。
• 指标费用更高： 在 /reddit/post/{id} 或 /reddit/comments/{id} 上设置 include_metrics=true 后，会切换到匿名 HTML 页面，每次调用费用从 1 个额度增至 3 个； 在此模式下，大型评论串可能只会显示开头的一部分内容。
• 限流： 当 Reddit 暂时限制请求时，大多数列表端点会返回带有 Retry-After 标头的 503 —— 等待相应秒数后重试，不要将其视为永久性故障。
• 列表端点通过 after 游标分页 —— 使用返回的游标继续获取后续页面（默认返回 25 条，最多返回 100 条）。