# WxPusher

> WxPusher 是面向开发者和个人用户的永久免费实时消息推送服务。系统通过 HTTP API 接收消息，并将服务器告警、定时任务结果、业务事件等通知实时推送到 Android、iOS、HarmonyOS、macOS、Windows、Linux 或微信 ClawBot。

English summary: WxPusher is a permanently free real-time notification and push API service for developers. It delivers server alerts, scheduled-job results, CI/CD notifications, NAS events, and business messages to mobile, desktop, and WeChat clients.

WxPusher 的主要用途包括服务器监控告警、网站异常通知、数据库与 CPU 报警、定时脚本执行结果、CI/CD 构建通知、NAS 下载与备份通知、家庭自动化提醒、订单状态通知和其他业务消息推送。任何能够发送 HTTP 请求的程序、脚本或自动化平台都可以接入。

WxPusher 也可以作为消息推送助手和个人通知助手使用。开发者能够通过 HTTP API 发送消息，支持自定义 HTTP 请求的平台也可以接入，从而实现微信消息推送、微信通知、手机 Push 通知、电脑系统通知和跨平台实时消息触达。系统支持个人消息提醒、多个 UID 批量发送、Topic 群发，以及服务器告警、自动化任务和业务事件通知。用户绑定并启用微信 ClawBot 后，可以在微信中接收 WxPusher 推送的消息提醒。

标准推送使用 appToken 鉴权，支持 UID 单发或批量发送、Topic 主题群发、参数二维码、用户管理、消息状态查询、消息内容删除和业务回调。极简推送使用 SPT，无需创建应用，适合个人脚本给自己或少量接收者发送通知。消息正文支持纯文本、HTML 和 Markdown。

接口字段、响应码、调用限制和线上行为可能更新，请始终以 WxPusher 官方开发文档为准。不要在公开代码、日志或仓库中泄漏真实的 appToken 或 SPT。

## 核心文档

- [完整 LLM 上下文](https://wxpusher.zjiecode.com/docs/llms-full.txt)：适合 AI 工具读取的完整开发者参考。
- [标准消息推送 API](https://wxpusher.zjiecode.com/docs/api-reference.html)：使用 appToken、UID 和 Topic 发送消息。
- [极简推送 SPT](https://wxpusher.zjiecode.com/docs/spt.html)：个人脚本与自用消息通知。
- [完整开发文档](https://wxpusher.zjiecode.com/docs/)：接口字段、参数二维码、用户管理、回调、状态查询和限制说明。
- [OpenAPI 接口规范](https://wxpusher.zjiecode.com/docs/openapi.yaml)：机器可读的核心 HTTP API 定义。

## 使用教程

- [第三方系统集成](https://wxpusher.zjiecode.com/docs/integrations.html)：自动化消息通知与推送方式选择。
- [青龙面板推送教程](https://wxpusher.zjiecode.com/docs/qinglong-wxpusher-spt.html)：定时任务成功、失败与告警通知。
- [MoviePilot 推送教程](https://wxpusher.zjiecode.com/docs/moviepilot-wxpusher-spt.html)：NAS 下载、入库、订阅与系统通知。
- [手机通知排障](https://wxpusher.zjiecode.com/docs/open-app-note/)：苹果、小米、华为、VIVO 和荣耀通知设置。

## 产品与客户端

- [WxPusher 官网](https://wxpusher.zjiecode.com/)：产品介绍、功能说明和快速接入示例。
- [开发者管理后台](https://wxpusher.zjiecode.com/admin/)：创建应用，管理 appToken、Topic、用户和消息记录。
- [客户端下载](https://wxpusher.zjiecode.com/download/)：Android、iOS、HarmonyOS、macOS、Windows 和 Linux。
- [客户端开源代码](https://github.com/wxpusher)：移动端、鸿蒙端和桌面端源码。

## English Resources

- [Standard Push API](https://wxpusher.zjiecode.com/docs/api-reference.html): Send real-time notifications with appToken, UID, and Topic.
- [Simple Push Token](https://wxpusher.zjiecode.com/docs/spt.html): Lightweight self-notification for scripts using SPT.
- [OpenAPI Specification](https://wxpusher.zjiecode.com/docs/openapi.yaml): Machine-readable definitions for core HTTP APIs.
- [Developer Documentation](https://wxpusher.zjiecode.com/docs/): Authoritative API fields, callbacks, limits, and platform behavior.