{"id":48394050,"url":"https://github.com/osscameroon/caparledev-bot","last_synced_at":"2026-04-06T01:16:03.762Z","repository":{"id":43902946,"uuid":"339506620","full_name":"osscameroon/caparledev-bot","owner":"osscameroon","description":"Twitter bot for the hashtag #caparledev","archived":false,"fork":false,"pushed_at":"2022-02-13T21:18:36.000Z","size":907,"stargazers_count":12,"open_issues_count":1,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-10-27T00:31:45.731Z","etag":null,"topics":["hashtag","twitter-api","twitter-bot","twitter-streaming-api"],"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/osscameroon.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":"2021-02-16T19:25:00.000Z","updated_at":"2023-03-21T22:22:52.000Z","dependencies_parsed_at":"2022-09-11T14:40:32.756Z","dependency_job_id":null,"html_url":"https://github.com/osscameroon/caparledev-bot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/osscameroon/caparledev-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osscameroon%2Fcaparledev-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osscameroon%2Fcaparledev-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osscameroon%2Fcaparledev-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osscameroon%2Fcaparledev-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/osscameroon","download_url":"https://codeload.github.com/osscameroon/caparledev-bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osscameroon%2Fcaparledev-bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31455616,"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":"ssl_error","status_checked_at":"2026-04-05T21:22:51.943Z","response_time":75,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["hashtag","twitter-api","twitter-bot","twitter-streaming-api"],"created_at":"2026-04-06T01:16:03.695Z","updated_at":"2026-04-06T01:16:03.753Z","avatar_url":"https://github.com/osscameroon.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CaParleDev Bot\n\n#### Twitter bot used to retweet all tweets having the hashtag `#caparledev`\n\n## Prerequisites\n- Node.js\n- MongoDB\n- Typescript\n\n## Installation\n- Clone the repository\n```shell\ngit clone https://github.com/osscameroon/caparledev-bot.git [project_name]\n\ncd [project_name]\n```\n\n- **Create configuration file and edit with your own value**\n```shell\ncp .env.example .env\nnano .env\n```\n\n- **Create a Twitter application**\n1. Login to your Twitter account on [developer.twitter.com](developer.twitter.com).\n2. Navigate to the [Twitter App dashboard](https://developer.twitter.com/en/portal/projects-and-apps)\n3. If you have an existing app, go to the next step. If not, to create an app, you will be first asked to create a\n   project. You can give the app the name you want. When asked the access level required for your app, select Read Only,\n   it will be enough for the script to work.\n4. Open the app and navigate to the \"keys and tokens\" page.\n5. Copy the Consumer Key and Secret, Access Token and Secret\n\n- **Set credentials in .env**\n```dotenv\nTWITTER_APP_CONSUMER_KEY=consumer_key\nTWITTER_APP_CONSUMER_SECRET=consumer_secret\nTWITTER_APP_ACCESS_TOKEN_KEY=access_token_key\nTWITTER_APP_ACCESS_TOKEN_SECRET=access_token_secret\n```\n- **Start application**\n```shell\nyarn watch # On Terminal 1\nyarn start # On Terminal 2\n```\n\n- **Launch ngrok tunnels to the app**\n```shell\nyarn ngrok\n```\n\n- **Register the auth callback in twitter application**\n  \n   Copy the url generated by Ngrok, go to to your Twitter app in developer portal, \n  locate the section the section \"CALLBACK URLS\", paste the url and save the changes.\n\n\n- **Call the endpoint to set generate auth URL**\n```shell\n# The call\ncurl http://localhost:7432/auth/url\n\n# The response\n{\"url\":\"https://api.twitter.com/oauth/authenticate?force_login=true\u0026oauth_token=Qj8UOwBBAAABTOKhAAABdCZxfsI\"}\n```\n\n- **Authenticate with the bot account**\n\nNavigate to the URL in the browser and login with the bot account.\nAfter successful login, you will receive a JSON reponse with OAuth access token key and OAuth access token secret\n```json\n{\n  \"oauthToken\": \"OAuth access token key\",\n  \"oauthTokenSecret\": \"OAuth access token secret\"\n}\n```\n\n- **Set in config file the OAuth token key and secret generated**\n```dotenv\nTWITTER_BOT_ACCESS_TOKEN_KEY=oauth_access_token_key\nTWITTER_BOT_ACCESS_TOKEN_SECRET=oauth_access_token_secret\n```\n\n- **Generate Bearer token**\n```bash\nyarn bearer:token\n```\nOpen the .env file and set the generated bearer token\n```dotenv\nTWITTER_BEARER_TOKEN=bearer_token\n```\n\n- **Enable Twitter stream and set the hashtag(s) you want to stream.**\n  \nSeparate hashtag with a comma if you have many. You can set up to 5000\n```dotenv\nENABLE_STREAM=true\nHASHTAG_TO_TRACK=#hastag1,#hastag2,#hastag3,....,#hastagn\n```\n\n- **Restart the app**\n```shell\nyarn start\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fosscameroon%2Fcaparledev-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fosscameroon%2Fcaparledev-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fosscameroon%2Fcaparledev-bot/lists"}