Lightpanda 是用于网页自动化和数据提取的无头浏览器。它执行 JavaScript、维护 DOM，让程序读取动态页面或操作表单。本文从 项目仓库 与官方使用文档整理本地接入步骤，资料检查日期为 2026 年 10 月 15 日；没有把文档示例当成本次运行记录。
先确定运行环境和版本
项目已在 2026 年 10 月 2 日发布 Lightpanda 1.0。安装资料同时提供稳定版与 nightly 构建；调试和部署时要保存版本信息，避免把不同构建的行为混在一起。Linux、macOS 有 x86_64 和 arm64 二进制，Windows 可以进入 WSL2 后使用 Linux 版本。项目没有提供原生 Windows exe。
Linux 二进制使用 glibc。选取与系统架构匹配的文件后，按照 安装文档 设置执行权限，再运行 ./lightpanda version。这里的 ./ 表示文件在当前目录；放进 PATH 后可以直接使用 lightpanda 命令。本文示例的外部页面使用项目演示站，不涉及真实登录资料。
先读取一页 Markdown
单页内容可以通过 fetch 获取。这个入口适合先观察正文、链接和动态内容是否齐全，再接入更长的采集任务。开启 robots 检查的示例是：
./lightpanda fetch --obey-robots --dump markdown https://demo-browser.lightpanda.io/campfire-commerce/
拿到文本后，检查页面是否真的加载了所需内容，包括分页、懒加载、语言切换或登录状态。输出有文字不代表采集已经完整，错误页和登录页也可能有正文。Lightpanda 的文本 PNG/PDF 导出同样不能用于检查页面的完整视觉布局。
让 Playwright 连接到本地服务
./lightpanda serve --obey-robots --host 127.0.0.1 --port 9222
在另一个终端使用 playwright-core 客户端，连接 chromium.connectOverCDP('ws://127.0.0.1:9222')，再创建 context 和 page。官方示例 展示了导航、读取标题与关闭页面的顺序。chromium 是客户端 API 名称，不表示服务端下载或运行了 Chromium。
需要 Docker 时，可从官方 lightpanda/browser 镜像启动服务；本机测试可将端口映射限定到 127.0.0.1。先验证页面上的具体字段，再逐步加入等待条件、Cookie 和表单操作。不要仅凭连接成功就认定旧脚本已完成迁移。
MCP 接入时保存会话
stdio 适合由支持 MCP 的客户端直接启动 lightpanda mcp --obey-robots。HTTP 服务可用 lightpanda mcp --host 127.0.0.1 --port 9223 --obey-robots。浏览器服务和 MCP 服务端口应分别配置。
HTTP 客户端在 initialize 后保存 Mcp-Session-Id，并在后续调用中发送该标头。否则请求会进入默认共享会话。官方 MCP 指南 也提供会话管理工具，适合把不同任务的页面、Cookie 和内存分开。
导航工具返回成功并不一定说明目标页面可用：404、500 或超时情形需要继续检查返回的 httpStatus 和实际内容。对于多页任务，还应记录每页的 URL、HTTP 状态、关键字段是否存在，以及失败后的重试结果。
代理模式与 PandaScript
agent 模式让语言模型规划浏览器动作；运行 lightpanda agent --no-llm 可以进入不连接模型的模式。带模型的任务要另外配置服务提供商密钥和调用预算。固定流程可导出为 PandaScript，再通过 lightpanda run session.js 重放。
脚本重放减少重复规划，页面改版、选择器变化或登录过期仍会造成失败。把结果字段和成功条件写清楚，比只保存点击顺序更可靠。公开示例应使用演示数据，不包含 Cookie、密钥或私有页面内容。
云端小时数怎样计算
2026 年 10 月 15 日的 价格页 列出：Explorer 免费，每月 10 浏览器小时、5 个并发会话；Builder 每月 19 美元，含 300 浏览器小时、30 个并发会话，超出部分每小时 0.08 美元。Enterprise 提供定制容量和支持。
“5 并发”是同一时间可打开的会话数，不是 API 请求总量；“10 小时”按所有会话实际打开时长累加。超过并发上限会返回 429。当前 云端限额文档 还列出 CDP 连接最长 15 分钟、MCP 空闲 5 分钟的限制，长任务需要保存中间结果并处理断开。
上线前检查的几件事
用一组经授权的代表性页面检查：动态字段是否完整，失败页能否识别，Cookie 是否隔离，脚本能否重放，以及同样任务下的延迟和内存。官网的性能测试是项目公布的数据，本文没有复跑，也没有把它换算成业务任务的完成率。
本地端口绑定回环地址，保留默认 CORS 检查；按站点许可、robots 规则和频率限制安排请求。遥测默认启用，可设置 LIGHTPANDA_DISABLE_TELEMETRY=true 关闭。源码默认采用 AGPL-3.0-only，本地算力、代理和模型调用成本分别核算。
复制链接，保存或分享这篇文章。
