Document CIDR input support in README and guides

Author: SamNet-dev

GUIDE.md

@@ -580,7 +580,7 @@ findns chain -i doh-resolvers.txt -o results.json \
 
 ### ورودی (Input)
 
-**حالت 1: فایل متنی ساده** (یک آی‌پی یا URL در هر خط)
+**حالت 1: فایل متنی ساده** (یک آی‌پی، رنج CIDR، یا URL در هر خط)
 
 </div>
 
@@ -589,10 +589,16 @@ findns chain -i doh-resolvers.txt -o results.json \
 1.1.1.1
 9.9.9.9
 # این یک کامنت است (نادیده گرفته می‌شود)
+
+# رنج CIDR (به صورت خودکار باز می‌شود)
+185.51.200.0/24
+10.202.10.0/28
 ```
 
 <div dir="rtl">
 
+**پشتیبانی از CIDR:** رنج‌هایی مثل `1.2.3.0/24` به صورت خودکار به آی‌پی‌های تکی تبدیل می‌شوند (آدرس شبکه و broadcast حذف می‌شوند). این قابلیت برای اسکن بلوک‌های آی‌پی منطقه‌ای (مثل فایل‌های `iran-ipv4.cidrs`) بسیار مفید است. اگر تعداد آی‌پی‌ها بیش از 100,000 باشد هشدار نمایش داده می‌شود.
+
 برای DoH:
 
 </div>
@@ -755,7 +761,60 @@ findns nxdomain -i resolved.json -o clean.json
 
 هر مرحله فقط IPهای "passed" از مرحله قبل را تست می‌کند.
 
-### سناریو 7: تست فقط resolverهای ایرانی
+### سناریو 7: اسکن با فایل CIDR (مثل iran-ipv4.cidrs)
+
+اگر فایلی دارید که رنج آی‌پی‌ها را به صورت CIDR دارد (مثل `iran-ipv4.cidrs`)، findns مستقیم آن را می‌خواند — نیازی به تبدیل نیست.
+
+**نمونه فایل CIDR:**
+
+</div>
+
+```
+# iran-ipv4.cidrs
+5.22.0.0/17
+5.34.192.0/20
+5.42.217.0/24
+5.52.0.0/16
+185.51.200.0/22
+```
+
+<div dir="rtl">
+
+**اسکن مستقیم:**
+
+</div>
+
+```bash
+findns scan -i iran-ipv4.cidrs -o results.json --domain t.mysite.com
+```
+
+<div dir="rtl">
+
+findns به صورت خودکار:
+1. هر رنج CIDR را به آی‌پی‌های تکی تبدیل می‌کند (مثلاً `/24` = 254 آی‌پی)
+2. آدرس شبکه و broadcast را حذف می‌کند
+3. تعداد رنج‌ها و آی‌پی‌های expand شده را نشان می‌دهد
+4. اگر بیش از 100,000 آی‌پی باشد هشدار می‌دهد
+
+**ترکیب CIDR با آی‌پی‌های تکی:** می‌توانید در یک فایل هم رنج CIDR و هم آی‌پی تکی داشته باشید:
+
+</div>
+
+```
+# آی‌پی‌های تکی
+8.8.8.8
+1.1.1.1
+
+# رنج‌های CIDR
+185.51.200.0/24
+10.202.10.0/28
+```
+
+<div dir="rtl">
+
+> **نکته:** فایل‌های `.cidrs` فرمت خاصی ندارند — همان فایل متنی ساده هستند. findns هر خطی که `/` داشته باشد را به عنوان CIDR تشخیص می‌دهد. خطوط خالی و خطوطی که با `#` شروع شوند نادیده گرفته می‌شوند.
+
+### سناریو 8: تست فقط resolverهای ایرانی
 
 </div>
 
@@ -769,7 +828,7 @@ findns scan -i my-resolvers.txt -o results.json --domain t.mysite.com
 
 <div dir="rtl">
 
-### سناریو 8: تست با تعداد worker کمتر (سرور ضعیف)
+### سناریو 9: تست با تعداد worker کمتر (سرور ضعیف)
 
 </div>
 

README.md

@@ -23,6 +23,7 @@ Supports both **UDP** and **DoH (DNS-over-HTTPS)** resolvers with end-to-end tun
 | 🌍 **Regional Resolver Lists** | Built-in support for regional intranet resolver lists (7,800+ IPs) |
 | ⚡ **High Concurrency** | 50 parallel workers by default — scans thousands of resolvers in minutes |
 | 📋 **JSON Pipeline** | Output from one scan feeds into the next for multi-stage filtering |
+| 🌐 **CIDR Input** | Accept IP ranges like `185.51.200.0/24` — auto-expanded to individual hosts |
 
 ---
 
@@ -420,20 +421,26 @@ Step format: `type:key=val,key=val`. Optional params: `count`, `timeout`.
 
 ### Input
 
-Plain text file with one entry per line. Supports both IPs and DoH URLs:
+Plain text file with one entry per line. Supports IPs, CIDR ranges, and DoH URLs:
 
 ```text
 # UDP resolvers (one IP per line)
 8.8.8.8
 1.1.1.1
 9.9.9.9
 
+# CIDR ranges (expanded automatically)
+185.51.200.0/24
+10.202.10.0/28
+
 # DoH resolvers (full URLs)
 https://dns.google/dns-query
 https://cloudflare-dns.com/dns-query
 https://dns.quad9.net/dns-query
 ```
 
+**CIDR support:** Ranges like `1.2.3.0/24` are automatically expanded to individual host IPs (network and broadcast addresses are excluded). This is useful for scanning regional IP blocks (e.g. `iran-ipv4.cidrs` files). A warning is shown when expansion exceeds 100,000 IPs.
+
 Can also accept JSON output from a previous scan (only `passed` entries are used by default).
 
 ### Output
@@ -576,6 +583,7 @@ MIT
 | 🌍 **resolverهای محلی** | لیست داخلی 7,800+ آی‌پی resolver منطقه‌ای |
 | ⚡ **همزمانی بالا** | 50 worker موازی — هزاران resolver در چند دقیقه اسکن می‌شود |
 | 📋 **خروجی JSON** | خروجی هر اسکن ورودی اسکن بعدی می‌شود |
+| 🌐 **ورودی CIDR** | رنج آی‌پی مثل `185.51.200.0/24` را می‌خواند و به صورت خودکار باز می‌کند |
 
 ---