shunkakinoki / heuristicalert

Instant access to twitter mentions relevant to your interest/business

Heuristicalert

Instant access to twitter mentions relevant to your interest/business.

It crawls Twitter every one hour and notify to Slack.

Installation

npm -g install heuristicalert

Run

env TWITTER_CONSUMER_KEY=xxx \
    TWITTER_CONSUMER_SECRET=xxx \
    TWITTER_ACCESS_TOKEN_KEY=xxx \
    TWITTER_ACCESS_TOKEN_SECRET=xxx \
    SLACK_WEBHOOK_URL=https://hooks.slack.com/services/xxx \
    heuristicalert heuristicalert.yml

heuristicalert.yml looks like this:

# Tweet including "Hello" and author's followers > 1000, favorite > 10, retweet > 10
- query: Hello
  lang: en
  followers_count: 1000
  favorite_count: 10
  retweet_count: 10

# Every tweet including "Remotehour"
- query: Remotehour
  lang: en
  followers_count: 0
  favorite_count: 0
  retweet_count: 0

TODO

• Add "oneshot" run to work with other scheduling service
• Usable in Module (to support AWS lambda environment)
• Customize cron scheduling
• Provide official docker image
• Write tests for easier maintainability