mcpbeat

Wechat Publisher

theneoai/wechat-publisher

| 告别公众号格式乱码！一行命令发布文章，100%保留样式。支持三套配色模板、青色/橙色、紫色一键切换。 包含自动发布到微信草稿箱的完整流程，支持中文封面图生成。

3k tokens
context cost
the whole folder, loaded on every use
1
files
instructions only
0
copies elsewhere
how many repositories repackaged it
130
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository 
npx skills add https://github.com/theneoai/awesome-skills --skill wechat-publisher

The instruction itself

17 sections, as written by the author

WeChat Publisher Skill

版本历史

| 版本 | 日期 | 更新内容 |

|-----|------|---------|

| v1.4.0 | 2026-04-06 | 初版发布 |

| v1.5.0 | 2026-04-16 | 新增 API 发布实战经验、中文字体支持、IP 白名单解决方案 |

| v1.6.0 | 2026-04-16 | 移除硬编码 AppID，安全去敏 |

| v1.7.0 | 2026-04-16 | 新增 AI Agent 文章创作经验、多模型并行工作流 |

一、微信公众号 API 发布实战经验（2026-04-16）

1.1 IP 白名单问题

问题描述：

  • 妙搭云电脑使用动态 IP（阿里云），IP 会变化
  • 微信公众号 API 调用需要 IP 在白名单中
  • 服务器直接调用 API 会失败：invalid ip 39.102.54.62, not in whitelist

解决方案：

方案 A：通过浏览器获取 access_token（推荐）

# 在浏览器中打开以下 URL（替换 appid 和 secret）：
https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=你的AppID&secret=你的AppSecret

# 浏览器会返回 JSON 格式的 access_token
# 复制返回结果中的 access_token 值

方案 B：配置 IP 白名单

  • 在公众号后台添加可能的 IP 地址
  • 注意：服务器 IP 可能是动态的，需要添加多个可能的 IP
  • 妙搭云电脑当前 IP：39.102.54.62、39.97.255.102（可能变化）

1.2 封面图生成（中文支持）

问题描述：

  • 服务器默认字体不支持中文，导致生成的封面图文字是方块乱码
  • 需要使用支持中文的字体

解决方案：

# 1. 先检查可用中文字体
fc-list :lang=zh

# 2. 推荐使用 Noto Sans CJK 字体
# 字体路径：/usr/share/fonts/opentype/noto/NotoSansCJK-Black.ttc

# 3. Python PIL 示例代码
from PIL import Image, ImageDraw, ImageFont

img = Image.new('RGB', (900, 383), color='#06b6d4')
draw = ImageDraw.Draw(img)
font = ImageFont.truetype('/usr/share/fonts/opentype/noto/NotoSansCJK-Black.ttc', 56)
draw.text((450, 191), '标题文字', fill='white', anchor='mm', font=font)
img.save('cover.png')

1.3 草稿箱发布完整流程

步骤 1：获取 access_token（通过浏览器）

1. 浏览器打开：https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=你的AppID&secret=你的AppSecret
2. 复制返回的 access_token（有效期 2 小时）

步骤 2：上传封面图获取 media_id

# 使用 curl 上传图片
curl -s "https://api.weixin.qq.com/cgi-bin/material/add_material?access_token=你的TOKEN&type=thumb" \
  -F "[email protected];type=image/png"

# 返回示例：
# {media_id":"vMrq-mSP3SIFyZbOzk_6TkpzzT22KaGPI6r5tTivqFzaskMCnN_U5F4-54CQ38VU",...}

步骤 3：创建草稿箱文章

curl -s "https://api.weixin.qq.com/cgi-bin/draft/add?access_token=你的TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "articles": [{
      "title": "文章标题",
      "author": "作者",
      "content": "<p>文章内容（HTML格式）</p>",
      "digest": "摘要",
      "thumb_media_id": "封面图media_id",
      "need_open_comment": 0,
      "only_fans_can_read": 0
    }]
  }'

1.4 常见错误处理

| 错误码 | 错误信息 | 解决方案 |

|-------|---------|---------|

| 40164 | invalid ip not in whitelist | 通过浏览器获取 token，或添加 IP 到白名单 |

| 40007 | invalid media_id | 必须先上传封面图获取 media_id，不能为空 |

| 40137 | invalid image format | 图片格式问题，确保是 PNG/JPG 格式 |

二、AI Agent 文章创作工作流（2026-04-16 新增）

2.1 多模型并行搜索策略

核心思路：使用多个 AI 模型并行搜索，提高信息覆盖度和时效性

# 并行搜索多个主题
web_search "Agent AI 人工智能 2026年4月 最新技术 新闻"
web_search "OpenClaw GitHub 2026年4月 AI Agent 开源"
web_search "Claude Anthropic 2026年4月 最新动态"

搜索结果整合：

  • 从多个搜索结果中提取关键信息
  • 交叉验证信息的准确性
  • 优先选择一手信息来源（官方公告、技术博客）

2.2 文章结构设计

深度分析文章标准结构：

一、事件/现象级概述
   - 核心事件回顾
   - 数据支撑（用户量、下载量、市场占有率等）

二、技术原理深度剖析
   - 核心技术解读
   - 与竞品的技术对比

三、行业影响分析
   - 对既有格局的冲击
   - 新机会点识别

四、实操指南/应用场景
   - 普通人如何应对
   - 企业如何布局

五、未来展望
   - 趋势判断
   - 行动建议

2.3 爆款标题公式

公式：年份 + 核心事件 + 悬念/情绪词

优秀标题示例：

  • "2026 AI Agent 爆发：从"回答问题"到"完成任务"的跨越"
  • "Claude 突然要查身份证了！AI 实名制时代正式来临"
  • "31万Star！2026最火开源AI神器深度解析"

2.4 长文创作要点

8000字深度文章要点：

  • 每个核心观点至少 500 字的详细阐述
  • 引用真实数据和案例
  • 包含对比表格和示意图（用 HTML/CSS 模拟）
  • 提供可操作的建议
  • 结尾有金句升华主题

2.5 多模型协同工作流

推荐工具组合：

| 场景 | 推荐模型 | 理由 |

|-----|---------|------|

| 资讯搜索 | MiniMax M2.7 | 时效性强，多语言搜索 |

| 深度分析 | GLM-5.1 | 长文本理解能力强 |

| 内容创作 | Miaoda Flash | 速度快，适合初稿 |

| 标题优化 | Qwen3.6 | 中文语感好 |

三、微信公众号文章格式标准

3.1 格式保留关键

微信公众号文章格式保留关键：

  • ❌ 微信编辑器过滤 <style> 标签
  • ❌ 微信编辑器过滤 class 属性
  • ✅ 微信编辑器保留内联样式 style="..."
  • ✅ 微信编辑器保留基础 HTML 标签

列表格式关键：

  • ❌ 不用 <ul>/<li> 列表（会产生多余黑点）
  • ✅ 用 • + 普通 <p> 段落

3.2 完整模板结构

<!DOCTYPE html>
<html>
<body style="font-family: -apple-system, 'PingFang SC', 'Microsoft YaHei', sans-serif; font-size: 15px; line-height: 1.6; color: #333; max-width: 640px; margin: 0 auto; padding: 20px;">

<!-- 标题 -->
<h1 style="font-size: 24px; font-weight: bold; color: #1a1a1a; margin-bottom: 8px;">文章标题</h1>
<p style="color: #999; font-size: 13px; margin-bottom: 20px;">日期 · 分类</p>

<!-- 标签（圆角胶囊） -->
<span style="display: inline-block; background: #e0f7fa; color: #06b6d4; padding: 2px 10px; border-radius: 20px; font-size: 13px; margin-right: 6px;">标签1</span>

<!-- 引言（青色左边框） -->
<p style="font-size: 16px; color: #555; margin: 20px 0; border-left: 4px solid #06b6d4; padding-left: 14px;">引言内容</p>

<!-- 二级标题 -->
<h2 style="font-size: 18px; font-weight: bold; color: #222; margin: 28px 0 14px; border-left: 4px solid #06b6d4; padding-left: 10px;">标题</h2>

<!-- 列表（用 • 符号，不用 <ul>/<li>） -->
<p style="margin: 8px 0; color: #444;">• 列表项1</p>
<p style="margin: 8px 0; color: #444;">• 列表项2</p>

<!-- 引用块 -->
<div style="background: #f0f9fa; border-left: 4px solid #06b6d4; padding: 12px 14px; margin: 16px 0; font-style: italic; color: #555;">
<p style="font-style: normal; color: #333;">引用内容</p>
</div>

<!-- 卡片（浅色背景+圆角+边框） -->
<div style="background: #f8feff; border-radius: 10px; padding: 14px; margin: 14px 0; border: 1px solid #cce8f0;">
<p style="font-weight: bold; color: #0891b2; font-size: 14px;">卡片标题</p>
<p style="color: #555; font-size: 13px;">卡片内容</p>
</div>

<!-- 警告块 -->
<div style="background: #fff8e1; border-left: 4px solid #ffc107; padding: 10px 14px; margin: 12px 0; font-size: 14px; color: #795548;">
<p style="margin: 0;">⚠️ 警告内容</p>
</div>

<!-- 双栏对比 -->
<div style="display: flex; gap: 12px; margin: 12px 0;">
<div style="flex: 1; background: #f8feff; border-radius: 10px; padding: 14px; border: 1px solid #cce8f0;">
<p style="font-weight: bold; color: #0891b2;">左栏标题</p>
<p style="color: #555; font-size: 12px;">左栏内容</p>
</div>
<div style="flex: 1; background: #fff5f5; border-radius: 10px; padding: 14px; border: 1px solid #ffcdd2;">
<p style="font-weight: bold; color: #c62828;">右栏标题</p>
<p style="color: #555; font-size: 12px;">右栏内容</p>
</div>
</div>

<!-- 签名 -->
<div style="text-align: center; color: #999; font-size: 13px; margin-top: 30px; padding-top: 16px; border-top: 1px solid #eee;">
<p>关注我，持续分享 👇</p>
<p style="color: #07c160; margin-top: 8px;">公众号名称</p>
</div>

</body>
</html>

四、配置（首次使用）

安全提示：凭证通过环境变量传递，不要硬编码！

export WECHAT_APP_ID="你的AppID"
export WECHAT_APP_SECRET="你的AppSecret"

获取方式：微信公众平台后台 → 设置与开发 → 基本配置

五、配色方案（固定风格）

| 用途 | 颜色 |

|------|------|

| 主色（标题、标签、边框） | #06b6d4（青色） |

| 标题文字 | #1a1a1a |

| 正文文字 | #444 |

| 次要文字 | #888 |

| 引用/卡片背景 | #f0f9fa / #f8feff |

| 警告背景 | #fff8e1 |

| 代码块背景 | #1a1a2e |

| 代码文字 | #a5f3fc |

六、文件结构

wechat-publisher/
├── SKILL.md           # 本文档（v1.7.0）
└── publish.py         # 发布脚本（可选）

七、注意事项

  • 封面图：必须先上传到微信永久素材，获取 media_id，不能为空
  • 列表：永远用 • + <p>，不用 <ul>/<li>
  • 行距：固定 1.6
  • 段落间距：正文 margin: 12px 0，列表 margin: 8px 0
  • 中文字体：生成封面图时使用 /usr/share/fonts/opentype/noto/NotoSansCJK-Black.ttc
  • access_token 有效期：2 小时，注意及时刷新

八、实战案例（2026-04-16）

案例1：Claude 实名制文章

  • 主题：Anthropic Claude 身份验证政策深度分析
  • 字数：8000字
  • 结构：7大章节 + FAQ
  • 发布：成功上传至草稿箱

案例2：AI Agent 爆发文章

  • 主题：2026 AI Agent 爆发深度剖析
  • 字数：8000字
  • 结构：10大章节
  • 来源：基于多个 AI 模型并行搜索的最新资讯
  • 发布：成功上传至草稿箱

How to use it

Copy the folder

Take theneoai/wechat-publisher from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.