{"id":15714848,"url":"https://github.com/iranianpep/retweeter","last_synced_at":"2026-04-06T07:02:10.577Z","repository":{"id":40750356,"uuid":"321806345","full_name":"iranianpep/retweeter","owner":"iranianpep","description":"Simple bot that retweets and likes recent tweets for a topic if they meet some criteria","archived":false,"fork":false,"pushed_at":"2023-01-06T17:20:30.000Z","size":584,"stargazers_count":3,"open_issues_count":9,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-27T10:11:39.737Z","etag":null,"topics":["bot","retweeter","twitter"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/iranianpep.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-12-15T22:39:23.000Z","updated_at":"2022-08-07T19:33:22.000Z","dependencies_parsed_at":"2023-02-06T07:00:18.711Z","dependency_job_id":null,"html_url":"https://github.com/iranianpep/retweeter","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/iranianpep/retweeter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iranianpep%2Fretweeter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iranianpep%2Fretweeter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iranianpep%2Fretweeter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iranianpep%2Fretweeter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iranianpep","download_url":"https://codeload.github.com/iranianpep/retweeter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iranianpep%2Fretweeter/sbom","scorecard":{"id":494186,"data":{"date":"2025-08-11","repo":{"name":"github.com/iranianpep/retweeter","commit":"dea99f220726ac315312d4054bf3cecce2ee8c94"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":2.2,"checks":[{"name":"Code-Review","score":0,"reason":"Found 0/22 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/npm-publish.yml:1","Warn: no topLevel permission defined: .github/workflows/test-on-push.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/npm-publish.yml:14: update your workflow using https://app.stepsecurity.io/secureworkflow/iranianpep/retweeter/npm-publish.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/npm-publish.yml:15: update your workflow using https://app.stepsecurity.io/secureworkflow/iranianpep/retweeter/npm-publish.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/npm-publish.yml:24: update your workflow using https://app.stepsecurity.io/secureworkflow/iranianpep/retweeter/npm-publish.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/npm-publish.yml:25: update your workflow using https://app.stepsecurity.io/secureworkflow/iranianpep/retweeter/npm-publish.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test-on-push.yml:15: update your workflow using https://app.stepsecurity.io/secureworkflow/iranianpep/retweeter/test-on-push.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test-on-push.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/iranianpep/retweeter/test-on-push.yml/main?enable=pin","Info:   0 out of   6 GitHub-owned GitHubAction dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":0,"reason":"license file not detected","details":["Warn: project does not have a license file"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 8 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":0,"reason":"23 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-968p-4wvh-cqc8","Warn: Project is vulnerable to: GHSA-67hx-6x53-jw92","Warn: Project is vulnerable to: GHSA-93q8-gq69-wqmw","Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw","Warn: Project is vulnerable to: GHSA-grv7-fg5c-xmjg","Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275","Warn: Project is vulnerable to: GHSA-w573-4hg7-7wgq","Warn: Project is vulnerable to: GHSA-fjxv-7rqg-78g4","Warn: Project is vulnerable to: GHSA-896r-f27r-55mw","Warn: Project is vulnerable to: GHSA-9c47-m6qq-7p4h","Warn: Project is vulnerable to: GHSA-952p-6rrq-rcjv","Warn: Project is vulnerable to: GHSA-f8q6-p94x-37v3","Warn: Project is vulnerable to: GHSA-xvch-5gv4-984h","Warn: Project is vulnerable to: GHSA-8hfj-j24r-96c4","Warn: Project is vulnerable to: GHSA-wc69-rhjr-hc9g","Warn: Project is vulnerable to: GHSA-hj48-42vr-x3v9","Warn: Project is vulnerable to: GHSA-hrpp-h998-j3pp","Warn: Project is vulnerable to: GHSA-p8p7-x288-28g6","Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw","Warn: Project is vulnerable to: GHSA-jgrx-mgxx-jf9v","Warn: Project is vulnerable to: GHSA-72xf-g2v4-qvf3","Warn: Project is vulnerable to: GHSA-j8xg-fqg3-53r7","Warn: Project is vulnerable to: GHSA-3h5v-q93c-6h6q"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-19T20:01:12.238Z","repository_id":40750356,"created_at":"2025-08-19T20:01:12.238Z","updated_at":"2025-08-19T20:01:12.238Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31463015,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-05T21:22:52.476Z","status":"online","status_checked_at":"2026-04-06T02:00:07.287Z","response_time":112,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["bot","retweeter","twitter"],"created_at":"2024-10-03T21:39:48.727Z","updated_at":"2026-04-06T07:02:10.560Z","avatar_url":"https://github.com/iranianpep.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Retweeter\nSimple bot that retweets and likes recent tweets for a topic if they meet some criteria\n\n![Node.js CI](https://github.com/iranianpep/retweeter/workflows/Node.js%20CI/badge.svg)\n[![Build Status](https://scrutinizer-ci.com/g/iranianpep/retweeter/badges/build.png?b=main)](https://scrutinizer-ci.com/g/iranianpep/retweeter/build-status/main)\n[![Maintainability](https://api.codeclimate.com/v1/badges/009464f86e33fae8df85/maintainability)](https://codeclimate.com/github/iranianpep/retweeter/maintainability)\n[![Code Coverage](https://scrutinizer-ci.com/g/iranianpep/retweeter/badges/coverage.png?b=main)](https://scrutinizer-ci.com/g/iranianpep/retweeter/?branch=main)\n[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/iranianpep/retweeter/badges/quality-score.png?b=main)](https://scrutinizer-ci.com/g/iranianpep/retweeter/?branch=main)\n[![Codacy Badge](https://app.codacy.com/project/badge/Grade/1d42b9f44b3b4dbdb73571cbee26a6d8)](https://www.codacy.com/gh/iranianpep/retweeter/dashboard?utm_source=github.com\u0026amp;utm_medium=referral\u0026amp;utm_content=iranianpep/retweeter\u0026amp;utm_campaign=Badge_Grade)\n[![StyleCI](https://styleci.io/repos/321806345/shield?branch=main)](https://styleci.io/repos/321806345)\n\n## How to use\n- Apply for a Twitter Developer Account to access Twitter APIs\n   - Once approved, you will have `API_KEY`, `API_KEY_SECRET`, `ACCESS_TOKEN`, `ACCESS_TOKEN_SECRET`\n\n- Choose the `#interesting_topic_to_retweet` you want to search the recent tweets for\n- Choose based on what criteria you would like the retweeter to retweet and like (explained the condig in more details later)\n- Instantiate a `Bot` object and call `retweet` function as follow:\n\n```\ntry {\n    console.log('Starting ...');\n    const bot = new Bot({\n      screenName: 'REPLACE_YOUR_ACCOUNT_SCREEN_NAME',\n      apiConfig: {\n        consumer_key: YOUR_API_KEY,\n        consumer_secret: YOUR_API_KEY_SECRET,\n        access_token: YOUR_ACCESS_TOKEN,\n        access_token_secret: YOUR_ACCESS_TOKEN_SECRET,\n        timeout_ms: 60 * 1000,\n        strictSSL: true,\n      },\n      tweetConfig: {\n        minFavs: YOUR_TWEET_MIN_FAVS,\n        minFavsToFollowers: YOUR_TWEET_MIN_FAVS_TO_FOLLOWERS_RATIO,\n        hashtagsLimit: YOUR_TWEET_MIN_ALLOWED_HASHTAGS,\n        wordBlocklist: YOUR_WORD_BLOCKLIST,\n        userConfig: {\n          minCreationDiff: YOUR_TWEET_USER_MIN_CREATION_DIFF,\n          minFollowers: YOUR_TWEET_USER_MIN_FOLLOWERS,\n          minTweets: YOUR_TWEET_USER_MIN_TWEETS,\n          userBlocklist: YOUR_USER_BLOCKLIST_IDS\n        }\n      }\n    });\n\n    await bot.retweet({\n      q: '#interesting_topic_to_retweet',\n      count: YOUR_SEARCH_PARAM_COUNT,\n      result_type: YOUR_SEARCH_PARAM_RESULT_TYPE,\n      lang: 'en',\n      // make sure hashtags are included\n      include_entities: true\n    });\n  } catch (error) {\n    console.log(error);\n  }\n```\n\n## Configs\n| Name | Description | Required | Type |\n| ------------- | ------------- | ------------- | ------------- |\n| consumer_key  | Twitter API key | Yes | string\n| cconsumer_secret | Twitter API key secret | Yes | string\n| access_token | Twitter API access token | Yes | string\n| access_token_secret | Twitter API access token secret | Yes | string\n| minFavs | Tweet minimum number of favorites for retweeting \u0026 liking | Yes | number\n| minFavsToFollowers | Ratio of tweet favorites to the user followers for retweeting \u0026 liking | Yes | number\n| hashtagsLimit | Maximum number of hashtag that can be in a tweet for retweeting \u0026 liking | Yes | number\n| wordBlocklist | Tweet is ignored if it has any of the blocklisted word | No | string[]\n| minCreationDiff | Only consider those users who joined tweeter X days ago | Yes | number\n| minFollowers | Tweet user minimum number of total followers for retweeting \u0026 liking | Yes | number\n| minTweets | Tweet user minimum number of total tweets for retweeting \u0026 liking | Yes | number\n| userBlocklist | Block listed user IDs | No | string[]\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Firanianpep%2Fretweeter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Firanianpep%2Fretweeter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Firanianpep%2Fretweeter/lists"}