MCP Web · 产品使用与部署手册

版本：4.8.9 ｜工具集：MCP Web（20 工具） ｜远程托管 + 本地部署

MCP Web 提供网页读写与浏览器自动化：静态极速解析（Axios + Cheerio）+ 真实 Chromium 动态渲染双内核。

一、产品概述

双内核：静态极速解析（Axios + Cheerio）与真实 Chromium 动态渲染。
20 个工具：读取、抽取、交互、截图、下载、批处理、录制回放、任务编排、凭证托管等。
端点：https://mcpweb.wjjnew.cn/mcp（别名 /web/mcp）；仅需 Token，无需额外配置。
鉴权：Authorization: Bearer mcp_sk_xxx。
控制台：https://mcpweb.wjjnew.cn/（注册 / API Token / 积分 / 产物）。
需要 GSC + WP + SEO 工具集？见 https://mcpweb.wjjnew.cn/GSC-WP。

二、工具清单（20）

#	工具	标题	用途
1	`fetch_static_web`	静态网页读取	Axios+Cheerio 极速抓静态页，返回标题/正文/标题结构/链接/HTML 片段
2	`fetch_dynamic_web`	动态网页读取	真实 Chromium 渲染 SPA/后台系统，支持等待/滚动
3	`fetch_web_auto`	网页智能读取（双内核自选）	先静态、不足则自动切动态
4	`web_observe`	页面感知（轻量 OM）	返回带稳定 ID 的可交互元素列表，供精准操作
5	`web_extract`	结构化抽取（Network First）	优先走页面 JSON 接口取结构化数据
6	`web_extract_table`	网页表格结构化提取	把列表/表格抽成结构化数据
7	`web_auto_action`	网页自动交互	填表、点击、上传下载、跨 iframe、弹窗、断言等
8	`web_browser`	浏览器生命周期与状态	启动/关闭、标签页、存储状态、CDP 调试
9	`web_batch`	批量网页抓取	队列式批量抓取
10	`web_record`	操作录制与回放	录制人工操作并回放
11	`web_screenshot`	网页截图	整页/元素截图，托管模式直接返回图片
12	`web_download`	图片/文件/视频下载	单个/批量流式下载，托管模式内联或给签名链接
13	`web_shopify`	Shopify 店铺数据提取	走 Shopify JSON 接口拿商品/集合/产品链接
14	`web_relay`	真实 Chrome 中继	接管用户真实 Chrome（仅同机/本地）
15	`browser`	统一浏览器原子操作	底层浏览器动作原语
16	`task`	任务编排	多步任务定义、执行、重试
17	`vault`	凭证保险箱	加密存储账号/密钥，供自动化复用
18	`write_local_html`	本地网页写入	创建/覆盖 HTML（托管模式写私有工作区）
19	`read_local_html`	本地网页读取	读取 HTML 源码
20	`modify_html_dom`	本地网页 DOM 修改	CSS 选择器精准改 DOM

要点

读取：fetch_static_web / fetch_dynamic_web / fetch_web_auto（含 max_length、max_html_length）。
抽取/交互：web_observe 拿元素 ID → web_auto_action 精准操作；web_extract（Network First）。
产物：web_screenshot / web_download 内联或签名链接；write/read/modify_*_html 作用于私有工作区。
Shopify：web_shopify（获取店铺/集合全部产品链接用它，勿依赖网页工具的链接列表）。

三、快速开始 · Remote 托管

打开 https://mcpweb.wjjnew.cn/ → 注册（邮箱验证，送 500 积分）→ 登录 → 控制台「API Token」创建 Token。
客户端配置：

{
  "mcpServers": {
    "mcp-web": {
      "type": "http",
      "url": "https://mcpweb.wjjnew.cn/mcp",
      "headers": { "Authorization": "Bearer mcp_sk_你的Token" }
    }
  }
}

Claude Desktop：claude_desktop_config.json；Cursor：.cursor/mcp.json；Trae 等：填 URL + 认证方式 API Key / Token。
验证：让 Agent 调用 fetch_static_web 抓 https://example.com，返回标题/正文即成功。

四、远程产物：下载 / 截图 / 工作区

托管模式下工具跑在云服务器，web_download / 截图等通过三层方案交回文件：

内联返回（默认 ≤ 2MB）：位图 → MCP image 块；HTML/JSON/CSV/文本 → resource 块。
签名限时链接（大文件/二进制）：https://mcpweb.wjjnew.cn/files/<签名>，默认 24 小时有效；return_mode（auto/path/inline/url）可覆盖。
每用户私有工作区：write_local_html/read_local_html/modify_html_dom 的 file_path 用工作区相对路径，返回可预览链接；控制台「产物」页可列出/下载/删除。

产物默认保留 24 小时 / 每用户 1GB。命令行拉取：npm run pull -- <签名链接> --out ./downloads。

五、本地部署

方式 A：Windows 程序包

登录 https://mcpweb.wjjnew.cn/ → 首页「本地部署」→ 下载 Windows 程序包（exe + license.pub + README.txt + start.cmd）。
客户端 stdio 配置：

{
  "mcpServers": {
    "mcp-web": {
      "command": "D:\\mcp-web\\mcp-web-full-read-write.exe",
      "env": { "MCP_WEB_HEADLESS": "true", "MCP_WEB_ALLOWED_ROOTS": "D:\\projects;D:\\web" }
    }
  }
}

方式 B：源码

npm install
npm run install:browser     # 安装 Chromium
npm start                   # stdio
npm run start:http          # HTTP（默认 127.0.0.1:3333/mcp）

常用本地配置

变量	说明
`MCP_WEB_HTTP_TOKEN`	HTTP 模式 Bearer Token
`MCP_WEB_ALLOWED_ROOTS`	本地文件白名单根目录（`;`/`,` 分隔）
`MCP_WEB_HEADLESS`	无头模式（`true`/`false`）
`MCP_WEB_DOWNLOADS_DIR`	`web_download` 默认下载目录
`MCP_WEB_DEPLOY_MODE`	`local`（默认）/ `cloud`（服务器）

六、计费与积分

统一积分：与 GSC + WP + SEO 工具集共用一份余额；用量按工具分开统计（控制台概览与流水）。
参考价：静态读取约 1 分/次，动态读取约 3 分/次，交互按动作数，下载按体积；失败按 20% 计。
套餐：1,000 分 ¥9.9 ｜ 10,000 分 ¥79 ｜ 55,000 分 ¥399 ｜ 200,000 分 ¥1,299。
充值：控制台「充值」用兑换码兑换；注册验证邮箱送 500 分。

七、安全与合规

使用免责声明：本服务仅供个人学习研究，或企业在其自有 / 已获授权的网站与系统内部使用；严禁爬取、抓取、批量下载任何未获授权的第三方网站内容，严禁绕过访问控制、侵犯知识产权、窃取数据或任何违法违规用途。使用者须自行符合目标网站 ToS、robots 协议及当地法律，后果自负。违规将被停用账号并保留追责权利。

技术安全：SSRF 防护（拦截私网/链路本地/元数据）、路径白名单、恒定时间鉴权、并发席位；托管模式 web_relay 禁用；产物签名链接带 HMAC + 时效。

八、常见问题与排障

现象	原因	处理
调用全部返回空/无响应	服务重启后客户端持旧 `Mcp-Session-Id`	已内置会话透明重建；重试即可
`web_download` 报路径不在允许目录	连的是本地旧版或本地模式	托管模式已忽略 `save_path`，改返回内联/签名链接
下载/截图只拿到服务器路径	旧版行为	升级后默认内联或给签名链接；`return_mode:url` 可强制给链接
页面链接列表不全	仅来自静态 `<a href>`	用 `web_shopify`、`fetch_dynamic_web` 或 `web_extract`
大输出被截断	单次返回体量过大	用 `max_html_length` / `max_length` 控量，或用 `web_extract`
正文为空（自写解析脚本）	只取直接文本节点	用工具的【正文内容】或改全量提取
401 Unauthorized	Token 缺失/错误	检查 `Authorization: Bearer mcp_sk_xxx`
积分不足	余额 ≤0	控制台「充值」用兑换码兑换
页面白屏（控制台）	编码损坏/缓存	强刷；确保 HTML 为无 BOM UTF-8