Python SDK
Python 示例
按浏览器任务选择可运行的 Python quickstart 脚本。
持续维护的脚本位于 Python quickstart 仓库。需要运行示例时请 clone 该仓库；本页只提供导航，不再复制每个脚本的实现。
准备环境
git clone https://github.com/lexmount/lexmount-python-sdk-quickstart.git
cd lexmount-python-sdk-quickstart
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
playwright install chromium
cp .env.example .env运行脚本前，在 .env 中填写 LEXMOUNT_API_KEY 和 LEXMOUNT_PROJECT_ID。
Browser Agent
使用 SDK 0.7.0，并选择已启用 Browser Agent 的项目。配置、幂等键和结果处理见 Browser Agent 指南。
| 命令 | 用途 |
|---|---|
python browser_agent.py | 同步 Run |
python browser_agent_async.py | 异步 Run |
python browser_agent_advanced.py | 已保存 Agent 与结构化输出 |
python browser_agent_recovery.py | 恢复已有请求 |
保存 Run ID 和幂等键；恢复查询无需创建替代 Run。
从这里开始
| 脚本 | 用途 |
|---|---|
demo.py | 最小 Chromium session、Playwright 连接、导航和截图 |
light_demo.py | Moli（light）session 与 LightMount resource 开关 |
inspect_url_demo.py | 输出 View URL，并保持 session 供人工观察 |
session_list.py | 带分页查询 active 和历史 session |
session_targets.py | 查询页面 target、View URL 和 websocket URL |
session_downloads.py | 触发、查询、获取、归档和清理存储下载文件 |
运行：
python3 demo.py
python3 light_demo.py
python3 inspect_url_demo.py持久化状态与扩展
| 脚本 | 用途 |
|---|---|
context_basic.py | 创建带描述的 context，并用于 read-write session |
context_list_get.py | 查询 context 的展示名称、描述和状态 |
context_fork.py | 把 available context fork 为新 context |
extension_basic.py | 上传、列出并挂载扩展 |
extension_list_get.py | 查询扩展列表/详情，并可选执行上传和删除 |
网络、区域与连接
| 脚本 | 用途 |
|---|---|
catalog_info.py | 查看公开区域与 endpoint 目录 |
connection_demo.py | 构造并使用 /connection 直连 websocket URL |
proxy_demo.py | 使用带认证的自定义上游代理 |
official_proxy_demo.py | 使用 Lexmount 官方代理池 |
运行形态与诊断
| 脚本 | 用途 |
|---|---|
custom_image_demo.py | 启动允许使用的 custom browser image |
window_size_demo.py | 设置初始浏览器尺寸 |
wpt_demo.py | 在一个或多个 session 中运行 Web Platform Tests 路径 |
cpu_load_demo.py | 生成受控的多页面浏览器负载用于诊断 |
Custom image、代理、context 和扩展示例需要项目具备对应能力。
安全清理
自己的脚本应优先使用 SDK context manager：
from lexmount import Lexmount
with Lexmount() as client:
with client.sessions.create() as session:
# Browser work
...失败后再次运行示例前，先检查控制台 session 列表。异步创建可能在客户端看到超时前就已经预留 session。
本地网络代理示例
安装上面的示例仓库后，在能访问目标站点的电脑上运行：
python3 local_proxy_demo.py --url 'https://your-internal-site.example/'使用 --region 或 .env 的 LEXMOUNT_REGION 指定区域；导航后按任意键退出并清理。先确认项目有 custom_proxy 权限。SDK 版本、隧道与会话配置见 本地代理指南。