webmcp-cli-wxt SKILL.md skillA

webmcp-cli-wxt from opentiny/webmcp-sdk is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add opentiny/webmcp-sdk/webmcp-cli-wxt@v2.0.0

Pins v2.0.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
opentiny/webmcp-sdk
Path
packages/webmcp-cli-skill/wxt/SKILL.md
Versions recorded
1
Latest version
v2.0.0, committed Sep 21, 2026
Size
6,768 bytes
Repository stars
124
License
MIT

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

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file 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

The exact contents, by fingerprint
mdr add opentiny/webmcp-sdk/webmcp-cli-wxt@sha256:f5a1e9a608751e57

The line at the top of this page pins the label v2.0.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

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

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Sep 21, 2026.

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

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the 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 · 124 stars · license MIT · pushed 2026-11-03 · 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 AI assistant 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.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from opentiny/webmcp-sdk

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

Every file in opentiny/webmcp-sdk

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