reddit-post-finder

Reddit 帖子查找器

使用 Apify trudax/reddit-scraper-lite actor 抓取 Reddit 帖子和评论。

快速开始

需要 APIFY_API_TOKEN 环境变量（或使用 --token 标志）。

# Top posts from r/growthhacking in last week
python3 skills/reddit-post-finder/scripts/search_reddit.py \
  --subreddit growthhacking --days 7 --sort top --time week

# Hot posts from multiple subreddits
python3 skills/reddit-post-finder/scripts/search_reddit.py \
  --subreddit "growthhacking,gtmengineering" --days 7 --sort hot

# Keyword-filtered competitor tracking
python3 skills/reddit-post-finder/scripts/search_reddit.py \
  --subreddit LLMDevs \
  --keywords "Langfuse,Arize,Langsmith" \
  --days 30

# Human-readable summary table
python3 skills/reddit-post-finder/scripts/search_reddit.py \
  --subreddit growthhacking --days 7 --output summary

脚本工作原理

1. 为每个 subreddit 构建完整的 Reddit URL（例如 https://www.reddit.com/r/growthhacking/top/?t=week）
2. 通过 REST API 调用 Apify trudax/reddit-scraper-lite actor
3. 轮询直至运行完成，然后获取数据集
4. 应用客户端关键词和日期筛选
5. 按赞数降序排序，并输出 JSON 或摘要

CLI 参考

标志	默认值	描述
--subreddit	必填	Subreddit 名称，可用逗号分隔多个名称
--keywords	无	用于筛选的关键词（逗号分隔，采用 OR 逻辑）
--days	30	仅包含最近 N 天内的帖子
--max-posts	50	每个 subreddit 抓取的帖子数上限
--sort	top	排序方式：hot、top、new、rising
--time	week	top 排序的时间范围：hour、day、week、month、year、all
--output	json	输出格式：json 或 summary
--token	环境变量	Apify token（建议使用 APIFY_API_TOKEN 环境变量）
--timeout	300	等待 Apify 运行的最长秒数

小型 Subreddit 的使用技巧

小型或流量较低的 subreddit（例如 r/gtmengineering）使用 --sort hot 时可能返回零条帖子，因为热门动态几乎没有内容。请改用 --sort top --time week（或 month）——这会抓取指定时间范围内排名靠前的帖子，并能稳定返回结果。

直接使用 API

如果直接调用 Apify API（例如通过 curl），请注意以下必填字段：

{
  "startUrls": [{"url": "https://www.reddit.com/r/growthhacking/top/?t=week"}],
  "maxItems": 50
}

trudax/reddit-scraper-lite 的重要说明：

• 使用 startUrls 和完整 Reddit URL（浏览 subreddit 时不使用 searches 数组）
• 排序方式和时间范围通过URL 路径控制（例如 /top/?t=week），而非单独的输入字段
• 只有 startUrls 和 maxItems 是已确认可用的输入字段
• 不支持 proxyConfiguration、scrollTimeout 或 searchType

输出字段：

• dataType — "post" 或 "comment"
• title — 帖子标题
• body — 帖子正文
• communityName — Subreddit 名称（不含 r/ 前缀）
• upVotes — 赞数
• numberOfComments — 评论数
• url — 帖子的完整 URL
• createdAt — 帖子创建时间的 ISO 时间戳

常见工作流

1. 竞品追踪

python3 skills/reddit-post-finder/scripts/search_reddit.py \
  --subreddit "LLMDevs,MachineLearning,LocalLLaMA" \
  --keywords "Langfuse,Arize,Weights & Biases,Langsmith,Braintrust" \
  --days 30 --sort top --time month

2. 痛点发现

python3 skills/reddit-post-finder/scripts/search_reddit.py \
  --subreddit LLMDevs \
  --keywords "frustrating,difficult,hard to,wish there was,better way" \
  --days 30

3. 品牌监测

python3 skills/reddit-post-finder/scripts/search_reddit.py \
  --subreddit "LLMDevs,MachineLearning" \
  --keywords "YourProductName" \
  --days 7 --sort new

重要：始终包含帖子 URL

向用户展示 Reddit 结果时，务必包含每条帖子的原始帖子 URL。这对于让用户阅读完整讨论、评论和上下文至关重要。切勿返回不带链接的摘要表格。

输出格式

帖子以按赞数排序的 JSON 数组形式返回。每条帖子包含：

{
  "dataType": "post",
  "title": "Post title",
  "body": "Post body...",
  "communityName": "growthhacking",
  "upVotes": 42,
  "numberOfComments": 15,
  "createdAt": "2026-02-18T12:00:00.000Z",
  "url": "https://reddit.com/r/..."
}

配置

详细的 API 配置、token 设置和速率限制请参阅 references/apify-config.md。