{"id":25452812,"url":"https://github.com/yllvar/raidtweet","last_synced_at":"2025-05-16T13:10:34.328Z","repository":{"id":265455385,"uuid":"896032980","full_name":"yllvar/RaidTweet","owner":"yllvar","description":"Increase the visibility of your token or project by engaging with influencers or popular crypto figures.","archived":false,"fork":false,"pushed_at":"2024-11-29T12:49:52.000Z","size":15,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-17T23:42:00.929Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","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/yllvar.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":"2024-11-29T12:10:16.000Z","updated_at":"2024-11-30T10:23:11.000Z","dependencies_parsed_at":"2024-11-29T13:33:15.391Z","dependency_job_id":null,"html_url":"https://github.com/yllvar/RaidTweet","commit_stats":null,"previous_names":["yllvar/raidtweet"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yllvar%2FRaidTweet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yllvar%2FRaidTweet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yllvar%2FRaidTweet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yllvar%2FRaidTweet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yllvar","download_url":"https://codeload.github.com/yllvar/RaidTweet/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254535822,"owners_count":22087399,"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":[],"created_at":"2025-02-17T23:41:42.299Z","updated_at":"2025-05-16T13:10:34.301Z","avatar_url":"https://github.com/yllvar.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"```markdown\n# RaidTweet 🚀\n\nWelcome to **RaidTweet**, your friendly tool for boosting engagement on X (formerly Twitter) for your crypto meme tokens! This bot is designed to help you give a shoutout to your favorite influencers or crypto personalities by replying to their latest tweets. Here's what you can do with it:\n\n- **Fetch Tweets**: Grab the latest tweet from specified X users. 🔍\n- **Engage**: Automatically reply with a fun message to show some love. 💬\n\n## 🎉 Why Use RaidTweet?\n\n- **Visibility**: Increase the visibility of your token or project by engaging with influencers or popular crypto figures.\n- **Community Building**: Encourage community interaction by having real members participate in these engagements.\n- **Fun \u0026 Engagement**: Add that spark to your marketing strategy with witty and engaging replies.\n\n## 🛠️ Installation Guide\n\nBefore we dive into the fun part, here's how you can set up RaidTweet:\n\n### Prerequisites\n\n- **Python 3.10 or higher** 🐍\n- **X API Access** (You need to get your own API keys and tokens from X Developer Portal)\n\n### Steps to Install\n\n1. **Clone the Repo**\n   ```bash\n   git clone https://github.com/your-github-username/RaidTweet.git\n   cd RaidTweet\n   ```\n\n2. **Set Up Virtual Environment**\n   ```bash\n   python -m venv venv\n   source venv/bin/activate  # On Windows use `venv\\Scripts\\activate`\n   ```\n\n3. **Install Dependencies**\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n4. **Configure Your Environment**\n   - Create a `.env` file in the root directory with your X API credentials:\n     ```\n     X_API_KEY=your_api_key\n     X_API_KEY_SECRET=your_api_secret\n     X_BEARER_TOKEN=your_bearer_token\n     X_ACCESS_TOKEN=your_access_token\n     X_ACCESS_TOKEN_SECRET=your_access_token_secret\n     ```\n   - Replace `your_api_key`, `your_api_secret`, etc., with your actual credentials. 🔑\n\n## 🚀 Running the Bot\n\nHere's how you can get RaidTweet to start engaging:\n\n1. **Navigate to the Project Folder**\n   ```bash\n   cd app\n   ```\n\n2. **Run the Script**\n   ```bash\n   python -m main\n   ```\n\n   This will initiate the bot to:\n   - Fetch the latest tweet from each user in `users_to_raid` list in `main.py`.\n   - Reply to these tweets with the predefined message.\n\n## ⚙️ Customization\n\n- **Users to Raid**: Edit the `users_to_raid` list in `main.py` to include the usernames you want your bot to interact with.\n- **Reply Message**: Change the `reply_text` in `twitter.py` if you want to customize the reply message.\n\n## 🚨 Important Notes\n\n- **Respect the Rates**: Keep an eye on X's API rate limits to avoid hitting the cap.\n- **Ethical Use**: Use this bot responsibly. Engagement should add value, not just noise. \n- **Privacy \u0026 Security**: Never share or commit your API keys to version control.\n\n## 🤔 Troubleshooting\n\nIf you encounter issues, check:\n\n- Your `.env` file for correct credentials.\n- The `requirements.txt` for up-to-date package versions.\n- Ensure you've activated your virtual environment before running.\n\n## 📝 Contributing\n\nGot ideas to make RaidTweet even cooler? Feel free to fork the repo and submit a pull request. Let's make crypto marketing fun together!\n\n## 📜 License\n\nThis project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details.\n\n---\n\nJoin the meme token revolution with RaidTweet! Remember, while this bot can help increase visibility, the real magic happens when the community truly believes in your project. Keep it real, keep it fun, and let's make some noise in the crypto space! 🎉\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyllvar%2Fraidtweet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyllvar%2Fraidtweet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyllvar%2Fraidtweet/lists"}