bb-browser 0.5.2 → 0.7.0

package/README.md

@@ -52,11 +52,6 @@ bb-browser flips this: **instead of forcing websites to provide machine interfac
 npm install -g bb-browser
 ```
 
-### Chrome Extension
-
-1. Download from [Releases](https://github.com/epiral/bb-browser/releases/latest)
-2. Unzip → `chrome://extensions/` → Developer Mode → Load unpacked
-
 ### Use
 
 ```bash
@@ -65,6 +60,24 @@ bb-browser site recommend     # see which adapters match your browsing habits
 bb-browser site zhihu/hot     # go
 ```
 
+### OpenClaw (no extension needed)
+
+If you use [OpenClaw](https://openclaw.ai), bb-browser runs directly through OpenClaw's built-in browser — no Chrome extension or daemon required:
+
+```bash
+bb-browser site reddit/hot --openclaw
+bb-browser site xueqiu/hot-stock 5 --openclaw --jq '.items[] | {name, changePercent}'
+```
+
+Skill on ClawHub: [bb-browser-openclaw](https://clawhub.ai/yan5xu/bb-browser)
+
+### Chrome Extension (standalone mode)
+
+For use without OpenClaw (Claude Code MCP, standalone CLI):
+
+1. Download from [Releases](https://github.com/epiral/bb-browser/releases/latest)
+2. Unzip → `chrome://extensions/` → Developer Mode → Load unpacked
+
 ### MCP (Claude Code / Cursor)
 
 ```json

package/README.zh-CN.md

@@ -52,11 +52,6 @@ bb-browser 翻转了这个逻辑：**不是让网站适配机器，而是让机
 npm install -g bb-browser
 ```
 
-### Chrome 扩展
-
-1. 从 [Releases](https://github.com/epiral/bb-browser/releases/latest) 下载 zip
-2. 解压 → `chrome://extensions/` → 开发者模式 → 加载已解压的扩展程序
-
 ### 使用
 
 ```bash
@@ -65,6 +60,24 @@ bb-browser site recommend     # 看看哪些和你的浏览习惯匹配
 bb-browser site zhihu/hot     # 开搞
 ```
 
+### OpenClaw（无需安装扩展）
+
+如果你使用 [OpenClaw](https://openclaw.ai)，bb-browser 可以直接通过 OpenClaw 内置浏览器运行，不需要额外安装 Chrome 扩展或 daemon：
+
+```bash
+bb-browser site reddit/hot --openclaw
+bb-browser site xueqiu/hot-stock 5 --openclaw --jq '.items[] | {name, changePercent}'
+```
+
+ClawHub Skill: [bb-browser-openclaw](https://clawhub.ai/yan5xu/bb-browser)
+
+### Chrome 扩展（独立模式）
+
+不使用 OpenClaw 时（Claude Code MCP、独立 CLI）需要安装扩展：
+
+1. 从 [Releases](https://github.com/epiral/bb-browser/releases/latest) 下载 zip
+2. 解压 → `chrome://extensions/` → 开发者模式 → 加载已解压的扩展程序
+
 ### MCP 接入（Claude Code / Cursor）
 
 ```json

package/dist/cli.js

@@ -9,6 +9,9 @@ import {
 } from "./chunk-AHGAQEFO.js";
 import "./chunk-D4HDZEJT.js";
 
+// packages/cli/src/index.ts
+import { fileURLToPath as fileURLToPath2 } from "url";
+
 // packages/cli/src/client.ts
 var jqExpression;
 function setJqExpression(expression) {
@@ -201,6 +204,17 @@ var BB_DIR = join(homedir(), ".bb-browser");
 var LOCAL_SITES_DIR = join(BB_DIR, "sites");
 var COMMUNITY_SITES_DIR = join(BB_DIR, "bb-sites");
 var COMMUNITY_REPO = "https://github.com/epiral/bb-sites.git";
+function checkCliUpdate() {
+  try {
+    const current = execSync("bb-browser --version", { timeout: 3e3, stdio: ["pipe", "pipe", "pipe"] }).toString().trim();
+    const latest = execSync("npm view bb-browser version", { timeout: 5e3, stdio: ["pipe", "pipe", "pipe"] }).toString().trim();
+    if (latest && current && latest !== current && latest.localeCompare(current, void 0, { numeric: true }) > 0) {
+      console.log(`
+\u{1F4E6} bb-browser ${latest} available (current: ${current}). Run: npm install -g bb-browser`);
+    }
+  } catch {
+  }
+}
 function parseSiteMeta(filePath, source) {
   let content;
   try {
@@ -405,6 +419,8 @@ function siteUpdate() {
   }
   const sites = scanSites(COMMUNITY_SITES_DIR, "community");
   console.log(`\u5DF2\u5B89\u88C5 ${sites.length} \u4E2A\u793E\u533A adapter\u3002`);
+  console.log(`\u2B50 Like bb-browser? \u2192 bb-browser star`);
+  checkCliUpdate();
 }
 function findSiteByName(name) {
   return getAllSites().find((site) => site.name === name);
@@ -581,6 +597,58 @@ async function siteRun(name, args, options) {
   const jsBody = jsContent.replace(/\/\*\s*@meta[\s\S]*?\*\//, "").trim();
   const argsJson = JSON.stringify(argMap);
   const script = `(${jsBody})(${argsJson})`;
+  if (options.openclaw) {
+    const { ocGetTabs, ocFindTabByDomain, ocOpenTab, ocEvaluate } = await import("./openclaw-bridge-P3G4KGYM.js");
+    let targetId;
+    if (site.domain) {
+      const tabs = ocGetTabs();
+      const existing = ocFindTabByDomain(tabs, site.domain);
+      if (existing) {
+        targetId = existing.targetId;
+      } else {
+        targetId = ocOpenTab(`https://${site.domain}`);
+        await new Promise((resolve2) => setTimeout(resolve2, 3e3));
+      }
+    } else {
+      const tabs = ocGetTabs();
+      if (tabs.length === 0) {
+        throw new Error("No tabs open in OpenClaw browser");
+      }
+      targetId = tabs[0].targetId;
+    }
+    const wrappedFn = `async () => { const __fn = ${jsBody}; return await __fn(${argsJson}); }`;
+    const parsed2 = ocEvaluate(targetId, wrappedFn);
+    if (typeof parsed2 === "object" && parsed2 !== null && "error" in parsed2) {
+      const errObj = parsed2;
+      const checkText = `${errObj.error} ${errObj.hint || ""}`;
+      const isAuthError = /401|403|unauthorized|forbidden|not.?logged|login.?required|sign.?in|auth/i.test(checkText);
+      const loginHint = isAuthError && site.domain ? `Please log in to https://${site.domain} in your OpenClaw browser first, then retry.` : void 0;
+      const hint = loginHint || errObj.hint;
+      const reportHint = `If this is an adapter bug, report via: gh issue create --repo epiral/bb-sites --title "[${name}] <description>" OR: bb-browser site github/issue-create epiral/bb-sites --title "[${name}] <description>"`;
+      if (options.json) {
+        console.log(JSON.stringify({ id: "openclaw", success: false, error: errObj.error, hint, reportHint }));
+      } else {
+        console.error(`[error] site ${name}: ${errObj.error}`);
+        if (hint) console.error(`  Hint: ${hint}`);
+        console.error(`  Report: gh issue create --repo epiral/bb-sites --title "[${name}] ..."`);
+        console.error(`     or: bb-browser site github/issue-create epiral/bb-sites --title "[${name}] ..."`);
+      }
+      process.exit(1);
+    }
+    if (options.jq) {
+      const { applyJq: applyJq2 } = await import("./jq-HHMLHEPA.js");
+      const expr = options.jq.replace(/^\.data\./, ".");
+      const results = applyJq2(parsed2, expr);
+      for (const r of results) {
+        console.log(typeof r === "string" ? r : JSON.stringify(r));
+      }
+    } else if (options.json) {
+      console.log(JSON.stringify({ id: "openclaw", success: true, data: parsed2 }));
+    } else {
+      console.log(JSON.stringify(parsed2, null, 2));
+    }
+    return;
+  }
   await ensureDaemonRunning();
   let targetTabId = options.tabId;
   if (!targetTabId && site.domain) {
@@ -2247,7 +2315,7 @@ async function historyCommand(subCommand, options = {}) {
 }
 
 // packages/cli/src/index.ts
-var VERSION = "0.3.0";
+var VERSION = "0.7.0";
 var HELP_TEXT = `
 bb-browser - AI Agent \u6D4F\u89C8\u5668\u81EA\u52A8\u5316\u5DE5\u5177
 
@@ -2266,6 +2334,7 @@ bb-browser - AI Agent \u6D4F\u89C8\u5668\u81EA\u52A8\u5316\u5DE5\u5177
   site <name> [args]           \u8FD0\u884C adapter
   site update                  \u66F4\u65B0\u793E\u533A adapter \u5E93
   guide                        \u5982\u4F55\u628A\u4EFB\u4F55\u7F51\u7AD9\u53D8\u6210 adapter
+  star                         \u2B50 Star bb-browser on GitHub
 
 \u6D4F\u89C8\u5668\u64CD\u4F5C\uFF1A
   open <url> [--tab]           \u6253\u5F00 URL
@@ -2338,6 +2407,8 @@ function parseArgs(argv) {
         result.flags.jq = args[nextIdx];
         result.flags.json = true;
       }
+    } else if (arg === "--openclaw") {
+      result.flags.openclaw = true;
     } else if (arg === "--help" || arg === "-h") {
       result.flags.help = true;
     } else if (arg === "--version" || arg === "-v") {
@@ -2387,7 +2458,7 @@ async function main() {
     return;
   }
   if (process.argv.includes("--mcp")) {
-    const mcpPath = new URL("./mcp.js", import.meta.url).pathname;
+    const mcpPath = fileURLToPath2(new URL("./mcp.js", import.meta.url));
     const { spawn: spawn3 } = await import("child_process");
     const child = spawn3(process.execPath, [mcpPath], { stdio: "inherit" });
     child.on("exit", (code) => process.exit(code ?? 0));
@@ -2741,10 +2812,32 @@ async function main() {
           json: parsed.flags.json,
           jq: parsed.flags.jq,
           days: parsed.flags.days,
-          tabId: globalTabId
+          tabId: globalTabId,
+          openclaw: parsed.flags.openclaw
         });
         break;
       }
+      case "star": {
+        const { execSync: execSync2 } = await import("child_process");
+        try {
+          execSync2("gh auth status", { stdio: "pipe" });
+        } catch {
+          console.error("\u9700\u8981\u5148\u5B89\u88C5\u5E76\u767B\u5F55 GitHub CLI: https://cli.github.com");
+          console.error("  brew install gh && gh auth login");
+          process.exit(1);
+        }
+        const repos = ["epiral/bb-browser", "epiral/bb-sites"];
+        for (const repo of repos) {
+          try {
+            execSync2(`gh api user/starred/${repo} -X PUT`, { stdio: "pipe" });
+            console.log(`\u2B50 Starred ${repo}`);
+          } catch {
+            console.log(`Already starred or failed: ${repo}`);
+          }
+        }
+        console.log("\nThanks for your support! \u{1F64F}");
+        break;
+      }
       case "guide": {
         console.log(`How to turn any website into a bb-browser site adapter
 =======================================================