npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

markov-twitter-bot

v1.3.12

Published

A shell for creating a twitter bot that generates tweets using markov chains

Downloads

25

Readme

markov-twitter-bot

Standard - JavaScript Style Guide

Everything you need to create a twitter bot that generates tweets using a Markov Chain, the method used by most '_ebooks' accounts. All you need to do is supply a twitter handle (without the @), and an object containing your bot account's API keys.

Requirements

You will need an active Twitter account for your bot, and you will also need to create a Twitter application. If you are unsure of how to do that, follow steps 1 - 3 on this page.

Usage

const TwitterBot = require('markov-twitter-bot')

const options = {
  account: 'SomeTwitterHandle',
  twitter: {
    consumer_key: 'CONSUMERKEYFROMTWITTER',
    consumer_secret: 'CONSUMERSECRETFROMTWITTER',
    access_token_key: 'ACCESSKEYFROMTWITTER',
    access_token_secret: 'ACCESSSECRETFROMTWITTER'
  },
  replyTo: 'MyBotAccountName'
}
// You can leave the twitter object out if you have environment variables set. (see below)

const bot = new TwitterBot( options )

That's all you need to have a bot generate tweets from SomeTwitterHandle every 4 hours, while updating the available tweets every hour at 55 minutes past the hour.

Options

A full options object with it's defaults is as follows:

{
  hour: 4,
  minute: 0,
  account: '',
  twitter: {
    consumer_key: process.env.TWITTER_CONSUMER_KEY,
    consumer_secret: process.env.TWITTER_CONSUMER_SECRET,
    access_token_key: process.env.TWITTER_ACCESS_TOKEN_KEY,
    access_token_secret: process.env.TWITTER_ACCESS_TOKEN_SECRET
  },
  bannedWords: [],
  includeAts: true,
  includeHashtags: true,
  replyTo: ''
}

options.hour

Number -- optional

This is the interval of hours that a new tweet will be generated and posted. Keep in mind that this will start at midnight local time. The example above will post a tweet every 4 hours, starting at midnight (continuing at 4AM, 8AM, 12PM...)

options.minute

Number -- optional

This is the interval of minutes to post a new tweet. Use this if you want to stagger the hourly posting of tweets so that it doesn't occur exactly on the hour. In the example above, this is set to 0, so a tweet is posted exactly every four hours. If this were set to 15, it would be posted every 4 hours on the fifteenth minute of the hour.

options.account

String -- required

This is the account to pull tweets from. Make sure to not include the @ in the string.

options.twitter

Object -- required

This is an object that contains four properties: consumer_key, consumer_secret, access_token_key, and access_token_secret. These properties default to environment variables, so you can have them automatically set that way, or you can explicitly pass them as strings. Here is the default object, so you can see the environment variable names:

{
  consumer_key: process.env.TWITTER_CONSUMER_KEY,
  consumer_secret: process.env.TWITTER_CONSUMER_SECRET,
  access_token_key: process.env.TWITTER_ACCESS_TOKEN_KEY,
  access_token_secret: process.env.TWITTER_ACCESS_TOKEN_SECRET
}

options.bannedWords

Array -- optional

An array of strings that you do not want to allow in the generated tweets. This package already uses this-is-probably-ok-to-say, but you can choose to filter out certain other words as well (i.e. a bot I created for a friend generated tweets containing the @ handle of their ex). Entered words will be case-insensitive, so 'TEST' will match 'test', etc.

options.includeAts

Boolean -- optional

Set this to false to exclude any tweets containing @usernames. Defaults to true.

options.includeHashtags

Boolean -- optional

Set this to false to exclude any tweets containing hashtags. Defaults to true.

options.replyTo

String -- optional

If you supply an account name to this value, the bot will reply to any tweets sent to that account. Enter your bot account's handle (without the @) to have it reply when it is mentioned. Defaults to '', disabling this functionality.