Communitygithub.com

0183ty2512/wechat-article-publisher

Habilidad para Claude Code / Codex: publica artículos Markdown en la cuenta oficial de WeChat a través de la API, incluyendo script principal y explicación detallada de límites.

¿Qué es wechat-article-publisher?

Este skill permite a agentes de IA como Claude Code o Codex publicar artículos en formato Markdown en la cuenta oficial de WeChat (微信公众号) utilizando su API oficial. Convierte automáticamente Markdown a HTML compatible con WeChat y lo sube como borrador o artículo publicado. Es útil para desarrolladores y creadores de contenido que gestionan cuentas de servicio verificadas (认证服务号) y necesitan automatizar el proceso de publicación. Soporta múltiples herramientas (Claude Code, Codex) y proporciona scripts reutilizables, manejo de límites de API (como el campo de autor con máximo 2 caracteres chinos) y reglas estrictas de organización de archivos: cada artículo debe estar en su propia carpeta. Incluye funciones como subida de imagen de portada, generación de resumen, modo de vista previa local y publicación directa.

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add 0183ty2512/wechat-article-publisher

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Publicador de Artículos para Cuenta Oficial de WeChat

Publica artículos Markdown en la cuenta oficial de WeChat a través de la API: convierte MD a HTML compatible con WeChat y súbelos como borradores o artículos publicados.

Organización de Archivos — Un Artículo por Carpeta (OBLIGATORIO)

Cada artículo DEBE estar en su propia carpeta. No se permiten archivos sueltos en el directorio raíz. Esto mantiene juntas las imágenes de portada, capturas de pantalla, HTML de vista previa y scripts específicos del artículo.

公众号/
├── AI工具前沿观察/
│   ├── AI工具前沿观察_2026-07-07.md
│   ├── AI工具前沿观察_2026-07-07.preview.html
│   └── ai-tools-frontier-2026-07-07.jpg
├── LaTeX教程/
│   ├── LaTeX教程-从零基础到学术公式自由.md
│   ├── latex_tutorial_screenshot.png
│   └── latex-tutorial-article.py
├── _scripts/          ← solo scripts de publicación compartidos
│   ├── wechat_publish.py
│   └── batch_publish_*.py
├── images/            ← activos de imagen compartidos (no específicos de artículo)
├── api.md             ← credenciales compartidas
└── cover.jpg          ← portada por defecto (se puede sobrescribir por artículo)

Reglas:

  1. Antes de escribir cualquier archivo de artículo, crea primero su carpeta (usa un nombre de carpeta en chino que coincida con el título del artículo)
  2. Todos los archivos pertenecientes a un artículo — .md, .preview.html, portada .jpg, capturas .png, scripts .py específicos del artículo — van en esa carpeta
  3. Solo los archivos compartidos/de utilidad permanecen en el nivel raíz o en _scripts/, _参考/, images/
  4. Al publicar por lotes, genera cada artículo en su propia carpeta, no en un directorio plano

Requisitos Previos

El usuario debe tener listo:

  • AppID + AppSecret: Desde el panel de la cuenta oficial de WeChat → Configuración y desarrollo → Configuración básica
  • Lista blanca de IP: La IP pública actual del usuario debe estar añadida a la lista blanca en la misma página
    • Cada vez que la red del usuario cambie, se debe añadir la nueva IP
    • Para verificar la IP actual: curl ifconfig.me o buscar "mi ip"
  • Imagen de portada: 900×500 píxeles, formato jpg/png
  • Tipo de cuenta: Debe ser una cuenta de servicio verificada (认证服务号); las cuentas de suscripción no admiten la API

Flujo de Trabajo

Paso 1: Recopilar Información

Antes de cualquier subida, recopila lo siguiente del usuario:

  1. AppID y AppSecret — pregunta si no se proporcionan (el usuario puede tenerlos en un archivo de configuración)
  2. Nombre del autor — ADVERTENCIA: La API de borradores limita el autor en chino a 2 caracteres hanzi o 4 caracteres mixtos (p. ej., "AI气象", "耄耋AI" son válidos; "人工智能大气科学" = 8 hanzi → FALLO)
  3. Imagen de portada — 900×500 jpg/png. Redimensiona/convierte si es necesario con PIL
  4. Resumen (opcional) — mantenlo por debajo de ~40 caracteres chinos (límite de API ~120 bytes, cada hanzi = 3 bytes)

Paso 2: Escribir / Localizar el Artículo Markdown

Primero, crea una carpeta para el artículo bajo el directorio de trabajo (p. ej., 公众号/). Usa el título del artículo (en chino) como nombre de la carpeta. Luego escribe o localiza el archivo Markdown dentro de esa carpeta.

Todos los archivos específicos del artículo (imágenes de portada, capturas de pantalla, HTML de vista previa, scripts auxiliares) van en esta misma carpeta.

Paso 3: Convertir y Subir

Ejecuta el script de publicación, apuntando al artículo dentro de su carpeta:

python _scripts/wechat_publish.py "carpeta_del_artículo/artículo.md" --author "Firma" --thumb "carpeta_del_artículo/portada.jpg"

Banderas opcionales:

BanderaEfecto
--publishPublica inmediatamente (por defecto: guarda como borrador)
--digest "xxx"Resumen manual (por defecto: extrae automáticamente los primeros 40 caracteres)
--previewSolo genera HTML de vista previa, no se conecta a la API
--title "xxx"Sobrescribe el título (por defecto: el primer encabezado # en MD)
--source-url "url"Enlace de origen original

Paso 4: Verificar en el Panel

Después de una subida exitosa → mp.weixin.qq.com → Bandeja de borradores → previsualizar → publicar manualmente.

Errores Críticos (por experiencia dolorosa)

Estos están documentados en detalle en references/api-limits.md. Los tres más importantes:

1. json.dumps(ensure_ascii=False) ES OBLIGATORIO

requests.post(json=...) llama internamente a json.dumps(ensure_ascii=True), que codifica todo el chino como \uXXXX. WeChat almacena estas secuencias de escape como texto literal. Usa siempre:

payload = json.dumps(data, ensure_ascii=False).encode("utf-8")
requests.post(url, data=payload, headers={"Content-Type": "application/json; charset=utf-8"})

2. Campo de autor: máximo 2 caracteres chinos

WeChat draft/add tiene un límite draconiano: ~8 bytes para el campo de autor. Cada carácter chino = 3 bytes en UTF-8. Por lo tanto: máximo 2 hanzi para nombres puramente chinos. Nombres mixtos chino+ASCII pueden extenderse a ~4 caracteres (p. ej., "耄耋AI").

3. Sin etiquetas <style> — solo estilos en línea

El editor de WeChat elimina los bloques <style> y renderiza su contenido CSS como texto visible del cuerpo. Usa atributos style="" en línea con moderación. También mantén el contenido total por debajo de ~20,000 caracteres para la API.

Ubicación del Script

El script de publicación wechat_publish.py debe colocarse en el directorio de scripts compartidos de tu proyecto (p. ej., _scripts/wechat_publish.py).

Estructura recomendada:

  • Script de publicación compartido: <proyecto>/_scripts/wechat_publish.py
  • Cada artículo en su propia carpeta: <proyecto>/<título_del_artículo>/
  • Credenciales compartidas: <proyecto>/api.md

El script de publicación maneja:

  • Conversión de markdown → HTML de WeChat (Python-Markdown + fenced_code, tables)
  • Subida de imagen de portada (API de material thumb)
  • Creación de borrador con codificación JSON correcta
  • Auto-publicación opcional
  • Modo de vista previa (HTML local sin llamadas a la API)

Obtén el script más reciente de: https://github.com/0183ty2512/wechat-article-publisher

Skills relacionados