{"id":25463252,"url":"https://github.com/starton-io/twitter-airdrop-bot","last_synced_at":"2026-01-27T13:34:13.783Z","repository":{"id":135990584,"uuid":"431563475","full_name":"starton-io/twitter-airdrop-bot","owner":"starton-io","description":"This bot allow you to airdrop Token (ERC20) or NFT (ERC721 / ERC1155) to your community directly from twitter","archived":false,"fork":false,"pushed_at":"2023-01-20T09:05:07.000Z","size":14,"stargazers_count":19,"open_issues_count":1,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-09T06:51:14.540Z","etag":null,"topics":["bot","cryptocurrency","erc1155","erc20","erc721","nft","smart-contracts","twitter"],"latest_commit_sha":null,"homepage":"https://starton.io","language":"JavaScript","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/starton-io.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-11-24T16:55:47.000Z","updated_at":"2024-10-19T18:15:43.000Z","dependencies_parsed_at":null,"dependency_job_id":"c63424c2-6c6a-4a49-9c49-16ff6ea3651e","html_url":"https://github.com/starton-io/twitter-airdrop-bot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/starton-io/twitter-airdrop-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/starton-io%2Ftwitter-airdrop-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/starton-io%2Ftwitter-airdrop-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/starton-io%2Ftwitter-airdrop-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/starton-io%2Ftwitter-airdrop-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/starton-io","download_url":"https://codeload.github.com/starton-io/twitter-airdrop-bot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/starton-io%2Ftwitter-airdrop-bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28813539,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-27T12:25:15.069Z","status":"ssl_error","status_checked_at":"2026-01-27T12:25:05.297Z","response_time":168,"last_error":"SSL_read: 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":["bot","cryptocurrency","erc1155","erc20","erc721","nft","smart-contracts","twitter"],"created_at":"2025-02-18T06:29:29.425Z","updated_at":"2026-01-27T13:34:13.778Z","avatar_url":"https://github.com/starton-io.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# Starton Twitter Quote-Retweet airdrop bot\n\nThis bot allows you to airdrop tokens (ERC20) or NFTs (ERC721 / ERC1155) to your community.\nPeople need to quote-retweet a specific tweet with a specific hashtag to receive the tokens or the NFT.\n\n# Requirements\n## Twitter\nYou need to have a Twitter Developper Account.\nYou can apply here: https://developer.twitter.com/en/apply-for-access\n\nWhen you have your credentials you need to set them in a `.env` file\n\n- `TWITTER_APP_KEY=`\n\n- `TWITTER_APP_SECRET=`\n\n- `TWITTER_ACCESS_TOKEN=`\n\n- `TWITTER_ACCESS_SECRET=`\n\nYou also need to set the **tweet id** and **hashtag** related to your contest.\n\n- `TWITTER_TWEET_ID=` : You can find it in the url of your already published tweet\n\n- `TWITTER_HASHTAG=` : Just the hashtag string without `#`\n\n## Starton Connect\nYou need to have a Starton Connect account.\nYou can create a free account [here](https://connect.starton.io)\n\nYou can create an API key in the `Developer` section.\nYou will need to add it to the `.env` file aswell.\n\n- `STARTON_API_KEY=`\n\n## Deploy or import a smart contract on Starton\n\nYou can now deploy a new contract or import an existing one in Starton's [`Deploy` section](https://connect.starton.io/deploy).\n\nOnce deployed you should add in the `.env` file:\n\n- `STARTON_SMART_CONTRACT_ADDRESS=`\n- `STARTON_SMART_CONTRACT_NETWORK=`\n- `STARTON_SMART_CONTRACT_SIGNER=`\n- `TOKEN_AMOUNT=`\n\n# Start the bot\n## Get the winners\nWhen the contest has ended, you just have to run the following script in order to get the list of all participating addresses.\n\n```bash\ngit clone https://github.com/starton-io/twitter-airdrop-bot\ncd twitter-airdrop-bot\nyarn install (or npm install)\nnode fetchTweet.js\n```\n\nIt will fetch all the tweets with the specific hashtag you defined in the `.env` file and then check if they are quote retweets of our initial tweet.\n\nIf this is the case, it will parse the tweets to find an address and save it in the file `addresses.csv`.\n\n## Send the tokens\nAll the winners should now be saved in the `address.csv` file.\nYou can modify this file in order to whitelist / blacklist certain addresses or filter the addresses based on your custom criterias.\n\nAll the addresses from this file will now receive tokens when running the following command :\n```bash\nnode sendToken.js\n```\n\n## Authors\n\n- [@cervantescedric - CTO @starton.io](https://linkedin.com/in/cedriccervantes/)\n- [@tibo-pendino - Backend Developer @starton.io](https://linkedin.com/in/tibo-pendino/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstarton-io%2Ftwitter-airdrop-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstarton-io%2Ftwitter-airdrop-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstarton-io%2Ftwitter-airdrop-bot/lists"}