A program to monitor crypto trends on social media.
Project description
XCryptoWatch
XCryptoWatch is a powerful Python tool that monitors social media platforms (Twitter, Truth Social, and Bluesky) for cryptocurrency-related posts from specified accounts. It uses OpenAI's GPT to analyze posts and can notify users via email when relevant cryptocurrency content is detected.
Features
- Multi-platform social media monitoring:
- Truth Social
- Bluesky
- AI-powered post analysis using OpenAI's GPT
- Flexible notification system:
- Postal API support
- SMTP email support
- Configurable monitoring intervals
- Interactive command-line interface
- Comprehensive logging system
Installation
To install XCryptoWatch, simply run:
pip install xcryptowatch
Requirements
- Python 3.9 or higher
- Required packages (automatically installed):
- postalsend
- jsonschema
- tweepy
- openai
- truthbrush
- atproto
Configuration
XCryptoWatch requires a configuration file (config.json) with your API credentials and settings. On first run, the program will guide you through creating this configuration.
Required credentials:
- Twitter API credentials (optional)
- Truth Social credentials (optional)
- Bluesky credentials (optional)
- OpenAI API key
- Email settings (SMTP or Postal)
Usage
- Start XCryptoWatch:
xcryptowatch
- Use the interactive menu to:
- Start/stop watching different platforms
- Add new accounts to monitor
- Add notification recipients
- Configure API credentials and settings
Menu Options
- Start watching tweets
- Stop watching tweets
- Start watching truths
- Stop watching truths
- Start watching bluesky
- Stop watching bluesky
- Add a new account to watch
- Add a new recipient to notify
- Configure XCryptoWatch
Configuration Options
The configuration interface allows you to set:
- Social media API credentials
- Monitoring intervals
- Email notification settings
- OpenAI API key
Development
git clone https://github.com/steelproxy/xcryptowatch.git
cd xcryptowatch
pip install -e .
License
MIT License - see LICENSE file for details.
Author
Collin Rodes (steelproxy@protonmail.com)
Version
Current version: 0.1.1
Contributing
- Fork the repository
- Create your feature branch
- Commit your changes
- Push to the branch
- Create a new Pull Request
Security Note
Keep your config.json file secure as it contains sensitive API credentials. The file is automatically added to .gitignore to prevent accidental commits.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file xcryptowatch-0.1.2.tar.gz.
File metadata
- Download URL: xcryptowatch-0.1.2.tar.gz
- Upload date:
- Size: 13.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.12.8
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
981731e1b40887aaf98db623188039e18da806c266fa43d489a36de2edc884f3
|
|
| MD5 |
f29787c45d086ed216bd847c2cf05460
|
|
| BLAKE2b-256 |
c174ab8917418a9bfa648007639444a26cf70fdabb94ab115bf095e71384f4bd
|
File details
Details for the file xcryptowatch-0.1.2-py3-none-any.whl.
File metadata
- Download URL: xcryptowatch-0.1.2-py3-none-any.whl
- Upload date:
- Size: 12.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.12.8
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
08ed92162bdb04dc7bc73ffadc75cb337c817a975bbd82e1a9751033ffdbbb46
|
|
| MD5 |
2d95455a0fd2fcdf0c7da6f084819334
|
|
| BLAKE2b-256 |
01479fe5d1ae8abeed0cbbbb1138fb22914640131511c9116d3a7b9bd3d801d3
|