{"id":13406393,"url":"https://github.com/Anish-Agnihotri/tweetdrop","last_synced_at":"2025-03-14T10:33:10.557Z","repository":{"id":40613180,"uuid":"398037255","full_name":"Anish-Agnihotri/tweetdrop","owner":"Anish-Agnihotri","description":"Generate dispersable airdrops from Twitter threads.","archived":false,"fork":false,"pushed_at":"2022-01-03T18:02:34.000Z","size":128,"stargazers_count":153,"open_issues_count":2,"forks_count":24,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-10-16T05:26:18.521Z","etag":null,"topics":["airdrop","crypto","ethereum","scraping","tweet","twitter","twitter-api"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Anish-Agnihotri.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}},"created_at":"2021-08-19T18:21:45.000Z","updated_at":"2024-09-27T20:44:07.000Z","dependencies_parsed_at":"2022-08-09T23:50:39.312Z","dependency_job_id":null,"html_url":"https://github.com/Anish-Agnihotri/tweetdrop","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Anish-Agnihotri%2Ftweetdrop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Anish-Agnihotri%2Ftweetdrop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Anish-Agnihotri%2Ftweetdrop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Anish-Agnihotri%2Ftweetdrop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Anish-Agnihotri","download_url":"https://codeload.github.com/Anish-Agnihotri/tweetdrop/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243562284,"owners_count":20311253,"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":["airdrop","crypto","ethereum","scraping","tweet","twitter","twitter-api"],"created_at":"2024-07-30T19:02:29.058Z","updated_at":"2025-03-14T10:33:10.526Z","avatar_url":"https://github.com/Anish-Agnihotri.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"# tweetdrop\n\nSimple script to collect and clean Ethereum addresses and ENS names from replies to a Tweet. Inspired by [punk4156 needing to airdrop thousands of addresses](https://twitter.com/punk4156/status/1428089265641201665?s=20).\n\nProduces batches of text files containing 100 addresses (one-per-line) per-file in the format `address, tokenAmount`, in `/output`, to use with [Disperse](https://disperse.app/) or [Multisender](https://multisender.app/).\n\n## Requirements\n\n1. Twitter API V2 access (easy to apply for at [developer.twitter.com](https://developer.twitter.com)). You will need a V2 API Bearer Token.\n2. Conversation ID for thread you'd like to scrape. This is the number after `/status/` in a tweets direct URL. For example, `1428089265641201665` for punk4156s tweet (`https://twitter.com/punk4156/status/1428089265641201665`). Because of Twitter API limitations, the thread must be less than 7 days old.\n3. Optional: If you'd like to resolve ENS names to addresses (necessary for Disperse), an Ethereum RPC url.\n\n## Steps\n\n```bash\n# 1. Copy .env.sample to .env and fill out environment variables\n# NUM_TOKENS should be how many tokens you'd like to airdrop per address\ncp .env.sample .env\n\n# 2. Install dependencies\nnpm install\n\n# 3. Run script\nnpm run start\n```\n\n## Credits\n\n- [@iainnash](https://github.com/iainnash) for [address parsing fixes](https://github.com/Anish-Agnihotri/tweetdrop/issues/1)\n\n# Extras\n\n## Most recent followers\n\nInspired by [Cole's](https://twitter.com/ColeThereum/status/1468221153344954369?s=20) tweet, Tweetdrop supports scraping your latest `X` followers.\n\n**Limitations:**\n\n- Really, none, beyond Twitter imposed timeouts (max: 30,000 followers / 15 minutes). By default, script pulls 15,000 newest followers at once.\n\n**Steps:**\n\n```bash\n# 1. Update only TWITTER_BEARER and TWITTER_USER (handle)\ncp .env.sample .env\n\n# 2. Install dependencies\nnpm install\n\n# 3. Run followers script\nnpm run followers\n```\n\n**Outputs:**\n\n- `follower-ids.json`: List of all follower ids\n- `follower-details.json`: List of follower details (beyond just id: `name`, `handle`, `description`, `followers_count`, `following_count`, `verified`, `created_at`)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAnish-Agnihotri%2Ftweetdrop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAnish-Agnihotri%2Ftweetdrop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAnish-Agnihotri%2Ftweetdrop/lists"}