Blog - BS Data, hackery, stories

Twitter monitoring tools on Github


There are many reasons why one might want to monitor what's happening on social media. And there are also many cases where there's a real public interest in monitoring particular activities. Despite having been shut down by Twitter recently, Sun Foundation's Politwoops was doing the conversation a service by keeping a record of US Congressmen's tweets - asking them why they deleted some of them.

Disclaimer: keeping tweets that were deleted is against Twitter's policy (you know, this document you signed without reading it when you signed up). You're supposed to honour this rule: if it's not on Twitter (because it has been deleted or because the user is private or has been suspended), you must delete the content.

However, there's a case for not honouring this policy. And here are some tools to do so - use them at your own risks.

You will find in this Github repository a collection of Python scripts to monitor deleted tweets, automate screenshoting, and archiving.

  • and work together to grab a real-time streamed timeline from Twitter and save all the results in a database.
  • All the tweets in the database are then screenshot by
  • Finally, the worker crawls through the database and checks if the tweets have been deleted.
  • I included, as the Twitter API often requires the ID, and not the screen name (eg not "@basilesimon").

Dependencies and install

  • git clone this repo
  • pip install tweepy
  • pip install MySQL-python (but you might need to apt-get install build-essential python-dev libmysqlclient-dev. I read it's easy to install on Max OS, with Homebrew)
  • pip install needle
  • You will need a comma-separated list of user IDs (see below), or a list of keywords you want to track. See all the other options in the Docs.
  • Obviously, you will also need your developer access keys and things. Paste them in the placeholders accordingly in each file.

Comma-separated list of user IDs

I use the wonderful t from sferik, a command line tool for twitter shenanigans. Usually, I have an account following all the people I want to track - but it also works with lists.

  • $ t followings [account] > list.csv
  • python > ids.csv

Run the program

Then to run it:

  • Run Constantly. If it doesn't run, you're not saving the tweets.
  • Run nosetests --with-save-baseline --nocapture periodically to grab the screenshots.
  • Run periodically to check for deleted tweets.

You might want to consider running all these with cron on a server. Just saying.


PDD/ Unlicense