🎁 Get the FREE AI Skills Starter Guide — Subscribe →
BytesAgainBytesAgain
BytesAgain › Skills › Browser Web Search
🦀 ClawHub

Browser Web Search

by @sipingme

一行命令搜遍全网 — 55 个平台 91+ 个命令，头条、知乎、豆瓣、YouTube、GitHub、Reddit、Hacker News 等。专为 OpenClaw 设计，复用浏览器登录态，返回结构化 JSON，天然适配 AI Agent 工具调用。

Versionv0.4.11
Downloads953
Installs3
#crypto-defi#security#data#video#legal
TERMINAL
clawhub install browser-web-search

📖 About This Skill

name: browser-web-search description: 一行命令搜遍全网 — 55 个平台 91+ 个命令，头条、知乎、豆瓣、YouTube、GitHub、Reddit、Hacker News 等。专为 OpenClaw 设计，复用浏览器登录态，返回结构化 JSON，天然适配 AI Agent 工具调用。 version: 0.4.4 versionNotes: | 0.4.4 — Sensitive tier sealed by default. Sensitive adapters now require BWS_ENABLE_SENSITIVE_TIER=1 *in addition to* the existing per-call/session opt-in. Responds to ClawScan May 2026 Identity-and-Privilege-Abuse and Tool-Misuse-and-Exploitation findings. Underlying npm package browser-web-search remains pinned at 0.4.3 (no change to integrity gate). author: Ping Si type: cli requires: runtime: - name: node version: ">=18.0.0" description: Node.js 运行时 - name: npm description: Node.js 包管理器（随 Node.js 安装） packages: - npm: browser-web-search global: false binaries: - name: openclaw description: OpenClaw CLI，用于浏览器自动化 install: command: npm install -g browser-web-search@0.4.3 riskLevel: medium riskReason: 通过 npm 全局安装第三方包，该包会在浏览器页面上下文中执行 JavaScript。安装前请审计源码。 requiresApproval: true source: registry: npmjs.com package: browser-web-search repository: https://github.com/sipingme/browser-web-search npm: https://www.npmjs.com/package/browser-web-search verification: - 安装前请审查 GitHub 仓库代码 - 检查 npm 包的下载量和维护状态 - 对比 npm 发布版本与 GitHub 源码是否一致 note: 用户需先通过 npm install -g 全局安装 browser-web-search，运行时调用本地已安装的 bws 命令 capabilities: sensitive: - type: browser-session-access riskLevel: high description: 通过 OpenClaw 在已认证的浏览器标签页中执行 JavaScript scope: 按 adapter 域名隔离（如 zhihu.com, xiaohongshu.com） access: - 当前页面 DOM - 当前页面 Session（继承，非提取） - 站点认证数据（登录态下的 API 响应） - 账户保护页面内容（如私信、收藏、个人资料） noAccess: - 浏览器 Cookie 文件（不直接读取） - 其他域名数据 - 用户配置目录 risks: - 第三方 npm 包（browser-web-search）在页面上下文中执行，可访问站点认证数据 - 恶意代码可能窃取 cookies 或页面内容 - 包代码不包含在此 Skill 中，需独立审计 mitigations: - adapter 脚本开源可审计 - 按域名隔离，无法跨站访问 - 不持久化存储任何凭证 privacyNotice: summary: 此 Skill 自动复用浏览器登录态，可读取您已登录站点的任何可见数据 details: - 零配置意味着 CLI 自动获得您在 OpenClaw 浏览器中的登录会话访问权 - 可读取账户保护的页面（私信、收藏、个人资料、订单等） - 访问范围取决于您在目标站点的登录权限 - 建议仅在信任 browser-web-search 包代码后使用 metadata: openclaw: primaryEnv: - name: BWS_PUBLIC_ONLY values: ["0", "1"] default: "0" purpose: Hard-isolation mode that denies all sensitive adapters (Gate 1; overrides everything below) - name: BWS_ENABLE_SENSITIVE_TIER values: ["0", "1"] default: "0" purpose: | v0.4.4+: sensitive tier is sealed by default. Operator must enrol the runtime via this env before any per-call/session opt-in is considered (Gate 2). Responds to ClawScan May 2026 "Identity and Privilege Abuse" recommendation. - name: BWS_ALLOW_SENSITIVE values: ["0", "1"] default: "0" purpose: Session-level opt-in within the enabled sensitive tier (Gate 3) - name: BWS_ALLOW_LOCAL_INSTALL values: ["0", "1"] default: "0" purpose: Allow loading bws from launcher-local or CWD node_modules (off by default to prevent path-pivoting) sensitiveTierGateOrder: - "Gate 1: BWS_PUBLIC_ONLY=1 hard-isolates (overrides everything)" - "Gate 2: sensitive tier sealed unless BWS_ENABLE_SENSITIVE_TIER=1" - "Gate 3: per-call/session opt-in via BWS_ALLOW_SENSITIVE=1 or --i-understand-sensitive" primaryCredentialUsage: none networkUsage: indirect-via-bws auditLog: path: ~/.bws/audit.log content: metadata-only (no payloads, no responses, args hashed via SHA-256) fields: [ts, pid, adapter, site, primaryDomain, classification, decision, reason, argHash] rotation: 1 MiB → audit.log.1 subprocessUsage: none moduleLoad: - file: scripts/run.js function: safeRunBws method: dynamic-esm-import loader: "await import(file://...)" target: pinned npm package "browser-web-search" targetResolution: platform-standard global node_modules roots only (no PATH lookup, no shell, no require.resolve fallback) targetResolutionOptIn: BWS_ALLOW_LOCAL_INSTALL=1 (adds launcher-local + CWD node_modules; off by default) symlinkPolicy: rejected per path component from the candidate root down to dist/index.js preImportIntegrityGate: enforcedBy: scripts/run.js:verifyBwsIntegrity checks: - package.json name == 'browser-web-search' - package.json version == '0.4.3' - stat(dist/index.js).size == 22871 - sha512(dist/index.js) == sha512-qoGLsUMOPgzIpdxtGMv08Gjy84bkh0AF90mKG9qvagq9O2ngcKcLg+GAy3Z8bljkvdfKcrQSp55xPO9mVCuv3Q== (timing-safe compare) envOverride: false failureMode: deny + audit-log entry (adapter="(integrity)") argSource: allow-listed-cli-args argValidation: - length-bounded (<= 1024 bytes per arg) - control-char rejection (NUL + ASCII control) - long-flag allow-list (--json/--jq/--count/--sort/--id/--limit/--page) - adapter-name regex ([a-zA-Z0-9_-]{1,64}/[a-zA-Z0-9_-]{1,64}) - "--" delimiter between subcommand and positional args purpose: Invoke the pinned 'browser-web-search' npm package in-process, with a validated argv injected via process.argv mutation, after a hard supply-chain integrity gate configPaths: - path: ~/.bws/ required: false tags: - browser - web-search - scraping - automation - ai-agent repository: https://github.com/sipingme/browser-web-search-skill package: https://github.com/sipingme/browser-web-search npm: https://www.npmjs.com/package/browser-web-search

Browser Web Search (BWS) Skill

> 一行命令，搜遍全网 — 为 AI Agent 而生的多平台内容搜索工具

把 55 个主流平台的搜索接口封装成统一命令行 API，让 AI Agent 直接拿到结构化 JSON，无需 API Key，无需额外配置。

🏗️ 架构说明

OpenClaw/AI Agent
    ↓ (读取 Skill 配置)
browser-web-search-skill
    ↓ (调用 CLI)
bws 命令
    ↓ (OpenClaw Browser)
目标网站（55 个平台）

🎯 核心特点

  • 🔍 跨平台搜索 — 今日头条、知乎、豆瓣、YouTube、GitHub、Reddit、Hacker News… 一套语法搞定
  • 🔑 无需 API Key — 复用浏览器登录态，开箱即用
  • 🤖 AI Agent 友好 — 结构化 JSON 输出，支持 --jq 过滤，天然适配 LLM 工具调用
  • ⚡ 零配置 — 无需 Chrome Extension，无需后台 Daemon

    • 📋 安装

    npm install -g browser-web-search@0.4.3

    验证安装

    bws --version
bws site list

    🚀 快速开始

    # 搜索今日头条关于 "ai search" 的最新文章
bws site toutiao/search "ai search"
    搜索知乎，返回 5 条
    
bws site zhihu/search "ai agent" --count 5
    Hacker News 最新讨论（按时间）
    
bws site hn/search "llm" --sort date
    GitHub 热门仓库（按 Star 数）
    
bws site github/search "ai search" --sort stars
    Reddit 最新帖子
    
bws site reddit/search "ai search" --sort new
    YouTube 视频搜索
    
bws site youtube/search "ai agent tutorial"
    查看所有可用命令
    
bws site list

    📊 内置平台（55 个）

    > 🔓 无需登录 · 🔐 需登录该站账号 · 🔀 依具体命令而定

    🇨🇳 国内平台（30 个）

    | 平台 | 说明 | 登录 | 命令 | |-----|------|:----:|-----| | 今日头条 | 新闻资讯 | 🔀 | toutiao/search, toutiao/hot, toutiao/feed | | 澎湃新闻 | 权威新闻 | 🔓 | thepaper/search, thepaper/hot | | 腾讯新闻 | 热点新闻 | 🔓 | qqnews/search, qqnews/hot | | 网易新闻 | 热点新闻 | 🔓 | netease/search, netease/hot | | 新浪新闻 | 门户新闻 | 🔓 | sina/search, sina/hot | | 36kr | 科技创投 | 🔓 | 36kr/search, 36kr/newsflash, 36kr/article | | 虎嗅 | 科技商业媒体 | 🔓 | huxiu/search | | 华尔街见闻 | 财经资讯 | 🔓 | wallstreetcn/search | | 东方财富 | 股票行情 & 财经新闻 | 🔓 | eastmoney/stock, eastmoney/news | | 掘金 | 技术社区 | 🔓 | juejin/search | | CSDN | 开发者社区 | 🔓 | csdn/search | | 博客园 | 技术博客 | 🔓 | cnblogs/search | | V2EX | 技术社区 | 🔓 | v2ex/search | | Baidu | 百度搜索 | 🔓 | baidu/search | | 虎扑 | 体育社区 | 🔓 | hupu/search | | 有道翻译 | 中英词典/翻译 | 🔓 | youdao/translate | | 什么值得买 | 好价/优惠聚合 | 🔓 | smzdm/search | | InfoQ | 技术媒体 | 🔓 | infoq/search | | 微信公众号 | 公众号文章 | 🔐 | weixin/search, weixin/article | | 小红书 | 生活分享 | 🔐 | xiaohongshu/search, xiaohongshu/note, xiaohongshu/comments, xiaohongshu/user_posts, xiaohongshu/me, xiaohongshu/feed | | 知乎 | 问答社区 | 🔀 | zhihu/search, zhihu/hot, zhihu/question, zhihu/me | | 微博 | 社交热搜 | 🔐 | weibo/search, weibo/hot | | Bilibili | 视频弹幕 | 🔀 | bilibili/search, bilibili/popular, bilibili/trending, bilibili/ranking, bilibili/video, bilibili/comments, bilibili/history, bilibili/me, bilibili/feed | | 雪球 | 股票社区 | 🔐 | xueqiu/search | | BOSS直聘 | 招聘平台 | 🔀 | boss/search, boss/detail | | 即刻 | 兴趣社区 | 🔐 | jike/search | | 豆瓣 | 影视/书籍评分社区 | 🔐 | douban/search, douban/movie, douban/movie-hot, douban/top250, douban/comments | | 起点中文网 | 网络小说 | 🔐 | qidian/search | | 携程 | 旅行/酒店/景点 | 🔐 | ctrip/search |

    🌏 国际平台（25 个）

    | 平台 | 说明 | 登录 | 命令 | |-----|------|:----:|-----| | Google | 谷歌搜索 | 🔓 | google/search | | Bing | 必应搜索 | 🔓 | bing/search | | DuckDuckGo | 隐私优先搜索 | 🔓 | duckduckgo/search | | GitHub | 代码托管 | 🔓 | github/search | | Hacker News | 科技社区 (YC) | 🔓 | hn/search | | Reddit | 英文社区 | 🔓 | reddit/search | | BBC | 国际新闻 | 🔓 | bbc/news | | Reuters | 路透社新闻 | 🔓 | reuters/search | | The Verge | 科技媒体 | 🔓 | verge/search | | Ars Technica | 深度科技媒体 | 🔓 | ars/search | | Engadget | 科技消费媒体 | 🔓 | engadget/search | | Stack Overflow | 开发者问答 | 🔓 | stackoverflow/search | | Dev.to | 开发者社区 | 🔓 | devto/search | | npm | Node.js 包 | 🔓 | npm/search | | PyPI | Python 包 | 🔓 | pypi/search | | arXiv | 学术论文 | 🔓 | arxiv/search | | IMDb | 全球最大影视数据库 | 🔓 | imdb/search, imdb/movie, imdb/top250 | | Genius | 歌词/歌曲数据库 | 🔓 | genius/search | | Wikipedia | 百科全书 | 🔓 | wikipedia/search, wikipedia/summary | | Open Library | 图书数据库 | 🔓 | openlibrary/search | | Yahoo Finance | 美股/港股行情 | 🔓 | yahoo-finance/quote | | GSMArena | 手机规格数据库 | 🔓 | gsmarena/search | | Product Hunt | 科技产品发现 | 🔓 | producthunt/today | | X (Twitter) | 社交媒体 | 🔐 | x/search | | LinkedIn | 职业社交 | 🔐 | linkedin/search | | YouTube | 视频 & 字幕 & 评论 | 🔀 | youtube/search, youtube/video, youtube/transcript, youtube/transcript-by-id, youtube/comments, youtube/channel, youtube/feed |

    🔧 命令参考

    bws site list                        # 列出所有 adapter
bws site info                  # 查看 adapter 参数说明
bws site  [args...]            # 运行 adapter
bws site  --count 5           # 限制返回数量
bws site  --json               # 输出原始 JSON
bws site  --jq '.items[].url' # jq 过滤提取字段

    📋 标准操作流程 (SOP)

    操作 1：跨平台搜索

    场景：用户想搜索多个平台关于某话题的最新内容

    # 国内平台
bws site toutiao/search "ai agent" --count 5
bws site zhihu/search "ai agent" --count 5
bws site huxiu/search "ai agent" --count 5
    国际平台
    
bws site hn/search "ai agent" --sort date --count 5
bws site reddit/search "ai agent" --sort new --count 5
bws site github/search "ai agent" --sort stars --count 5

    操作 2：获取热点资讯

    bws site zhihu/hot        # 知乎热榜
bws site weibo/hot        # 微博热搜
bws site toutiao/hot      # 今日头条热榜
bws site thepaper/hot     # 澎湃新闻热点
bws site bilibili/trending  # B 站热搜词
bws site bilibili/popular   # B 站全站热门

    操作 3：使用 jq 过滤数据

    # 只提取标题
bws site zhihu/search "大模型" --jq '[.items[].title]'
    只提取 URL 列表
    
bws site hn/search "llm" --jq '[.items[].url]'
    提取标题+日期
    
bws site toutiao/search "ai" --jq '[.items[] | {title, date}]'

    操作 4：影视 / 娱乐内容

    # 豆瓣搜索影视
bws site douban/search "三体"
bws site douban/movie-hot
    IMDb 搜索
    
bws site imdb/search "Inception"
bws site imdb/top250 --count 10
    YouTube 视频与字幕
    
bws site youtube/search "ai tutorial"
bws site youtube/transcript-by-id --id dQw4w9WgXcQ

    操作 5：开发者资源搜索

    # 搜索 npm 包
bws site npm/search "langchain"
    搜索 PyPI 包
    
bws site pypi/search "openai"
    arXiv 论文
    
bws site arxiv/search "retrieval augmented generation" --count 5
    Stack Overflow
    
bws site stackoverflow/search "python async await"

    操作 6：登录态管理

    需要登录的站点（微信公众号、小红书、微博、X、豆瓣等）：

    # 在 OpenClaw 浏览器中登录
openclaw browser open https://weixin.qq.com
openclaw browser open https://x.com
openclaw browser open https://www.xiaohongshu.com
openclaw browser open https://www.douban.com
    登录完成后重试
    
bws site weixin/search "ai"
bws site douban/search "三体"

    🔧 技术架构：如何访问登录态

    bws 命令
    ↓ 调用
openclaw browser evaluate