knowledge-base/1 - Inbox/epiralbb-sites Community fetch recipes for bb-browser — pre-built adapters for Reddit, Twitter, GitHub, and more.md

---
title: "epiral/bb-sites: Community fetch recipes for bb-browser — pre-built adapters for Reddit, Twitter, GitHub, and more"
source: "https://github.com/epiral/bb-sites"
author:
  - "[[GitHub]]"
published:
created: 2026-03-26
description: "Community fetch recipes for bb-browser — pre-built adapters for Reddit, Twitter, GitHub, and more - epiral/bb-sites"
tags:
  - "clippings"
---
## bb-sites

Community site adapters for [bb-browser](https://github.com/epiral/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](https://github.com/epiral/bb-sites/blob/main/README.md) · [中文](https://github.com/epiral/bb-sites/blob/main/README.zh-CN.md)

> **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

| Platform | Command | Description |
| --- | --- | --- |
| Google | `google/search` | Google search |
| Baidu | `baidu/search` | Baidu search |
| Bing | `bing/search` | Bing search |
| DuckDuckGo | `duckduckgo/search` | DuckDuckGo search (HTML lite) |
| Sogou | `sogou/weixin` | Sogou WeChat article search |

### 📰 News & Media

| Platform | Command | Description |
| --- | --- | --- |
| BBC | `bbc/news` | BBC News headlines (RSS) or search |
| Reuters | `reuters/search` | Reuters news search |
| Toutiao | `toutiao/search`, `toutiao/hot` | Toutiao (今日头条) search & trending |
| Eastmoney | `eastmoney/news` | Eastmoney (东方财富) financial news |

| Platform | Commands | Description |
| --- | --- | --- |
| Twitter/X | `twitter/user`, `twitter/thread`, `twitter/search`, `twitter/tweets`, `twitter/notifications` | User profile, tweet threads, search, timeline, notifications |
| Reddit | `reddit/me`, `reddit/posts`, `reddit/thread`, `reddit/context` | User info, posts, discussion trees, comment chains |
| Weibo | `weibo/me`, `weibo/hot`, `weibo/feed`, `weibo/user`, `weibo/user_posts`, `weibo/post`, `weibo/comments` | Full Weibo (微博) support — profile, trending, timeline, posts, comments |
| Hupu | `hupu/hot` | Hupu (虎扑) hot posts |

### 💻 Tech & Dev

| Platform | Commands | Description |
| --- | --- | --- |
| GitHub | `github/me`, `github/repo`, `github/issues`, `github/issue-create`, `github/pr-create`, `github/fork` | User info, repos, issues, PRs, forks |
| Hacker News | `hackernews/top`, `hackernews/thread` | Top stories, post + comment tree |
| Stack Overflow | `stackoverflow/search` | Search questions |
| CSDN | `csdn/search` | CSDN tech article search |
| cnblogs | `cnblogs/search` | cnblogs (博客园) tech article search |
| npm | `npm/search` | Search npm packages |
| PyPI | `pypi/search`, `pypi/package` | Search & get Python package details |
| arXiv | `arxiv/search` | Search academic papers |
| Dev.to | `devto/search` | Search Dev.to articles |
| V2EX | `v2ex/hot`, `v2ex/latest`, `v2ex/topic` | Hot/latest topics, topic detail + replies |

### 🎬 Entertainment

| Platform | Commands | Description |
| --- | --- | --- |
| YouTube | `youtube/search`, `youtube/video`, `youtube/comments`, `youtube/channel`, `youtube/feed`, `youtube/transcript` | Search, video details, comments, channels, feed, transcripts |
| Bilibili | `bilibili/me`, `bilibili/popular`, `bilibili/ranking`, `bilibili/search`, `bilibili/video`, `bilibili/comments`, `bilibili/feed`, `bilibili/history`, `bilibili/trending` | Full B站 support — 9 adapters |
| IMDb | `imdb/search` | IMDb movie search |
| Genius | `genius/search` | Song/lyrics search |
| Douban | `douban/search`, `douban/movie`, `douban/movie-hot`, `douban/movie-top`, `douban/top250`, `douban/comments` | Douban (豆瓣) movies — search, details, rankings, Top 250, reviews |
| Qidian | `qidian/search` | Qidian (起点中文网) novel search |

### 💼 Jobs & Career

| Platform | Commands | Description |
| --- | --- | --- |
| BOSS Zhipin | `boss/search`, `boss/detail` | BOSS直聘 job search & JD details |
| LinkedIn | `linkedin/profile`, `linkedin/search` | LinkedIn profile & post search |

### 💰 Finance

| Platform | Commands | Description |
| --- | --- | --- |
| Eastmoney | `eastmoney/stock`, `eastmoney/news` | 东方财富 stock quotes & financial news |
| Yahoo Finance | `yahoo-finance/quote` | Stock quotes (AAPL, TSLA, etc.) |

### 📱 Digital & Products

| Platform | Command | Description |
| --- | --- | --- |
| GSMArena | `gsmarena/search` | Phone specs search |
| Product Hunt | `producthunt/today` | Today's top products |

### 📚 Knowledge & Reference

| Platform | Commands | Description |
| --- | --- | --- |
| Wikipedia | `wikipedia/search`, `wikipedia/summary` | Search & page summaries |
| Zhihu | `zhihu/me`, `zhihu/hot`, `zhihu/question`, `zhihu/search` | 知乎 — user info, trending, Q&A, search |
| Open Library | `openlibrary/search` | Book search |

### 🌐 Lifestyle & Travel

| Platform | Command | Description |
| --- | --- | --- |
| Youdao | `youdao/translate` | 有道翻译 — translation & dictionary |
| Ctrip | `ctrip/search` | 携程 — destination & attraction search |

| Platform | Commands | Description |
| --- | --- | --- |
| Jike | `jike/feed`, `jike/search` | 即刻 — recommended feed & search |
| Xiaohongshu | `xiaohongshu/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](https://github.com/epiral/bb-sites/blob/main/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/
```