A bot that tweets random items from the Digital Public Library of America
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
dplabot_beta.js
license.txt
package.json
readme.md

readme.md

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