Boring Description: A CLI tool for Reddit
Fun Description: Ever wanted to search reddit without being sucked into the hivemind? Well here is your solution!
This simple, easy to use Command Line tool allows you to cut out the BS, and find exactly what you are searchng for on the worlds most toxic
website! (besides twitter) Better yet, if you are a security professional, or a simple script kiddie, you now have access to an OSINT tool that will
help you get the info you need, and fast!
SETUP:
You will need a reddit secret token, client ID and reddit login to use this tool (enter this info into 'config/credentials.json')
Follow this guide here
SYNTAX:
-h: Help
-s: Search (use "*" for wildcard/all, and "" for mutli word searches: "RTX 3090 release date"
NOTE: Reddit will search for the exact string first (ex "RTX 3090 release date") and then search based on each word if there are no matches/it runs out of matches to display (ex results containing: RTX, OR 3090, OR release, OR date)
-sbr: Subreddit to search
-vd: Download videos attached to posts if available (auto sorted by subreddit)
FILTERS:
--sort: sort by top, hot, new, controversial, comments <-(most comments)
--time: Time to filter by: all, year, month, day, hour !! needs -sort flag to work !!
--limit: How many posts to display on screen, max is 100 (NOTE: The higher the limit, the longer the search takes)
Alternative Searches:
-u: Search for a user
-c: Search for a comment (BETA - limited to top level comments only)
EXAMPLES:
General Usage:
python3 reddit_osint.py -s "*" --limit 5 -vd
Advanced Usage:
python3 reddit_osint.py -s ferrari --sort hot -sbr idiotsincars --limit 30 --time all -vd
Email Hunting:
python3 reddit_osint.py -s "*@gmail.com" -c
User Searching:
python3 reddit_osint.py -s "ryanq47" -u
General Flow Diagram of how it works:
NOTE: There may be an error with Pandas, Pandas 1.4.3 is the version you need incase you run into any trouble