@xbrowser/cli 1.22.0 → 1.23.1

package/README.md

@@ -1,6 +1,6 @@
 # xbrowser
 
-> **Browser automation CLI** for web scraping, headless browsing, SEO analysis, and AI agent workflows. 51 commands, 75 plugins. A command-line alternative to Playwright, Puppeteer, and Selenium — **no code required**.
+> **Browser automation CLI** for web scraping, headless browsing, SEO analysis, and AI agent workflows. 57 commands, 132 plugins. A command-line alternative to Playwright, Puppeteer, and Selenium — **no code required**.
 
 [![CI Status](https://github.com/dyyz1993/xbrowser/workflows/CI/badge.svg)](https://github.com/dyyz1993/xbrowser/actions)
 [![codecov](https://codecov.io/gh/dyyz1993/xbrowser/branch/master/graph/badge.svg)](https://codecov.io/gh/dyyz1993/xbrowser)
@@ -9,7 +9,7 @@
 
 ## 特性
 
-- **51 浏览器命令** — 导航、交互、查询、存储、截图，覆盖常见自动化场景
+- **57 浏览器命令** — 导航、交互、查询、存储、截图，覆盖常见自动化场景
 - **命令链** — 用 `&&`、`,`、`+`、`->`、`;` 串联多个命令，一行搞定复杂流程
 - **管道 & Heredoc** — 支持 stdin 管道和 heredoc 批量执行
 - **录制 / 回放** — 录制浏览器操作为 YAML，随时回放，可转换为 JS/Python/Bash 脚本
@@ -57,6 +57,22 @@ xbrowser juejin publish --file article.md
 # (Each platform has its own plugin — run `xbrowser plugin list` to see available)
 ```
 
+**Content Marketing — xbrowser promotes itself (dogfooding)**
+```bash
+# Browse the built-in promo case library (self-healing replay, CLI for AI agents, stealth…)
+xbrowser content cases
+
+# Render a case into a platform-ready article (en/zh, {{VAR}} substituted)
+xbrowser content draft --case self-healing-replay --lang zh
+
+# Render an OG cover image with the browser itself — zero imaging libraries
+xbrowser "set-viewport 1200 630 && content cover --title 'Self-Healing Replay' --output cover.png"
+
+# Publish through any of the 18 platform plugins
+xbrowser devto publish --file output/content/self-healing-replay-en.md --tags "typescript,automation"
+```
+The full write → cover → publish loop that promotes xbrowser is itself built on xbrowser commands.
+
 ## 快速开始
 
 ### 安装
@@ -458,6 +474,19 @@ project > browser > page > element
 Error: 需要活跃的页面，请先执行 xbrowser goto <url>
 ```
 
+## MCP Server（AI Agent 接入）
+
+xbrowser 内置 Model Context Protocol 服务器——让 Claude Desktop / Cursor / 任何 MCP 客户端直接使用浏览器能力：
+
+```bash
+# 注册到 Claude Code
+claude mcp add xbrowser -- xbrowser mcp
+
+# 或手动配置（stdio）：command: xbrowser, args: ["mcp"]
+```
+
+7 个工具：`browser_navigate` / `browser_act` / `browser_read` / `browser_snapshot`（accessibility tree，token 友好）/ `browser_screenshot` / `browser_network` / `browser_replay`（自愈回放）。协议冒烟：`node scripts/mcp-smoke.mjs`。
+
 ## 插件系统
 
 ### 插件加载顺序
@@ -546,6 +575,7 @@ xbrowser 自带以下插件：
 | **douyin** | `ai-summary`, `user-info`, `video-info` | 抖音视频信息提取 |
 | **github** | `update-profile`, `add-social-link`, `create-gist`, `get-profile` | GitHub 个人资料管理 |
 | **web-automation** | `extract`, `paginate`, `fill-and-submit`, `screenshot` | 通用 Web 自动化工具 |
+| **content** | `cases`, `draft`, `cover` | 内容营销：内置推广 case 渲染成文 + 浏览器自渲染封面 |
 
 使用插件命令：
 
@@ -884,7 +914,7 @@ xbrowser/
 | **Setup** | `npm i -g` — 0 config | Install + browser download | Install + browser download | Install + WebDriver + drivers |
 | **Web Scraping** | Built-in (`scrape`, `crawl`, `map`) | Write custom scripts | Write custom scripts | Write custom scripts |
 | **Search** | Built-in multi-engine (`search`) | No | No | No |
-| **Plugin Ecosystem** | 75 plugins | Limited | Limited | No |
+| **Plugin Ecosystem** | 132 plugins | Limited | Limited | No |
 | **No Code Required** | ✅ CLI commands | ❌ Must write JS/TS | ❌ Must write JS/TS | ❌ Must write code |
 | **Headless Mode** | ✅ Default | ✅ | ✅ | ✅ |
 | **Record/Replay** | ✅ Built-in (`record`/`replay`) | ✅ Codegen | ❌ | ❌ |

package/dist/{chunk-PIWNMC36.js → chunk-A3MORKYR.js}

@@ -95,7 +95,7 @@ import { join } from "path";
 import { execSync } from "child_process";
 var SHARED_PLUGIN_DEPENDENCIES = {
   "zod": "^3.24.0",
-  "@dyyz1993/xcli-core": "^0.12.1"
+  "@dyyz1993/xcli-core": "^0.19.0"
 };
 function ensurePluginDependencies(pluginsDir) {
   const zodPath = join(pluginsDir, "node_modules", "zod");

package/dist/{chunk-OMU63E6J.js → chunk-FBQZ3PVD.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-HBMEFSTB.js";
 
 // src/human-interaction.ts
-import { execSync } from "child_process";
+import { execFile } from "child_process";
 
 // src/captcha-detector.ts
 var CAPTCHA_SELECTORS = [
@@ -138,11 +138,6 @@ var WebhookNotifier = class {
   }
 };
 
-// src/utils/shell-escape.ts
-function shellEscape(value) {
-  return `'${value.replace(/'/g, "'\\''")}'`;
-}
-
 // src/human-interaction.ts
 var HumanInteractionManager = class {
   wsServer;
@@ -171,8 +166,10 @@ var HumanInteractionManager = class {
   tryAutoOpen(previewUrl) {
     if (!this.autoOpen) return;
     try {
-      const cmd = process.platform === "darwin" ? "open" : process.platform === "linux" ? "xdg-open" : "start";
-      execSync(`${cmd} ${shellEscape(previewUrl)}`, { stdio: "ignore" });
+      const opener = process.platform === "darwin" ? "open" : process.platform === "linux" ? "xdg-open" : "cmd";
+      const args = process.platform === "win32" ? ["/c", "start", "", previewUrl] : [previewUrl];
+      execFile(opener, args, { timeout: 1e4 }, () => {
+      });
     } catch {
     }
   }