Add runnable sync and async SDK examples

Co-authored-by: Shri Sukhani <shrisukhani@users.noreply.github.com>

Author: cursoragent

README.md

@@ -168,6 +168,13 @@ python -m pytest -q
 python -m build
 ```
 
+## Examples
+
+Ready-to-run examples are available in `examples/`:
+
+- `examples/sync_scrape.py`
+- `examples/async_extract.py`
+
 ## License
 
 MIT — see [LICENSE](LICENSE).

examples/async_extract.py

@@ -0,0 +1,31 @@
+"""
+Asynchronous extract example.
+
+Run:
+    export HYPERBROWSER_API_KEY="your_api_key"
+    python examples/async_extract.py
+"""
+
+import asyncio
+
+from hyperbrowser import AsyncHyperbrowser
+from hyperbrowser.models import StartExtractJobParams
+
+
+async def main() -> None:
+    async with AsyncHyperbrowser() as client:
+        result = await client.extract.start_and_wait(
+            StartExtractJobParams(
+                urls=["https://hyperbrowser.ai"],
+                prompt="Extract the main product value propositions as a list.",
+            ),
+            poll_interval_seconds=1.0,
+            max_wait_seconds=120.0,
+        )
+
+        print(result.status)
+        print(result.data)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

examples/sync_scrape.py

@@ -0,0 +1,36 @@
+"""
+Synchronous scrape example.
+
+Run:
+    export HYPERBROWSER_API_KEY="your_api_key"
+    python examples/sync_scrape.py
+"""
+
+from hyperbrowser import Hyperbrowser
+from hyperbrowser.exceptions import HyperbrowserTimeoutError
+from hyperbrowser.models import ScrapeOptions, StartScrapeJobParams
+
+
+def main() -> None:
+    with Hyperbrowser() as client:
+        try:
+            result = client.scrape.start_and_wait(
+                StartScrapeJobParams(
+                    url="https://hyperbrowser.ai",
+                    scrape_options=ScrapeOptions(formats=["markdown"]),
+                ),
+                poll_interval_seconds=1.0,
+                max_wait_seconds=120.0,
+            )
+        except HyperbrowserTimeoutError:
+            print("Scrape job timed out.")
+            return
+
+        if result.data and result.data.markdown:
+            print(result.data.markdown[:500])
+        else:
+            print(f"Scrape finished with status={result.status} and no markdown payload.")
+
+
+if __name__ == "__main__":
+    main()