前言¶
写自动化脚本读企业微信消息,常见的两条路都不省心:一是直接调企业微信开放接口,要做企业 ID、应用凭证、回调地址和通讯录权限一整套配置,还得自己处理分页和媒体文件下载;二是让 Agent 自己上网找办法,它没有现成的工具可用,只能编流程。
下面介绍的 Skill 解决的就是中间那一层:把「列会话、拉消息、取媒体、发文本」这几件事打包成 Agent 可直接调用的技能,开发者不用自己写胶水代码。
这是什么¶
「企业微信消息」是一个社区来源的通用 SKILL.md 格式技能,坐标 @user_d8831e99/wecomcli-msg,版本 1.0.0,由发布者 user_d8831e99 维护,分类属于 office-efficiency。官方地址为 https://api.skillhub.cn/user_d8831e99/wecomcli-msg ,SkillHub 页面在 https://www.skillhub.cn/skills/user_d8831e99/wecomcli-msg 。
它解决的问题是:当 Agent 需要「看看最近有什么消息」「翻某人的聊天记录」「给群里发一条通知」「把对方发过的图片和文件落下来」时,直接调用这个技能,而不是临时去查企业微信接口文档。
抓取资料中的页面信息显示,评分 100000,下载 4154,标签里带 requires_api_key=false,即页面侧没有标注需要注册 API key。
核心功能¶
按官方简介,这个技能提供四类能力:
- 会话列表查询:列出当前账号可见的会话,用于回答「最近有什么消息」这类问题。
- 消息记录拉取:拉取指定会话的历史消息,支持文本、图片、文件、语音、视频五类消息内容。
- 多媒体文件获取:把消息里的图片、文件、语音、视频取回本地或交给 Agent 继续处理。
- 文本消息发送:向指定联系人或群聊发送文本消息。
触发场景与官方简介一致,当用户说「查看消息」「看聊天记录」「发消息给某人」「最近有什么消息」「给群里发消息」「看看发了什么图片/文件」时,由 Agent 判断并调用该技能。
需要区分两点:发送能力只覆盖文本消息,图片、文件等多媒体是「取」而不是「发」;语音、视频消息可以拉取和获取,但官方简介没有提到语音识别或视频内容理解。
安装与启用¶
官方页面为 https://api.skillhub.cn/user_d8831e99/wecomcli-msg ,SkillHub 页面为 https://www.skillhub.cn/skills/user_d8831e99/wecomcli-msg 。
关于安装命令和配置字段,已抓取的资料里只有坐标、版本、来源、分类、发布者、评分、下载量、标签和简介,没有提供具体的安装命令、目录路径或配置项。作者用 web_fetch 打开上述两个地址尝试核对,页面正文未能抓取到(疑似前端渲染),因此不在这里给出未经核实的安装步骤。建议以官方页面的安装说明为准,拿到命令后再写入自己的 README。
从已有信息可以确定的两点:
- 它是通用 SKILL.md 格式,接入方式遵循你所用 Agent 平台的 Skill 加载规则,而不是一个需要 pip/npm 安装的包。
- 标签
requires_api_key=false是页面侧标注,不代表不需要任何账号权限;企业微信侧的能力大概率仍需对应账号和应用的授权,这一点请在启用前实测确认。
典型用法¶
下面这些示例来自官方简介中列出的触发场景,属于 Agent 侧的调用意图,具体参数名以技能实际的 SKILL.md 为准。
查询会话列表:
最近有什么消息?
拉取某个会话的聊天记录:
看一下张三最近的聊天记录
发送文本消息:
发消息给李四:下午三点评审改到四点
给群聊发通知:
给「项目同步」群发一条消息:本周周报请在周五前提交
获取多媒体文件:
看看昨天群里发了哪些图片和文件,都存下来
这几条都是自然语言形式的指令,由 Agent 解析后落到技能的具体调用上。如果要写进自己的流程,建议把参数(会话名、条数、时间范围、保存路径)显式传给 Agent,而不是只丢一句自然语言,否则它可能挑错会话或拉错条数。
适用场景与注意¶
适合的场景:个人开发者想把企业微信的消息浏览、记录整理、群通知这类重复操作交给 Agent;需要把收到的图片、文件按会话归档;需要 Agent 在对话里回答「刚才发了什么」这类基于上下文的查询。
需要注意的地方:
- 版本 1.0.0,来源是 community,发布者为个人账号
user_d8831e99,没有组织背书。用于内部生产流程前,建议先在测试账号上跑一遍核心链路。 - 发送只支持文本,需要发图片、文件、链接卡片时仍要另找方案。
- 五类消息里,语音、视频只涉及获取,官方简介没有说明转写或抽帧处理。
- 权限边界取决于账号授权范围。会话列表和消息记录受企业微信的管理策略约束,企业如果开启了会话内容存档限制或禁用了应用权限,技能能取到的内容会相应收窄。
- 发送消息属于写操作,建议在提示词里约束 Agent 只在明确授权时发送,避免它自作主张给群里发消息。
结尾¶
这个技能的价值在于把企业微信的读消息和发文本两件事变成 Agent 的一次调用,省掉自建接口对接的工作量。功能边界也比较清楚:能查会话、能拉五类消息、能取多媒体、能发文本,不能做多媒体发送和内容理解。
官方地址:https://api.skillhub.cn/user_d8831e99/wecomcli-msg ,SkillHub 页面:https://www.skillhub.cn/skills/user_d8831e99/wecomcli-msg 。