This project is a browser extension that identifies LinkedIn posts with self-centered content that contain pictures of the author, and allows you to instantly unsubscribe from these authors.
- Automatically highlights LinkedIn posts that contain self-centered content and images
- Adds an "Unsubscribe" button to quickly unfollow authors of these posts
- Works directly in your LinkedIn feed
- Simple browser extension with an easy-to-use interface
-
Clone the repository:
git clone https://github.com/yourusername/linkedin-llm-post-detector.git
-
Navigate to the project directory:
cd linkedin-llm-post-detector -
Install the dependencies:
npm install
-
Build the extension:
./build.sh
Note: You should use the
build.shscript to build the extension. This script will handle the TypeScript compilation and any additional build steps required for packaging the extension. Make sure the script is executable (chmod +x build.sh). -
Load the extension in your browser:
- For Chrome: Go to chrome://extensions/, enable "Developer mode", click "Load unpacked", and select the
distfolder - For Firefox: Go to about:debugging#/runtime/this-firefox, click "Load Temporary Add-on...", and select any file in the
distfolder - For Edge: Go to edge://extensions/, enable "Developer mode", click "Load unpacked", and select the
distfolder
- For Chrome: Go to chrome://extensions/, enable "Developer mode", click "Load unpacked", and select the
- Navigate to LinkedIn in your browser.
- The extension will automatically highlight posts that contain self-centered content and images.
- Click the "Unsubscribe" button on any highlighted post to unfollow that author.
- Click the extension icon in your browser toolbar to see statistics and configure settings.
-
Clone the repository and install dependencies as described above.
-
Start the development build with watch mode:
npm run watch
-
Load the extension in your browser as described in the Installation section.
-
Make changes to the source code and webpack will automatically rebuild the extension.
-
Reload the extension in your browser to see the changes.
The extension includes built-in debugging capabilities to help troubleshoot issues:
- Debug Mode: Enable debug mode in the extension popup to see detailed logs.
- Debug Console: Click "Show Debug Console" in the extension popup to open an in-page debug console that shows real-time information about post detection.
- Manual Analysis: Click "Analyze Feed Now" to force the extension to scan the current LinkedIn feed for posts.
- Browser Console: Open your browser's developer tools (F12) and check the console for detailed logs.
- Post Processing Debug: For detailed information about how each post is being processed, look for debug statements in your browser's console. The extension logs step-by-step analysis and detection results for every post it processes.
- Post Visualization: In debug mode, the extension highlights the DOM elements being processed.
- Selector Testing: The extension tries multiple CSS selectors to find LinkedIn posts, with debug logs showing which selectors were successful.
- Content Analysis: Detailed logs show why posts are being flagged (or not) based on content and image analysis.
- Statistics: Track how many posts are analyzed, detected, and how many authors are unfollowed.
If posts are not being detected:
- Enable debug mode in the extension popup
- Click "Analyze Feed Now" to trigger manual analysis
- Check the debug console for any errors
- Verify that the CSS selectors match LinkedIn's current UI
- Ensure content script is running on LinkedIn by checking the browser console
- Try scrolling down to load more posts and trigger the mutation observer
Contributions are welcome! Please open an issue or submit a pull request for any enhancements or bug fixes.
This project is licensed under the MIT License. See the LICENSE file for details.