Docs: Update README

README.md

@@ -60,10 +60,18 @@ The app will open automatically in your browser at `http://127.0.0.1:7861`.
 You can also run the tools directly via the terminal if you don't want to use the UI.
 
 ### Step 1: Main Scrape
+By default, running the script in the terminal will fetch data for all 6 target categories. 
 ```powershell
 python -m pytest tests/test_scrape_districts_by_category.py -v -s --state "GOA"
 ```
 
+**Filter by Specific Categories:**
+If you want to only fetch data for specific categories (e.g., just category 5, or 3 and 5), you can set the `KYS_TARGET_CATEGORIES` environment variable before the command:
+```powershell
+$env:KYS_TARGET_CATEGORIES="5"; python -m pytest tests/test_scrape_districts_by_category.py -v -s --state "GOA"
+```
+*(You can pass multiple IDs separated by commas: `"3,5"`)*
+
 ### Step 2: Retry Failures
 ```powershell
 python -m pytest tests/test_retry_districts_by_category.py -v -s --state "GOA"

tests/test_scrape_districts_by_category.py

@@ -607,7 +607,7 @@ def test_scrape_schools_by_district_category(
     else:
         log.info("All combos collected successfully — no captcha failures!")
 
-    assert success_count > 0, (
-        f"No successful responses collected! "
+    assert (success_count + no_data_count) > 0, (
+        f"No valid responses collected! "
         f"Check OCR accuracy and network connectivity. Failed: {failed_count}"
     )