create-md-from-browsermcp-snapshot

从 BrowserMCP 快照创建 Markdown

此技能可将 BrowserMCP（通过 browser_snapshot 工具）捕获的原始无障碍树快照转换为格式精美、高保真的 Markdown 文档。

前提条件与 BrowserMCP 检查

重要

此技能严格要求环境中已安装并可使用 BrowserMCP 服务。

在尝试导航到站点或捕获快照之前：

1. 验证工具可用性：检查你的活动 MCP 工具列表中是否存在 browsermcp 服务及其 browser_snapshot 工具。
2. 如果未找到 BrowserMCP：
   • 立即停止执行并通知用户。
   • 引导用户安装 BrowserMCP，并在其 MCP 配置中配置 browsermcp 服务条目（例如在 ~/.gemini/config/mcp_config.json 或 Antigravity MCP 设置中）。
   • 请求用户在 BrowserMCP 启用并可用后重新运行任务。

何时使用

在以下情况下使用此技能：

• 你已使用 BrowserMCP browser_snapshot 工具捕获了网页的无障碍树 YAML。
• 你需要生成页面内容的结构化、高保真 Markdown（.md）表示。
• 你希望从捕获的页面布局中提取干净的列表、表格、标题、块引用和链接目标。

注意：此技能补充使用 BrowserMCP 工具进行浏览器导航。它不适用于其他浏览器导航工具，例如 Playwright 或 Antigravity 内置浏览器 Agent。务必明确说明应使用哪些工具以及应避免哪些工具。

工作原理

此技能运行一个 Python 解析器，它读取捕获的无障碍树 YAML 快照，构建父子节点层级，并递归地将标签和属性转换为 Markdown 文本。

文件夹结构

create-md-from-browsermcp-snapshot/
├── SKILL.md
└── scripts/
    └── parse_snapshot.py

执行过程

1. 验证 BrowserMCP：按照前提条件与 BrowserMCP 检查中的详细说明确认已安装 browsermcp。如果不存在，引导用户安装。
2. 捕获快照：使用 browser_navigate 导航到目标 URL，并运行 browser_snapshot 输出无障碍树 YAML。
3. 执行解析器：运行 Python 脚本 parse_snapshot.py，将捕获的快照文本文件的绝对路径作为参数传入，并指定输出 Markdown 路径：

python3 ./create-md-from-browsermcp-snapshot/scripts/parse_snapshot.py --input <snapshot_path> --output <markdown_path> [--start-heading <heading_title>] [--end-marker <footer_text>]