logo
0
0
WeChat Login
yan5xu<lueco.x@gmail.com>
docs: update README with 93 adapters across 35 platforms

bb-sites

Community site adapters for bb-browser — turning websites into CLI commands.

Each site adapter is a JS function that runs inside your browser via bb-browser eval. The browser is already logged in — no API keys, no cookie extraction, no anti-bot bypass.

English · 中文

95 adapters across 35 platforms — and growing.

Quick Start

bb-browser site update # install/update site adapters bb-browser site list # list available commands bb-browser site reddit/me # run a command bb-browser site reddit/thread <url> # run with args

Available Adapters

🔍 Search Engines

PlatformCommandDescription
Googlegoogle/searchGoogle search
Baidubaidu/searchBaidu search
Bingbing/searchBing search
DuckDuckGoduckduckgo/searchDuckDuckGo search (HTML lite)
Sogousogou/weixinSogou WeChat article search

📰 News & Media

PlatformCommandDescription
BBCbbc/newsBBC News headlines (RSS) or search
Reutersreuters/searchReuters news search
Toutiaotoutiao/search, toutiao/hotToutiao (今日头条) search & trending
Eastmoneyeastmoney/newsEastmoney (东方财富) financial news

💬 Social Media

PlatformCommandsDescription
Twitter/Xtwitter/user, twitter/thread, twitter/search, twitter/tweets, twitter/notificationsUser profile, tweet threads, search, timeline, notifications
Redditreddit/me, reddit/posts, reddit/thread, reddit/contextUser info, posts, discussion trees, comment chains
Weiboweibo/me, weibo/hot, weibo/feed, weibo/user, weibo/user_posts, weibo/post, weibo/commentsFull Weibo (微博) support — profile, trending, timeline, posts, comments
Hupuhupu/hotHupu (虎扑) hot posts

💻 Tech & Dev

PlatformCommandsDescription
GitHubgithub/me, github/repo, github/issues, github/issue-create, github/pr-create, github/forkUser info, repos, issues, PRs, forks
Hacker Newshackernews/top, hackernews/threadTop stories, post + comment tree
Stack Overflowstackoverflow/searchSearch questions
CSDNcsdn/searchCSDN tech article search
cnblogscnblogs/searchcnblogs (博客园) tech article search
npmnpm/searchSearch npm packages
PyPIpypi/search, pypi/packageSearch & get Python package details
arXivarxiv/searchSearch academic papers
Dev.todevto/searchSearch Dev.to articles
V2EXv2ex/hot, v2ex/latest, v2ex/topicHot/latest topics, topic detail + replies

🎬 Entertainment

PlatformCommandsDescription
YouTubeyoutube/search, youtube/video, youtube/comments, youtube/channel, youtube/feed, youtube/transcriptSearch, video details, comments, channels, feed, transcripts
Bilibilibilibili/me, bilibili/popular, bilibili/ranking, bilibili/search, bilibili/video, bilibili/comments, bilibili/feed, bilibili/history, bilibili/trendingFull B站 support — 9 adapters
IMDbimdb/searchIMDb movie search
Geniusgenius/searchSong/lyrics search
Doubandouban/search, douban/movie, douban/movie-hot, douban/movie-top, douban/top250, douban/commentsDouban (豆瓣) movies — search, details, rankings, Top 250, reviews
Qidianqidian/searchQidian (起点中文网) novel search

💼 Jobs & Career

PlatformCommandsDescription
BOSS Zhipinboss/search, boss/detailBOSS直聘 job search & JD details
LinkedInlinkedin/profile, linkedin/searchLinkedIn profile & post search

💰 Finance

PlatformCommandsDescription
Eastmoneyeastmoney/stock, eastmoney/news东方财富 stock quotes & financial news
Yahoo Financeyahoo-finance/quoteStock quotes (AAPL, TSLA, etc.)

📱 Digital & Products

PlatformCommandDescription
GSMArenagsmarena/searchPhone specs search
Product Huntproducthunt/todayToday's top products

📚 Knowledge & Reference

PlatformCommandsDescription
Wikipediawikipedia/search, wikipedia/summarySearch & page summaries
Zhihuzhihu/me, zhihu/hot, zhihu/question, zhihu/search知乎 — user info, trending, Q&A, search
Open Libraryopenlibrary/searchBook search

🌐 Lifestyle & Travel

PlatformCommandDescription
Youdaoyoudao/translate有道翻译 — translation & dictionary
Ctripctrip/search携程 — destination & attraction search

🗨️ Social Apps

PlatformCommandsDescription
Jikejike/feed, jike/search即刻 — recommended feed & search
Xiaohongshuxiaohongshu/me, xiaohongshu/feed, xiaohongshu/search, xiaohongshu/note, xiaohongshu/comments, xiaohongshu/user_posts小红书 — full support via Pinia store actions

All Xiaohongshu (小红书) adapters use Pinia Store Actions — calling the page's own Vue store functions, which go through the complete signing + interceptor chain. Zero reverse engineering needed.

Usage Examples

# Search the web bb-browser site google/search "bb-browser" bb-browser site duckduckgo/search "Claude Code" # Social media bb-browser site twitter/search "claude code" bb-browser site twitter/tweets plantegg bb-browser site reddit/thread https://reddit.com/r/programming/comments/... bb-browser site weibo/hot # Tech research bb-browser site github/repo epiral/bb-browser bb-browser site hackernews/top 10 bb-browser site stackoverflow/search "python async await" bb-browser site arxiv/search "large language model" bb-browser site npm/search "react state management" # Entertainment bb-browser site youtube/transcript dQw4w9WgXcQ bb-browser site bilibili/search 编程 bb-browser site douban/top250 # Finance bb-browser site yahoo-finance/quote AAPL bb-browser site eastmoney/stock 贵州茅台 # Jobs bb-browser site boss/search "AI agent" bb-browser site linkedin/search "AI agent" # Translate bb-browser site youdao/translate hello

Writing a Site Adapter

Run bb-browser guide for the full development workflow, or read SKILL.md.

/* @meta { "name": "platform/command", "description": "What this adapter does", "domain": "www.example.com", "args": { "query": {"required": true, "description": "Search query"} }, "readOnly": true, "example": "bb-browser site platform/command value1" } */ async function(args) { if (!args.query) return {error: 'Missing argument: query'}; const resp = await fetch('/api/search?q=' + encodeURIComponent(args.query), {credentials: 'include'}); if (!resp.ok) return {error: 'HTTP ' + resp.status, hint: 'Not logged in?'}; return await resp.json(); }

Contributing

# Option A: with gh CLI gh repo fork epiral/bb-sites --clone cd bb-sites && git checkout -b feat-mysite # add adapter files git push -u origin feat-mysite gh pr create # Option B: with bb-browser (no gh needed) bb-browser site github/fork epiral/bb-sites git clone https://github.com/YOUR_USER/bb-sites && cd bb-sites git checkout -b feat-mysite # add adapter files git push -u origin feat-mysite bb-browser site github/pr-create epiral/bb-sites --title "feat(mysite): add adapters" --head "YOUR_USER:feat-mysite"

Private Adapters

Put private adapters in ~/.bb-browser/sites/. They override community adapters with the same name.

~/.bb-browser/ ├── sites/ # Your private adapters (priority) │ └── internal/ │ └── deploy.js └── bb-sites/ # This repo (bb-browser site update) ├── reddit/ ├── twitter/ ├── github/ ├── youtube/ ├── bilibili/ ├── zhihu/ ├── weibo/ ├── douban/ ├── xiaohongshu/ ├── google/ ├── ... # 35 platform directories └── qidian/