{"id":15606732,"url":"https://github.com/firmoholanda/ruby-twitter-bot","last_synced_at":"2025-07-23T12:35:09.128Z","repository":{"id":99481010,"uuid":"229094314","full_name":"firmoholanda/ruby-twitter-bot","owner":"firmoholanda","description":"This bot was built in ruby, using twitter's API. It was created to store the location of any given tweet and analyze which countries spoke most about a topic.","archived":false,"fork":false,"pushed_at":"2020-09-11T17:18:10.000Z","size":142,"stargazers_count":11,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"development","last_synced_at":"2025-06-04T18:51:28.001Z","etag":null,"topics":["ruby","twitter-api","twitter-bot"],"latest_commit_sha":null,"homepage":"","language":"Ruby","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/firmoholanda.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":"2019-12-19T16:22:55.000Z","updated_at":"2021-04-11T02:07:21.000Z","dependencies_parsed_at":null,"dependency_job_id":"725e847c-042d-4ffa-91b8-9c96f082cb80","html_url":"https://github.com/firmoholanda/ruby-twitter-bot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/firmoholanda/ruby-twitter-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firmoholanda%2Fruby-twitter-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firmoholanda%2Fruby-twitter-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firmoholanda%2Fruby-twitter-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firmoholanda%2Fruby-twitter-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/firmoholanda","download_url":"https://codeload.github.com/firmoholanda/ruby-twitter-bot/tar.gz/refs/heads/development","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firmoholanda%2Fruby-twitter-bot/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266680332,"owners_count":23967791,"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","status":"online","status_checked_at":"2025-07-23T02:00:09.312Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"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":["ruby","twitter-api","twitter-bot"],"created_at":"2024-10-03T04:41:50.374Z","updated_at":"2025-07-23T12:35:09.105Z","avatar_url":"https://github.com/firmoholanda.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📃 ruby-twitter-bot\n\nThis bot was built in ruby, using twitter's API. It was created to store the location of any given tweet and analyze which countries spoke most about a topic.\n\n\nwith this bot one can: \n- search for topics;\n- display results while searching;\n- auto like found tweets;\n- create new tweet informing the bot found it;\n- save to local storage using yml;\n- retrieve from local storage;\n- display the top 10 locations from found tweets.\n\n\n\n## 📡 technologies used\n\n- ruby\n- twitter api\n- yml\n- github\n\nruby, twitter api, yml and github was used on this project.\n\n\n\n## 🚀 the project\n\nthis project can be found in https://github.com/firmoholanda/ruby-twitter-bot\n\n\n\n## 🔨 instructions\n\nthe instructions are as follows to download and run this bot:\n\ndownload:\n\n1. clone the source repository from Github.\n\n  on the command line, enter:\n  git clone https://github.com/firmoholanda/ruby-twitter-bot.git \n\n  or you can use Github for Windows or Github for Mac instead of the command line. go to: https://github.com/firmoholanda/ruby-twitter-bot, and click on the \"Clone or download\" green button.\n\n2. extract files to the desired location;\n\n3. cd (change directory) to extracted directory;\n\n4. give execute permission to the twitter_bot.rb\n``` \nchmod +x bin/twitter_bot.rb\n```\n\n\ninstallation:\n\n1. create a twitter api account;\n\n  to start using the Twitter api, you need to [register your application with Twitter](https://apps.twitter.com/). registration requires you to answer some questions about your application and agree to the [Twitter api terms of use](https://dev.twitter.com/overview/terms/agreement-and-policy).\n  your new application will be assigned a consumer key/secret pair that identifies your application to Twitter.\n\n2. insert your api keys and secret;\n\nchange lines 23, 24, 25 and 26 on the bin/twitter_bot.rb file, with your information:\n  ```\n  @@api_config = {\n      consumer_key:        \"YOUR_CONSUMER_KEY\",\n      consumer_secret:     \"YOUR_CONSUMER_SECRET\",\n      access_token:        \"YOUR_ACCESS_TOKEN\",\n      access_token_secret: \"YOUR_ACCESS_TOKEN_SECRET\"\n  }\n  ```\n\n3. install dependencies;\n\n```\ngem install twitter\n```\n\n\nusage:\n\n- after that, you can start the bot by running \n\n``` \nruby ./bin/examples.rb\n```\n\nit will initialize the application, look for tweets related to ruby coding, display information on the terminal, like the found tweet and create a new tweet informing what was found. then, it will display the top 10 locations sorted in ascending order and then save that information on a yml file called: stored_tweets.yml\n\nlike_the_tweet, alert_in_new_tweet\n\n```\nmy_bot = TwitterBot.new\nmy_bot.find_tweets([[\"ruby\", \"rayls\", \"coding\"], true, true, true)\nmy_bot.display_top_10_locations\t\nmy_bot.save_stored_tweets\t\n```\n\nyou can also use:\n```\nmy_bot.retrieve_stored_tweets\t\nmy_bot.display_stored_tweets\n```\nto load information from stored_tweets.yml to the class and then display on the terminal.\n\n\n### ✨ [code picture]\n\n\u003cimg alt=\"project image\" src=\"https://github.com/firmoholanda/ruby-twitter-bot/blob/features/img/screen.png\"/\u003e\n\n\n\n## 🤝 contributing\n\ncontributions, issues, and feature requests are welcome!\u003cbr/\u003efeel free to check [issues page](https://github.com/firmoholanda/ruby-enumerable-methods/development/issues).\n\n1. fork it (https://github.com/firmoholanda/ruby-twitter-bot/development/fork)\n2. create your working branch (git checkout -b [choose-a-name])\n3. commit your changes (git commit -am 'what this commit will fix/add/improve')\n4. push to the branch (git push origin [chosen-name])\n5. create a new pull request\n\n\n\n## 🤖 contributor\n\nfirmo holanda - [GitHub](https://github.com/firmoholanda)\n\n\n\n## 🙋‍♂ show your support\n\ngive a ⭐️ if you like this project!\n\n\n\n## 📝 license\n\nthis project is [MIT](https://github.com/firmoholanda/newsweek.com-clone/development/blob/development/license.txt) licensed.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffirmoholanda%2Fruby-twitter-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffirmoholanda%2Fruby-twitter-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffirmoholanda%2Fruby-twitter-bot/lists"}