Document how to run the new test suite

README.md

@@ -13,3 +13,16 @@ pinned: true
 # `SERPent`
 
 `SERPent` provides a SERP / scrapping API for use by AI agents / projects.
+
+## Running tests
+
+```
+pip install -r requirements.txt -r requirements-dev.txt
+playwright install chromium   # if not already present on the machine
+pytest
+```
+
+The suite mocks all outbound HTTP (via `respx`) and drives the Playwright-based
+scrapers against local fixture HTML instead of live search engines - see
+`tests/helpers.py` for how - so it runs fully offline and doesn't depend on,
+or risk tripping, any site's anti-bot measures.