wechat-mp-publisher

# 微信公众号远程发布 (Remote Publisher - Compliance Optimized)

**核心痛点解决**：家用宽带 IP 频繁变动，无法固定添加到公众号白名单？
本技能通过远程 `wenyan-mcp` 服务中转，让你的本地 OpenClaw 也能稳定发布文章，无需本地 IP 权限！

## 🌟 架构优势

- **IP 漫游无忧**：仅需将远程 MCP 服务器 IP 加入白名单，无论你在家里、咖啡厅还是 4G 热点，都能随时发布。
- **合规隔离**：凭证与系统配置分离，避免污染全局 `TOOLS.md`。
- **依赖自检**：脚本运行时自动检查 `jq`、`mcporter` 和 `wenyan-cli`。
- **灵活配置**：支持自定义 MCP 配置文件路径。

## ⚙️ 快速配置

### 1. 准备凭证 (wechat.env)

在技能根目录下复制 `wechat.env.example` 为 `wechat.env` 并填入公众号凭证：

```bash
cp wechat.env.example wechat.env
nano wechat.env
```

内容示例：
```bash
export WECHAT_APP_ID="wx..."
export WECHAT_APP_SECRET="cx..."
# Optional: 指定 MCP 配置文件 (默认 $HOME/.openclaw/mcp.json)
# export MCP_CONFIG_FILE="/path/to/your/mcp.json"
```

### 2. 连接远程服务 (mcp.json)

确保你的 `mcp.json` 指向远程 MCP 实例：

```json
{
  "mcpServers": {
    "wenyan-mcp": {
      "name": "公众号远程助手",
      "transport": "sse",
      "url": "http://<your-remote-server-ip>:3000/sse",
      "headers": {
        "X-API-Key": "<optional-api-key>"
      }
    }
  }
}
```

## 🚀 使用指南

### 方式 A: 智能助手 (推荐)

直接对我说：
> "帮我把 `path/to/article.md` 发布到公众号，使用默认主题。"

我会自动：
1. 读取 `wechat.env` 获取凭证
2. 检查本地环境 (`mcporter`, `jq`)
3. 调用远程 MCP 完成发布

### 方式 B: 命令行脚本 (高级)

我们提供了封装好的脚本 `scripts/publish-remote.sh`，体验与本地 CLI 一致：

```bash
# 赋予执行权限
chmod +x scripts/publish-remote.sh

# 发布文章 (自动加载 wechat.env)
./scripts/publish-remote.sh ./my-post.md

# 指定主题 (lapis)
./scripts/publish-remote.sh ./my-post.md lapis
```

## 📝 Markdown 规范

与标准 wenyan-cli 一致，头部必须包含元数据：

```markdown
---
title: 我的精彩文章
cover: https://example.com/cover.jpg
---

# 正文开始
...
```

*提示：`cover` 推荐使用图床链接，以确保远程服务器能正确下载封面。*

##...

# wechat-mp-publisher

**Remote WeChat Official Account Publisher via HTTP MCP**

OpenClaw 技能，用于将 Markdown 文章一键发布到微信公众号草稿箱。
专为解决家用宽带动态 IP 痛点而生，通过远程 `wenyan-mcp` 服务中转，让你的本地环境无需繁琐配置即可稳定发文。

## ✨ 核心特性

- **IP 漫游**: 仅需一次配置远程 MCP 服务器 IP 白名单，无论在哪都能发。
- **大文件传输**: 优化的 `upload_file` 协议，稳定支持长图文。
- **完全兼容**: 支持 wenyan-cli 所有排版主题与 Frontmatter 语法。
- **安全隔离**: 敏感凭证 (AppID/Secret) 仅在运行时传递，不落地存储。

## 📦 快速安装

1. 下载并解压 `wechat-mp-publisher.zip` 到 OpenClaw `skills/` 目录。
2. 配置 `/root/.openclaw/mcp.json` 指向远程服务。
3. 运行 `./scripts/publish-remote.sh` 或直接与 Agent 对话发布。

## 📚 文档索引

- [使用说明 (SKILL.md)](SKILL.md)
- [排版主题预览](references/themes.md)
- [故障排查指南](references/troubleshooting.md)

## 🔗 相关项目

- [wenyan-mcp](https://github.com/caol64/wenyan-mcp): 本技能依赖的后端服务
- [wenyan-cli](https://github.com/caol64/wenyan-cli): 核心排版引擎