Inspecto-Engage is a Python tool that checks the social media engagement of URLs using the SharedCount API. It fetches interaction data from platforms like Facebook and Pinterest, displaying results via a simple and intuitive GUI. The tool supports batch URL processing, concurrent requests, and provides detailed feedback on post existence and engagement.
- Python 3.x (Recommended: 3.8 or higher)
- Required Python Packages:
requests,tkinter,pyinstaller - You can install the necessary Python packages by running the following:
pip install requests tkinter- Download the latest
.exeinstaller from the GitHub releases section. - Run the installer
.exefile. This will automatically extract the program and create a folder for Inspecto-Engage on your machine. - You can then run Inspecto-Engage from the extracted folder. If you want, you can also create shortcuts for easy access.
- Download the latest
.shinstaller from the GitHub releases section. - Make the installer executable by running the following command:
chmod +x inspecto-engage-installer.sh
- Run the installer script:
./inspecto-engage-installer.sh
- The installer will automatically extract and set up the program. You can run Inspecto-Engage from the installed directory.
-
Clone or download the project repository:
git clone https://github.com/yourusername/inspecto-engage.git cd inspecto-engage -
Install the necessary Python dependencies:
pip install -r requirements.txt
-
Run the program using the following command:
python3 sharedcount_exec_multithread.py
This section provides both the easy installer option (using the .sh file) and the manual method for users who prefer to work with the code directly. Let me know if you need further adjustments!
- Open Inspecto-Engage.
- Select a CSV file containing URLs you want to check. The file should have one URL per row.
- Enter your SharedCount API Key.
- Choose the desired number of Concurrent Requests (the default is 30). You can adjust this based on your network and system capacity.
- Specify the output file name and location where the results should be saved.
- Click on Run to start the process. The program will process the URLs and display the results in the specified output file.
https://example.com/article1
https://example.com/article2
https://example.com/article3
The output CSV file will contain:
- URL: The URL that was checked.
- Message: A status message indicating whether the URL has engagement data, was not shared, or failed.
- Pinterest: Engagement count from Pinterest.
- Facebook Total: Total Facebook engagement.
- Facebook Comments: Number of Facebook comments.
- Facebook Reactions: Number of Facebook reactions.
- Facebook Shares: Number of Facebook shares.
- Rate Limit Reached: If the SharedCount API rate limit is exceeded, the program will display a warning and stop further processing.
- Request Errors: If there are issues connecting to the API (e.g., network issues), the program will notify you with the error message.
- No Data Found: If a URL is found but has no engagement data, a message will be displayed indicating that the post exists but has no interactions.
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
- The program utilizes the SharedCount API to fetch social media engagement data.
- Thanks to the Tkinter library for creating the GUI.
We welcome contributions to Inspecto-Engage! If you would like to contribute to the project, please follow these steps:
- Fork the repository.
- Create a new branch for your feature or bug fix.
- Write tests to verify your changes.
- Ensure all tests pass and that the code is properly formatted.
- Submit a pull request describing your changes.
By submitting a pull request, you agree that your contributions will be licensed under the Apache License, Version 2.0.
For any bugs or feature requests, please open an issue on the GitHub repository.
Thank you for contributing!
Happy engagement inspection!