bb-browser Skill

Chrome CDP automation with 103 commands across 36 platforms. Runs via the bb-browser daemon on the host machine, accessible from inside the Rabbit container.

How It Works

bb-browser connects to a real Chromium instance on the host via Chrome DevTools Protocol (CDP). The daemon runs at localhost:19824. Commands execute within the actual browser — with real cookies and sessions — so you can access logged-in content without any API keys.

The binary is available inside the container at /usr/local/bin/bb-browser (bind-mounted from host).

Basic Syntax

# Run a site adapter
bb-browser site \x3Cadapter>/\x3Ccommand> [args]

# List all available adapters
bb-browser site list

# Get adapter usage details
bb-browser site info boss/search

# Output as JSON
bb-browser site \x3Cadapter>/\x3Ccommand> [args] --json

Key Adapters Available

Job Search (BOSS直聘)

bb-browser site boss/search '工程师 上海' --json
bb-browser site boss/detail \x3Cjob_url>

⚠️ BOSS has anti-bot detection. If you see 您的环境存在异常, the browser session needs a manual BOSS visit to solve captcha first.

Twitter / X

bb-browser site twitter/search 'AI agent 2025' --json
bb-browser site twitter/bookmarks --json
bb-browser site twitter/notifications --json
bb-browser site twitter/tweets \x3Cusername> --json
bb-browser site twitter/user \x3Cusername> --json
bb-browser site twitter/thread \x3Ctweet_url> --json

小红书 (Xiaohongshu)

bb-browser site xiaohongshu/search '东京旅游' --json
bb-browser site xiaohongshu/feed --json
bb-browser site xiaohongshu/note \x3Cnote_url> --json
bb-browser site xiaohongshu/me --json
bb-browser site xiaohongshu/user_posts \x3Cuser_id> --json

Note: Requires logged-in XHS session in Chromium.

Bilibili

bb-browser site bilibili/search 'Claude AI' --json
bb-browser site bilibili/trending --json
bb-browser site bilibili/popular --json
bb-browser site bilibili/feed --json
bb-browser site bilibili/history --json

Weibo

bb-browser site weibo/hot --json
bb-browser site weibo/feed --json
bb-browser site weibo/search \x3Ckeyword> --json
bb-browser site weibo/user \x3Cuid_or_name> --json

Zhihu

bb-browser site zhihu/hot --json
bb-browser site zhihu/search \x3Ckeyword> --json
bb-browser site zhihu/question \x3Cquestion_url> --json

Finance & Markets

bb-browser site xueqiu/hot-stock 5 --json
bb-browser site xueqiu/stock \x3Ccode> --json
bb-browser site eastmoney/news --json
bb-browser site yahoo-finance/quote AAPL --json

Research / News

bb-browser site google/search 'Claude AI 2025' --json
bb-browser site reddit/hot programming --json
bb-browser site hackernews/top --json
bb-browser site arxiv/search 'LLM agents' --json
bb-browser site github/issues owner/repo --json

Translation

bb-browser site youdao/translate '株式会社' --json

Browser Direct Control

For sites without adapters, use raw CDP commands:

bb-browser open \x3Curl>                  # Open URL in current tab
bb-browser open \x3Curl> --tab            # Open in new tab
bb-browser snapshot -i                 # Screenshot + page snapshot
bb-browser tab                         # List open tabs
bb-browser tab \x3Cindex>                 # Switch to tab
bb-browser eval "document.title"       # Run JS in active tab
bb-browser network requests --json     # Capture network traffic

Calling from OpenClaw Skills

When you want to use bb-browser in a Python subprocess inside the container:

import subprocess, json

result = subprocess.run(
    ['bb-browser', 'site', 'twitter/search', query, '--json'],
    capture_output=True, text=True, timeout=30
)
data = json.loads(result.stdout)

Or from a skill shell script:

bb-browser site zhihu/hot --json | python3 -c "import json,sys; items=json.load(sys.stdin); print('\
'.join(i['title'] for i in items[:5]))"

Requirements

• bb-browser daemon running on host at localhost:19824
• Real Chrome/Chromium browser open with bb-browser extension installed
• For site-specific adapters: active logged-in session in that browser