atestu / tweelead

Generate actionable leads from Twitter

Tweelead

Generate actionable leads from Twitter in real-time.

Intro

There are many people out there literally asking you to introduce your product to them so they can become your customers, but the problem is that it's very difficult to find them!

Tweelead will help you find those people easily - It gets the Tweets matching the keywords that are important to you from the Twitter Stream API, sends them to AYLIEN (free account required) for sentiment analysis, and depending on your preference, puts the positive (or negative) tweets in a spreadsheet on your Google Drive.

You can read more about Tweelead here: http://blog.taskulu.com/post/how-get-actionable-leads-twitter-real-time

How to set it up

Setting Tweelead up is very easy and can be done in a few minutes:

1) Download the code from Github:

wget https://github.com/Taskulu/tweelead/archive/master.zip -O tweelead-master.zip
unzip tweelead-master.zip

or

git clone https://github.com/Taskulu/tweelead.git

2) Create a Twitter Application. Go to the “Keys and Access Tokens” tab, and generate a new access token (there will be a button towards the bottom).

3) Register an account with AYLIEN and generate the free application ID and Key.

4) If you're using 2 Factor Authentication with your Google account, create an app specific password for Tweelead here.

5) Copy this spreadsheet to your Google Drive. We'll need the spreadsheet key from the URL later.

URL format: https://docs.google.com/spreadsheets/d/{SPREADSHEET-KEY}/edit

6) Update the constants in index.js from code you downloaded in step 1:

const GOOGLE_EMAIL        = '[e-mail]';
// If  you use Google 2 Factor Authentication this will be the app key you generated in step 4
const GOOGLE_PASSWORD     = 'YOUR-PASSWORD123!#';
const AYLIEN_APP_ID       = 'YOUR-AYLIEN-APPLICATION-ID';
const AYLIEN_APP_KEY      = 'YOUR-AYLIEN-APPLICATION-KEY';
const TW_CONSUMER_KEY     = 'TWITTER-CONSUMER-KEY';
const TW_CONSUMER_SEC     = 'TWITTER-CONSUMER-SECRET';
const TW_ACCESS_TOKEN_KEY = 'TWITTER-ACCESS-TOKEN-KEY';
const TW_ACCESS_TOKEN_SEC = 'TWITTER-ACCESS-TOKEN-SECRET';

7) Add the keywords you want to track on twitter in index.js, AYLIEN offers 1000 free API calls per day, so don't add too many keywords so you don't go over the API limit.

client.stream('statuses/filter', {track: 'comma,separated,list,of,keywords,you,want,to,monitor'}, function(stream) {

8) Open up your terminal and start finding Tweeleads!

cd /path/to/tweelead
npm install
node index

Acceptance conditions

I've configured the code to accept any negetavie tweet and neutral tweets with less than 65% confidence level and send those tweets to the Google Spreadsheet. This needs to be changed/tuned for your use case. To change it open index.js and find and edit this part:

if (error === null && (response.polarity == 'negative' || (response.polarity == 'neutral' && response.polarity_confidence <= 0.65))) {