How tuhin-thinks/snifferex works
SnifferEx pairs a browser extension with Python WebSocket consumers to scrape live pages and send browser actions over the same session. The main flow is: a user starts listening, the extension connects, a consumer submits extraction or action commands, and results return to that consumer. The README also describes real-user/hybrid use and dynamic-page support. The deployment diagram mentions message buses and workers, but the sampled runtime shows a local WebSocket server instead; those documented future-style services are not mapped here. Some server and extension excerpts are partial, so uncertain internal links are omitted.
Main entry points: background.js Socket and command handler · ws_server.py WebSocket server · example_consumers Scraping consumers · popup.js Extension popup
Components 9
Browser extension
- Extension popup
extension/popup.js - Socket and command handler
extension/background.js - Page extraction script
extension/content.js
WebSocket backend
- WebSocket server
Websocket_Server_AND_Consumer/ws_server.py - Connection state
Websocket_Server_AND_Consumer/connection_handler.py
Consumer clients
- Scraping consumers
Websocket_Server_AND_Consumer/example_consumers - Scraped results
Websocket_Server_AND_Consumer/example_consumers/ex_insta_follower_users.py
Other components
- Browser user
- Active webpage
Connections 11
- Browser user → Extension popup: starts listening
extension/popup.js - Extension popup → Socket and command handler: requests socket
extension/popup.js - Socket and command handler → WebSocket server: opens WebSocket
extension/background.js - WebSocket server → Connection state: uses connections
Websocket_Server_AND_Consumer/ws_server.py - Scraping consumers → WebSocket server: sends commands
Websocket_Server_AND_Consumer/example_consumers/ex_linkedin_post_text_preview.py - WebSocket server → Socket and command handler: routes commands
README.md - Socket and command handler → Active webpage: extracts or acts
extension/background.js - Active webpage → Socket and command handler: returns extraction
extension/background.js - WebSocket server → Scraping consumers: forwards results
README.md - Scraping consumers → Scraped results: writes results
Websocket_Server_AND_Consumer/example_consumers/ex_insta_follower_users.py - Socket and command handler → Page extraction script: may delegate