前言¶

团队协作文档落在企业微信在线文档上时，常见做法是人工打开链接、复制表格或段落，再贴回对话里让 AI 分析或改写。链接在 doc.weixin.qq.com，没有官方面向 Agent 的读写 API，自动化往往停在「截图 + OCR」或半手工导出。

下面介绍 SkillHub 上的 企微文档读写全能小助手 skill（坐标 @user_5f5835e5/wecom-doc-skill，当前版本 1.0.17）。它把企业微信文档 MCP 服务的源码和安装脚本打包进 Skill，安装后由 Playwright 驱动浏览器完成扫码登录，并通过 MCP 工具读取、写入、截图在线文档，无需自行 git clone 拉仓库。

这是什么¶

一句话定位：面向 AI Agent 的企业微信在线文档 MCP 服务安装与使用指南 Skill。

• 发布渠道：SkillHub 社区技能，分类 office-efficiency，发布者 user_5f5835e5；页面标注 requires_api_key=false，不依赖额外 API Key。
• 解决的问题：在 Cursor、CodeBuddy、Windsurf、Claude Desktop 等支持 MCP 的客户端里，让 Agent 能处理 doc.weixin.qq.com 链接——读表格、追写文档、按单元格改表、对幻灯片/导图等做只读提取或截图。
• 实现方式：Skill 内置 source/ 与 scripts/setup.sh，将服务安装到 ~/wecom-doc-mcp，注册名为 wecom-doc 的 MCP Server（node 启动 src/index.js）。

核心功能¶

以下能力均来自 Skill 自带的 SKILL.md 与 references/tool_reference.md。

文档类型¶

MCP 工具¶

运行环境要求（Skill 元数据）：Node.js 18+、首次扫码需要桌面环境；支持 macOS 与 Linux；Playwright Chromium 由安装脚本自动安装。

安装与启用¶

1. 在 SkillHub 安装 Skill¶

先按 SkillHub 安装说明 准备 skillhub CLI（未安装时可执行官方安装脚本）。安装技能时需用 --dir 指向当前 Agent 的 skills 目录，例如 Cursor 为 ~/.cursor/skills/：

skillhub install @user_5f5835e5/wecom-doc-skill --dir ~/.cursor/skills/

也可在 SkillHub 技能页，将提示词发给 AI：「请根据 https://skillhub.cn/install/skillhub.md，安装 @user_5f5835e5/wecom-doc-skill。」

安装完成后，Agent 会加载 Skill 内的 SKILL.md 决策流程。

2. 安装 MCP 服务（首次使用企微文档能力）¶

Skill 要求 Agent 在用户使用文档功能前，检测 ~/wecom-doc-mcp 是否已安装：

test -f ~/wecom-doc-mcp/package.json && echo "已安装" || echo "未安装"

若未安装，在 Skill 目录下执行捆绑脚本（路径以你本机 Skill 解压位置为准）：

bash scripts/setup.sh

脚本会：把内置 source/ 复制到 ~/wecom-doc-mcp → npm install → npx playwright install chromium → 探测本机 AI 工具并写入 MCP 配置。默认安装目录可通过 bash setup.sh [install_dir] 覆盖。

安装成功后需重启 AI 客户端（完全退出再打开），否则 MCP 工具可能不可用。

3. MCP 配置（手动备用）¶

自动配置失败时，可在对应工具的 MCP 配置中加入（args 请改为本机 index.js 绝对路径）：

"wecom-doc": {
    "command": "node",
    "args": ["/Users/yourname/wecom-doc-mcp/src/index.js"],
    "timeout": 180000
}

Skill 文档给出的配置文件位置包括：

setup.sh 还会在未检测到上述目录时，默认写入 CodeBuddy 的 mcp.json。

4. 登录¶

重启后再次发起企微文档相关请求时，Agent 应先调 wecom_doc_status；未登录则调 wecom_doc_login，在弹出浏览器中用企业微信扫码。Cookie 有效期约数天，过期后按同样流程重登。终端备用命令：

cd ~/wecom-doc-mcp && npm run login

典型用法¶

下列示例与官方工具参考一致，便于在对话中复现。

读取整张表格

用户给出 https://doc.weixin.qq.com/sheet/e3_xxx，Agent 调用 wecom_doc_fetch，url 为完整链接；返回中的 sheetList 为工作表列表，sheets 为数据。

读取指定工作表

先 wecom_doc_fetch 不带 tab 拿到 sheetList 里各表的 tab ID，再带 tab 参数读取「项目排期」等指定表。

文档末尾追加段落

对 /doc/ 链接调用 wecom_doc_write，传入 url 与 content（仅纯文本，不支持富文本或中间插入）。

表格单元格写入

wecom_doc_write_sheet(url=..., cell="A5", content="完成", mode="overwrite")

批量追加一行

先 wecom_doc_fetch 确认最后一行行号 N，再对 A{N+1}、B{N+1} … 逐格 wecom_doc_write_sheet，mode 用 overwrite；完成后可再次 fetch 校验。

幻灯片截图

对 /slide/ 等链接调用 wecom_doc_screenshot，可选 output_path。

当工具返回「未登录或登录已过期」时，应先 wecom_doc_login，登录成功后重试原操作。

适用场景与注意¶

适合谁

• 日常在企微文档、在线表格里协作，希望 Cursor / CodeBuddy 等 Agent 直接读表、写单元格、追写会议纪要的团队。
• 愿意在本机跑 Node + Playwright、并接受首次扫码登录的开发者。

限制与注意

• 依赖浏览器自动化，表格写入是逐单元格操作，大批量写入会较慢；type_delay / line_delay 可调输入节奏。
• doc 写入只能在末尾追加；slide / mindmap / flowchart 只读。
• 文档权限仍受企业微信侧控制；页面未加载完可能导致表格为空，需重试或检查权限。
• SkillHub 页面提供维护者微信 tbj18234127547 用于问题私聊；Skill 内 MIT 许可源码作者标注为 baojiantang，上游仓库见 Skill 元数据中的 git.woa.com/baojiantang/wecom-doc-mcp（安装本 Skill 不强制访问该仓库）。

SkillHub 统计（以技能页与抓取数据为准）：评分 100000，下载约 21735 次，安装 72 次。

结尾¶

企微文档读写全能小助手把「安装 MCP + 扫码登录 + 读写 doc.weixin.qq.com」收敛成一条 Skill 工作流：先装 @user_5f5835e5/wecom-doc-skill，再跑 setup.sh，重启客户端后即可用自然语言丢链接让 Agent 调 MCP 工具。

• SkillHub 技能页：https://www.skillhub.cn/skills/user_5f5835e5/wecom-doc-skill
• API 坐标页：https://api.skillhub.cn/user_5f5835e5/wecom-doc-skill