fix(stealth): omit focus_control by default

patchright_focus_control defaulted to False, so context_options passed
focus_control=False to launch_persistent_context, which patchright builds
without that option reject. Both MCP tools crashed since fetch went
stealth in 0.5.9. Default to None so the option is omitted unless set.

Also refresh the docs home copy for the LLM/MCP story.

Bump 0.5.9 -> 0.6.0.

Author: kacigaya

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "webskrap"
-version = "0.5.9"
+version = "0.6.0"
 description = "A Playwright-based Python scraping framework with coherent browser profiles and session controls."
 readme = "README.md"
 requires-python = ">=3.11"

src/webskrap/models.py

@@ -185,9 +185,10 @@ class SessionConfig(BaseModel):
     # scheme, reduced motion, and caller-provided extra headers) while still
     # avoiding viewport, user-agent, and JavaScript fingerprint patches.
     patchright_context_profile: bool = False
-    # Patchright-specific focus behavior control. Set to None to omit the option
-    # for Patchright versions that do not accept it.
-    patchright_focus_control: bool | None = False
+    # Patchright-specific focus behavior control. Defaults to None so the option
+    # is omitted entirely; Patchright builds that lack focus_control reject it.
+    # Set True/False only when targeting a build that accepts the option.
+    patchright_focus_control: bool | None = None
 
     def launch_options(self) -> dict[str, Any]:
         options: dict[str, Any] = {

tests/test_models.py

@@ -61,7 +61,7 @@ def test_patchright_context_omits_profile_by_default() -> None:
     options = config.context_options(profile)
 
     assert options["no_viewport"] is True
-    assert options["focus_control"] is False
+    assert "focus_control" not in options
     assert "user_agent" not in options
     assert "extra_http_headers" not in options
 
@@ -84,7 +84,7 @@ def test_patchright_context_profile_applies_native_context_metadata() -> None:
     options = config.context_options(profile)
 
     assert options["no_viewport"] is True
-    assert options["focus_control"] is False
+    assert "focus_control" not in options
     assert options["locale"] == "en-US"
     assert options["timezone_id"] == "Europe/Paris"
     assert options["color_scheme"] == "dark"
@@ -108,6 +108,24 @@ def test_patchright_focus_control_can_be_omitted() -> None:
     assert "focus_control" not in options
 
 
+def test_patchright_focus_control_omitted_by_default() -> None:
+    profile = BrowserProfile(name="test")
+    config = SessionConfig(driver="patchright")
+
+    options = config.context_options(profile)
+
+    assert "focus_control" not in options
+
+
+def test_patchright_focus_control_emitted_when_set() -> None:
+    profile = BrowserProfile(name="test")
+    config = SessionConfig(driver="patchright", patchright_focus_control=True)
+
+    options = config.context_options(profile)
+
+    assert options["focus_control"] is True
+
+
 def test_headless_chromium_gets_simulated_screen() -> None:
     config = SessionConfig(driver="patchright", channel="chrome", headless=True)
 

web/content/index.md

@@ -1,6 +1,6 @@
 # WebSkrap
 
-Async-first Python scraping on Playwright. Coherent profiles, persistent sessions, resource routing, and Patchright-powered stealth.
+Async-first Python scraping on Playwright that also works as a web tool for LLMs and agents. You get coherent browser profiles, persistent sessions, resource routing, and Patchright-powered stealth. The MCP server runs that same stealth path, so agents get live pages back as plain text instead of raw HTML.
 
 > **⚠ Usage boundary** — WebSkrap does not include CAPTCHA solving, login-wall bypassing, credential bypassing, or access-control circumvention. Use it only on targets you are allowed to access.
 
@@ -38,4 +38,5 @@ asyncio.run(main())
 - [Profiles](/docs/user-guide/profiles)
 - [Stealth](/docs/user-guide/stealth)
 - [CLI](/docs/user-guide/cli)
+- [MCP Server](/docs/user-guide/mcp)
 - [API Reference](/docs/api-reference)