This toolset helps manage X (formerly Twitter) sweepstakes by collecting user interactions and selecting winners.
-
Interaction Collector (
interaction_collector.js
)- Collects usernames from X interaction pages (likes, retweets, comments)
- Tracks if users follow the account
- Exports data to CSV
-
Weighted Randomizer (
randomizer.html
)- Web-based tool for selecting winners from collected data
- Allows weighting based on follow status
- Provides a user-friendly interface for running the sweepstakes
- Open X in your browser
- Navigate to the interaction page (likes, retweets, or comments)
- Open the browser console and paste the
interaction_collector.js
code - Run
startCollecting()
to begin - Scroll through interactions to collect data
- Run
stopCollecting()
when finished - Use
exportToCSV()
to download the data
- Open
randomizer.html
in a web browser - Upload the CSV file exported from the Interaction Collector
- Set the number of winners and follow weight
- Click "Select Winners" to choose and display results
- Ensure you comply with X's terms of service and relevant sweepstakes regulations
- The toolset should be used responsibly