{"id":21696736,"url":"https://github.com/kokushin/node-twatch","last_synced_at":"2025-04-12T12:11:54.361Z","repository":{"id":82362443,"uuid":"101709113","full_name":"kokushin/node-twatch","owner":"kokushin","description":"Monitor specific tweets and post to Slack.","archived":false,"fork":false,"pushed_at":"2017-09-03T05:29:11.000Z","size":547,"stargazers_count":3,"open_issues_count":0,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-09T18:01:29.164Z","etag":null,"topics":["nodejs","slack","slack-api","slack-bot","twitter","twitter-api","twitter-bot"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/node-twatch","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kokushin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-08-29T02:22:08.000Z","updated_at":"2019-05-09T09:35:17.000Z","dependencies_parsed_at":null,"dependency_job_id":"39a41bbb-ba54-4d18-9f25-a17a61d63510","html_url":"https://github.com/kokushin/node-twatch","commit_stats":{"total_commits":33,"total_committers":2,"mean_commits":16.5,"dds":"0.12121212121212122","last_synced_commit":"6fd991a6329e339b4ee5045800711619d0101051"},"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kokushin%2Fnode-twatch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kokushin%2Fnode-twatch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kokushin%2Fnode-twatch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kokushin%2Fnode-twatch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kokushin","download_url":"https://codeload.github.com/kokushin/node-twatch/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248565074,"owners_count":21125417,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["nodejs","slack","slack-api","slack-bot","twitter","twitter-api","twitter-bot"],"created_at":"2024-11-25T19:21:39.374Z","updated_at":"2025-04-12T12:11:54.342Z","avatar_url":"https://github.com/kokushin.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# node-twatch\n\n\u003e Monitor specific tweets and post to Slack.\n\n![node-twatch](https://github.com/kokushin/node-twatch/blob/material/demo.gif?raw=true)\n\n## Install\n\n\u003e npm (global)\n\n```shell\n$ npm install node-twatch -g\n```\n\n\u003e clone\n\n```shell\n$ git clone git@github.com:kokushin/node-twatch.git\n$ cd node-twatch\n$ npm install\n```\n\n\u003e download [here](https://github.com/kokushin/node-twatch/archive/master.zip)\n\n```shell\n$ unzip node-twatch-master.zip\n$ cd node-twatch-master\n$ npm install\n```\n\n## Usage\n\nOpen `config.json` in a text editor and enter the Twitter API key and Slack's API key.\n\n\u003e 💡 When `npm install node-twatch -g` is executed, config.json exists in `/usr/local/lib/node_modules/node-twatch`.\n\n- How to get Twitter API key [here](https://apps.twitter.com/)\n- How to get Slack API key [here](https://api.slack.com/apps?new_app=1)\n\n```json\n{\n  \"twitter\": {\n    \"consumer_key\": \"YOUR_CONSUMER_KEY\",\n    \"consumer_secret\": \"YOUR_CONSUMER_SECRET\",\n    \"access_token_key\": \"YOUR_ACCESS_TOKEN_KEY\",\n    \"access_token_secret\": \"YOUR_ACCESS_TOKEN_SECRET\"\n  },\n  \"slack\": {\n    \"token\": \"YOUR_ACCESS_TOKEN_KEY\",\n    \"channel\": \"YOUR_CHANNEL_NAME\"\n  }\n}\n```\n\nWhen you enter the following command, Twatch starts monitoring.\n\n\u003e 💡 Twitter users to monitor must \"follow\".\n\n\u003e npm (global)\n\n```shell\n$ twatch\n```\n\n\u003e clone \u0026 download\n\n```shell\n$ npm run twatch\n```\n\nPress Ctrl + C to stop monitoring.\n\n## Options\n\nThere is an option to specify the Twitter ID to be monitored and the keyword contained within tweet respectively.\n\n### -u, -user\n\nYou can specify the ID of the Twitter user to monitor. It is possible to specify more than one with \",\".\n\n\u003e npm (global)\n\n```shell\n$ twatch -u user_id1,user_id2\n```\n\n\u003e clone \u0026 download\n\n```shell\n$ npm run twatch -- --u user_id1,user_id2\n```\n\n### -k, -keyword\n\nYou can specify keywords to be included in the tweets to be monitored. Uppercase and lowercase letters are not distinguished. It is possible to specify more than one with \",\".\n\n\u003e npm (global)\n\n```shell\n$ twatch -k keyword1,keyword2\n```\n\n\u003e clone \u0026 download\n\n```shell\n$ npm run twatch -- --k keyword1,keyword2\n```\n\n### -l, -link\n\nAvailable from `v1.1.0`\n\nWhen this option is specified, only tweets containing links are monitored.\n\n\u003e npm (global)\n\n```shell\n$ twatch -l\n```\n\n\u003e clone \u0026 download\n\n```shell\n$ npm run twatch -- --l\n```\n\n### combine\n\nThese options can be used in combination.\n\n\u003e npm (global)\n\n```shell\n$ twatch -u user_id1,user_id2 -k keyword1,keyword2 -l\n```\n\n\u003e clone \u0026 download\n\n```shell\n$ npm run twatch -- --u user_id1,user_id2 --k keyword1,keyword2 --l\n```\n\n\u003e 💡 If you do not specify an option, we will monitor all followers and tweets.\n\n## Trouble shooting\n\n\u003e Error: Status Code: 401\n\nThe API key is not set correctly. You need to check and edit `config.json`.\n\n\u003e Error: Status Code: 420\n\nSince the requests are concentrated, please wait for a while before running.\n\n## Contributor\n[@kokushin](https://github.com/kokushin)\n\n## License\nCode and documentation copyright 2017 by kokushin. Code released under the [MIT License](https://github.com/kokushin/node-twatch/blob/master/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkokushin%2Fnode-twatch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkokushin%2Fnode-twatch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkokushin%2Fnode-twatch/lists"}