kral (pronounced: "crawl") is a python library intended to be a flexible solution for retreiving live streaming data from a variety of social network apis on given keyword(s), and yeilding the retreived data in a unified format.
- Ability to harvest user information, and posts from Twitter, Facebook, Buzz, Identica, Youtube, Flickr, Wordpress
- Ability to expand all short-urls into full real URLs.
- Ability to track number of mentions of a given URL across multiple networks.
- Modular design. Easily add or disable plugins for different social networks.
- Python 2.6 - 2.7
Usage / Installation
pip install -e git+https://github.com/Tawlk/kral/#egg=kral
Edit ~/kral/config.ini file with your credentials.
From here you can start using the kral.stream() generator to collect data within your appliction.
Example that outputs the latest social data on "android" and "bitcoin" across all available networks.
import kral for item in kral.stream(['android','bitcoin']): print "%s | %s" % (item.service,item.text)
Example that outputs the latest social data on "obama" using only twitter.
import kral for item in kral.stream('obama','twitter'): print "%s | %s" % (item.service,item.text)
You can also collect data via the CLI interface.
kral stream --services="twitter,facebook" --queries="android"
For more information on the CLI interface run:
Many more features coming soon as this project is under active development.
This is by no means production-ready code. Do not actually use it in production unless you wish to be eaten by a grue.
Questions/Comments? Please check us out on IRC via irc://udderweb.com/#uw