Kral

About

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.

Current Features

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.

Requirements

Python 2.6 - 2.7
pip

Usage / Installation

Install kral

pip install -e git+https://github.com/Tawlk/kral/#egg=kral

Configure

Edit ~/kral/config.ini file as follows:

[ DEFAULT ]
TWITTER_USER = your_user
TWITTER_PASS = your_pass
BUZZ_API_KEY = your_key
FACEBOOK_API_KEY = your_key
FLICKR_API_KEY = your_key

Collect data

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:
```
kral --help
```

Notes

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