Skip to main content

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:
    • Twitter
    • 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

  1. Start XCryptoWatch:
xcryptowatch
  1. 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

  1. Start watching tweets
  2. Stop watching tweets
  3. Start watching truths
  4. Stop watching truths
  5. Start watching bluesky
  6. Stop watching bluesky
  7. Add a new account to watch
  8. Add a new recipient to notify
  9. 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

  1. Fork the repository
  2. Create your feature branch
  3. Commit your changes
  4. Push to the branch
  5. 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

xcryptowatch-0.1.2.tar.gz (13.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

xcryptowatch-0.1.2-py3-none-any.whl (12.4 kB view details)

Uploaded Python 3

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

Hashes for xcryptowatch-0.1.2.tar.gz
Algorithm Hash digest
SHA256 981731e1b40887aaf98db623188039e18da806c266fa43d489a36de2edc884f3
MD5 f29787c45d086ed216bd847c2cf05460
BLAKE2b-256 c174ab8917418a9bfa648007639444a26cf70fdabb94ab115bf095e71384f4bd

See more details on using hashes here.

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

Hashes for xcryptowatch-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 08ed92162bdb04dc7bc73ffadc75cb337c817a975bbd82e1a9751033ffdbbb46
MD5 2d95455a0fd2fcdf0c7da6f084819334
BLAKE2b-256 01479fe5d1ae8abeed0cbbbb1138fb22914640131511c9116d3a7b9bd3d801d3

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page