Skip to content

A bot that tweets random items from the Digital Public Library of America

License

Notifications You must be signed in to change notification settings

samplereality/DPLAbot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 

Repository files navigation

DPLAbot

@DPLAbot is a Twitter bot that tweets links to random items located in the vast collections of the Digital Public Library of America.

Rationale

The Digital Public Library of America (DPLA) provides a powerful API, which gives developers a number of ways to query and access the 2.5 million items in the DPLA collections. However, the API has no means of calling up totally random items. This bot is an attempt to infuse what we all love about libraries--serendipitous discovery--into the DPLA, by retrieving random items at regular intervals.

###Method DPLAbot works by first coming up with a random noun and next searching the DPLA using that noun as a keyword. The result is a kind of "Surprise Me!" search function for the DPLA.

The avatar for DPLAbot comes from an early test of the bot, in which the DPLA item "Cat and kitten" was the random result.

DPLAbot relies on two APIs to work:

  1. Obviously, the DPLA API, which is free and open;
  2. And the Wordnik API, which provides the "secret sauce"--the randomness--that powers DPLAbot.

To run or modify your own version of DPLAbot, you'll need keys to these two APIs. Insert them in the code in the appropriate places.

###Installation

DPLAbot runs on node.js, a server-side Javascript engine. In addition to node, the bot requires NPM and several dependencies, which you can install this way (on the command line):

npm install restler
npm install twit
npm install inflection

Execute the bot with:

node dplabot_beta.js

About

A bot that tweets random items from the Digital Public Library of America

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published