mooncat-browser-client 0.4.7__tar.gz

mooncat_browser_client-0.4.7/PKG-INFO

@@ -0,0 +1,70 @@
+Metadata-Version: 2.4
+Name: mooncat-browser-client
+Version: 0.4.7
+Summary: Python client for the local MoonCat browser daemon
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/NINTING/mooncat-browser
+Project-URL: Repository, https://github.com/NINTING/mooncat-browser
+Project-URL: Issues, https://github.com/NINTING/mooncat-browser/issues
+Keywords: browser,automation,mooncat,browserd
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: httpx<1,>=0.27.0
+Requires-Dist: markdownify<2,>=0.13.0
+
+# MoonCat Browser Python Client
+
+这是 MoonCat 本地浏览器服务 `browserd` 的 Python 客户端。复杂的浏览器逻辑运行在
+统一后端中，Python 包只负责调用服务接口。
+
+## 安装
+
+```powershell
+pip install mooncat-browser-client
+```
+
+先启动 MoonCat 本地浏览器服务，再运行 Python：
+
+```python
+from browser import Browser
+
+browser = Browser()
+browser.open()
+tab = browser.new_tab("https://example.com")
+print(browser.inner_text(tab, "body"))
+```
+
+`new_tab()` 返回包含 `pageHandle` 的标签信息。为方便使用，`operate()`、`click()`、
+`fill()` 等方法既接受完整标签信息，也接受其中的 `pageHandle`。
+
+## 服务地址
+
+默认连接 `http://127.0.0.1:17322`。可直接指定外部服务端口：
+
+```python
+browser = Browser(host="192.168.1.20", port=17322)
+```
+
+也可使用完整地址：
+
+```python
+browser = Browser(base_url="http://192.168.1.20:17322")
+```
+
+支持环境变量：
+
+- `MOONCAT_BROWSERD_BASE_URL`
+- `MOONCAT_BROWSERD_HOST`
+- `MOONCAT_BROWSERD_PORT`
+
+## 后端接口
+
+客户端提供浏览器打开/关闭、标签页、通用页面操作、Cookie、下载任务和自动下载设置接口。
+页面动作统一通过 `operate()` 发送给 browserd，Python 侧不重复实现浏览器逻辑。

mooncat_browser_client-0.4.7/README.md

@@ -0,0 +1,49 @@
+# MoonCat Browser Python Client
+
+这是 MoonCat 本地浏览器服务 `browserd` 的 Python 客户端。复杂的浏览器逻辑运行在
+统一后端中，Python 包只负责调用服务接口。
+
+## 安装
+
+```powershell
+pip install mooncat-browser-client
+```
+
+先启动 MoonCat 本地浏览器服务，再运行 Python：
+
+```python
+from browser import Browser
+
+browser = Browser()
+browser.open()
+tab = browser.new_tab("https://example.com")
+print(browser.inner_text(tab, "body"))
+```
+
+`new_tab()` 返回包含 `pageHandle` 的标签信息。为方便使用，`operate()`、`click()`、
+`fill()` 等方法既接受完整标签信息，也接受其中的 `pageHandle`。
+
+## 服务地址
+
+默认连接 `http://127.0.0.1:17322`。可直接指定外部服务端口：
+
+```python
+browser = Browser(host="192.168.1.20", port=17322)
+```
+
+也可使用完整地址：
+
+```python
+browser = Browser(base_url="http://192.168.1.20:17322")
+```
+
+支持环境变量：
+
+- `MOONCAT_BROWSERD_BASE_URL`
+- `MOONCAT_BROWSERD_HOST`
+- `MOONCAT_BROWSERD_PORT`
+
+## 后端接口
+
+客户端提供浏览器打开/关闭、标签页、通用页面操作、Cookie、下载任务和自动下载设置接口。
+页面动作统一通过 `operate()` 发送给 browserd，Python 侧不重复实现浏览器逻辑。

mooncat_browser_client-0.4.7/behavior.py

@@ -0,0 +1,138 @@
+"""web/behavior — 人类行为模拟 (路由无关, 全走 operate).
+
+忠实复刻 lib/web/behavior.js。
+贝塞尔鼠标轨迹 / 随机点击偏移 / 打字节奏 / 平滑滚动。
+所有页面动作统一走 operate(pageHandle, {action})，本模块只编排动作序列。
+
+依赖: browser (operate)
+"""
+from __future__ import annotations
+import math
+import random
+import time
+from typing import Any
+
+import sys
+sys.path.insert(0, __file__.rsplit("\\", 1)[0] if "\\" in __file__ else __file__.rsplit("/", 1)[0])
+from browser import operate  # noqa: E402
+
+
+def _bezier(p0: float, p1: float, p2: float, p3: float, t: float) -> float:
+    u = 1 - t
+    return u * u * u * p0 + 3 * u * u * t * p1 + 3 * u * t * t * p2 + t * t * t * p3
+
+
+def _trajectory(from_pt: dict, to_pt: dict, steps: int) -> list[dict]:
+    """生成贝塞尔轨迹点 (含随机抖动)."""
+    pts = []
+    mx = (from_pt["x"] + to_pt["x"]) / 2 + (random.random() - 0.5) * abs(to_pt["x"] - from_pt["x"]) * 0.6
+    my = (from_pt["y"] + to_pt["y"]) / 2 + (random.random() - 0.5) * abs(to_pt["y"] - from_pt["y"]) * 0.6
+    c1 = {"x": from_pt["x"] + (mx - from_pt["x"]) * 0.3, "y": from_pt["y"] + (my - from_pt["y"]) * 0.3}
+    c2 = {"x": to_pt["x"] + (mx - to_pt["x"]) * 0.3, "y": to_pt["y"] + (my - to_pt["y"]) * 0.3}
+    for i in range(steps + 1):
+        t = i / steps
+        pts.append({
+            "x": _bezier(from_pt["x"], c1["x"], c2["x"], to_pt["x"], t) + (random.random() - 0.5) * 2,
+            "y": _bezier(from_pt["y"], c1["y"], c2["y"], to_pt["y"], t) + (random.random() - 0.5) * 2,
+        })
+    return pts
+
+
+def _random_point_in_rect(rect: dict) -> dict:
+    return {
+        "x": rect["x"] + rect["width"] * (0.3 + random.random() * 0.4),
+        "y": rect["y"] + rect["height"] * (0.3 + random.random() * 0.4),
+    }
+
+
+def _move_trajectory(page_handle: dict, from_pt: dict, to_pt: dict) -> None:
+    """沿贝塞尔轨迹多点 mouseMove 注入."""
+    pts = _trajectory(from_pt, to_pt, 10 + random.randint(0, 5))
+    for pt in pts:
+        operate(page_handle, {"action": "mouseMove", "x": pt["x"], "y": pt["y"]})
+        time.sleep(0.008 + random.random() * 0.016)
+
+
+def create_behavior(page_handle: dict) -> dict:
+    """创建绑定到 pageHandle 的行为模拟器.
+
+    返回: move_to, click, click_element, type_text, type_in_element, scroll_down, scroll_to_bottom, scroll_to_element
+    """
+    if not page_handle:
+        raise ValueError("create_behavior: page_handle required")
+    last_pos = {"x": 100, "y": 100}
+
+    def move_to(x: float, y: float) -> None:
+        nonlocal last_pos
+        _move_trajectory(page_handle, last_pos, {"x": x, "y": y})
+        last_pos = {"x": x, "y": y}
+
+    def click(x: float, y: float, options: dict | None = None) -> None:
+        nonlocal last_pos
+        _move_trajectory(page_handle, last_pos, {"x": x, "y": y})
+        last_pos = {"x": x, "y": y}
+        time.sleep(0.05 + random.random() * 0.1)
+        operate(page_handle, {"action": "click", "x": x, "y": y})
+        delay = (options or {}).get("delay", 0.05 + random.random() * 0.1)
+        time.sleep(delay)
+
+    def click_element(selector: str, timeout: int = 10000) -> None:
+        nonlocal last_pos
+        operate(page_handle, {"action": "waitForSelector", "selector": selector, "timeout": timeout})
+        box_r = operate(page_handle, {"action": "boundingBox", "selector": selector})
+        box = None
+        if isinstance(box_r, dict) and box_r.get("width") is not None:
+            box = box_r
+        if not box:
+            operate(page_handle, {"action": "click", "selector": selector})
+            time.sleep(0.05 + random.random() * 0.1)
+            return
+        pt = _random_point_in_rect(box)
+        move_to(pt["x"], pt["y"])
+        time.sleep(0.05 + random.random() * 0.1)
+        operate(page_handle, {"action": "click", "x": pt["x"], "y": pt["y"]})
+        time.sleep(0.05 + random.random() * 0.1)
+
+    def type_text(text: str, delay: float = 0.1) -> None:
+        for ch in text:
+            operate(page_handle, {"action": "press", "selector": "body", "key": ch})
+            d = delay * (0.5 + random.random())
+            if random.random() < 0.1:
+                d += 0.2 + random.random() * 0.4
+            time.sleep(d)
+
+    def type_in_element(selector: str, text: str, options: dict | None = None) -> None:
+        opts = options or {}
+        delay = opts.get("delay", 0.1)
+        timeout = opts.get("timeout", 10000)
+        operate(page_handle, {"action": "waitForSelector", "selector": selector, "timeout": timeout})
+        operate(page_handle, {"action": "click", "selector": selector})
+        operate(page_handle, {"action": "type", "selector": selector, "value": text, "delay": delay})
+
+    def scroll_down(pixels: int = 400) -> None:
+        step = 30 + random.randint(0, 29)
+        operate(page_handle, {
+            "action": "evaluate",
+            "source": f"(p) => new Promise((r) => {{ let done = 0; const t = setInterval(() => {{ window.scrollBy(0, {step}); done += {step}; if (done >= p) {{ clearInterval(t); r() }} }}, 30 + Math.random() * 30) }})",
+            "args": pixels
+        })
+
+    def scroll_to_bottom() -> None:
+        operate(page_handle, {
+            "action": "evaluate",
+            "source": "() => new Promise((resolve) => { let last=-1; const t=setInterval(()=>{ window.scrollBy(0,100+Math.random()*100); const h=document.body.scrollHeight; if(h===last){clearInterval(t);resolve()} last=h }, 150) })"
+        })
+
+    def scroll_to_element(selector: str, timeout: int = 10000) -> None:
+        operate(page_handle, {
+            "action": "evaluate",
+            "source": f'(s) => {{ const el = document.querySelector(s); if (el) el.scrollIntoView({{ behavior: "smooth", block: "center" }}) }}',
+            "args": selector
+        })
+
+    return {
+        "move_to": move_to, "click": click, "click_element": click_element,
+        "type_text": type_text, "type_in_element": type_in_element,
+        "scroll_down": scroll_down, "scroll_to_bottom": scroll_to_bottom,
+        "scroll_to_element": scroll_to_element,
+    }