martinkeith700/ruyiJS

选用指南

AI 根据 README 整理 · 2026/10/27 01:12:23

适用场景

适用于需要执行网站 JavaScript、绕过反爬验证、采集动态数据的场景，例如爬取需要签名或挑战的网站。

查看 README 依据

- **Truly headless.** No window, no layout, no renderer. A pure JavaScript + Web API environment that starts fast and stays light. - **Isolated and reproducible.** Each `Context` is its own process with a persistent JavaScript world and its own proxy, so sessions never leak into each other. - **Offline when you need it.** Serve scripts and responses yourself and replay a whole captured flow with no network. If you scrape, reverse-engineer web JavaScript, or collect data behind a challenge, it's for you. If a plain HTTP client already gets your pages, you don't need it.

| **瑞数 Ruishu 5/6** | Dynamic VM / page protection | `fangdi` · `cebwm` | | **极验 Geetest** | Slider / one-click | `geetest` | | **腾讯天御 Tencent Captcha** | No-feel + slider | `tianyu` | | **数美 Shumei** | Slider | `shumei` | | **网易易盾 NetEase Yidun** | Smart check | `yidun` | | **Arkose Labs + iovation** | Enterprise risk / device | `expedia-taap` | | **CreepJS** | Fingerprint audit — passes every section | `creepjs` | Full production data-collection flows: **BOSS 直聘**, **今日头条 Toutiao**, **抖音 Douyin**, **小红书 RedNote**, **Google**, **Expedia TAAP**.

使用方式

通过 Python 库使用，提供 Context 对象执行 JavaScript、加载页面、配置指纹、网络代理等。

查看 README 依据

Runs on **Windows x64** with **Python 3.10+** (verified on Python 3.14). The wheel bundles the pinned native runtime, so there's nothing else to download. ## 🚀 Quick start **1 · Install.** ```sh python -m pip install ruyijs ``` _{The wheel ships the SHA256-pinned SpiderMonkey + Necko runtime; local scripts run offline right after install. No browser download.} **2 · Open a context and run JavaScript.** Variables and functions persist across `eval` calls within the same context. ```python from ruyijs import Context with Context() as context: context.eval("let count = 40")

print(context.eval("count += 2")) # 42 print(context.eval("navigator.userAgent")) ``` **3 · Point it at a real target.** Configure the environment, load the page, and let the site's own JavaScript mint whatever token it demands. ```python with Context(proxy="http://127.0.0.1:7890") as context: context.configure_fingerprint({ "navigator": {"language": "zh-CN", "hardwareConcurrency": 8}, "locale": {"timezone": "Asia/Shanghai"}, }) context.load_page("https://target.example/", html)

Execute scripts in a persistent context, load real HTML with iframes and classic scripts, and query the resulting DOM. References to live JS objects come back as `JSObject` / `JSFunction` you can call from Python. | Capability | How | | :-- | :-- | | Execute JS, keep state | `context.eval(src)` — variables and functions persist | | Get a callable back | `context.eval(src, to_py=False)` → `JSFunction` | | Load a page | `context.load_page(url, html)` — relative URLs resolve against `url` | | Top-level navigation | `context.navigate(url)` — no Referer, `Sec-Fetch-Site: none` |

部署要求

需要 Windows x64 和 Python 3.10 或更高版本，安装时无需额外下载浏览器。

查看 README 依据

Runs on **Windows x64** with **Python 3.10+** (verified on Python 3.14). The wheel bundles the pinned native runtime, so there's nothing else to download. ## 🚀 Quick start **1 · Install.** ```sh python -m pip install ruyijs ``` _{The wheel ships the SHA256-pinned SpiderMonkey + Necko runtime; local scripts run offline right after install. No browser download.} **2 · Open a context and run JavaScript.** Variables and functions persist across `eval` calls within the same context. ```python from ruyijs import Context with Context() as context: context.eval("let count = 40")

已知限制

仅支持 Windows x64，没有浏览器窗口和完整页面布局渲染，仅用于自动化、分析和研究。

查看 README 依据

ruyiJS provides JavaScript execution and a broad Web API environment on **Windows x64**. It has **no browser window and no full page layout or rendering** — it is a tool for automation, analysis, and research. Use it in compliance with the terms of service of any site you interact with and with applicable law. **Related:** [**ruyiHttp**](https://gitee.com/losenine888/ruyiHttp) — a Requests-style Python HTTP library built on Firefox's native networking components. ## 💬 Contact