https://github.com/yllvar/raidtweet
Increase the visibility of your token or project by engaging with influencers or popular crypto figures.
https://github.com/yllvar/raidtweet
Last synced: about 1 year ago
JSON representation
Increase the visibility of your token or project by engaging with influencers or popular crypto figures.
- Host: GitHub
- URL: https://github.com/yllvar/raidtweet
- Owner: yllvar
- Created: 2024-11-29T12:10:16.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-11-29T12:49:52.000Z (over 1 year ago)
- Last Synced: 2025-02-17T23:42:00.929Z (over 1 year ago)
- Language: Python
- Size: 14.6 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
```markdown
# RaidTweet 🚀
Welcome 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:
- **Fetch Tweets**: Grab the latest tweet from specified X users. 🔍
- **Engage**: Automatically reply with a fun message to show some love. 💬
## 🎉 Why Use RaidTweet?
- **Visibility**: Increase the visibility of your token or project by engaging with influencers or popular crypto figures.
- **Community Building**: Encourage community interaction by having real members participate in these engagements.
- **Fun & Engagement**: Add that spark to your marketing strategy with witty and engaging replies.
## 🛠️ Installation Guide
Before we dive into the fun part, here's how you can set up RaidTweet:
### Prerequisites
- **Python 3.10 or higher** 🐍
- **X API Access** (You need to get your own API keys and tokens from X Developer Portal)
### Steps to Install
1. **Clone the Repo**
```bash
git clone https://github.com/your-github-username/RaidTweet.git
cd RaidTweet
```
2. **Set Up Virtual Environment**
```bash
python -m venv venv
source venv/bin/activate # On Windows use `venv\Scripts\activate`
```
3. **Install Dependencies**
```bash
pip install -r requirements.txt
```
4. **Configure Your Environment**
- Create a `.env` file in the root directory with your X API credentials:
```
X_API_KEY=your_api_key
X_API_KEY_SECRET=your_api_secret
X_BEARER_TOKEN=your_bearer_token
X_ACCESS_TOKEN=your_access_token
X_ACCESS_TOKEN_SECRET=your_access_token_secret
```
- Replace `your_api_key`, `your_api_secret`, etc., with your actual credentials. 🔑
## 🚀 Running the Bot
Here's how you can get RaidTweet to start engaging:
1. **Navigate to the Project Folder**
```bash
cd app
```
2. **Run the Script**
```bash
python -m main
```
This will initiate the bot to:
- Fetch the latest tweet from each user in `users_to_raid` list in `main.py`.
- Reply to these tweets with the predefined message.
## ⚙️ Customization
- **Users to Raid**: Edit the `users_to_raid` list in `main.py` to include the usernames you want your bot to interact with.
- **Reply Message**: Change the `reply_text` in `twitter.py` if you want to customize the reply message.
## 🚨 Important Notes
- **Respect the Rates**: Keep an eye on X's API rate limits to avoid hitting the cap.
- **Ethical Use**: Use this bot responsibly. Engagement should add value, not just noise.
- **Privacy & Security**: Never share or commit your API keys to version control.
## 🤔 Troubleshooting
If you encounter issues, check:
- Your `.env` file for correct credentials.
- The `requirements.txt` for up-to-date package versions.
- Ensure you've activated your virtual environment before running.
## 📝 Contributing
Got ideas to make RaidTweet even cooler? Feel free to fork the repo and submit a pull request. Let's make crypto marketing fun together!
## 📜 License
This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details.
---
Join 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! 🎉
```