tw2csv

1.0.3 • Public • Published

tw2csv

Useful CLI tool for collecting tweets.

If you haven't set up Node.js environment, you should install it.

v0.x -> v1

There are destructive changes from v0.x to v1.x. Please re-setup the app configuration file.

Install

npm install -g tw2csv

How to use

At first, get your application's keys from developer.twitter.com and setup command.

# directory name "tweets" is just an example
$ mkdir ~/tweets
$ cd ~/tweets
$ tw2csv

If there isn't tw2csv.config.json, tw2csv will generate it automatically. You have to set Twitter app's keys to tw2csv.config.json like below.

{
    "appKey": "***************************",,
    "appSecret": "***************************",,
    "accessToken": "***************************",
    "accessSecret": "***************************"
}

Then you can run tw2csv!

$ tw2csv search "Node.js" results.csv

Commands

Search Tweets

$ tw2csv search "KEYWORDS FOR SEARCH" OUTPUT_FILENAME.csv

Options

  • --bot (-b) : Ignore tweets from possible bots. tw2csv detect bots based on the source is on its allow list. So if you need to be careful at the misdetection, I recommend not to turn on.
  • --rt (-r) : Ignore retweets.
  • --quote (-q) : Ignore quote tweets.
  • --mention (-m) : Ignore replies (mentions).
  • --linebreak (-l) : Remove line breaks in tweets and user's bio. Please turn it on if your tool or script have a trouble with multi-lined CSV file.
  • --verbose (-v) : verbose mode. Show all logs on console.

Check API Access Limits

$ tw2csv limit

This will show the API Limit and its reset time like below.

[Info] API Limit ( 74 / 75 ), Reset: 5/31/2022, 10:34:03 PM

Readme

Keywords

Package Sidebar

Install

npm i tw2csv

Weekly Downloads

2

Version

1.0.3

License

MIT

Unpacked Size

15.7 kB

Total Files

9

Last publish

Collaborators

  • ryo-a