mwhammadrezss/shirokhorshidscanner

This is a Python tool that tests a list of IP addresses to find the ones that work best for connecting through a specific type of network workaround called CDN Fronting, used by an app called Shiro Khorshid (also known as Shir Khorshid). CDN Fronting is a technique where network traffic is routed through the servers of major content delivery networks, such as Cloudflare or Google, to bypass internet restrictions imposed by internet service providers or firewalls. The scanner is designed for users in regions where direct internet access is limited, and it helps find clean IP addresses suitable for use in that app's settings. The tool tests each IP address multiple times and scores it on a combination of speed, ping latency, jitter, and reliability. An IP must pass at least three out of five connection attempts to be considered stable. The scoring formula weighs download speed most heavily at 55 percent, with ping at 20 percent, stability at 15 percent, and jitter at 10 percent. Results are graded from S (above 300 KB/s) down to D (below 50 KB/s), and IPs that the ISP is actively throttling are flagged separately so you know not to use them. The scanner automatically detects which CDN provider an IP belongs to and tests it against the most suitable connection identifiers first. Supported CDN networks include Cloudflare, Akamai, Google, Amazon, Azure, Fastly, and several Iranian services. There are two scanning modes. Simple Scan runs quickly using a standard default setting. Auto-SNI mode is more thorough, automatically detects the CDN type, and tests multiple identifiers to find the best result. The README recommends providing between 20 and 100 IP addresses at a time. Installation is a straightforward clone and run with Python, and the tool works on both Android (via Termux) and Windows. Results are intended to be pasted directly into the Shiro Khorshid app's CDN Fronting configuration screen.