Agent skill

Webmcp CLI Wxt

by opentiny in opentiny/webmcp-sdk

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

MITAuto-check passedBackend & APIs

Install Webmcp CLI Wxt

skills CLI
$ npx skills add opentiny/webmcp-sdk --skill webmcp-cli-wxt -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install opentiny/webmcp-sdk webmcp-cli-wxt --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/opentiny/webmcp-sdk.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/webmcp-cli-skill/wxt .claude/skills/webmcp-cli-wxt && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
webmcp-cli-wxt
GitHub stars
121
Token cost
~1.1k tokens
SKILL.md length
180 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 5 steps: 认证 Token 与配对 → 后台守护进程(Daemon) → 连接异常排查 → …
  • Tasks that involve Realtime and WebSockets
  • SKILL.md covers 适用场景与特征, 安装, 快速准备与前置排查 and 交互模式一:高层子代理委托 (agent run) — 推荐, plus 3 more sections
  • Calls npm

What it does

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

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering Realtime and WebSockets. It works with Bash and Model Context Protocol. The repository describes itself as: OpenTiny NEXT-SDKs is a front-end AI and browser automation toolkit. It implements WebMCP + WebSkills to build AI-native apps, and leverages webmcp-cli to enable LLM agents to…. The licence is MIT.

When your agent uses it

  • Tasks that involve Realtime and WebSockets

Example prompts

  • “/webmcp-cli-wxt”

Requirements

  • Node.js

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. 认证 Token 与配对
  2. 后台守护进程(Daemon)
  3. 连接异常排查
  4. 状态感知与标签页管理
  5. 页面元素感知与操作 page-agent-tool

What it can do on your machine

Read from SKILL.md and the folder at commit 47a2b03. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Webmcp CLI Wxt loads about 1.1k tokens when it runs. Until then it costs about 32 tokens; SKILL.md has 180 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~32
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from opentiny/webmcp-sdk at commit 47a2b03, republished under its MIT licence (© opentiny). 180 words, ~1,076 tokens.

Download SKILL.mdSave it as .claude/skills/webmcp-cli-wxt/SKILL.md (or your agent's skills folder).
name
webmcp-cli-wxt
description
面向第三方 AI Agent 的 WXT 扩展桥接模式执行指南:通过 Tiny Robot 扩展 WebSocket 桥接操控用户真实浏览器,复用登录态/Cookie,支持双向本地 Bash 协同与高层自主 Agent 委托。
license
MIT
metadata.author
opentiny
metadata.version
2.0.0

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 扩展;
  2. 确认扩展弹窗中的 Bridge Token 是否与 webmcp-cli --mode wxt token 一致。

交互模式一:高层子代理委托 (agent run) — 推荐

对于复杂、跨步骤的开放式任务(如“帮我查一下上个月的订单并导出报表”、“把该商品加入购物车”),优先整包委托扩展自主执行,无需本地逐行编写点击代码:

bash
# 委托扩展内的 Tiny Robot 自主执行
webmcp-cli --mode wxt agent run "帮我把购物车中的第一个商品结算"

# 限制最大步数自主执行
webmcp-cli --mode wxt agent run --max-steps 10 "搜索最新的 TinyVue 实战教程"

# 针对指定页签执行
webmcp-cli --mode wxt agent run --tab 1024 "审批当前页面的加班申请,意见填同意"

交互模式二:细粒度自主交互(标准流程)

1. 状态感知与标签页管理
bash
# 查询当前活跃标签页与可用工具
webmcp-cli --mode wxt state

# 查询指定标签页(注意:WXT 模式下 Tab ID 必须为纯数字)
webmcp-cli --mode wxt state --tab 1024

# 标签页操作
webmcp-cli --mode wxt tabs open "https://console.cloud.example.com"
webmcp-cli --mode wxt tabs switch 1024
webmcp-cli --mode wxt tabs close 1024
webmcp-cli --mode wxt tabs back
webmcp-cli --mode wxt tabs forward
2. 页面元素感知与操作 page-agent-tool

每个页面均会自动注入该工具。支持动作: browserState、searchTree、click、fill、select、scroll、executeJavascript。

(1) 终端 JSON 参数转义规则
  • bash / zsh 终端:单引号包裹 JSON:webmcp-cli --mode wxt run page-agent-tool '{"action": "click", "index": 0}'
  • cmd 终端:双引号包裹,内部双引号转义:"{\"action\": \"click\", \"index\": 0}"
  • PowerShell 终端:单引号包裹,内部双引号反斜杠转义:'{\"action\": \"click\", \"index\": 0}'
(2) searchTree 优先决策树(降低 80%+ Token)
已知要找的元素类型或文字(如“搜索”、“立即购买”、“button”)?
    ↓ 是
    → 先用 searchTree 搜索
        ↓ 找到了?
            是 → 直接使用命中的 #N 索引操作(click / fill 等)
            否 → 再用 browserState(full) 获取全量树兜底
    ↓ 否(初次进入未知页面或探索全局结构)
    → 用 browserState(full) 抓取完整树

示例:

bash
# 精准按关键词搜索元素并获取 #N 索引
webmcp-cli --mode wxt run page-agent-tool '{"action": "searchTree", "query": "提交"}'
webmcp-cli --mode wxt run page-agent-tool '{"action": "searchTree", "query": "button"}'
(3) 获取页面无障碍树
bash
# 抓取完整无障碍树
webmcp-cli --mode wxt run page-agent-tool '{"action": "browserState", "responseMode": "full"}'

无障碍树节点格式:- role #N [tokens] "accessible name"

  • #N 为唯一操作索引,每次交互后重新分配,严禁复用历史旧索引。
(4) 交互操作(自动返回 diff 增量)
bash
# 点击指定索引
webmcp-cli --mode wxt run page-agent-tool '{"action": "click", "index": 12}'

# 输入文本
webmcp-cli --mode wxt run page-agent-tool '{"action": "fill", "index": 15, "text": "华为商城"}'

# 下拉选择
webmcp-cli --mode wxt run page-agent-tool '{"action": "select", "index": 8, "value": "option_val"}'

# 滚动
webmcp-cli --mode wxt run page-agent-tool '{"action": "scroll", "direction": "down", "amount": 400}'

提示:操作完成后工具会自动返回最新界面的 diff 增量,优先分析 diff 决定下一步,无需重复抓取全局树。


业务技能探索 (skills)

查看扩展当前已载入的业务技能说明(例如企业内部价保审核、商品销售分析规则等):

bash
# 列出扩展已同步的所有业务技能
webmcp-cli --mode wxt skills list

# 查看指定技能的业务流程与规则说明书
webmcp-cli --mode wxt skills get price-protection

启动为标准 MCP 服务

可在 Cursor、Antigravity 或 Claude Desktop 中挂载 WXT 桥接模式:

bash
# 细粒度操作工具暴露
webmcp-cli --mode wxt mcp

# 高层子代理委托模式(暴露 browser_state 与 browser_sub_agent_run 工具,将任务托付给扩展自主规划执行)
webmcp-cli --mode wxt mcp --agent

© opentiny, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in packages/webmcp-cli-skill/wxt of opentiny/webmcp-sdk.

Open the folder on GitHubat commit 47a2b03

Compare with similar skills

Webmcp CLI Wxt next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Webmcp CLI Wxt compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Webmcp CLI Wxt this skillopentiny/webmcp-sdk121—~1.1kAutomated safety check: PassMIT
Supabase Development and Debuggingsupabase/agent-skills2.7k3 repos~3.6kAutomated safety check: PassMIT
Spider Kingaoyunyang/spider-king-skill507—~7.3kAutomated safety check: PassMIT
Agents SDKhodgef/apiker1273 repos~3kAutomated safety check: PassMIT
Mas API ContractAUTO-MAS-Project/AUTO-MAS708—~1.9kAutomated safety check: PassAGPL-3.0
Neon Functionsneondatabase/agent-skills100—~12kAutomated safety check: NotesApache-2.0

Similar skills

  • Official

    General Supabase skill for database, auth, Edge Functions, Realtime and storage work, plus client libraries, migrations, security audits, debugging and reading logs.

    2.7k GitHub starsUsed in 3 repos~3.6k tokens
    Backend & APIsAuto-check passed
  • Spider King

    aoyunyang/spider-king-skill

    Pure-web protocol reverse skill: turn hostile browser clients into browser-free Python collectors.

    507 GitHub stars~7.3k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • Agents SDK

    hodgef/apiker

    Build AI agents on Cloudflare Workers using the Agents SDK. An agent skill from hodgef/apiker.

    127 GitHub starsUsed in 3 repos~3k tokens
    Backend & APIsAuto-check passed
  • Mas API Contract

    AUTO-MAS-Project/AUTO-MAS

    Define backend API contract standards for FastAPI services. An agent skill from AUTO-MAS-Project/AUTO-MAS.

    708 GitHub stars~1.9k tokensUpdated today
    Backend & APIsAuto-check passed
  • Neon Functions

    neondatabase/agent-skills

    Official

    Long-running, serverless Node.js HTTP functions deployed onto your Neon branch, with DATABASEURL injected automatically and compute that runs next to your data.

    100 GitHub stars~12k tokensUpdated yesterday
    Backend & APIsAuto-check: notes
  • Openenv Agentic Rl

    burtenshaw/training-agents

    A skill your agent uses when designing, reviewing, or implementing OpenEnv-style environment interfaces for agentic RL with TRL, including reset/step/state contracts, tasksets, Docker or…

    153 GitHub stars~381 tokensUpdated 25 days ago
    Backend & APIsAuto-check passed

More from opentiny/webmcp-sdk

  • Next SDK Page Agent

    opentiny/webmcp-sdk

    @opentiny/next-sdk 的 page-agent-tool / a11y / registerPageAgentTool 相关开发。

    121 GitHub stars~815 tokensUpdated 17 days ago
    Auto-check passed
  • Webmcp CLI Cdp

    opentiny/webmcp-sdk

    面向第三方 AI Agent 的 CDP 直连模式执行指南:通过 Chrome DevTools Protocol 独立沙箱操作浏览器,自动注入 page-agent-tool 及领域工具。

    121 GitHub stars~1.5k tokensUpdated 17 days ago
    Auto-check passed
  • Drawer Expert

    opentiny/webmcp-sdk

    擅长绘制各种图表、流程图、架构图等,能够提供专业的设计建议和方案

    121 GitHub stars~2.2k tokensUpdated 17 days ago
    Auto-check passed
  • Month Report Expert

    opentiny/webmcp-sdk

    擅长通过工具调用帮助用户生成月报。

    121 GitHub stars~122 tokensUpdated 17 days ago
    Auto-check passed

Categories

Questions about Webmcp CLI Wxt

What does Webmcp CLI Wxt do?

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

When should I use Webmcp CLI Wxt?

Webmcp CLI Wxt fits situations like: tasks that involve Realtime and WebSockets.

How do I install Webmcp CLI Wxt in Claude Code?

Run `npx skills add opentiny/webmcp-sdk --skill webmcp-cli-wxt -a claude-code`. Or copy the skill folder (packages/webmcp-cli-skill/wxt in opentiny/webmcp-sdk) into .claude/skills/webmcp-cli-wxt in your project. Claude Code loads it when a task matches its description.

How do I install Webmcp CLI Wxt in Codex?

Run `npx skills add opentiny/webmcp-sdk --skill webmcp-cli-wxt -a codex`. Or copy the skill folder (packages/webmcp-cli-skill/wxt in opentiny/webmcp-sdk) into .agents/skills/webmcp-cli-wxt in your project. Codex loads it when a task matches its description.

Can I use Webmcp CLI Wxt in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add opentiny/webmcp-sdk --skill webmcp-cli-wxt -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/webmcp-cli-wxt, .gemini/skills/webmcp-cli-wxt, .github/skills/webmcp-cli-wxt and .opencode/skills/webmcp-cli-wxt in your project.

What does Webmcp CLI Wxt need to run?

Going by SKILL.md and its folder, Webmcp CLI Wxt needs the command-line tools its instructions call (npm). Our summary lists: Node.js.

Does Webmcp CLI Wxt access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Webmcp CLI Wxt safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Webmcp CLI Wxt use?

Webmcp CLI Wxt is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Webmcp CLI Wxt use?

About 1.1k tokens (SKILL.md is roughly 4.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Webmcp CLI Wxt?

Skills that share tags, products or a category with Webmcp CLI Wxt: Supabase Development and Debugging (supabase/agent-skills, 2.7k stars), Spider King (aoyunyang/spider-king-skill, 507 stars), Agents SDK (hodgef/apiker, 127 stars) and Mas API Contract (AUTO-MAS-Project/AUTO-MAS, 708 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Webmcp CLI Wxt?

opentiny (a GitHub organization) maintains it in opentiny/webmcp-sdk, which has 121 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on September 21, 2026.

Source: opentiny/webmcp-sdk on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.