s2fcore/s2f-lead-commander-core

S2F-Core is a self-hosted software pipeline built to automatically find and reach out to potential business customers, specifically athletic brands, sports clubs, and training centers, on behalf of its owner, a sportswear manufacturer in Sialkot, Pakistan. Rather than paying for commercial lead generation or scraping services, the whole system runs on hardware you own, using free local tools instead of paid APIs. The pipeline works in stages. First, it gathers public business information such as emails, phone numbers, and social media profiles from sources including Google Maps and search results. Next, it uses a locally run AI language model, Qwen2.5, to judge whether each lead is actually relevant to the business, filtering out competitors, directories, and other bad matches. Qualified leads are then sorted into different outreach queues depending on whether an email address, a social profile, or neither was found. Finally, a scheduling component sends outbound emails only during business hours in the recipient's own time zone, rotating between several email delivery services and including reply options such as interested, later, and unsubscribe. The system uses several techniques to keep working when a target website tries to block automated access, including routing some requests through the Tor network and automatically rotating its network identity if a connection is blocked. Phone numbers collected are standardized into international format using Google's phone number library. The project runs as a set of services connected to a shared PostgreSQL database, and is designed to run on a Linux server, specifically Debian or Ubuntu, with at least 8 gigabytes of memory and four CPU cores. Setup involves creating directories, initializing the database schema from a provided SQL file, and starting supporting services such as the database and a headless browser through Docker Compose. The README does not state an open source license, and the project describes its core crawling and validation components as proprietary technology owned by the author and his company.