浏览器会话(免费版)

Polar Sponsor
爱发电 赞助
.NET 9.0

浏览器会话管理免费版,支持一次性页面抓取、基础会话列表与简易调试。

浏览器会话助手(免费版)

功能概述

浏览器会话助手(免费版)是一项面向实际任务的技能,主要用于打开URL、提取信息、返回结果;三步完成单次浏览器会话;

核心要点

  • 无需编写完整自动化脚本,通过简单的fetch命令即可完成单次页面抓取任务;
  • 免费版聚焦轻量场景,让浏览器自动化触手可及;
  • 免费版浏览器会话工具为个人开发者提供基础的浏览器会话管理能力;

使用与执行

通过Docker容器化的Chrome实例,在隔离环境中执行页面操作,保障本地系统安全;免费版能力;单次抓取(fet。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。

结果检查与注意事项

从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。

浏览器会话助手(免费版)

打开URL、提取信息、返回结果。三步完成单次浏览器会话。

无需编写完整自动化脚本,通过简单的fetch命令即可完成单次页面抓取任务。免费版聚焦轻量场景,让浏览器自动化触手可及。

概述

免费版浏览器会话工具为个人开发者提供基础的浏览器会话管理能力。通过Docker容器化的Chrome实例,在隔离环境中执行页面操作,保障本地系统安全。

核心定位

维度 免费版能力
单次抓取(fetch) 支持
定时任务(recurring) 不支持(需专业版)
会话持久化 不支持(需专业版)
Webhook通知 不支持(需专业版)
批量会话管理 不支持(需专业版)
基础元素交互 支持(click/fill/snapshot)
Docker容器隔离 支持
调试模式 支持(基础)

核心能力

1. 单次页面抓取(fetch模式)

import subprocess
import json

class BsessionFetcher:
    """浏览器会话抓取器(免费版)"""

    def __init__(self, container_name="agent-browser"):
        self.container = container_name

    def check_container(self):
        """检查容器是否运行"""
        try:
            result = subprocess.run(
                ["docker", "exec", self.container, "echo", "ok"],
                capture_output=True, text=True, timeout=5
            )
            return result.returncode == 0
        except Exception:
            return False

    def find_free_port(self, start=9222, max_try=10):
        """查找可用的CDP端口"""
        for port in range(start, start + max_try):
            check_cmd = f"docker exec {self.container} python3 -c "import urllib.request; " 
                       f"urllib.request.urlopen('http://localhost:{port}/json/version', timeout=2)""
            result = subprocess.run(check_cmd, shell=True, capture_output=True)
            if result.returncode != 0:
                return port
        return None

    def fetch_url(self, url, wait_seconds=5):
        """抓取单个URL内容"""
        if not self.check_container():
            return {"success": False, "error": "容器未运行,请先执行 setup"}

        port = self.find_free_port()
        if not port:
            return {"success": False, "error": "无可用CDP端口"}

        try:
            # 启动临时Chrome
            subprocess.run(
                ["docker", "exec", self.container, "python3", "-c",
                 f"import sys; sys.path.insert(0, '/app'); "
                 f"from lib.browser import start_chrome; "
                 f"start_chrome({port}, '/workspace/data/profile-tmp')"],
                capture_output=True, text=True, timeout=10
            )

            # 打开URL
            subprocess.run(
                ["docker", "exec", self.container, "agent-browser",
                 "--cdp", str(port), "open", url],
                capture_output=True, text=True, timeout=30
            )

            # 等待加载
            import time
            time.sleep(wait_seconds)

            # 获取页面快照
            result = subprocess.run(
                ["docker", "exec", self.container, "agent-browser",
                 "--cdp", str(port), "snapshot"],
                capture_output=True, text=True, timeout=10
            )

            return {
                "success": True,
                "content": result.stdout,
                "port": port,
                "url": url
            }
        except Exception as e:
            return {"success": False, "error": str(e)}
        finally:
            # 清理临时Chrome
            subprocess.run(
                ["docker", "exec", self.container, "python3", "-c",
                 f"import sys; sys.path.insert(0, '/app'); "
                 f"from lib.browser import stop_chrome; "
                 f"stop_chrome({port})"],
                capture_output=True, text=True, timeout=5
            )

# 示例
fetcher = BsessionFetcher()
result = fetcher.fetch_url("https://example.com", wait_seconds=3)
print(result.get("content", "")[:500] if result.get("success") else result.get("error"))

输入: 用户提供单次页面抓取(fetch模式)所需的指令和必要参数。 处理: 按照skill规范执行单次页面抓取(fetch模式)操作,遵循单一意图原则。 输出: 返回单次页面抓取(fetch模式)的执行结果,包含操作状态和输出数据。

  • 执行此能力时使用input_params参数,支持创建/查询/导出操作

2. 基础元素交互

class BsessionInteraction:
    """基础元素交互(免费版)"""

    def __init__(self, container="agent-browser", port=9222):
        self.container = container
        self.port = port

    def click_element(self, ref):
        """点击元素"""
        cmd = ["docker", "exec", self.container, "agent-browser",
               "--cdp", str(self.port), "click", ref]
        result = subprocess.run(cmd, capture_output=True, text=True)
        return result.returncode == 0

    def fill_field(self, ref, value):
        """填写表单字段"""
        cmd = ["docker", "exec", self.container, "agent-browser",
               "--cdp", str(self.port), "fill", ref, value]
        result = subprocess.run(cmd, capture_output=True, text=True)
        return result.returncode == 0

    def take_snapshot(self):
        """获取页面快照"""
        cmd = ["docker", "exec", self.container, "agent-browser",
               "--cdp", str(self.port), "snapshot"]
        result = subprocess.run(cmd, capture_output=True, text=True)
        return result.stdout if result.returncode == 0 else ""

# 使用示例
interaction = BsessionInteraction(port=9222)
content = interaction.take_snapshot()
# 解析ref后执行交互
# interaction.click_element("ref_button_1")
# interaction.fill_field("ref_input_email", "user@test.com")

输入: 用户提供基础元素交互所需的指令和必要参数。 处理: 按照skill规范执行基础元素交互操作,遵循单一意图原则。 输出: 返回基础元素交互的执行结果,包含操作状态和输出数据。

  • 执行此能力时使用input_params参数,支持创建/查询/导出操作

3. 会话列表查看

class SessionLister:
    """会话列表查看器(免费版)"""

    def list_sessions(self):
        """列出所有会话"""
        try:
            result = subprocess.run(
                ["docker", "exec", "agent-browser", "python3", "-c",
                 "import sys; sys.path.insert(0, '/app'); "
                 "from lib.browser import list_sessions; "
                 "list_sessions()"],
                capture_output=True, text=True, timeout=10
            )
            return result.stdout
        except Exception as e:
            return f"查询失败:{e}"

    def show_session(self, session_name):
        """查看指定会话详情"""
        try:
            result = subprocess.run(
                ["docker", "exec", "agent-browser", "bsession", "show", session_name],
                capture_output=True, text=True, timeout=10
            )
            return result.stdout
        except Exception as e:
            return f"查询失败:{e}"

输入: 用户提供会话列表查看所需的指令和必要参数。 处理: 按照skill规范执行会话列表查看操作,遵循单一意图原则。 输出: 返回会话列表查看的执行结果,包含操作状态和输出数据。 能力覆盖范围:本skill的核心能力覆盖以下场景关键词:浏览器会话管理免、支持一次性页面抓、基础会话列表与简、易调试、浏览器会话助手免、费版是面向个人开、发者的轻量浏览器、会话管理工具、提取信息、返回结果、三步流程、无需编写完整脚本、即可完成单次页面、抓取任务、when、需要代码生成、编程辅助、调试测试、开发部署时使用、不适用于无明确技、术栈的模糊需求、适用于独立开发者、企业团队和自动化、工作流场景等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

  • 执行此能力时使用input_params参数,支持创建/查询/导出操作

使用场景

场景一:单次页面信息提取

场景描述:需要快速提取某网页的标题和正文内容。

fetcher = BsessionFetcher()
result = fetcher.fetch_url("https://news.example.com/article/123", wait_seconds=3)

if result.get("success"):
    content = result["content"]
    # 简单解析内容
    title = content.split("n")[0] if content else "未获取到标题"
    print(f"标题:{title}")
    print(f"内容长度:{len(content)} 字符")
else:
    print(f"抓取失败:{result.get('error')}")

场景二:简易登录测试

场景描述:测试某网站的登录流程是否正常。

# 1. 打开登录页
fetcher = BsessionFetcher()
result = fetcher.fetch_url("https://app.example.com/login")

# 2. 获取快照并解析元素ref
interaction = BsessionInteraction(port=result.get("port", 9222))
snapshot = interaction.take_snapshot()

# 3. 填写表单并提交(需根据实际页面结构调整ref)
# interaction.fill_field("ref_email", "test@user.com")
# interaction.fill_field("ref_password", "password123")
# interaction.click_element("ref_login_button")
# 4. 验证登录结果
# final_snapshot = interaction.take_snapshot()
# print("登录成功" if "dashboard" in final_snapshot else "登录失败")

场景三:学习浏览器自动化

场景描述:初学者通过单次抓取学习浏览器自动化基础。

# 学习示例:理解浏览器自动化基础流程
print("=== 浏览器会话基础流程 ===")
print("1. 检查容器状态")
fetcher = BsessionFetcher()
if fetcher.check_container():
    print("   容器运行中")
else:
    print("   容器未运行,请先执行 setup")

print("n2. 查找可用端口")
port = fetcher.find_free_port()
print(f"   可用端口:{port}")

print("n3. 抓取页面")
result = fetcher.fetch_url("https://example.com")
print(f"   抓取结果:{'成功' if result.get('success') else '失败'}")

print("n4. 解析内容")
if result.get("success"):
    content_length = len(result.get("content", ""))
    print(f"   内容长度:{content_length} 字符")

快速开始

  1. 阅读## 核心能力章节了解skill功能
  2. 按## 依赖说明配置环境
  3. 执行所需能力对应的命令
  4. 参考## 错误处理章节处理异常
  5. 查看## FAQ解答常见疑问

30秒上手

# 1. 检查Docker容器
docker exec agent-browser echo ok

# 2. 执行单次抓取
docker exec agent-browser agent-browser --cdp 9222 open "https://example.com"
sleep 3
docker exec agent-browser agent-browser --cdp 9222 snapshot

120秒标准搭建

# 1. 启动容器(如果未运行)
cd ~/.bsession/
docker compose up -d

# 2. 验证环境
docker exec agent-browser python3 -c "
import sys; sys.path.insert(0, '/app')
from lib.browser import list_sessions
print('环境正常')
"

# 3. 执行抓取
docker exec agent-browser agent-browser --cdp 9222 open "https://news.example.com"
sleep 5
docker exec agent-browser agent-browser --cdp 9222 snapshot > page_content.txt

# 4. 清理
docker exec agent-browser python3 -c "
import sys; sys.path.insert(0, '/app')
from lib.browser import stop_chrome
stop_chrome(9222)
"

结果处理: 执行完成后,查看输出结果确认操作状态。成功时输出包含处理摘要和结果数据;失败时根据错误信息排查问题,查阅错误处理章节获取恢复步骤。

配置示例

基础配置

import os

class BsessionConfig:
    """bsession配置(免费版)"""
    CONTAINER_NAME = os.getenv("BSESSION_CONTAINER", "agent-browser")
    DEFAULT_PORT = int(os.getenv("BSESSION_PORT", "9222"))
    WORKSPACE = os.getenv("BSESSION_WORKSPACE", "~/.bsession/workspace/")
    WAIT_TIMEOUT = int(os.getenv("BSESSION_WAIT", "5"))
    MAX_PORTS_TRY = int(os.getenv("BSESSION_MAX_PORTS", "10"))

    @classmethod
    def show(cls):
        print("=== bsession 配置 ===")
        print(f"容器名称:{cls.CONTAINER_NAME}")
        print(f"默认端口:{cls.DEFAULT_PORT}")
        print(f"工作空间:{cls.WORKSPACE}")
        print(f"等待时间:{cls.WAIT_TIMEOUT}s")
        print(f"最大端口尝试:{cls.MAX_PORTS_TRY}")

BsessionConfig.show()

容器路径解析

import os
from pathlib import Path

def resolve_bsession_paths():
    """解析bsession路径(按优先级)"""
    paths = {
        "bsession_home": None,
        "workspace": None,
        "cli_path": None
    }

    # 1. 解析bsession CLI
    cli_candidates = [
        os.getenv("BSESSION_CLI"),
        os.path.expanduser("~/.bsession/bsession"),
        "./bsession"
    ]
    for candidate in cli_candidates:
        if candidate and os.path.exists(candidate):
            paths["cli_path"] = candidate
            break

    # 2. 解析workspace
    workspace_candidates = [
        os.getenv("BSESSION_WORKSPACE"),
        os.path.expanduser("~/.bsession/workspace/"),
        "./workspace/"
    ]
    for candidate in workspace_candidates:
        if candidate and os.path.exists(candidate):
            paths["workspace"] = candidate
            break

    # 3. 解析bsession_home
    paths["bsession_home"] = os.path.expanduser("~/.bsession/")

    return paths

paths = resolve_bsession_paths()
for k, v in paths.items():
    print(f"{k}: {v}")

最佳实践

1. 资源清理

# 使用try/finally确保Chrome进程被清理
def safe_fetch(url):
    fetcher = BsessionFetcher()
    try:
        return fetcher.fetch_url(url)
    finally:
        # 确保临时Chrome被关闭
        subprocess.run(
            ["docker", "exec", "agent-browser", "python3", "-c",
             "import sys; sys.path.insert(0, '/app'); "
             "from lib.browser import cleanup_temp; cleanup_temp()"],
            capture_output=True
        )

错误处理

def robust_fetch(url, max_retries=2):
    """带错误恢复的抓取"""
    for attempt in range(max_retries):
        try:
            fetcher = BsessionFetcher()
            result = fetcher.fetch_url(url)
            if result.get("success"):
                return result
            print(f"第{attempt+1}次失败:{result.get('error')}")
        except Exception as e:
            print(f"第{attempt+1}次异常:{e}")
    return {"success": False, "error": "重试次数已用完"}

3. 端口管理 - 处理方式: 按上述步骤操作并确认结果

# 避免端口冲突
class PortManager:
    """端口管理器"""
    USED_PORTS = set()

    @classmethod
    def get_free_port(cls, start=9222):
        for port in range(start, start + 20):
            if port not in cls.USED_PORTS:
                cls.USED_PORTS.add(port)
                return port
        return None

    @classmethod
    def release_port(cls, port):
        cls.USED_PORTS.discard(port)

错误场景2

检查error_code并按照处理方式进行排查。

错误场景3

检查error_code并按照处理方式进行排查。

常见问题

Q1:免费版支持定时任务吗?

不支持。免费版仅支持单次(one-shot)抓取任务。如需定时执行(如每30分钟检查一次)、循环监控、状态变化检测等场景,需升级至专业版。

Q2:Docker容器未运行怎么办?

请按以下步骤排查:(1) 检查Docker是否安装并运行:docker ps;(2) 启动bsession容器:cd ~/.bsession && docker compose up -d;(3) 验证容器状态:docker exec agent-browser echo ok。如首次使用,需执行 setup 命令初始化环境。

Q3:抓取的页面内容为空?

可能原因:(1) 页面加载未完成,增加 wait_seconds 参数;(2) 页面使用JavaScript动态渲染,需等待更长;(3) 触发反爬机制,建议降低抓取频率;(4) 容器内Chrome版本过旧,更新镜像。

Q4:如何保存抓取结果以便复用?

免费版不持久化会话状态。可通过 > 重定向输出到文件,或使用Python脚本保存为JSON。如需将会话保存为可复用的脚本(conf+py文件),需升级专业版。

Q5:多个URL抓取会冲突吗?

免费版单次只处理一个URL。如需同时抓取多个URL,建议串行执行并合理设置间隔(建议2-5秒),避免触发反爬。专业版支持并发批量处理。

依赖说明

运行环境

  • Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
  • 操作系统: Windows / macOS / Linux
  • Docker: 20+(运行bsession容器)
  • Python: 3.8+(容器内执行)

依赖详情

依赖项 类型 是否必需 获取方式
Docker 运行时 必需 官网下载安装
Docker Compose 工具 必需 随Docker Desktop安装
Python 3.8+ 运行时 必需 容器内已内置
Chrome 浏览器 必需 容器内已内置
agent-browser CLI 工具 必需 容器内已内置
LLM API API 必需 由Agent平台内置LLM提供

API Key 配置

  • 免费版无需任何API Key
  • 浏览器自动化基于本地Docker容器执行,不涉及云端调用
  • LLM模型路由由Agent平台内置提供

可用性分类

  • 分类: MD+EXEC(Markdown指令+命令行执行)
  • 说明: 通过自然语言指令驱动Agent执行浏览器会话管理任务

已知限制

本免费体验版限制以下高级功能(需升级至专业版解锁):

  • 定时任务(recurring):循环执行、状态变化检测
  • 会话持久化:保存为可复用脚本(conf+py文件)
  • Webhook通知:结果自动推送到n8n/飞书/Slack
  • 批量会话管理:多会话并发、状态聚合
  • 企业级监控:会话健康检查、失败告警
  • Cloudflare绕过:自动识别与处理反爬
  • 会话调试增强:详细日志、断点调试
  • 优先技术支持

解锁全部高级能力请使用专业版:bsession-tool-pro

示例

基本用法

输入:用户提供操作指令和必要参数

输出:返回执行结果,包含操作状态和输出数据

用户: 执行核心功能
Skill: 正在执行核心功能...
Skill: 执行完成,结果如下: 操作成功

相关专题

更多
浏览器缓存清理方法汇总
浏览器缓存清理方法汇总

本专题整合了浏览器缓存清理教程汇总,阅读专题下面的文章了解更多详细内容。

2026.01.15

626

29

不受国内限制的浏览器大全
不受国内限制的浏览器大全

想找真正自由、无限制的上网体验?本合集精选2025年最开放、隐私强、访问无阻的浏览器App,涵盖Tor、Brave、Via、X浏览器、Mullvad等高自由度工具。支持自定义搜索引擎、广告拦截、隐身模式及全球网站无障碍访问,部分更具备防追踪、去谷歌化、双内核切换等高级功能。无论日常浏览、隐私保护还是突破地域限制,总有一款适合你!

2025.12.31

6742

19

如何将浏览器设置为32位模式
如何将浏览器设置为32位模式

在Windows系统下将浏览器设置为32位模式的方法如下: 确认系统类型:右键"此电脑"→"属性",检查系统是否为64位。 查找32位浏览器: Chrome/Edge:默认安装包含32位版本,在安装目录的"Program Files (x86)"中查找 Firefox:官网下载时选择"Windows 32-bit"版本 创建快捷方式:找到32位程序

2025.05.08

3256

8

免费外国网站浏览器有哪些
免费外国网站浏览器有哪些

常见的免费外国网站浏览器,适合访问国际内容: Google Chrome – 全球最流行的浏览器,支持多平台和丰富扩展。 Mozilla Firefox – 开源浏览器,隐私保护较强,支持跨设备同步。 Microsoft Edge – 基于Chromium,性能优秀,内置翻译和隐私模式。 Opera – 内置免费VPN(限部分区域),适合访问外网。 Brave – 隐私导向,默认屏蔽广告和追踪器,支持Tor模式。 Tor B

2025.05.07

12089

6

浏览器缓存清理方法
浏览器缓存清理方法

浏览器清理缓存的方法:1、找到“internet选项”,然后在“internet属性”里清除缓存;2、打开“清除浏览数据”弹窗,然后清除缓存;3、打开360加速器,然后清理缓存。想了解更多缓存清理相关的内容,可阅读本专题下面的相关文章。

2024.11.11

7020

12

浏览器历史记录删除了怎么恢复
浏览器历史记录删除了怎么恢复

恢复浏览器历史记录的方法:1、打开浏览器,点击右上角的三个横杠图标;2、点击左侧栏的历史记录图标;3、进入界面;4、点击搜索图标,输入“%appdata%”;5、选择匹配的文件夹;6、选择日期;7、删除db文件;8、重命名文件即可。想了解更多浏览器历史记录相关的内容,可阅读本专题下面的相关文章。

2024.10.28

10344

11

浏览器打不开网页的原因
浏览器打不开网页的原因

浏览器打不开网页是因为网络连接问题、dns解析问题、防火墙或安全软件限制、代理设置问题、浏览器缓存问题、网站问题和浏览器配置问题造成的。想了解更多浏览器打不开相关的内容,可阅读本专题下面的相关文章。

2024.10.09

1805

9

浏览器打不开网页是什么原因
浏览器打不开网页是什么原因

浏览器打不开网页是因为网络连接问题、dns解析问题、防火墙或安全软件限制、代理设置问题、浏览器缓存问题、网站问题和浏览器配置问题造成的。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.05.15

6548

7

打开网页出现乱码怎么解决
打开网页出现乱码怎么解决

打开网页出现乱码可以通过修改浏览器编码设置、使用翻译工具、使用编码转换工具和使用其他浏览器来解决。更多关于网页乱码的问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.01

5058

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
MDN CSS 文档与布局指南
MDN CSS 文档与布局指南

共0课时 | 0人学习

Postman安装指南
Postman安装指南

共0课时 | 0人学习