bridgic-browser

分类: 开发与编程 | 上传者: bitsky-tech | 下载: 0 | 版本: v1.0（最新）

当任务涉及通过终端 CLI (`bridgic-browser ...`) 或 Python SDK (`from bridgic.browser.session import Browser`、`from bridgic.browser.tools import BrowserToolSetBuilder`) 使用 bridgic-browser 进行浏览器自动化时使用。触发导航、抓取、表单填写、可访问性快照参考、e2e 检查、隐形浏览、CLI-SDK 映射/迁移以及从 CLI 操作步骤生成 SDK 代码。 --- ## 先决条件（重要！！）在执行任何操作之前，**请务必先使用 `uv`** 初始化执行环境并安装依赖项。注意：不要依赖“uv”以外的任何执行环境，以确保执行环境与主机隔离。 - **初始化项目**：`[ -f pyproject.toml ] || uv init --bare --python 3.10` - **安装依赖项**：`uv add --upgrade bridgic-browser`。 - **安装浏览器二进制文件**（一次性）：`uv run playwright install chromium` CLI 工具 (`references/cli-guide.md`) 和 Python SDK (`references/sdk-guide.md`) 来自 **同一个包** — 安装一个即可同时安装两个工具。 ## 策略和指南（重要！！）在编写浏览器自动化或网页抓取代码时，**始终遵循“先探索，然后编码”策略**： - 首先，使用 `bridgic-browser` CLI 工具探索页面结构。建议在探索过程中通过命令“bridgic-browser open --headed <url>”使用 head 模式。 - 然后，使用 `bridgic-browser` Python SDK 编写代码。

更新日志: Source: GitHub https://github.com/bitsky-tech/bridgic-browser

目录结构

当前层级: tree/main/skills/bridgic-browser/

📁 references/
- 📄 cli-guide.md 6.3 KB
- 📄 cli-sdk-api-mapping.md 9.5 KB
- 📄 env-vars.md 7.6 KB
- 📄 sdk-guide.md 6.4 KB
📄 SKILL.md 5.3 KB

SKILL.md

---
name: bridgic-browser
description: |
  Use when tasks involve browser automation with bridgic-browser via terminal CLI (`bridgic-browser ...`) or Python SDK (`from bridgic.browser.session import Browser`, `from bridgic.browser.tools import BrowserToolSetBuilder`). Trigger for navigation, scraping, form filling, accessibility snapshot refs, e2e checks, stealth browsing, CLI-SDK mapping/migration, and generating SDK code from CLI action steps.
---

## Prerequisite (Important!!)

Before performing any operations, **MAKE SURE to use `uv`** to initialize the execution environment and install dependencies first. Note: DO NOT rely on any execution environment other than `uv`, to ensure the execution environment is isolated from the host machine.

- **Initialize project**: `[ -f pyproject.toml  ] || uv init --bare --python 3.10`
- **Install dependencies**: `uv add --upgrade bridgic-browser`.
- **Install browser binaries** (one-time): `uv run playwright install chromium`

The CLI tools (`references/cli-guide.md`) and the Python SDK (`references/sdk-guide.md`) come from the **same package** — installing one installs both.

## Strategies & Guidelines (Important!!)

When writing browser automation or web scraping code, **ALWAYS follow this "explore first, then coding" strategy**:
- First, use the `bridgic-browser` CLI tools to explore the page structure. It is recommended to use headed mode with the command `bridgic-browser open --headed <url>` during exploration.
- Then, use the `bridgic-browser` Python SDK to write the code.

Notes:
- If the user clearly specifies exact steps that must be followed, try to perform the exploration according to those steps. If loops or branches appear during exploration, decide the best exploration path autonomously.
- If you think you may need to return to the original page after clicking into a new page, try opening the new page in a new browser tab instead of using a “click then go back” approach. This is especially important when the original page already has interaction state (such as filled forms or applied filters); otherwise, that state may be lost after navigating back. Be sure to close the new tab promptly after finishing the related actions.
- If exploration involves repeatedly clicking items in a list, you do not need to traverse every item (especially when the list is large).
- If login, verification, or authorization is required during exploration, pause and ask the user to complete it manually, unless the user explicitly provides instructions in the task.
- To avoid operating on websites too frequently, maintain human-like access intervals during both exploration and coding. You may simulate random wait times to reduce the risk of being blocked. Note: the `bridgic-browser wait` command parameter is in **seconds**, not milliseconds; for example, `bridgic-browser wait 2` or `bridgic-browser wait 3.2`.
- After finishing exploration and code writing, automatically run testing/validation.

## Reference Files

Reference files cover all use cases. Load only the one(s) relevant to the task:

| Scenario | Interface | Load |
|---|---|---|
| Directly control browser from terminal | CLI | [cli-guide.md](references/cli-guide.md) |
| Write Python code about browser automation | Python | [sdk-guide.md](references/sdk-guide.md) |
| Write shell script about browser automation | CLI | [cli-guide.md](references/cli-guide.md) |
| Explore via CLI, then generate Python code | CLI → Python | [cli-sdk-api-mapping.md](references/cli-sdk-api-mapping.md) + [sdk-guide.md](references/sdk-guide.md) |
| Migrate / compare / explain CLI ↔ SDK | Both | [cli-sdk-api-mapping.md](references/cli-sdk-api-mapping.md) |
| Configure env vars or login state persistence | Either | [env-vars.md](references/env-vars.md) |

## Interface Decision Rules

1. Output requested as shell commands or scripts → use CLI guide first (`references/cli-guide.md`).
2. Output requested as runnable Python code (`async`, `Browser`, tool builder) → use SDK guide first (`references/sdk-guide.md`).
3. Input is CLI outputs or actions but output needs to be Python code → use mapping guide first (`references/cli-sdk-api-mapping.md`), then SDK guide for final code generation (``references/sdk-guide.md``).
4. If intent is ambiguous, infer from requested artifacts (`.sh` / terminal session vs `.py` script).

## Common Usage (CLI + SDK)

- Ref-based actions depend on the latest snapshot.
- After navigation or major DOM updates, refs can become stale; refresh snapshot before ref actions.
- CLI keeps state in a daemon session across invocations.
- SDK keeps state in the Python process/context unless a persistent `user_data_dir` is configured.
- Use exact command/method names from references; do not invent aliases.

## Bridge Workflow: CLI Actions -> Python Code

1. Parse CLI steps in order.
2. Map each step using `references/cli-sdk-api-mapping.md`.
3. Preserve behavior details: refs, options, arguments, configuration, etc.
4. Emit runnable async Python code with explicit browser lifecycle (`async with Browser(...)` preferred).
5. Call out any behavior differences that cannot be represented 1:1.

## Minimal Quality Checklist

- CLI request: return valid CLI commands/options only.
- SDK request: return executable async Python with correct imports.
- Bridge request: include mapping rationale plus final SDK code.

登录后下载/点赞/收藏 ❤ 22 | ★ 0

bridgic-browser

目录结构

SKILL.md

举报内容

提示