wechat-article-parser 0.0.16__tar.gz → 0.0.17__tar.gz

{wechat_article_parser-0.0.16 → wechat_article_parser-0.0.17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: wechat-article-parser
-Version: 0.0.16
+Version: 0.0.17
 Summary: WeChat MP article parser - extract metadata and content from WeChat public account articles
 License-Expression: MIT
 License-File: LICENSE
@@ -117,6 +117,7 @@ print(result.raw_html)
 - 明确识别的 SVG 快速逐帧动画仅保留首帧；轮播及无法确认的帧序列保留可提取图片。具体规则见[正文转换规则](docs/content-rules.md)。
 - 视频、音频分享可以没有文字附言。付费预览及部分卡片可能只返回文字提示；`is_valid=True` 不代表已获取付费全文、媒体文件或小程序内部内容。
 - 页面结构变化或内容不可访问时，可能返回不完整结果。调用方应检查 `is_valid`；长链接的 `article_id` 为空属于正常情况。
+- **自 2026-11-02 起，微信短链接文章页不再提供文章签名 `sn`，返回的 `article_sn` 为空字符串，不影响 `is_valid` 判断。**
 - 检测到微信人机验证时抛出 `WeChatVerifyError`；HTTP 状态异常和网络错误通过 `httpx` 异常向外传播。接口不自动重试，处理示例见 [API 参考](docs/api.md#异常与不完整结果)。
 
 ## 文档

{wechat_article_parser-0.0.16 → wechat_article_parser-0.0.17}/README.md

@@ -102,6 +102,7 @@ print(result.raw_html)
 - 明确识别的 SVG 快速逐帧动画仅保留首帧；轮播及无法确认的帧序列保留可提取图片。具体规则见[正文转换规则](docs/content-rules.md)。
 - 视频、音频分享可以没有文字附言。付费预览及部分卡片可能只返回文字提示；`is_valid=True` 不代表已获取付费全文、媒体文件或小程序内部内容。
 - 页面结构变化或内容不可访问时，可能返回不完整结果。调用方应检查 `is_valid`；长链接的 `article_id` 为空属于正常情况。
+- **自 2026-11-02 起，微信短链接文章页不再提供文章签名 `sn`，返回的 `article_sn` 为空字符串，不影响 `is_valid` 判断。**
 - 检测到微信人机验证时抛出 `WeChatVerifyError`；HTTP 状态异常和网络错误通过 `httpx` 异常向外传播。接口不自动重试，处理示例见 [API 参考](docs/api.md#异常与不完整结果)。
 
 ## 文档

{wechat_article_parser-0.0.16 → wechat_article_parser-0.0.17}/docs/api.md

@@ -86,7 +86,7 @@ result = parse(
 | `article_url_type` | `ArticleURLType` | 输入链接类型：`short`、`long` 或 `unknown`（默认）；可从包顶层导入枚举，支持字符串比较和 JSON 序列化 |
 | `article_msg_id` | `int` | 文章所在的群发消息 ID |
 | `article_idx` | `int` | 群发图文中的位置（从 1 开始） |
-| `article_sn` | `str` | 文章签名（防伪校验） |
+| `article_sn` | `str` | 文章签名（防伪校验）；页面未提供时为空字符串，不影响 `is_valid` |
 | `article_title` | `str` | 文章标题 |
 | `article_cover_image` | `str` | 文章封面图链接 |
 | `article_description` | `str` | 文章摘要 |
@@ -99,7 +99,8 @@ result = parse(
 | `images` | `list[str]` | 最终保留的正文图片链接，按顺序去重；不包含被省略的动画帧、小程序封面和头像、红包封面预览图 |
 | `is_valid` | `bool` | 关键字段是否全部解析成功（属性） |
 
-`is_valid` 为 `True` 的条件：`mp_id`、`mp_name`、`article_msg_id`、`article_idx`、`article_sn`、`article_title`、`article_publish_time` 均不为空/零，且 `article_markdown` 非空或 `article_display_type in ("video", "audio")`。
+`is_valid` 为 `True` 的条件：`mp_id`、`mp_name`、`article_msg_id`、`article_idx`、`article_title`、`article_publish_time` 均不为空/零，且 `article_markdown` 非空或 `article_display_type in ("video", "audio")`。
+`article_sn` 为非必需字段，页面未提供签名时仍可返回有效结果；这不改变输入长链接的参数要求，详见[链接识别](#链接识别)。
 此外，`article_url_type == "long"` 时允许 `article_id` 为空；短链接和未识别链接仍要求 `article_id` 非空。
 视频和音频分享允许没有文字正文，仍须满足其他关键字段要求；有效性不表示已获取视频或音频文件。
 

{wechat_article_parser-0.0.16 → wechat_article_parser-0.0.17}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "wechat-article-parser"
-version = "0.0.16"
+version = "0.0.17"
 description = "WeChat MP article parser - extract metadata and content from WeChat public account articles"
 readme = "README.md"
 requires-python = ">=3.10"

{wechat_article_parser-0.0.16 → wechat_article_parser-0.0.17}/src/wechat_article_parser/models.py

@@ -98,14 +98,13 @@ class ArticleResult:
 
     @property
     def is_valid(self) -> bool:
-        """检查关键字段是否解析成功；视频和音频分享允许正文为空。"""
+        """检查关键字段是否解析成功；签名可为空，视频和音频分享允许正文为空。"""
         return bool(
             self.mp_id
             and self.mp_name
             and (self.article_id or self.article_url_type == ArticleURLType.LONG)
             and self.article_msg_id
             and self.article_idx
-            and self.article_sn
             and self.article_title
             and (
                 self.article_markdown

{wechat_article_parser-0.0.16 → wechat_article_parser-0.0.17}/tests/test_article_urls.py

@@ -50,6 +50,17 @@ def test_long_url_parses_without_article_id(scheme: str, suffix: str) -> None:
     assert result.is_valid
 
 
+@pytest.mark.parametrize("url", [_SHORT_URL, _LONG_URL])
+@pytest.mark.parametrize("declaration", ['var sn = "" || "" || "";', ""])
+def test_page_without_signature_is_valid(url: str, declaration: str) -> None:
+    html = _HTML.replace(f'var sn = "{_PARAMS["sn"]}";', declaration)
+    result = parser._parse_html(url, html)
+
+    assert result.article_sn == ""
+    assert result.article_markdown == "正文"
+    assert result.is_valid
+
+
 @pytest.mark.parametrize("key", _PARAMS)
 @pytest.mark.parametrize("value", [None, "", " \t\n"])
 def test_long_url_requires_each_parameter_with_value(key: str, value: str | None) -> None:

{wechat_article_parser-0.0.16 → wechat_article_parser-0.0.17}/tests/test_models.py

@@ -22,11 +22,13 @@ _COMPLETE = ArticleResult(
 
 @pytest.mark.parametrize("display_type", list(ArticleDisplayType))
 @pytest.mark.parametrize("markdown", ["", "正文"])
+@pytest.mark.parametrize("signature", ["", "signature"])
 def test_only_video_and_audio_can_be_valid_without_markdown(
-    display_type: ArticleDisplayType, markdown: str,
+    display_type: ArticleDisplayType, markdown: str, signature: str,
 ) -> None:
     result = replace(
         _COMPLETE, article_display_type=display_type, article_markdown=markdown,
+        article_sn=signature,
     )
 
     assert result.is_valid is (
@@ -42,7 +44,6 @@ def test_only_video_and_audio_can_be_valid_without_markdown(
         ("article_id", ""),
         ("article_msg_id", 0),
         ("article_idx", 0),
-        ("article_sn", ""),
         ("article_title", ""),
         ("article_publish_time", 0),
     ],
@@ -103,12 +104,14 @@ def test_paid_field_serializes_as_boolean(is_paid: bool) -> None:
 @pytest.mark.parametrize("url_type", list(ArticleURLType))
 @pytest.mark.parametrize("display_type", list(ArticleDisplayType))
 @pytest.mark.parametrize("markdown", ["", "正文"])
+@pytest.mark.parametrize("signature", ["", "signature"])
 def test_only_long_url_can_omit_article_id(
-    url_type: ArticleURLType, display_type: ArticleDisplayType, markdown: str,
+    url_type: ArticleURLType, display_type: ArticleDisplayType, markdown: str, signature: str,
 ) -> None:
     result = replace(
         _COMPLETE, article_id="", article_url_type=url_type,
         article_display_type=display_type, article_markdown=markdown,
+        article_sn=signature,
     )
     assert result.is_valid is (
         url_type == ArticleURLType.LONG
@@ -120,7 +123,7 @@ def test_only_long_url_can_omit_article_id(
     ("field_name", "empty_value"),
     [
         ("mp_id", 0), ("mp_name", ""), ("article_msg_id", 0),
-        ("article_idx", 0), ("article_sn", ""), ("article_title", ""),
+        ("article_idx", 0), ("article_title", ""),
         ("article_publish_time", 0),
     ],
 )

{wechat_article_parser-0.0.16 → wechat_article_parser-0.0.17}/tests/test_parser.py

@@ -57,6 +57,8 @@ TEST_URLS = [
     "https://mp.weixin.qq.com/s/CgWnsf3lyBijzy3L5Y7Xtg",
     # foreignObject 定位且帧间距大于图片尺寸的 SVG 背景帧序列。
     "https://mp.weixin.qq.com/s/6pT1xECveLM7iTqiYvjH-g",
+    # 页面中的文章签名为空，但正文和其他关键元数据完整。
+    "https://mp.weixin.qq.com/s/skgpeibg1sbv2QFFdQeFxA",
 ]
 
 
@@ -131,7 +133,6 @@ def _assert_result(result: ArticleResult, url: str) -> None:
     assert result.article_id, "article_id should not be empty"
     assert result.article_msg_id > 0, "article_msg_id should be positive"
     assert result.article_idx > 0, "article_idx should be positive"
-    assert result.article_sn, "article_sn should not be empty"
     assert result.article_title, "article_title should not be empty"
     if result.article_display_type not in ("video", "audio"):
         assert result.article_markdown, "article_markdown should not be empty for non-video/audio articles"