media-automation

media-automation is a personal Python project collection focused on automating repetitive social media and messaging processes. It includes a MailBomber that uses Beautiful Soup to scrape text from a URL, splits it into segments, and sends it to multiple email addresses rapidly. The WhatsAppBomber similarly extracts text and uses PyAutoGUI or Selenium to send bulk messages or images to WhatsApp contacts. An Instagram tool compares following and followers lists to identify non-reciprocal accounts. The repository also includes an anti-AFK random walk utility and shared helper scripts in a Utils module.

[{"step":"Prepare your input files. For bulk messaging, ensure your audience list is in a CSV file with columns like 'name', 'phone', and 'preferences'. For Instagram analysis, export your post data as a JSON file or provide the account handle.","action":"Use tools like Google Sheets or Excel to format your data, then save as CSV. For Instagram, you can use Instagram’s native export feature or third-party tools like Hootsuite to download post analytics.","tip":"Validate your data for errors (e.g., duplicate entries, invalid phone numbers) before running the script. Use a small test batch first to confirm the automation works as expected."},{"step":"Customize the script parameters. Adjust message templates, scheduling times, hashtag suggestions, or anti-AFK actions based on your goals.","action":"Edit the Python script or use the provided configuration file to set parameters like delay between messages (e.g., 5 seconds), maximum messages per day (e.g., 100), or engagement thresholds for the anti-AFK utility.","tip":"Start with conservative settings (e.g., lower message volume, shorter delays) to avoid triggering platform restrictions. Gradually increase intensity based on results."},{"step":"Run the automation and monitor results. Use the built-in logging features to track deliveries, engagement, and errors.","action":"Execute the script via command line (e.g., `python whatsapp_bulk.py`) or schedule it using cron jobs (for Linux/macOS) or Task Scheduler (for Windows). Check the output logs or dashboard for real-time updates.","tip":"Set up alerts for critical errors (e.g., failed message deliveries, account bans) by integrating the script with tools like Slack or email notifications."},{"step":"Analyze performance and iterate. Review the generated reports to identify trends and optimize future campaigns.","action":"Use the provided analytics scripts to generate visual reports (e.g., engagement over time, top-performing messages). Adjust your strategy based on the data, such as refining your message templates or targeting a different audience segment.","tip":"A/B test different messages, posting times, or hashtags by running parallel campaigns and comparing results."}]