Reddit Post Finder Agent Skill
Scrape and search Reddit posts using Apify. Use when you need to find Reddit discussions, track competitor mentions, monitor product feedback, discover pain points, or analyze subreddit content. Supports keyword filtering, time-based searches, and subreddit-specific queries.
Install
one command, takes just this skill from the repositorynpx skills add https://github.com/gooseworks-ai/goose-skills --skill reddit-post-finderWhat comes with it
12 874 bytes besides the instructionThe instruction itself
13 sections, as written by the authorReddit Post Finder
Scrape Reddit posts and comments using the Apify trudax/reddit-scraper-lite actor.
Quick Start
Requires APIFY_API_TOKEN env var (or --token flag).
# 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
How the Script Works
- Builds full Reddit URLs for each subreddit (e.g.
https://www.reddit.com/r/growthhacking/top/?t=week) - Calls the Apify
trudax/reddit-scraper-liteactor via REST API - Polls until the run completes, then fetches the dataset
- Applies client-side keyword and date filtering
- Sorts by upvotes (descending) and outputs JSON or summary
CLI Reference
| Flag | Default | Description |
|------|---------|-------------|
| --subreddit | *required* | Subreddit name(s), comma-separated |
| --keywords | none | Keywords to filter (comma-separated, OR logic) |
| --days | 30 | Only include posts from the last N days |
| --max-posts | 50 | Max posts to scrape per subreddit |
| --sort | top | Sort: hot, top, new, rising |
| --time | week | Time window for top sort: hour, day, week, month, year, all |
| --output | json | Output format: json or summary |
| --token | env var | Apify token (prefer APIFY_API_TOKEN env var) |
| --timeout | 300 | Max seconds to wait for the Apify run |
Tips for Small Subreddits
Small or low-traffic subreddits (e.g. r/gtmengineering) may return zero posts with --sort hot because the hot feed is nearly empty. Use --sort top --time week (or month) instead — this scrapes the top-ranked posts over the time window and reliably returns results.
Direct API Usage
If calling the Apify API directly (e.g. via curl), note these required fields:
{
"startUrls": [{"url": "https://www.reddit.com/r/growthhacking/top/?t=week"}],
"maxItems": 50
}
Key notes for trudax/reddit-scraper-lite:
- Uses
startUrlswith full Reddit URLs (not asearchesarray for subreddit browsing) - Sort/time are controlled via the URL path (e.g.
/top/?t=week), not separate input fields - Only
startUrlsandmaxItemsare confirmed working input fields - Does not support
proxyConfiguration,scrollTimeout, orsearchType
Output fields:
dataType—"post"or"comment"title— Post titlebody— Post body textcommunityName— Subreddit name (withoutr/prefix)upVotes— Number of upvotesnumberOfComments— Comment counturl— Full URL to the postcreatedAt— ISO timestamp of when the post was created
Common Workflows
1. Competitor Tracking
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. Pain Point Discovery
python3 skills/reddit-post-finder/scripts/search_reddit.py \
--subreddit LLMDevs \
--keywords "frustrating,difficult,hard to,wish there was,better way" \
--days 30
3. Brand Monitoring
python3 skills/reddit-post-finder/scripts/search_reddit.py \
--subreddit "LLMDevs,MachineLearning" \
--keywords "YourProductName" \
--days 7 --sort new
Important: Always Include Post URLs
When presenting Reddit results to the user, always include the original post URL for every post. This is critical for allowing users to read the full discussion, comments, and context. Never return a summary table without links.
Output Format
Posts are returned as JSON array sorted by upvotes. Each post has:
{
"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/..."
}
Configuration
See references/apify-config.md for detailed API configuration, token setup, and rate limits.
Other skills for the same job
different authors, same section of the catalogue
Universal AI-powered web scraper for any platform. Scrape data from Instagram, Facebook, TikTok, YouTube, LinkedIn, X/Twitter, Google Maps, Google Search, Google Trends, Reddit, Airbnb, Yelp, and 15+ more platforms. Use for lead generation, brand monitoring, competitor analysis, influencer discovery, trend research, content analytics, audience analysis, review analysis, SEO intelligence, recruitment, or any data extraction task.
eBay sold-listings scraper across 8 marketplaces (ebay.com/.co.uk/.de/.fr/.it/.es/.ca/.com.au). Takes keyword plus filters (category, price range, item condition, item location, sort order, completed toggle) and returns paginated real-sale records with itemId, url, title, condition, conditionId, endedAt, soldPrice, soldCurrency, listingType (best_offer_accepted / buy_it_now / auction), isBestOfferAccepted, buyingFormat, bidCount, shipping, totalPrice, thumbnails, seller info, sellerType. Use when user mentions ebay sold, ebay sold listings, ebay sold prices, ebay completed listings, ebay comps, ebay resale prices, ebay auction sold results, ebay best offer accepted, scrape ebay sold, ebay market research, ebay pricing intelligence, ebay flipping research, real sold prices ebay, get sold prices from ebay. Also applies to price benchmarking, sold-price analytics, resale valuation, cross-marketplace price arbitrage, appraisal for collectibles, brand demand tracking on ebay.
Etsy keyword search scraper: given a search keyword and optional page number, returns paginated product listings with listingId, shopId, title, url, image, salePrice, originalPrice, currency, rating, reviewCount, shopName, isAd, freeShipping, badge from etsy.com search results. Use when user mentions Etsy, etsy.com, Etsy search, search Etsy by keyword, scrape Etsy listings, extract Etsy products, Etsy product search, Etsy marketplace search, find products on Etsy, Etsy handmade search, Etsy vintage search, Etsy craft search, bulk Etsy product export, Etsy price monitoring, Etsy competitor research, Etsy top listings, Etsy bestseller extraction, Etsy sales data, Etsy shop discovery via keyword. Also applies to trend research on handmade or craft niches, competitor keyword ranking on Etsy, sourcing Etsy suppliers by product type, and any paginated bulk product collection driven by a search keyword.
Etsy product detail scraper: given an Etsy listing URL, returns full product detail including listingId, title, priceCurrent, priceOriginal, currency, images (all), description, shopName, shopUrl, rating, reviewCount, favorites, inCartCount, variations (with per-option price ranges), highlights, listedDate, relatedTags. Use when user mentions Etsy product, Etsy listing detail, Etsy item info, Etsy product page, scrape Etsy listing, extract Etsy product data, Etsy price and variations, Etsy product images, Etsy product description, Etsy shop from listing, Etsy favorites count, Etsy sale count, Etsy variations extraction, Etsy listing metadata, single Etsy product scrape, bulk enrich Etsy listing URLs, Etsy product details export. Also applies to competitor product monitoring, price and variation tracking on a specific listing, favorites/wishlist popularity tracking, description mining for SEO analysis, and any per-listing enrichment task.
Scrapes second-hand item search results from Goofish (闲鱼/xianyu, goofish.com) — China's largest second-hand marketplace. Input: keyword, optional sort/filter params. Output: list of items with id, title, price, image, location, want-count per page (30 items/page). Use when user mentions goofish, 闲鱼, xianyu, 二手交易, second-hand marketplace China, 二手商品搜索, search used goods, scrape goofish listings, xianyu search results, collect second-hand prices, monitor used item prices, 闲鱼关键词搜索, 闲鱼数据采集, 批量抓取闲鱼, goofish scraper, goofish data, xianyu data extraction, 二手商品价格监控, used iPhone prices, 二手手机价格. Also applies to: price research on Chinese second-hand market, competitor product monitoring via used goods listings, inventory analysis.
This skill helps users automatically scrape business data from Google Maps using the BrowserAct Google Maps API. Agent should proactively trigger this skill for needs like finding restaurants in a specific city, extracting contact info of dental clinics, researching local competitors, collecting addresses of coffee shops, generating lead lists for specific industries, monitoring business ratings and reviews, getting opening hours of local services, finding specialized stores (e.g., Turkish-style restaurants), analyzing business categories in a region, extracting website links from local businesses, gathering phone numbers for sales outreach, mapping out service providers in a specific country.
Extracts Google Search results page (SERP) data including organic results, paid ads, related searches, People Also Ask questions, AI Overview text, and total result count from google.com. Use when user mentions Google search results, SERP scraping, google search data, search engine results page, organic rankings, keyword SERP, Google SERP extraction, scrape Google search, Google search API alternative, SEO ranking data, paid search ads, PPC ads on Google, Google search monitoring, keyword research, search results export, check Google rankings, what shows up on Google, search engine scraper, google results checker.
Scrape job listings from Indeed.com by keyword, location, and country. Returns job title, company, salary, rating, description, benefits, and apply links. Use when user mentions Indeed, Indeed scraper, Indeed jobs, scrape Indeed, job search Indeed, Indeed job listings, extract Indeed data, Indeed job data, get jobs from Indeed, Indeed employment data, job market research Indeed, Indeed salary data, bulk job extraction Indeed, Indeed job scraper, monitor Indeed listings, Indeed hiring data, job postings Indeed, Indeed career search. Also applies to: job market analysis, salary benchmarking from Indeed, competitor hiring monitoring, recruitment data collection, building job databases from Indeed search results.
How to use it
Take gooseworks-ai/reddit-post-finder from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.