mcpField
B
bb-browser-openclaw

bb-browser-openclaw

github.com/epiralData & databases6.3k672 installsUpdated 22w ago
Repository

About bb-browser-openclaw

bb-browser-openclaw is a site-command skill for OpenClaw's browser, extracting structured data from websites using the browser's login state. It provides adapter-based commands and lets users filter returned fields.

Key features

  1. 01Run commands through OpenClaw's browser
  2. 02Extract structured data from websites
  3. 03Find adapters by keyword
  4. 04Filter output fields with jq
  5. 05Update community adapters

Use cases

  1. 01Search social media posts
  2. 02Retrieve content from developer sites
  3. 03Filter stock or news data
  4. 04Access sites requiring login

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/epiral/bb-browser --skill bb-browser-openclaw

After installing, type/bb-browser-openclawin Claude Code to confirm it loaded.

Details

From the project README

bb-browser sites — The web as CLI

36 platforms, 103 commands. One-liner structured data from any website using your login state.

All commands use --openclaw to run through OpenClaw's browser. No Chrome extension or daemon needed.

Quick Start

# First time: pull community adapters
bb-browser site update

# See what's available
bb-browser site list

# See which adapters match your browsing habits
bb-browser site recommend

# Run any adapter via OpenClaw's browser
bb-browser site reddit/hot --openclaw
bb-browser site hackernews/top 5 --openclaw
bb-browser site v2ex/hot --openclaw

IMPORTANT: Always use --openclaw

Every bb-browser site command MUST include --openclaw to use OpenClaw's browser:

# Correct
bb-browser site twitter/search "AI agent" --openclaw
bb-browser site zhihu/hot 10 --openclaw --json
bb-browser site xueqiu/hot-stock 5 --openclaw --jq '.items[] | {name, changePercent}'

# Wrong (requires separate Chrome extension)
bb-browser site twitter/search "AI agent"

Data Extraction (most common use)

# Social media
bb-browser site twitter/search "OpenClaw" --openclaw
bb-browser site twitter/thread <tweet-url> --openclaw
bb-browser site reddit/thread <post-url> --openclaw
bb-browser site weibo/hot --openclaw
bb-browser site xiaohongshu/search "query" --openclaw

# Developer
bb-browser site github/repo owner/repo --openclaw
bb-browser site github/issues owner/repo --openclaw
bb-browser site hackernews/top 10 --openclaw
bb-browser site stackoverflow/search "async await" --openclaw
bb-browser site arxiv/search "transformer" --openclaw

# Finance
bb-browser site xueqiu/stock SH600519 --openclaw
bb-browser site xueqiu/hot-stock 5 --openclaw
bb-browser site eastmoney/stock "茅台" --openclaw

# News & Knowledge
bb-browser site zhihu/hot --openclaw
bb-browser site 36kr/newsflash --openclaw
bb-browser site wikipedia/summary "Python" --openclaw

# Video
bb-browser site youtube/transcript VIDEO_ID --openclaw
bb-browser site bilibili/search "query" --openclaw

Filtering with --jq

Use --jq to extract specific fields (no need for --json, it's implied):

# Just stock names
bb-browser site xueqiu/hot-stock 5 --openclaw --jq '.items[].name'

# Specific fields as objects
bb-browser site xueqiu/hot-stock 5 --openclaw --jq '.items[] | {name, changePercent, heat}'

# Filter results
bb-browser site reddit/hot --openclaw --jq '.posts[] | {title, score}'

View adapter details

# Check what args an adapter takes
bb-browser site info xueqiu/stock

# Search adapters by keyword
bb-browser site search reddit

Login State

Adapters run inside OpenClaw's browser tabs. If a site requires login:

  1. The adapter will return an error like {"error": "HTTP 401", "hint": "Not logged in?"}
  2. Log in to the site in OpenClaw's browser:
    openclaw browser open https://twitter.com
    
  3. Complete login manually in the browser window
  4. Retry the command

Creating New Adapters

Turn any website into a CLI command:

# Read the guide
bb-browser guide

# Or just tell me: "turn notion.so into a bb-browser adapter"
# I'll reverse-engineer the API, write the adapter, test it, and submit a PR.

All 36 Platforms

CategoryPlatforms
SearchGoogle, Baidu, Bing, DuckDuckGo, Sogou WeChat
SocialTwitter/X, Reddit, Weibo, Xiaohongshu, Jike, LinkedIn, Hupu
NewsBBC, Reuters, 36kr, Toutiao, Eastmoney
DevGitHub, StackOverflow, HackerNews, CSDN, cnblogs, V2EX, Dev.to, npm, PyPI, arXiv
VideoYouTube, Bilibili
EntertainmentDouban, IMDb, Genius, Qidian
FinanceXueqiu, Eastmoney, Yahoo Finance
JobsBOSS Zhipin, LinkedIn
KnowledgeWikipedia, Zhihu, Open Library
ShoppingSMZDM
ToolsYoudao, GSMArena, Product Hunt, Ctrip

Comments

Markdown supported