SuperAPI AI 工具集

moli-cdp-server

测试与质量

查看项目

更新于 10-15 23:59

技能介绍

用途:启动一个 Moli CDP 服务端,并把指定的 CDP 客户端连接到其端点;在 Moli 支持范围内保留客户端原有 API,用远程端点替代本地 Chromium 进程。

主要能力:提供无头浏览器的 CDP 端点,支持 Playwright、Puppeteer 及原始 CDP 客户端接入;默认监听回环地址 http://127.0.0.1:9222;可用 --layout 支持真实元素几何、坐标输入、截图、PDF、录屏;用 --resource 启用全部可选视觉/媒体资源;用 --profile-dir 持久化状态;并行隔离运行可用不同端口。

使用方式:先解析 PATH 中的 moli,若不可用则安装最新预构建版本。Linux/macOS:curl --proto '=https' --tlsv1.2 -fsSL https://github.com/lexmount/moli/releases/latest/download/moli-installer.sh | sh;Windows:powershell -ExecutionPolicy ByPass -c "irm https://github.com/lexmount/moli/releases/latest/download/moli-installer.ps1 | iex"。默认安装位置为 Linux/macOS 的 ~/.local/bin/moli,Windows 的 %LOCALAPPDATA%\Moli\bin\moli.exe。随后运行 moli --version,执行 moli serve 启动服务端,连接前先探测 /json/version,再用客户端的 remote/attach API 连接(如 Playwright 的 chromium.connectOverCDP("http://127.0.0.1:9222")),不要另起一个内置浏览器;结束时先干净关闭 CDP 客户端,若由本方管理再停止 Moli 服务端。

适用场景:需要无头浏览器 CDP 端点、替换 Chromium 进程、或让现有 CDP 客户端接入远程浏览器的工作流。

限制:默认只绑定 127.0.0.1,仅在用户明确需要远程访问且已处理网络访问控制时才暴露其他主机;应把 Moli 视为远程端点,避免使用依赖本地 Chromium 可执行文件的 Chrome 启动参数与假设;CDP 覆盖为部分而非完整 Chrome 协议一致,遇到不支持应保留明确的报错;代理、Cookie、资源、user-agent 和私网策略应传给 Moli 服务端,而非不存在的子浏览器进程。CDP 发现 URL、服务端选项、客户端选择和连接排错详见 references/protocols.md。收费、价格等信息暂未提供。