In an effort to make curating categories of work easier, sometimes it's good to be able to watch the blockchain for stories with certain keywords in them.
This is the source code for the steem-seeress bot that runs on Discord. You don't need to do anything with this code to use the bot, please see the article detailing how to use the seeress at:
https://steemit.com/tools/@triddin/introducing-steem-seeress-bot-for-discord
The Seeress will look at the channel topic of any channel of the server she is on. If she sees a topic that contains the following:
ABNF specification.
topic-list = "steem-seeress=" match-set *1TERM
match_set = match *( ":" match )
match = key-field *( "," key-field )
key-field = *WSP key-word *WSP
key-word = key-type key-text
key-type = *1NEG *1TYP / VOTE
key-text = 1*<any UTF8 except SEP>
COLON = ":"
SEMICOLON = ";"
SPACE = " "
TAB = %x09
NEWLINE = %x0a
TERM `= SEMICOLON / NEWLINE ; topic list terminator
SEP = TERM / COLON ; item separator
WSP = SPACE / TAB ; whitespace
NEG = "!" / "-" ; negating operator
TYP = "@" / "#" ; type operator
VOTE = "$" ; vote operator
UTF8 = UTF8-1 / UTF8-2 / UTF8-3 / UTF8-4
UTF8-1 = %x00-7F
UTF8-2 = %xC2-DF UTF8-tail
UTF8-3 = %xE0 %xA0-BF UTF8-tail / %xE1-EC 2( UTF8-tail ) /
%xED %x80-9F UTF8-tail / %xEE-EF 2( UTF8-tail )
UTF8-4 = %xF0 %x90-BF 2( UTF8-tail ) / %xF1-F3 3( UTF8-tail ) /
%xF4 %x80-8F 2( UTF8-tail )
UTF8-tail = %x80-BF
Some examples:
steem-seeress=bicycle, wheel, axle, @bikerboy, !@wheelsmadman : train, carriage, !steam train, #locomotives, @choochoo, $trainguy ;
This example expands out to:
- Find stories that:
- HAVE the words "bicycle", "wheel" or "axle" in them anywhere
- OR are by or reference the author bikerboy
- BUT are not by or refernce the author wheelsmadman
- As well as stories that:
- HAVE the words "train" or "carriage" in them anywhere
- OR have or reference the locomotives tag
- OR are by or reference the author choochoo
- BUT DO NOT HAVE the phrase "steam train" in theme anywhere
- AND list any votes by the voter trainguy on stories we have matched using these criteria
You cah write these rules many different ways, each of which are equivalent:
steem-seeress=bicycle,wheel,axle,@bikerboy,!@wheelsmadman:train,carriage,!steam train,#locomotives,@choochoo,$trainguy
steem-seeress=bicycle,wheel,axle,@bikerboy,!@wheelsmadman:train,carriage,!steam train,#locomotives,@choochoo,$trainguy;
steem-seeress=@bikerboy,!@wheelsmadman,wheel,axle,bicycle:!steam train,#locomotives,@choochoo,$trainguy,carriage,train;
steem-seeress=bicycle, wheel, axle, @bikerboy, !@wheelsmadman: train, carriage, !steam train, #locomotives, @choochoo, $trainguy
steem-seeress=bicycle, wheel, axle, @bikerboy, !@wheelsmadman: train, carriage, !steam train, #locomotives, @choochoo, $trainguy;
steem-seeress=train, carriage, !steam train, #locomotives, @choochoo, $trainguy : bicycle, wheel, axle, @bikerboy, !@wheelsmadman;
To start up this bot, you will need to:
npm i
npm run bot
The first time around, it will generate a config.json file and tell you to edit it's options. Do so, then run it again.