Skip to content

Latest commit

 

History

History
236 lines (154 loc) · 7.18 KB

README.md

File metadata and controls

236 lines (154 loc) · 7.18 KB
Raw

📢 Facebook Comment Bot

Facebook Comment Bot Python OpenAI

A Selenium-based bot designed to automatically post human-like comments on a specified Facebook post using OpenAI's language models. This bot simulates genuine user interactions to enhance engagement on your Facebook posts.

📋 Table of Contents

🌟 Features

  • Automated Commenting: Automatically generate and post comments on a specified Facebook post.
  • Human-like Interactions: Simulates human behavior with random pauses, mouse movements, and typing patterns to mimic genuine user interactions.
  • OpenAI Integration: Utilizes OpenAI's language models to generate contextually relevant and engaging comments.
  • Robust Logging: Comprehensive logging for monitoring bot activities and debugging.
  • Error Handling: Captures and logs errors, raising exceptions for critical issues.

🔧 Prerequisites

Before setting up the bot, ensure you have the following:

  • Python 3.7 or Higher: Download Python
  • Google Chrome Browser: Ensure it's installed on your system.
  • ChromeDriver: Managed automatically by webdriver-manager, so no manual setup is required.
  • OpenAI API Key: Sign up at OpenAI to obtain your API key.
  • Facebook Account: A Facebook account to post comments.

💻 Installation

  1. Clone the Repository:

    git clone https://github.com/thanhduy1706/ai-comment-bot.git
cd ai-comment-bot

  2. Create a Virtual Environment (Optional but Recommended):

    python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

  3. Install Required Packages:

    Ensure you have pip installed. Then run:

    pip install -r requirements.txt

    requirements.txt Content:

    selenium
webdriver-manager
openai==0.28
python-dotenv
pre-commit

⚙️ Configuration

  1. Create a .env File:

    In the root directory of the project, create a .env file to store your sensitive information.

  2. Populate the .env File:

    Open the .env file in a text editor and add the following configurations:

    OPENAI_API_KEY=your_openai_api_key_here
OPENAI_MODEL=gpt-4o-mini
OPENAI_PROMPT=Generate a friendly, specific, and engaging Facebook comment.
POST_URL=https://www.facebook.com/your_post_url_here

    Replace:

    • your_openai_api_key_here with your actual OpenAI API key.
    • gpt-4o-mini with the desired OpenAI model (e.g., gpt-4, gpt-4-turbo, gpt-4o-mini).
    • Generate a friendly, specific, and engaging Facebook comment. with your desired OpenAI prompt.
    • https://www.facebook.com/your_post_url_here with the URL of the Facebook post you want to comment on.

🚀 Usage

Follow these steps to run the Facebook Comment Bot:

  1. Ensure Environment Variables are Set:

    Double-check your .env file to ensure all required variables are correctly set.

  2. Run the Script:

    Execute the bot using the following command:

    python cmt.py

  3. Bot Execution Flow:

    • Initialization: The bot sets up the Chrome WebDriver with specified options to minimize detection.
    • Navigating to Post: It navigates to the specified Facebook post URL.
    • Commenting Process:
      • The bot generates comments using OpenAI's API.
      • Simulates human-like typing and interactions to post comments.
      • Repeats the process based on MAX_COMMENTS and MAX_ITERATIONS settings.
      • Periodically refreshes the page to maintain session stability.

    Example Command:

    python cmt.py

🔑 Handling Login

Manual Login Process:

  • Step 1: If not logged in, you need opens a new tab directing to Facebook's login page.
  • Step 2: Manually log in to Facebook in the newly opened tab.
  • Step 3: After successfully logging in, closes the login tab.
  • Step 4: Refreshes the main tab, and resumes the commenting process.

Note: This manual login step ensures that your credentials remain secure and adheres to Facebook's policies by avoiding automated login attempts.

📝 Logging and Debugging

The bot maintains detailed logs to monitor its activities and assist in debugging:

  1. Log Files:

    • Stored in the logs/ directory.
    • Named using the timestamp format: facebook_comment_bot_YYYYMMDD_HHMMSS.log.

  2. Log Levels:

    • INFO: General operational messages (e.g., driver setup, comment posting).
    • DEBUG: Detailed information useful for debugging (e.g., pauses, mouse movements).
    • WARNING: Non-critical issues (e.g., failed comment posts).
    • ERROR: Critical problems that may halt execution.
    • CRITICAL: Severe issues requiring immediate attention.

⚠️ Ethical Considerations

Important: Automating interactions on platforms like Facebook can violate their Terms of Service and Community Standards. Use such bots responsibly and ethically, ensuring compliance with all relevant policies.

Potential Risks:

  • Account Restrictions or Bans: Automated actions can lead to your Facebook account being restricted or banned.
  • Legal Implications: Depending on jurisdiction and usage, there could be legal consequences.

Recommendation: Use this bot for educational purposes only and ensure you have the necessary permissions to interact with the targeted Facebook posts.

🛠️ Troubleshooting

Issue: Bot fails to post comments.

Solution:

  • Ensure you're logged into Facebook. If prompted, follow the manual login steps.
  • Check the logs/ directory for detailed error messages.
  • Update the COMMENT_BOX_XPATH in the CONFIG if Facebook has updated its UI.

Issue: "element click intercepted" error persists.

Solution:

  • Enhance the close_overlays method to handle new pop-ups or overlays.
  • Implement additional delays to ensure elements are fully loaded.
  • Use more robust selectors to accurately locate the comment box.

Issue: Unable to locate comment box.

Solution:

  • Verify the COMMENT_BOX_XPATH in the CONFIG.
  • Update the XPath based on the current Facebook UI.
  • Ensure that Facebook hasn't changed the structure or labels of the comment box.

📄 License

This project is licensed under the MIT License.

📞 Contact

For any inquiries or support, please contact [email protected].

🔗 Acknowledgements

  • Selenium
  • WebDriver Manager
  • OpenAI
  • Python-dotenv