Home / opentiny / webmcp-sdk · packages/webmcp-cli-skill/wxt/SKILL.md · GitHub

webmcp-cli-wxt skillA

webmcp-cli-wxt is agent-read markdown (skill) from opentiny/webmcp-sdk: 面向第三方 AI Agent 的 WXT 扩展桥接模式执行指南:通过 Tiny Robot 扩展 WebSocket 桥接操控用户真实浏览器,复用登录态/Cookie,支持双向本地 Bash 协同与高层自主 Agent 委托。.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# WebMCP CLI (WXT 扩展桥接模式) Skill

本 Skill 指导 AI Agent 如何通过 `@opentiny/webmcp-cli --mode wxt` 与用户正在使用的真实 Chrome 浏览器(通过 Tiny Robot 扩展)进行双向通信与操控。

## 适用场景与特征

- **复用真实用户数据**:直接在用户正在使用的浏览器窗口中工作,**完美继承用户的登录态、Cookie、企业内网 SSO 会话、已有标签页**,告别验证码和重新登录。
- **扩展与本地双向协同**:
  - 本地 Agent 可直接操控浏览器中的网页;
  - 浏览器扩展在遇到需本地环境的任务时,可通过 WebSocket 桥接安全请求本地执行 bash 指令或选择目录。
- **高层子代理委托 (`agent run`)**:除了单步交互,可直接将高层任务整包委托给扩展内的 Tiny Robot 自主多轮执行。
- **标识特征**:
  - 必须携带模式参数:`webmcp-cli --mode wxt <command>`(或在终端设置环境变量 `export WEBMCP_MODE=wxt`);
  - Tab ID 格式为 **纯数字**(Chrome Tab ID,如 `1024`);
  - 依赖用户已安装并启用 Tiny Robot 扩展。

## 安装

当 shell 终端提示找不到工具时执行:

```bash
npm install -g @opentiny/webmcp-cli
```

---

## 快速准备与前置排查

### 1. 认证 Token 与配对

CLI 与扩展之间通过 Token 进行安全鉴权,默认保存在 `~/.robot-wxt/bridge-token`。

```bash
# 查看当前本地 Token(若扩展未连接,可将输出的 Token 配置到扩展设置中)
webmcp-cli --mode wxt token

# 将已有的扩展 Token 同步到本地
webmcp-cli --mode wxt token set <你的Token>
```

### 2. 后台守护进程(Daemon)

无需手动启动服务,执行任何 WXT 命令时 CLI 会**自动拉起**后台 WebSocket 桥接进程(监听 `127.0.0.1:18999`)。
如需手动释放端口或停止后台服务:

```bash
webmcp-cli --mode wxt stop
```

### 3. 连接异常排查

若执行命令报连接超时或等待扩展连接,请指导用户:
1. 检查 Chrome 右上角是否已安装并启用 Tiny Robot 扩展;
…

Read the whole file at its exact version.

How to install

Latest version
mdr add opentiny/webmcp-sdk/webmcp-cli-wxt@v2.0.0
Exact content
mdr add opentiny/webmcp-sdk/webmcp-cli-wxt@sha256:f5a1e9a608751e57

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_wadbl4arvtww7hdt.svg)](https://markdownregistry.com/a/art_wadbl4arvtww7hdt)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
v2.0.0 latest2026-09-21 47a2b03 6,768 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (6768 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

opentiny/webmcp-sdk · 119 stars · license MIT · pushed 2026-09-21 · branch dev

API

GET https://markdownregistry.com/api/v1/artifacts/art_wadbl4arvtww7hdt
GET https://markdownregistry.com/api/v1/resolve?ref=opentiny/webmcp-sdk/webmcp-cli-wxt
GET https://markdownregistry.com/api/v1/blob/f5a1e9a608751e57e683f860375f28360597f640c0857c247a404ecaf4824392

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from opentiny/webmcp-sdk

AGENTS.md agents
opentiny/webmcp-sdk · AGENTS.md
git:20260729.c3a3843 · audit A · 119 stars
库存入库管理助手 skill
opentiny/webmcp-sdk · packages/doc-ai-angular/remoter/src/skills/inventory/SKILL.md · 帮助电商管理员理解入库规则并执行入库操作的业务手册
v1.0.0 · audit A · 119 stars
订单管理助手 skill
opentiny/webmcp-sdk · packages/doc-ai-angular/remoter/src/skills/orders/SKILL.md · 帮助电商管理员查询和跟踪客户订单信息。当用户询问某个订单的状态、物流、买家信息,或需要查阅原始订单号以发起价保申请时使用。
v1.0.0 · audit A · 119 stars
客户价保单创建及审核 skill
opentiny/webmcp-sdk · packages/doc-ai-angular/remoter/src/skills/price-protection/SKILL.md · 帮助电商管理员处理顾客因降价提出的补差价请求的业务说明书,比如价保单的创建、审核等
v1.0.0 · audit A · 119 stars
product-guide skill
opentiny/webmcp-sdk · packages/doc-ai-angular/remoter/src/skills/product-guide/SKILL.md · 商品管理指南技能包,提供商品管理相关的搜索、查询和商品详情获取功能。
git:20260312.363d2cc · audit A · 119 stars
商品销售记录分析助手 skill
opentiny/webmcp-sdk · packages/doc-ai-angular/remoter/src/skills/sales/SKILL.md · 帮助电商管理员查询商品销售记录并解读销售趋势的业务说明书
v1.0.0 · audit A · 119 stars
库存入库管理助手 skill
opentiny/webmcp-sdk · packages/doc-ai-react/remoter/src/skills/inventory/SKILL.md · 帮助电商管理员理解入库规则并执行入库操作的业务手册
v1.0.0 · audit A · 119 stars
订单管理助手 skill
opentiny/webmcp-sdk · packages/doc-ai-react/remoter/src/skills/orders/SKILL.md · 帮助电商管理员查询和跟踪客户订单信息。当用户询问某个订单的状态、物流、买家信息,或需要查阅原始订单号以发起价保申请时使用。
v1.0.0 · audit A · 119 stars
客户价保单创建及审核 skill
opentiny/webmcp-sdk · packages/doc-ai-react/remoter/src/skills/price-protection/SKILL.md · 帮助电商管理员处理顾客因降价提出的补差价请求的业务说明书,比如价保单的创建、审核等
v1.0.0 · audit A · 119 stars
商品销售记录分析助手 skill
opentiny/webmcp-sdk · packages/doc-ai-react/remoter/src/skills/sales/SKILL.md · 帮助电商管理员查询商品销售记录并解读销售趋势的业务说明书
v1.0.0 · audit A · 119 stars
库存入库管理助手 skill
opentiny/webmcp-sdk · packages/doc-ai/src/skills/inventory/SKILL.md · 帮助电商管理员理解入库规则并执行入库操作的业务手册
v1.0.0 · audit A · 119 stars
订单管理助手 skill
opentiny/webmcp-sdk · packages/doc-ai/src/skills/orders/SKILL.md · 帮助电商管理员查询和跟踪客户订单信息。当用户询问某个订单的状态、物流、买家信息,或需要查阅原始订单号以发起价保申请时使用。
v1.0.0 · audit A · 119 stars

Every file in opentiny/webmcp-sdk

Browse by kind, by grade A, or by owner.