TL;DR: AmputatorBot is a Reddit bot that replies to comments and submissions containing AMP URLs with the canonical URL.
Features include:
- Automatically create required log and datafiles
- Scan for comments, submissions and mentions
- Check each item against specified criteria
- Strip URLs of markdown
- Check URLs for AMP links
- Find canonicals using 9 different methods
- Calculate which canonical is 'best'
- Return 2 canonicals if the canonicals have more than 1 domain
- Return an AMP-canonical if the real canonical can't be found
- Generate and send automatic replies to AMP items with the canonical(s) and some info
- Automatically keep track of bans
- Keep track of items interacted with
- Let users opt-out and opt-back-in
- Send DMs when summoned by users
- Experimental: Guess-and-check method with article-comparison
- Local- and SQL-database-logging
Please note:
- AmputatorBot works automatically in a select number of subreddits
- AmputatorBot won't work in subreddits where it is banned or forbidden
- The online version of AmputatorBot can be found at AmputatorBot.com
- You can find the changelog here!
- Clone the repository
- Fill in and change the required values in static.txt (see /static)
- Change the filename of static.txt to .py
- Choose which script(s) you want to run (check_comments.py, check_inbox.py or check_submissions.py)
- Set the 'settings' in the run_bot function of the script. I recommended to set everything (guess_and_check, reply_to_post, write_to_database) to False when you are starting out.
- Run the script - All logs and required datafiles will be automatically and dynamically created. In /data: allowed_subreddits.txt, comments_failed.txt, comments_success.txt, disallowed_mods.txt, disallowed_subreddits.txt, disallowed_users.txt, mentions_failed.txt, mentions.success.txt, np_subreddits.txt, problematic_domains.txt, submissions_failed.txt, submissions_success.txt and in /logs: check_comments_X.X.log, check_inbox_X.X.log and check_submissions_X.X.log.
- Stop the script to see and edit the newly generated files. Odds are you want to add subreddits to allowed_subreddits.txt (for example: ,subreddit1,subreddit2)
- Re-run the script
.. By summoning the bot: If you've spotted an AMP URL on Reddit and u/AmputatorBot seems absent, you can summon the bot by mentioning u/AmputatorBot in a reply to the comment or submission containing the AMP URL. You'll receive a confirmation through PM. For more details, check out this post!
.. By giving feedback: Most of the new features were made after suggestions from you guys, so hit me up if you have any feedback! You can contact me on Reddit, fill an issue or make a pull request.
.. By sponsoring: The bot and website cost approximately €8.26 a month to host and while that might not seem like much, it adds up. All donations will be used ONLY to pay for hosting. You can specify any amount you want, but please keep in mind that I only want to try to cover some of the costs. Thank you so much! - https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=EU6ZFKTVT9VH2
.. By spreading the word: In the end, the only goal of AmputatorBot is to allow people to have an informed choice. You can help by spreading the word in whatever way you deem the most appropriate.
From the bottom of my heart, thank you so much for the tremendous support you've given me and AmputatorBot <3