shadey 0.1.0__tar.gz

shadey-0.1.0/PKG-INFO

@@ -0,0 +1,165 @@
+Metadata-Version: 2.4
+Name: shadey
+Version: 0.1.0
+Summary: Stealth browser sessions for AI agents
+Home-page: https://shadey.dev
+Author: Shadey
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: aiohttp>=3.8
+Provides-Extra: playwright
+Requires-Dist: playwright>=1.40; extra == "playwright"
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# shadey
+
+Stealth browser sessions for AI agents. Pass Cloudflare, DataDome, PerimeterX, and Kasada from any IP.
+
+## Install
+
+```bash
+pip install shadey
+```
+
+## Quick Start
+
+```python
+import asyncio
+from shadey import Shadey
+
+async def main():
+    async with Shadey("sk_your_api_key") as client:
+        async with await client.session() as session:
+            # Navigate and extract — no CDP/Playwright needed
+            await session.goto("https://example.com")
+            title = await session.evaluate("document.title")
+            print(title["result"])
+
+            # Extract text from elements
+            headings = await session.extract("h1", all=True)
+            print(headings["data"])
+
+            # Get full page HTML
+            page = await session.content()
+            print(f"{page['length']} bytes")
+
+            # Screenshot
+            img = await session.screenshot()  # base64 jpeg
+
+asyncio.run(main())
+```
+
+## With Behavioral Actions
+
+```python
+async with Shadey("sk_your_api_key") as client:
+    async with await client.session() as session:
+        await session.goto("https://nowsecure.nl")
+
+        # Human-like interactions to build trust
+        await session.idle(duration_ms=3000)
+        await session.scroll(400)
+        await session.click(500, 300)
+        await session.type_text("hello world", context="search")
+
+        # Then extract what you need
+        result = await session.extract(".result-title", all=True)
+```
+
+## With Playwright (CDP)
+
+```python
+async with Shadey("sk_your_api_key") as client:
+    async with await client.session() as session:
+        # Full browser control via CDP
+        from playwright.async_api import async_playwright
+        async with async_playwright() as p:
+            browser = await p.chromium.connect_over_cdp(session.playwright_url)
+            page = browser.contexts[0].pages[0]
+            await page.goto("https://nowsecure.nl")
+            print(await page.title())
+```
+
+## API
+
+### `Shadey(api_key, base_url="https://api.shadey.dev")`
+
+Create a client. Use as async context manager or call `.close()` manually.
+
+### `client.session(stealth="full", proxy=None, profile=None)`
+
+Create a stealth browser session. Returns a `ShadeySession`.
+
+### REST Actions
+
+### `session.goto(url, wait_ms=3000)`
+
+Navigate to a URL. Waits for page load + extra `wait_ms`.
+
+### `session.screenshot()`
+
+Returns a base64 JPEG data URI of the current page.
+
+### `session.extract(selector, attribute="textContent", all=False)`
+
+Extract data from the page. Set `all=True` to get all matching elements.
+
+### `session.evaluate(expression)`
+
+Run JavaScript and return the result.
+
+### `session.content()`
+
+Get the full page HTML.
+
+### Behavioral Actions
+
+### `session.click(x, y, width=50)`
+
+Move mouse and click at coordinates with Fitts' law timing and corrective submovements.
+
+### `session.type_text(text, context="form")`
+
+Type text with QWERTY bigram-modeled keystroke timing. Context: `"form"`, `"search"`, `"url"`.
+
+### `session.scroll(distance)`
+
+Scroll with momentum and inertia. Positive = down, negative = up.
+
+### `session.dwell(context="content")`
+
+Wait a human-realistic amount of time. Context: `"content"`, `"search"`, `"form"`.
+
+### `session.idle(duration_ms=5000)`
+
+Simulate idle browsing — mouse movements, scrolls, pauses driven by HMM behavioral model.
+
+### CDP Access
+
+### `session.playwright_url` / `session.puppeteer_url`
+
+CDP WebSocket URL for direct browser control.
+
+### `session.close()`
+
+Destroy the session.
+
+### `client.usage()`
+
+Get plan usage stats.
+
+### `client.health()`
+
+Check API health.

shadey-0.1.0/README.md

@@ -0,0 +1,140 @@
+# shadey
+
+Stealth browser sessions for AI agents. Pass Cloudflare, DataDome, PerimeterX, and Kasada from any IP.
+
+## Install
+
+```bash
+pip install shadey
+```
+
+## Quick Start
+
+```python
+import asyncio
+from shadey import Shadey
+
+async def main():
+    async with Shadey("sk_your_api_key") as client:
+        async with await client.session() as session:
+            # Navigate and extract — no CDP/Playwright needed
+            await session.goto("https://example.com")
+            title = await session.evaluate("document.title")
+            print(title["result"])
+
+            # Extract text from elements
+            headings = await session.extract("h1", all=True)
+            print(headings["data"])
+
+            # Get full page HTML
+            page = await session.content()
+            print(f"{page['length']} bytes")
+
+            # Screenshot
+            img = await session.screenshot()  # base64 jpeg
+
+asyncio.run(main())
+```
+
+## With Behavioral Actions
+
+```python
+async with Shadey("sk_your_api_key") as client:
+    async with await client.session() as session:
+        await session.goto("https://nowsecure.nl")
+
+        # Human-like interactions to build trust
+        await session.idle(duration_ms=3000)
+        await session.scroll(400)
+        await session.click(500, 300)
+        await session.type_text("hello world", context="search")
+
+        # Then extract what you need
+        result = await session.extract(".result-title", all=True)
+```
+
+## With Playwright (CDP)
+
+```python
+async with Shadey("sk_your_api_key") as client:
+    async with await client.session() as session:
+        # Full browser control via CDP
+        from playwright.async_api import async_playwright
+        async with async_playwright() as p:
+            browser = await p.chromium.connect_over_cdp(session.playwright_url)
+            page = browser.contexts[0].pages[0]
+            await page.goto("https://nowsecure.nl")
+            print(await page.title())
+```
+
+## API
+
+### `Shadey(api_key, base_url="https://api.shadey.dev")`
+
+Create a client. Use as async context manager or call `.close()` manually.
+
+### `client.session(stealth="full", proxy=None, profile=None)`
+
+Create a stealth browser session. Returns a `ShadeySession`.
+
+### REST Actions
+
+### `session.goto(url, wait_ms=3000)`
+
+Navigate to a URL. Waits for page load + extra `wait_ms`.
+
+### `session.screenshot()`
+
+Returns a base64 JPEG data URI of the current page.
+
+### `session.extract(selector, attribute="textContent", all=False)`
+
+Extract data from the page. Set `all=True` to get all matching elements.
+
+### `session.evaluate(expression)`
+
+Run JavaScript and return the result.
+
+### `session.content()`
+
+Get the full page HTML.
+
+### Behavioral Actions
+
+### `session.click(x, y, width=50)`
+
+Move mouse and click at coordinates with Fitts' law timing and corrective submovements.
+
+### `session.type_text(text, context="form")`
+
+Type text with QWERTY bigram-modeled keystroke timing. Context: `"form"`, `"search"`, `"url"`.
+
+### `session.scroll(distance)`
+
+Scroll with momentum and inertia. Positive = down, negative = up.
+
+### `session.dwell(context="content")`
+
+Wait a human-realistic amount of time. Context: `"content"`, `"search"`, `"form"`.
+
+### `session.idle(duration_ms=5000)`
+
+Simulate idle browsing — mouse movements, scrolls, pauses driven by HMM behavioral model.
+
+### CDP Access
+
+### `session.playwright_url` / `session.puppeteer_url`
+
+CDP WebSocket URL for direct browser control.
+
+### `session.close()`
+
+Destroy the session.
+
+### `client.usage()`
+
+Get plan usage stats.
+
+### `client.health()`
+
+Check API health.

shadey-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

shadey-0.1.0/setup.py

@@ -0,0 +1,25 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="shadey",
+    version="0.1.0",
+    description="Stealth browser sessions for AI agents",
+    long_description=open("README.md").read(),
+    long_description_content_type="text/markdown",
+    author="Shadey",
+    url="https://shadey.dev",
+    packages=find_packages(),
+    python_requires=">=3.8",
+    install_requires=[
+        "aiohttp>=3.8",
+    ],
+    extras_require={
+        "playwright": ["playwright>=1.40"],
+    },
+    classifiers=[
+        "Development Status :: 3 - Alpha",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: MIT License",
+        "Programming Language :: Python :: 3",
+    ],
+)

shadey-0.1.0/shadey/__init__.py

@@ -0,0 +1,5 @@
+from .client import Shadey, ShadeyError
+from .session import ShadeySession
+
+__version__ = "0.1.0"
+__all__ = ["Shadey", "ShadeyError", "ShadeySession"]

shadey-0.1.0/shadey/client.py

@@ -0,0 +1,85 @@
+import aiohttp
+from typing import Optional, List
+from .session import ShadeySession
+
+
+class Shadey:
+    def __init__(self, api_key: str, base_url: str = "https://api.shadey.dev"):
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self._http: Optional[aiohttp.ClientSession] = None
+
+    async def __aenter__(self):
+        self._http = aiohttp.ClientSession(
+            headers={"Authorization": f"Bearer {self.api_key}"}
+        )
+        return self
+
+    async def __aexit__(self, *args):
+        if self._http:
+            await self._http.close()
+
+    def _ensure_http(self):
+        if not self._http:
+            self._http = aiohttp.ClientSession(
+                headers={"Authorization": f"Bearer {self.api_key}"}
+            )
+
+    async def _request(self, method: str, path: str, **kwargs) -> dict:
+        self._ensure_http()
+        async with self._http.request(method, f"{self.base_url}{path}", **kwargs) as resp:
+            if resp.status == 204:
+                return {}
+            data = await resp.json()
+            if resp.status >= 400:
+                raise ShadeyError(resp.status, data.get("error", str(data)))
+            return data
+
+    async def session(
+        self,
+        stealth: str = "full",
+        proxy: Optional[str] = None,
+        profile: Optional[str] = None,
+    ) -> "ShadeySession":
+        payload = {"stealth": stealth}
+        if proxy:
+            payload["proxy"] = proxy
+        if profile:
+            payload["profile_name"] = profile
+
+        data = await self._request("POST", "/v1/sessions", json=payload)
+        return ShadeySession(
+            id=data["id"],
+            cdp_url=data["cdp_url"],
+            client=self,
+        )
+
+    async def sessions(self) -> List[dict]:
+        return await self._request("GET", "/v1/sessions")
+
+    async def health(self) -> dict:
+        self._ensure_http()
+        async with self._http.get(f"{self.base_url}/health") as resp:
+            return await resp.json()
+
+    async def usage(self) -> dict:
+        return await self._request("GET", "/v1/usage")
+
+    async def profiles(self) -> list:
+        data = await self._request("GET", "/v1/profiles")
+        return data.get("profiles", [])
+
+    async def delete_profile(self, name: str):
+        await self._request("DELETE", f"/v1/profiles/{name}")
+
+    async def close(self):
+        if self._http:
+            await self._http.close()
+            self._http = None
+
+
+class ShadeyError(Exception):
+    def __init__(self, status: int, message: str):
+        self.status = status
+        self.message = message
+        super().__init__(f"[{status}] {message}")

shadey-0.1.0/shadey/session.py

@@ -0,0 +1,116 @@
+from __future__ import annotations
+from typing import Optional, TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from .client import Shadey
+
+
+class ShadeySession:
+    def __init__(self, id: str, cdp_url: str, client: "Shadey"):
+        self.id = id
+        self.cdp_url = cdp_url
+        self._client = client
+        self._closed = False
+
+    async def close(self, save: bool = False):
+        if not self._closed:
+            path = f"/v1/sessions/{self.id}"
+            if save:
+                path += "?save=true"
+            await self._client._request("DELETE", path)
+            self._closed = True
+
+    async def __aenter__(self):
+        return self
+
+    async def __aexit__(self, *args):
+        await self.close()
+
+    # -- behavioral actions --
+
+    async def click(self, x: float, y: float, width: float = 50.0) -> dict:
+        return await self._behave({
+            "action": "move_and_click",
+            "target_x": x,
+            "target_y": y,
+            "target_width": width,
+        })
+
+    async def type_text(self, text: str, context: str = "form") -> dict:
+        return await self._behave({
+            "action": "type",
+            "text": text,
+            "typing_context": context,
+        })
+
+    async def scroll(self, distance: float) -> dict:
+        return await self._behave({
+            "action": "scroll",
+            "distance": distance,
+        })
+
+    async def dwell(self, context: str = "content") -> dict:
+        return await self._behave({
+            "action": "dwell",
+            "page_context": context,
+        })
+
+    async def idle(self, duration_ms: int = 5000) -> dict:
+        return await self._behave({
+            "action": "idle_browse",
+            "duration_ms": duration_ms,
+        })
+
+    async def _behave(self, payload: dict) -> dict:
+        return await self._client._request(
+            "POST", f"/v1/sessions/{self.id}/behave", json=payload
+        )
+
+    # -- REST actions --
+
+    async def goto(self, url: str, wait_ms: int = 3000) -> dict:
+        return await self._client._request(
+            "POST", f"/v1/sessions/{self.id}/navigate",
+            json={"url": url, "wait_ms": wait_ms},
+        )
+
+    async def screenshot(self) -> str:
+        data = await self._client._request(
+            "POST", f"/v1/sessions/{self.id}/screenshot"
+        )
+        return data["data"]
+
+    async def extract(self, selector: str, attribute: str = "textContent", all: bool = False) -> dict:
+        return await self._client._request(
+            "POST", f"/v1/sessions/{self.id}/extract",
+            json={"selector": selector, "attribute": attribute, "all": all},
+        )
+
+    async def evaluate(self, expression: str) -> dict:
+        return await self._client._request(
+            "POST", f"/v1/sessions/{self.id}/evaluate",
+            json={"expression": expression},
+        )
+
+    async def content(self) -> dict:
+        return await self._client._request(
+            "POST", f"/v1/sessions/{self.id}/content"
+        )
+
+    # -- CDP access --
+
+    @property
+    def playwright_url(self) -> str:
+        return self.cdp_url
+
+    @property
+    def puppeteer_url(self) -> str:
+        return self.cdp_url
+
+    @property
+    def is_active(self) -> bool:
+        return not self._closed
+
+    def __repr__(self):
+        status = "active" if not self._closed else "closed"
+        return f"ShadeySession(id={self.id!r}, status={status!r})"

shadey-0.1.0/shadey.egg-info/PKG-INFO

@@ -0,0 +1,165 @@
+Metadata-Version: 2.4
+Name: shadey
+Version: 0.1.0
+Summary: Stealth browser sessions for AI agents
+Home-page: https://shadey.dev
+Author: Shadey
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: aiohttp>=3.8
+Provides-Extra: playwright
+Requires-Dist: playwright>=1.40; extra == "playwright"
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# shadey
+
+Stealth browser sessions for AI agents. Pass Cloudflare, DataDome, PerimeterX, and Kasada from any IP.
+
+## Install
+
+```bash
+pip install shadey
+```
+
+## Quick Start
+
+```python
+import asyncio
+from shadey import Shadey
+
+async def main():
+    async with Shadey("sk_your_api_key") as client:
+        async with await client.session() as session:
+            # Navigate and extract — no CDP/Playwright needed
+            await session.goto("https://example.com")
+            title = await session.evaluate("document.title")
+            print(title["result"])
+
+            # Extract text from elements
+            headings = await session.extract("h1", all=True)
+            print(headings["data"])
+
+            # Get full page HTML
+            page = await session.content()
+            print(f"{page['length']} bytes")
+
+            # Screenshot
+            img = await session.screenshot()  # base64 jpeg
+
+asyncio.run(main())
+```
+
+## With Behavioral Actions
+
+```python
+async with Shadey("sk_your_api_key") as client:
+    async with await client.session() as session:
+        await session.goto("https://nowsecure.nl")
+
+        # Human-like interactions to build trust
+        await session.idle(duration_ms=3000)
+        await session.scroll(400)
+        await session.click(500, 300)
+        await session.type_text("hello world", context="search")
+
+        # Then extract what you need
+        result = await session.extract(".result-title", all=True)
+```
+
+## With Playwright (CDP)
+
+```python
+async with Shadey("sk_your_api_key") as client:
+    async with await client.session() as session:
+        # Full browser control via CDP
+        from playwright.async_api import async_playwright
+        async with async_playwright() as p:
+            browser = await p.chromium.connect_over_cdp(session.playwright_url)
+            page = browser.contexts[0].pages[0]
+            await page.goto("https://nowsecure.nl")
+            print(await page.title())
+```
+
+## API
+
+### `Shadey(api_key, base_url="https://api.shadey.dev")`
+
+Create a client. Use as async context manager or call `.close()` manually.
+
+### `client.session(stealth="full", proxy=None, profile=None)`
+
+Create a stealth browser session. Returns a `ShadeySession`.
+
+### REST Actions
+
+### `session.goto(url, wait_ms=3000)`
+
+Navigate to a URL. Waits for page load + extra `wait_ms`.
+
+### `session.screenshot()`
+
+Returns a base64 JPEG data URI of the current page.
+
+### `session.extract(selector, attribute="textContent", all=False)`
+
+Extract data from the page. Set `all=True` to get all matching elements.
+
+### `session.evaluate(expression)`
+
+Run JavaScript and return the result.
+
+### `session.content()`
+
+Get the full page HTML.
+
+### Behavioral Actions
+
+### `session.click(x, y, width=50)`
+
+Move mouse and click at coordinates with Fitts' law timing and corrective submovements.
+
+### `session.type_text(text, context="form")`
+
+Type text with QWERTY bigram-modeled keystroke timing. Context: `"form"`, `"search"`, `"url"`.
+
+### `session.scroll(distance)`
+
+Scroll with momentum and inertia. Positive = down, negative = up.
+
+### `session.dwell(context="content")`
+
+Wait a human-realistic amount of time. Context: `"content"`, `"search"`, `"form"`.
+
+### `session.idle(duration_ms=5000)`
+
+Simulate idle browsing — mouse movements, scrolls, pauses driven by HMM behavioral model.
+
+### CDP Access
+
+### `session.playwright_url` / `session.puppeteer_url`
+
+CDP WebSocket URL for direct browser control.
+
+### `session.close()`
+
+Destroy the session.
+
+### `client.usage()`
+
+Get plan usage stats.
+
+### `client.health()`
+
+Check API health.

shadey-0.1.0/shadey.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+setup.py
+shadey/__init__.py
+shadey/client.py
+shadey/session.py
+shadey.egg-info/PKG-INFO
+shadey.egg-info/SOURCES.txt
+shadey.egg-info/dependency_links.txt
+shadey.egg-info/requires.txt
+shadey.egg-info/top_level.txt

shadey-0.1.0/shadey.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

shadey-0.1.0/shadey.egg-info/requires.txt

@@ -0,0 +1,4 @@
+aiohttp>=3.8
+
+[playwright]
+playwright>=1.40

shadey-0.1.0/shadey.egg-info/top_level.txt

@@ -0,0 +1 @@
+shadey