wechat-publish 1.0.0__tar.gz

wechat_publish-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wechat-publish contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

wechat_publish-1.0.0/PKG-INFO

@@ -0,0 +1,161 @@
+Metadata-Version: 2.4
+Name: wechat-publish
+Version: 1.0.0
+Summary: Programmatically push rendered HTML articles (with auto-rehosted images) to a WeChat Official Account (公众号) draft box, and optionally publish them.
+Author: 程序员白大力
+License: MIT
+Project-URL: Homepage, https://github.com/baiyigali/wechat-publish
+Project-URL: Repository, https://github.com/baiyigali/wechat-publish
+Keywords: wechat,wechat-mp,公众号,publish,draft,article,cms,api
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Internet :: WWW/HTTP
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25
+Dynamic: license-file
+
+# wechat-publish
+
+把渲染好的 **HTML 文章一键发布到微信公众号**：自动获取 access_token、把正文里的外链图片转存到微信 CDN、上传封面、创建草稿，可选择立即群发。
+
+支持一次推送 **1–8 篇图文**（微信草稿上限），同时提供 Python API 和命令行两种用法。
+
+## 安装
+
+```bash
+pip install wechat-publish
+```
+
+或从源码安装：
+
+```bash
+cd wechat-publish
+pip install .
+```
+
+依赖仅 [`requests`](https://docs.python-requests.org/)。
+
+## 快速开始
+
+### Python API
+
+```python
+from wechat_publish import push_articles
+
+draft_id = push_articles(
+    appid="wx你的AppID",
+    secret="你的AppSecret",
+    articles=[
+        {"html_path": "a1.html", "title": "标题1", "cover_path": "c1.jpg"},
+        {"html_path": "a2.html", "title": "标题2", "cover_path": "c2.jpg"},
+    ],
+    author="程序员白大力",
+    open_comment=True,
+    publish_now=True,   # True=立即群发；False=只存草稿箱
+)
+print("draft media_id =", draft_id)
+```
+
+### 命令行
+
+安装后会得到 `wechat-publish` 命令。AppID / AppSecret 优先读环境变量：
+
+```bash
+export WECHAT_APPID="wx你的AppID"
+export WECHAT_SECRET="你的AppSecret"
+
+wechat-publish \
+    --html a1.html --title "标题1" --cover c1.jpg \
+    --html a2.html --title "标题2" --cover c2.jpg \
+    --author "程序员白大力" --comment --publish
+```
+
+不传 `--publish` 则只存草稿箱；也可以用 `--appid` / `--secret` 直接传入。
+
+## 文章字段说明
+
+`articles` 列表里每一项是一个 dict：
+
+| 字段 | 必填 | 说明 |
+|---|---|---|
+| `html_path` | 是 | 渲染好的 HTML 文件路径（UTF-8） |
+| `title` | 是 | 文章标题，最长 32 字 |
+| `cover_path` | 是 | 封面图路径（jpg/png），会作为永久素材上传 |
+| `digest` | 否 | 摘要，最长 120 字 |
+| `source_url` | 否 | “阅读原文”跳转链接 |
+
+公共参数：
+
+| 参数 | 类型 | 默认 | 说明 |
+|---|---|---|---|
+| `author` | `str` | `""` | 作者名，最长 16 字 |
+| `open_comment` | `bool` | `False` | 是否打开评论 |
+| `publish_now` | `bool` | `False` | True 立即群发，False 仅存草稿 |
+
+## 工作流程
+
+调用 `push_articles()` 时内部按顺序执行：
+
+1. **获取 access_token** —— `cgi-bin/token`，有效期约 2 小时。
+2. **处理正文图片** —— 扫描 HTML 里所有 `<img src>`，把非微信域名（`mmbiz.qpic.cn` / `mmecoa.com` 除外）的图片下载后通过 `cgi-bin/media/uploadimg` 转存，并把 `src` 改写成微信 CDN 地址（微信会过滤外链图片）。
+3. **上传封面** —— 通过 `cgi-bin/material/add_material` 上传为永久图片素材，拿到 `thumb_media_id`。
+4. **创建草稿** —— `cgi-bin/draft/add`，一次最多 8 篇。
+5. **（可选）群发** —— `cgi-bin/freepublish/submit`。
+
+任一接口返回 `errcode != 0` 都会抛出 `wechat_publish.WeChatAPIError`，错误信息里带 errcode / errmsg。
+
+## API 一览
+
+```python
+from wechat_publish import (
+    push_articles,          # 高层入口，从自己代码里调用
+    WeChatAPIError,         # 接口错误异常
+    get_access_token,        # 低层：取 token
+    upload_cover,           # 低层：上传封面永久素材
+    upload_content_images,  # 低层：转存正文图片并改写 src
+    add_draft,              # 低层：创建草稿
+    publish,                # 低层：提交群发
+    MAX_ARTICLES,           # 8
+)
+```
+
+> 常见用法：先 `push_articles(..., publish_now=False)` 存草稿，在公众号后台人工预览确认后，再用返回的 `draft media_id` 调 `publish(token, media_id)` 正式群发。
+
+## CI / 自动发布
+
+仓库自带 GitHub Actions（`.github/workflows/publish.yml`），与常见开源 Python 包一致：
+
+- **push 到 `main`** → 编译 sdist + wheel，自动发布到 **TestPyPI**（官方测试源，验证打包流程不污染正式版）；
+- **打 tag `v*`**（如 `v1.0.0`）→ 编译后发布到**正式 PyPI**；
+- 也支持在 Actions 页面手动触发（`workflow_dispatch`），只编译不发布。
+
+免密推送：在 PyPI / TestPyPI 后台把本仓库配置为 **Trusted Publisher（OIDC）**，workflow 里 `id-token: write` 自动换取临时凭据，不需要任何 `PYPI_API_TOKEN`。
+
+## 技术交流
+
+扫码添加微信，交流使用问题、定制与合作：
+
+<p align="center">
+  <img src="docs/images/wechat-contact-qr.jpg" alt="微信二维码" width="240" />
+</p>
+
+## 项目赞助
+
+本项目由微信公众号 **「程序员白大力」** 提供赞助，感谢支持：
+
+<p align="center">
+  <img src="docs/images/wechat-official-account-qr.png" alt="程序员白大力公众号二维码" width="240" />
+</p>
+
+## License
+
+MIT

wechat_publish-1.0.0/README.md

@@ -0,0 +1,136 @@
+# wechat-publish
+
+把渲染好的 **HTML 文章一键发布到微信公众号**：自动获取 access_token、把正文里的外链图片转存到微信 CDN、上传封面、创建草稿，可选择立即群发。
+
+支持一次推送 **1–8 篇图文**（微信草稿上限），同时提供 Python API 和命令行两种用法。
+
+## 安装
+
+```bash
+pip install wechat-publish
+```
+
+或从源码安装：
+
+```bash
+cd wechat-publish
+pip install .
+```
+
+依赖仅 [`requests`](https://docs.python-requests.org/)。
+
+## 快速开始
+
+### Python API
+
+```python
+from wechat_publish import push_articles
+
+draft_id = push_articles(
+    appid="wx你的AppID",
+    secret="你的AppSecret",
+    articles=[
+        {"html_path": "a1.html", "title": "标题1", "cover_path": "c1.jpg"},
+        {"html_path": "a2.html", "title": "标题2", "cover_path": "c2.jpg"},
+    ],
+    author="程序员白大力",
+    open_comment=True,
+    publish_now=True,   # True=立即群发；False=只存草稿箱
+)
+print("draft media_id =", draft_id)
+```
+
+### 命令行
+
+安装后会得到 `wechat-publish` 命令。AppID / AppSecret 优先读环境变量：
+
+```bash
+export WECHAT_APPID="wx你的AppID"
+export WECHAT_SECRET="你的AppSecret"
+
+wechat-publish \
+    --html a1.html --title "标题1" --cover c1.jpg \
+    --html a2.html --title "标题2" --cover c2.jpg \
+    --author "程序员白大力" --comment --publish
+```
+
+不传 `--publish` 则只存草稿箱；也可以用 `--appid` / `--secret` 直接传入。
+
+## 文章字段说明
+
+`articles` 列表里每一项是一个 dict：
+
+| 字段 | 必填 | 说明 |
+|---|---|---|
+| `html_path` | 是 | 渲染好的 HTML 文件路径（UTF-8） |
+| `title` | 是 | 文章标题，最长 32 字 |
+| `cover_path` | 是 | 封面图路径（jpg/png），会作为永久素材上传 |
+| `digest` | 否 | 摘要，最长 120 字 |
+| `source_url` | 否 | “阅读原文”跳转链接 |
+
+公共参数：
+
+| 参数 | 类型 | 默认 | 说明 |
+|---|---|---|---|
+| `author` | `str` | `""` | 作者名，最长 16 字 |
+| `open_comment` | `bool` | `False` | 是否打开评论 |
+| `publish_now` | `bool` | `False` | True 立即群发，False 仅存草稿 |
+
+## 工作流程
+
+调用 `push_articles()` 时内部按顺序执行：
+
+1. **获取 access_token** —— `cgi-bin/token`，有效期约 2 小时。
+2. **处理正文图片** —— 扫描 HTML 里所有 `<img src>`，把非微信域名（`mmbiz.qpic.cn` / `mmecoa.com` 除外）的图片下载后通过 `cgi-bin/media/uploadimg` 转存，并把 `src` 改写成微信 CDN 地址（微信会过滤外链图片）。
+3. **上传封面** —— 通过 `cgi-bin/material/add_material` 上传为永久图片素材，拿到 `thumb_media_id`。
+4. **创建草稿** —— `cgi-bin/draft/add`，一次最多 8 篇。
+5. **（可选）群发** —— `cgi-bin/freepublish/submit`。
+
+任一接口返回 `errcode != 0` 都会抛出 `wechat_publish.WeChatAPIError`，错误信息里带 errcode / errmsg。
+
+## API 一览
+
+```python
+from wechat_publish import (
+    push_articles,          # 高层入口，从自己代码里调用
+    WeChatAPIError,         # 接口错误异常
+    get_access_token,        # 低层：取 token
+    upload_cover,           # 低层：上传封面永久素材
+    upload_content_images,  # 低层：转存正文图片并改写 src
+    add_draft,              # 低层：创建草稿
+    publish,                # 低层：提交群发
+    MAX_ARTICLES,           # 8
+)
+```
+
+> 常见用法：先 `push_articles(..., publish_now=False)` 存草稿，在公众号后台人工预览确认后，再用返回的 `draft media_id` 调 `publish(token, media_id)` 正式群发。
+
+## CI / 自动发布
+
+仓库自带 GitHub Actions（`.github/workflows/publish.yml`），与常见开源 Python 包一致：
+
+- **push 到 `main`** → 编译 sdist + wheel，自动发布到 **TestPyPI**（官方测试源，验证打包流程不污染正式版）；
+- **打 tag `v*`**（如 `v1.0.0`）→ 编译后发布到**正式 PyPI**；
+- 也支持在 Actions 页面手动触发（`workflow_dispatch`），只编译不发布。
+
+免密推送：在 PyPI / TestPyPI 后台把本仓库配置为 **Trusted Publisher（OIDC）**，workflow 里 `id-token: write` 自动换取临时凭据，不需要任何 `PYPI_API_TOKEN`。
+
+## 技术交流
+
+扫码添加微信，交流使用问题、定制与合作：
+
+<p align="center">
+  <img src="docs/images/wechat-contact-qr.jpg" alt="微信二维码" width="240" />
+</p>
+
+## 项目赞助
+
+本项目由微信公众号 **「程序员白大力」** 提供赞助，感谢支持：
+
+<p align="center">
+  <img src="docs/images/wechat-official-account-qr.png" alt="程序员白大力公众号二维码" width="240" />
+</p>
+
+## License
+
+MIT

wechat_publish-1.0.0/pyproject.toml

@@ -0,0 +1,43 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "wechat-publish"
+version = "1.0.0"
+description = "Programmatically push rendered HTML articles (with auto-rehosted images) to a WeChat Official Account (公众号) draft box, and optionally publish them."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [
+    { name = "程序员白大力" },
+]
+keywords = ["wechat", "wechat-mp", "公众号", "publish", "draft", "article", "cms", "api"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Internet :: WWW/HTTP",
+]
+dependencies = [
+    "requests>=2.25",
+]
+
+[project.scripts]
+wechat-publish = "wechat_publish.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/baiyigali/wechat-publish"
+Repository = "https://github.com/baiyigali/wechat-publish"
+
+[tool.setuptools]
+packages = ["wechat_publish"]
+
+[tool.setuptools.package-data]
+wechat_publish = ["py.typed"]

wechat_publish-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

wechat_publish-1.0.0/tests/test_publish.py

@@ -0,0 +1,110 @@
+"""Offline unit tests for wechat_publish — no real WeChat API calls.
+
+Network calls are patched, so this runs in CI with zero credentials.
+"""
+
+from pathlib import Path
+
+import pytest
+
+from wechat_publish import (
+    MAX_ARTICLES,
+    WeChatAPIError,
+    __version__,
+    push_articles,
+    upload_content_images,
+)
+from wechat_publish.core import _check
+
+
+class _FakeResp:
+    def __init__(self, data):
+        self._data = data
+        self.headers = {}
+
+    def json(self):
+        return self._data
+
+
+def test_version_exported():
+    assert isinstance(__version__, str)
+    assert __version__
+
+
+def test_check_raises_on_errcode():
+    with pytest.raises(WeChatAPIError):
+        _check(_FakeResp({"errcode": 40001, "errmsg": "invalid credential"}), "test")
+
+
+def test_check_passes_when_no_errcode():
+    data = {"access_token": "abc"}
+    assert _check(_FakeResp(data), "test") is data
+
+
+def test_push_articles_requires_at_least_one():
+    with pytest.raises(ValueError):
+        push_articles("wx", "secret", [])
+
+
+def test_push_articles_caps_at_eight():
+    articles = [{"html_path": "x", "title": "t", "cover_path": "x"}] * (MAX_ARTICLES + 1)
+    with pytest.raises(ValueError):
+        push_articles("wx", "secret", articles)
+
+
+def test_upload_content_images_no_images_returns_unchanged():
+    html = "<p>hello</p>"
+    assert upload_content_images("token", html) == html
+
+
+def test_upload_content_images_skips_wechat_hosts(monkeypatch):
+    # mmbiz images must NOT be downloaded / re-uploaded
+    html = '<p><img src="https://mmbiz.qpic.cn/aaa/640"></p>'
+    calls = []
+
+    def _no_get(*a, **k):
+        calls.append(a)
+        raise AssertionError("should not download mmbiz image")
+
+    monkeypatch.setattr("wechat_publish.core.requests.get", _no_get)
+    out = upload_content_images("token", html)
+    assert out == html
+    assert calls == []
+
+
+def test_upload_content_images_replaces_external_image(monkeypatch):
+    html = '<p><img src="https://example.com/a.png"></p>'
+
+    class _ImgResp:
+        headers = {"Content-Type": "image/png"}
+
+        def raise_for_status(self):
+            pass
+
+        content = b"\x89PNG fake"
+
+    def fake_get(url, timeout=0):
+        return _ImgResp()
+
+    def fake_post(url, params=None, files=None, timeout=0):
+        return _FakeResp({"url": "https://mmbiz.qpic.cn/wechat/new.png"})
+
+    monkeypatch.setattr("wechat_publish.core.requests.get", fake_get)
+    monkeypatch.setattr("wechat_publish.core.requests.post", fake_post)
+
+    out = upload_content_images("token", html)
+    assert "example.com/a.png" not in out
+    assert "mmbiz.qpic.cn/wechat/new.png" in out
+
+
+def test_push_articles_missing_html_file_raises(tmp_path, monkeypatch):
+    # token fetch succeeds, but html_path does not exist
+    monkeypatch.setattr(
+        "wechat_publish.core.get_access_token", lambda a, s: "tok"
+    )
+    missing = tmp_path / "nope.html"
+    with pytest.raises(FileNotFoundError):
+        push_articles(
+            "wx", "secret",
+            [{"html_path": str(missing), "title": "t", "cover_path": str(tmp_path / "c.jpg")}],
+        )

wechat_publish-1.0.0/wechat_publish/__init__.py

@@ -0,0 +1,46 @@
+"""wechat_publish — programmatically publish rendered HTML articles to a
+WeChat Official Account (公众号).
+
+Public API::
+
+    from wechat_publish import push_articles, WeChatAPIError
+
+    draft_id = push_articles(
+        appid="wx...",
+        secret="...",
+        articles=[
+            {"html_path": "a1.html", "title": "标题1", "cover_path": "c1.jpg"},
+        ],
+        author="程序员白大力",
+        open_comment=True,
+        publish_now=True,
+    )
+
+A ``wechat-publish`` console script is also installed for quick testing.
+"""
+
+from __future__ import annotations
+
+from .core import (
+    MAX_ARTICLES,
+    WeChatAPIError,
+    add_draft,
+    get_access_token,
+    publish,
+    push_articles,
+    upload_content_images,
+    upload_cover,
+)
+
+__all__ = [
+    "MAX_ARTICLES",
+    "WeChatAPIError",
+    "add_draft",
+    "get_access_token",
+    "publish",
+    "push_articles",
+    "upload_content_images",
+    "upload_cover",
+]
+
+__version__ = "1.0.0"

wechat_publish-1.0.0/wechat_publish/cli.py

@@ -0,0 +1,62 @@
+"""CLI entry point for wechat_publish.
+
+Installs the ``wechat-publish`` console script via ``[project.scripts]``.
+"""
+
+from __future__ import annotations
+
+import argparse
+import os
+import sys
+
+from .core import push_articles
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(
+        prog="wechat-publish",
+        description="Push rendered HTML files to WeChat MP (1-8 articles per push).",
+        epilog="""\
+Examples:
+  wechat-publish --html a.html --title "标题" --cover c.jpg
+  wechat-publish \\
+      --html a1.html --title "标题1" --cover c1.jpg \\
+      --html a2.html --title "标题2" --cover c2.jpg \\
+      --author "程序员白大力" --comment --publish
+""",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+    parser.add_argument("--html", action="append", required=True,
+                        help="Path to rendered HTML file (repeat for multiple articles)")
+    parser.add_argument("--title", action="append", required=True,
+                        help="Article title (repeat, one per --html)")
+    parser.add_argument("--cover", action="append", required=True,
+                        help="Cover image path (repeat, one per --html)")
+    parser.add_argument("--author", default="", help="Author name (max 16 chars)")
+    parser.add_argument("--comment", action="store_true", help="Open comments")
+    parser.add_argument("--publish", action="store_true", help="Publish immediately")
+    parser.add_argument("--appid", default=os.environ.get("WECHAT_APPID", ""))
+    parser.add_argument("--secret", default=os.environ.get("WECHAT_SECRET", ""))
+    args = parser.parse_args()
+
+    if not args.appid or not args.secret:
+        sys.exit("Error: set WECHAT_APPID / WECHAT_SECRET env vars or pass --appid/--secret")
+
+    if not (len(args.html) == len(args.title) == len(args.cover)):
+        sys.exit("Error: --html, --title and --cover must be repeated the same number of times")
+
+    articles = [
+        {"html_path": h, "title": t, "cover_path": c}
+        for h, t, c in zip(args.html, args.title, args.cover)
+    ]
+
+    push_articles(
+        args.appid, args.secret, articles,
+        author=args.author,
+        open_comment=args.comment,
+        publish_now=args.publish,
+    )
+
+
+if __name__ == "__main__":
+    main()

wechat_publish-1.0.0/wechat_publish/core.py

@@ -0,0 +1,241 @@
+"""Low-level and high-level API for publishing to WeChat Official Account (公众号).
+
+This module is a faithful refactor of the original ``wechat_publish.py`` script:
+all behavior (error handling, image re-hosting, draft + publish flow) is kept.
+"""
+
+from __future__ import annotations
+
+import json
+import re
+from pathlib import Path
+from urllib.parse import urlparse
+
+import requests
+
+BASE = "https://api.weixin.qq.com/cgi-bin"
+MAX_ARTICLES = 8  # WeChat allows 1-8 articles per draft
+
+
+class WeChatAPIError(RuntimeError):
+    """Raised when WeChat returns an errcode != 0."""
+
+
+def _check(resp: requests.Response, action: str) -> dict:
+    """Parse a WeChat JSON response and raise on API error."""
+    data = resp.json()
+    if "errcode" in data and data["errcode"] != 0:
+        raise WeChatAPIError(
+            f"{action} failed: errcode={data['errcode']} errmsg={data.get('errmsg', '')}"
+        )
+    return data
+
+
+# ---------------------------------------------------------------------------
+# Low-level API
+# ---------------------------------------------------------------------------
+def get_access_token(appid: str, secret: str) -> str:
+    """Fetch a valid access_token. Valid for ~2 hours."""
+    resp = requests.get(
+        f"{BASE}/token",
+        params={"grant_type": "client_credential", "appid": appid, "secret": secret},
+        timeout=15,
+    )
+    data = _check(resp, "get access_token")
+    token = data.get("access_token")
+    if not token:
+        raise WeChatAPIError(f"no access_token in response: {data}")
+    return token
+
+
+def upload_cover(token: str, image_path: str | Path) -> str:
+    """Upload an image as a permanent material, returns thumb_media_id."""
+    image_path = Path(image_path)
+    with open(image_path, "rb") as f:
+        resp = requests.post(
+            f"{BASE}/material/add_material",
+            params={"access_token": token, "type": "image"},
+            files={"media": (image_path.name, f, "image/jpeg")},
+            timeout=30,
+        )
+    data = _check(resp, "upload cover")
+    media_id = data.get("media_id")
+    if not media_id:
+        raise WeChatAPIError(f"no media_id in response: {data}")
+    return media_id
+
+
+def upload_content_images(token: str, html: str) -> str:
+    """Download every external <img> in *html*, upload it to WeChat, and
+    rewrite the ``src`` to WeChat's own CDN URL.
+
+    WeChat filters non-WeChat image URLs out of article content, so we
+    must proxy them through ``/cgi-bin/media/uploadimg`` first.
+    """
+    img_urls = re.findall(r'<img[^>]+src="([^"]+)"', html)
+    if not img_urls:
+        return html
+
+    replaced = html
+    for url in img_urls:
+        host = urlparse(url).netloc
+        if "mmbiz.qpic.cn" in host or "mmecoa.com" in host:
+            continue
+
+        try:
+            resp = requests.get(url, timeout=30)
+            resp.raise_for_status()
+        except Exception as e:
+            print(f"  [warn] failed to download {url}: {e}")
+            continue
+
+        content_type = resp.headers.get("Content-Type", "image/jpeg")
+        ext_map = {
+            "image/jpeg": "jpg", "image/jpg": "jpg", "image/png": "png",
+            "image/gif": "gif", "image/webp": "webp",
+        }
+        ext = ext_map.get(content_type, "jpg")
+        fname = f"img.{ext}"
+
+        up = requests.post(
+            f"{BASE}/media/uploadimg",
+            params={"access_token": token},
+            files={"media": (fname, resp.content, content_type)},
+            timeout=30,
+        )
+        up_data = up.json()
+        if "url" not in up_data:
+            print(f"  [warn] uploadimg failed for {url}: {up_data}")
+            continue
+
+        wechat_url = up_data["url"]
+        print(f"  [image] {url} -> {wechat_url}")
+        replaced = replaced.replace(f'src="{url}"', f'src="{wechat_url}"')
+
+    return replaced
+
+
+def add_draft(token: str, articles: list[dict]) -> str:
+    """Create a draft with 1-8 articles. Returns draft media_id."""
+    body = json.dumps({"articles": articles}, ensure_ascii=False).encode("utf-8")
+    resp = requests.post(
+        f"{BASE}/draft/add",
+        params={"access_token": token},
+        data=body,
+        headers={"Content-Type": "application/json; charset=utf-8"},
+        timeout=60,
+    )
+    data = _check(resp, "add draft")
+    media_id = data.get("media_id")
+    if not media_id:
+        raise WeChatAPIError(f"no media_id in draft response: {data}")
+    return media_id
+
+
+def publish(token: str, media_id: str) -> dict:
+    """Submit a draft for publishing. Returns the publish job info."""
+    body = json.dumps({"media_id": media_id}, ensure_ascii=False).encode("utf-8")
+    resp = requests.post(
+        f"{BASE}/freepublish/submit",
+        params={"access_token": token},
+        data=body,
+        headers={"Content-Type": "application/json; charset=utf-8"},
+        timeout=30,
+    )
+    return _check(resp, "publish")
+
+
+# ---------------------------------------------------------------------------
+# High-level API — call this from your own code
+# ---------------------------------------------------------------------------
+def push_articles(
+    appid: str,
+    secret: str,
+    articles: list[dict],
+    *,
+    author: str = "",
+    open_comment: bool = False,
+    publish_now: bool = False,
+) -> str:
+    """Push one or more articles to WeChat MP.
+
+    Parameters
+    ----------
+    appid : str
+        WeChat official account AppID.
+    secret : str
+        WeChat official account AppSecret.
+    articles : list[dict]
+        Each dict must contain:
+          - ``html_path``  — path to the rendered HTML file
+          - ``title``      — article title (max 32 chars)
+          - ``cover_path`` — path to the cover image (jpg/png)
+        Optional keys per article:
+          - ``digest``     — summary (max 120 chars)
+          - ``source_url`` — "read more" URL
+        Up to 8 articles allowed.
+    author : str
+        Author name for all articles (max 16 chars).
+    open_comment : bool
+        Whether to enable comments on all articles.
+    publish_now : bool
+        If True, publish immediately after creating the draft.
+        If False, only save to draft box.
+
+    Returns
+    -------
+    str
+        The draft ``media_id`` (pass to ``publish()`` to publish later).
+    """
+    n = len(articles)
+    if n < 1:
+        raise ValueError("at least one article is required")
+    if n > MAX_ARTICLES:
+        raise ValueError(f"WeChat allows at most {MAX_ARTICLES} articles per push (got {n})")
+
+    # Token
+    token = get_access_token(appid, secret)
+    print(f"[1/3] got access_token")
+
+    # Build articles
+    wechat_articles = []
+    for i, art in enumerate(articles):
+        title = art["title"]
+        print(f"[2/3] article {i + 1}/{n}: {title}")
+
+        html_path = Path(art["html_path"])
+        if not html_path.exists():
+            raise FileNotFoundError(f"HTML file not found: {html_path}")
+        content = html_path.read_text(encoding="utf-8")
+
+        # Rehost external images
+        content = upload_content_images(token, content)
+
+        # Upload cover
+        cover_path = Path(art["cover_path"])
+        if not cover_path.exists():
+            raise FileNotFoundError(f"cover image not found: {cover_path}")
+        thumb_id = upload_cover(token, cover_path)
+
+        wechat_articles.append({
+            "title": title,
+            "author": author[:16],
+            "digest": art.get("digest", ""),
+            "content": content,
+            "content_source_url": art.get("source_url", ""),
+            "thumb_media_id": thumb_id,
+            "need_open_comment": 1 if open_comment else 0,
+            "only_fans_can_comment": 0,
+        })
+
+    # Create draft
+    draft_id = add_draft(token, wechat_articles)
+    print(f"[3/3] draft created -> media_id={draft_id}")
+
+    if publish_now:
+        result = publish(token, draft_id)
+        print(f"published! publish_id={result.get('publish_id')}")
+    else:
+        print("draft saved (not published). pass publish_now=True to publish immediately.")
+
+    return draft_id

wechat_publish-1.0.0/wechat_publish.egg-info/PKG-INFO

@@ -0,0 +1,161 @@
+Metadata-Version: 2.4
+Name: wechat-publish
+Version: 1.0.0
+Summary: Programmatically push rendered HTML articles (with auto-rehosted images) to a WeChat Official Account (公众号) draft box, and optionally publish them.
+Author: 程序员白大力
+License: MIT
+Project-URL: Homepage, https://github.com/baiyigali/wechat-publish
+Project-URL: Repository, https://github.com/baiyigali/wechat-publish
+Keywords: wechat,wechat-mp,公众号,publish,draft,article,cms,api
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Internet :: WWW/HTTP
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25
+Dynamic: license-file
+
+# wechat-publish
+
+把渲染好的 **HTML 文章一键发布到微信公众号**：自动获取 access_token、把正文里的外链图片转存到微信 CDN、上传封面、创建草稿，可选择立即群发。
+
+支持一次推送 **1–8 篇图文**（微信草稿上限），同时提供 Python API 和命令行两种用法。
+
+## 安装
+
+```bash
+pip install wechat-publish
+```
+
+或从源码安装：
+
+```bash
+cd wechat-publish
+pip install .
+```
+
+依赖仅 [`requests`](https://docs.python-requests.org/)。
+
+## 快速开始
+
+### Python API
+
+```python
+from wechat_publish import push_articles
+
+draft_id = push_articles(
+    appid="wx你的AppID",
+    secret="你的AppSecret",
+    articles=[
+        {"html_path": "a1.html", "title": "标题1", "cover_path": "c1.jpg"},
+        {"html_path": "a2.html", "title": "标题2", "cover_path": "c2.jpg"},
+    ],
+    author="程序员白大力",
+    open_comment=True,
+    publish_now=True,   # True=立即群发；False=只存草稿箱
+)
+print("draft media_id =", draft_id)
+```
+
+### 命令行
+
+安装后会得到 `wechat-publish` 命令。AppID / AppSecret 优先读环境变量：
+
+```bash
+export WECHAT_APPID="wx你的AppID"
+export WECHAT_SECRET="你的AppSecret"
+
+wechat-publish \
+    --html a1.html --title "标题1" --cover c1.jpg \
+    --html a2.html --title "标题2" --cover c2.jpg \
+    --author "程序员白大力" --comment --publish
+```
+
+不传 `--publish` 则只存草稿箱；也可以用 `--appid` / `--secret` 直接传入。
+
+## 文章字段说明
+
+`articles` 列表里每一项是一个 dict：
+
+| 字段 | 必填 | 说明 |
+|---|---|---|
+| `html_path` | 是 | 渲染好的 HTML 文件路径（UTF-8） |
+| `title` | 是 | 文章标题，最长 32 字 |
+| `cover_path` | 是 | 封面图路径（jpg/png），会作为永久素材上传 |
+| `digest` | 否 | 摘要，最长 120 字 |
+| `source_url` | 否 | “阅读原文”跳转链接 |
+
+公共参数：
+
+| 参数 | 类型 | 默认 | 说明 |
+|---|---|---|---|
+| `author` | `str` | `""` | 作者名，最长 16 字 |
+| `open_comment` | `bool` | `False` | 是否打开评论 |
+| `publish_now` | `bool` | `False` | True 立即群发，False 仅存草稿 |
+
+## 工作流程
+
+调用 `push_articles()` 时内部按顺序执行：
+
+1. **获取 access_token** —— `cgi-bin/token`，有效期约 2 小时。
+2. **处理正文图片** —— 扫描 HTML 里所有 `<img src>`，把非微信域名（`mmbiz.qpic.cn` / `mmecoa.com` 除外）的图片下载后通过 `cgi-bin/media/uploadimg` 转存，并把 `src` 改写成微信 CDN 地址（微信会过滤外链图片）。
+3. **上传封面** —— 通过 `cgi-bin/material/add_material` 上传为永久图片素材，拿到 `thumb_media_id`。
+4. **创建草稿** —— `cgi-bin/draft/add`，一次最多 8 篇。
+5. **（可选）群发** —— `cgi-bin/freepublish/submit`。
+
+任一接口返回 `errcode != 0` 都会抛出 `wechat_publish.WeChatAPIError`，错误信息里带 errcode / errmsg。
+
+## API 一览
+
+```python
+from wechat_publish import (
+    push_articles,          # 高层入口，从自己代码里调用
+    WeChatAPIError,         # 接口错误异常
+    get_access_token,        # 低层：取 token
+    upload_cover,           # 低层：上传封面永久素材
+    upload_content_images,  # 低层：转存正文图片并改写 src
+    add_draft,              # 低层：创建草稿
+    publish,                # 低层：提交群发
+    MAX_ARTICLES,           # 8
+)
+```
+
+> 常见用法：先 `push_articles(..., publish_now=False)` 存草稿，在公众号后台人工预览确认后，再用返回的 `draft media_id` 调 `publish(token, media_id)` 正式群发。
+
+## CI / 自动发布
+
+仓库自带 GitHub Actions（`.github/workflows/publish.yml`），与常见开源 Python 包一致：
+
+- **push 到 `main`** → 编译 sdist + wheel，自动发布到 **TestPyPI**（官方测试源，验证打包流程不污染正式版）；
+- **打 tag `v*`**（如 `v1.0.0`）→ 编译后发布到**正式 PyPI**；
+- 也支持在 Actions 页面手动触发（`workflow_dispatch`），只编译不发布。
+
+免密推送：在 PyPI / TestPyPI 后台把本仓库配置为 **Trusted Publisher（OIDC）**，workflow 里 `id-token: write` 自动换取临时凭据，不需要任何 `PYPI_API_TOKEN`。
+
+## 技术交流
+
+扫码添加微信，交流使用问题、定制与合作：
+
+<p align="center">
+  <img src="docs/images/wechat-contact-qr.jpg" alt="微信二维码" width="240" />
+</p>
+
+## 项目赞助
+
+本项目由微信公众号 **「程序员白大力」** 提供赞助，感谢支持：
+
+<p align="center">
+  <img src="docs/images/wechat-official-account-qr.png" alt="程序员白大力公众号二维码" width="240" />
+</p>
+
+## License
+
+MIT

wechat_publish-1.0.0/wechat_publish.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+pyproject.toml
+tests/test_publish.py
+wechat_publish/__init__.py
+wechat_publish/cli.py
+wechat_publish/core.py
+wechat_publish/py.typed
+wechat_publish.egg-info/PKG-INFO
+wechat_publish.egg-info/SOURCES.txt
+wechat_publish.egg-info/dependency_links.txt
+wechat_publish.egg-info/entry_points.txt
+wechat_publish.egg-info/requires.txt
+wechat_publish.egg-info/top_level.txt

wechat_publish-1.0.0/wechat_publish.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

wechat_publish-1.0.0/wechat_publish.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+wechat-publish = wechat_publish.cli:main

wechat_publish-1.0.0/wechat_publish.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.25

wechat_publish-1.0.0/wechat_publish.egg-info/top_level.txt

@@ -0,0 +1 @@
+wechat_publish