Skip to content

OmniSocKit/Open-Wecom-Skills

⚡ Open WeCom Skills

让你的 AI 大模型成为企业微信开发专家

41 Skills · 550+ APIs · 三大开发模式全覆盖 · MCP 一行命令接入

English | 简体中文

License npm Docs


✨ 这是什么

Open WeCom Skills 是一套面向 AI 大模型的企业微信开发结构化知识体系,源于 源雀 团队六年深耕企微生态、服务 500+ 企业的实战经验结晶。

它不是官方文档的搬运,而是一套为 AI 深度优化的知识工程:

  • 🎯 精确 API 知识 — 每个接口的参数、响应、限制都有结构化文档,杜绝 AI 幻觉
  • 🛡️ 踩坑指南 — 内置 Gotcha Guide,提炼真实项目中的实战经验,让 AI 主动避坑
  • 即用代码模板 — Python / TypeScript / Go / Java / PHP 五语言模板,可直接生成项目代码

💡 源雀开源生态项目 — 本项目中的每一个踩坑指南、参数约束、边界条件,都来自 源雀 SCRM 的一线开发实践,经过大量生产环境验证。 了解源雀 SCRM · 查看开源

有 SKILL vs 没有 SKILL

没有 SKILL 有 SKILL
❌ AI 凭记忆编造 API ✅ AI 精确查阅接口定义
❌ 遗漏 WelcomeCode 20 秒时限 ✅ 主动提醒关键限制
❌ 搞混 follow_user vs follow_info ✅ 参数语义完全准确
❌ 不知道 linkedcorp 全 POST ✅ 知道每个踩坑点

🚀 快速开始

方式一:通过 MCP Server(推荐) ⚡

在你的 AI 工具中添加一行配置,即可让 AI 精通企微全部 API:

{
  "mcpServers": {
    "omnisockit": {
      "command": "npx",
      "args": ["@omnisockit/mcp-server"]
    }
  }
}

零克隆、零配置、AI 按需读取 SKILL — 查看各工具详细配置

兼容所有主流 AI 工具:Claude Desktop / Claude Code / Cursor / Windsurf / VS Code + Copilot / Trae / Antigravity / Cline / Roo Code / Kilo Code / Continue / Cherry Studio / Zed / OpenAI Codex CLI 等。

方式二:手动注入 AI 上下文

skills/ 目录注册到你的 AI 工具:

Claude Code / Codex

# 将 SKILL 复制到项目的 skills 目录
cp -r skills/ your-project/.claude/skills/

# 或创建符号链接
ln -s /path/to/open-wecom-skills/skills your-project/.claude/skills

Cursor

# 在 .cursorrules 中引用
echo "参考 skills/ 目录中的企业微信 SKILL 文档" >> .cursorrules

其他 AI 助手 — 将 skills/ 目录添加到 AI 工具的知识库或上下文中即可。

方式三:作为开发者参考文档

# 克隆仓库
git clone https://github.com/OmniSocKit/Open-Wecom-Skills.git

# 查看 SKILL 分类
ls skills/             # enterprise/ isv/ third-party/
ls skills/enterprise/  # 企业内部开发 30 个
ls skills/isv/         # 服务商代开发 8 个
ls skills/third-party/ # 第三方应用 3 个

# 阅读核心 SKILL(建议第一个读)
cat skills/enterprise/wecom-core.md

方式四:作为项目脚手架

每个 SKILL 都提供代码模板,可直接复制到项目中:

  1. 阅读 wecom-core.md 搭建鉴权基座
  2. 根据业务选择需要的 SKILL 模块
  3. 复制代码模板到项目中
  4. 对照 Code Review 清单做检查

Skills 清单

📁 企业内部开发 (skills/enterprise/) — 30 SKILL

基础域 (7)

SKILL 说明 API 行数
wecom-core 认证基座 · access_token · 回调验签 · 频率限制 5 901
wecom-contact 通讯录管理 · 成员/部门/标签 CRUD · 异步导入 35 1262
wecom-app 应用管理 · 菜单 · 工作台 · 自建机器人 20 1452
wecom-message 消息管理 · 模板卡片 · 群聊 · 撤回 25 1958
wecom-media 素材管理 · 图片/语音/文件上传 6 1163
wecom-auth 身份验证 · OAuth2 · 扫码登录 · 二次验证 12 1407
wecom-jssdk JS-SDK · 网页应用 · 签名 · 分享 30 1106

CRM 域 (8)

SKILL 说明 API 行数
wecom-crm-customer 客户管理 · 列表/详情/备注 · unionid 8 1223
wecom-crm-tag 客户标签 · 企业标签 · 规则组 12 1365
wecom-crm-masssend 群发消息 · 欢迎语 · 群发记录 10 1338
wecom-crm-contactway 联系我 · 渠道活码 · 入群方式 14 1374
wecom-crm-moment 客户朋友圈 · 发表/互动/统计 12 1267
wecom-crm-group 客户群管理 · opengid · 加群 8 1148
wecom-crm-transfer 客户继承 · 在职/离职继承 8 1263
wecom-crm-acquisition 获客助手 · 获客链接 · 额度统计 10 1161

办公域 (8)

SKILL 说明 API 行数
wecom-approval 审批 · 模板/实例 CRUD · 流程推进 15 1483
wecom-doc 文档 · 权限 · 收集表 15 945
wecom-meeting 会议 · 预约/PSTN/网络研讨会 12 1190
wecom-office-checkin 打卡 · 考勤规则/记录/汇总 6 266
wecom-office-calendar 日程 · 日历/参与者/回调 10 256
wecom-office-email 邮件 · 收件箱/群组/公共邮箱 12 222
wecom-office-wedrive 微盘 · 文件管理/权限/分块上传 18 223
wecom-office-live 直播 · 预约/统计/回放 8 188

客服域 (1)

SKILL 说明 API 行数
wecom-kf 微信客服 · 会话/消息/知识库 22 1270

客户端域 (2)

SKILL 说明 API 行数
wecom-miniapp 小程序 · 登录认证 · jwecom 15 329
wecom-mobile-sdk 移动端 SDK · iOS/Android/Harmony 7 233

高级域 (3)

SKILL 说明 API 行数
wecom-advanced 会话存档/企业支付/电子发票/汇报 40 240
wecom-security 安全管理 · 文件防泄漏/设备/人事 18 267
wecom-data-intelligence 数据与智能 · AI 模型/知识集/专区 35 267

行业域 (1)

SKILL 说明 API 行数
wecom-vertical 家校/政民/上下游/企业互联/收款 90 245

📁 服务商代开发 (skills/isv/) — 8 SKILL

SKILL 说明 行数
wecom-isv-core 三级凭证体系 · 自建差异 · 多企业架构 1640
wecom-isv-auth 授权流程 · 预授权码 · 永久授权码 2696
wecom-isv-callback 双通道回调体系 · 指令/数据回调 2875
wecom-isv-license 接口调用许可 · 购买/续期/激活 3551
wecom-isv-billing 收银台 · 定价/收款/订单 2472
wecom-isv-jssdk JS-SDK 签名差异 · 代开发模式 2183
wecom-isv-provider 服务商管理 · 登录/注册 2483
wecom-isv-appendix 错误码 · 频率限制 · 兼容性 956

📁 第三方应用开发 (skills/third-party/) — 3 SKILL

SKILL 说明
wecom-3rd-quickstart 快速入门 · 注册→授权→上架→推广全流程
wecom-3rd-idconvert ID 转换 · corpid/userid/external_userid 加密互转
wecom-3rd-data 数据 API · 获客组件/会话存档/AI 模型

💡 第三方应用的凭证体系复用 ISV SKILL,业务 API 复用企业内部开发 SKILL。


🔧 兼容性

Open WeCom Skills 可配合以下 AI 工具使用(推荐通过 MCP 接入):

AI 工具 MCP 支持 手动注入
Claude Desktop 配置
Claude Code 配置 .claude/skills/
Cursor 配置 .cursorrules
Windsurf 配置 .windsurfrules
VS Code + Copilot 配置 上下文参考
Trae 配置
Cline 配置 知识库
其他 MCP 工具 通用配置 System Prompt

🔒 安全性

MCP Server 的设计原则是纯知识交付,零副作用

安全保证 说明
不调用外部 API MCP Server 不会向企业微信或任何第三方服务器发送请求
不需要凭证 不要求你提供 corpid、secret、access_token 等任何敏感信息
不收集数据 不包含遥测、埋点、使用统计,不上报任何数据
纯本地运行 通过 stdio 与 AI 工具通信,不监听任何网络端口
内容可验证 SKILL 知识内容基于 Open WeCom Skills 开源知识库

💡 你可以通过 npm pack @omnisockit/mcp-server 下载包后检查全部源码,验证以上承诺。


🤝 贡献

欢迎贡献!请查看 贡献指南 了解详情。

简单来说:Fork → 新增/修改 SKILL → 提交 PR


🌐 源雀开源生态

Open WeCom Skills 是 源雀 开源生态中的开发者项目。

  • 💼 需要完整的企微 SCRM 解决方案?源雀 SCRM 源码 100% 开放 · 支持私有化部署 · AI 智能客服 · 会话存档

Note

🚧 本项目仍在持续优化中。 SKILL 内容会随企业微信 API 更新而迭代,部分模块的代码模板和踩坑指南还在完善中。如果你在使用过程中发现任何问题或有改进建议,非常欢迎提交 IssuePull Request,你的反馈是这个项目变得更好的关键驱动力。


📄 License

本项目基于 Apache License 2.0 开源。


如果觉得有用,请给一个 ⭐ Star!

官网 · MCP Server · Issues · Discussions

About

让你的 AI 大模型成为企业微信开发专家 - 1 MCP · 41 Skills · 550+ APIs · 三大开发模式全覆盖 —— Make Your AI Model a WeCom Development Expert - 1 MCP · 41 Skills · 550+ APIs · Comprehensive Coverage of Three Major Development Modes

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors