justoneapi 3.0.97__tar.gz → 3.0.98__tar.gz

{justoneapi-3.0.97 → justoneapi-3.0.98}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: justoneapi
-Version: 3.0.97
+Version: 3.0.98
 Summary: OpenAPI-driven Python SDK for Just One API
 Author-email: Just One API <support@justoneapi.com>
 Requires-Python: >=3.10
@@ -65,6 +65,22 @@ print(response.message)  # 服务端消息
 print(response.data)     # 实际业务数据
 ```
 
+微信公众号文章搜索示例：
+
+```python
+response = client.weixin.search_article_v1(
+    keyword="人工智能",
+    publish_time_type="SEVEN_DAYS",
+    sort_type="LATEST",
+    current_page=1,
+)
+
+# V2 可按文章类别筛选
+response = client.weixin.search_article_v2(keyword="人工智能", sub_search_type="HOT")
+```
+
+`keyword` 必填。SDK 会自动提交 POST 表单和 Token。连续分页时，按接口文档传回上一页响应中的 `offset` 和 `cookies_buffer`，并设置 `current_page`。
+
 ## 返回结构
 
 每个 API 方法都会返回一个 `ApiResponse` 对象，包含以下字段：

justoneapi-3.0.97/justoneapi.egg-info/PKG-INFO → justoneapi-3.0.98/README.md

@@ -1,19 +1,3 @@
-Metadata-Version: 2.4
-Name: justoneapi
-Version: 3.0.97
-Summary: OpenAPI-driven Python SDK for Just One API
-Author-email: Just One API <support@justoneapi.com>
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: httpx<0.29,>=0.28
-Requires-Dist: pydantic<3,>=2.12
-Provides-Extra: dev
-Requires-Dist: datamodel-code-generator<0.56,>=0.55; extra == "dev"
-Requires-Dist: PyYAML<7,>=6; extra == "dev"
-Requires-Dist: pytest<10,>=9; extra == "dev"
-Dynamic: license-file
-
 <p align="center">
   <a href="https://justoneapi.com/zh?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_official_justoneapi_python&utm_content=repo_readme_logo">
     <img src="https://justoneapi.com/logo/logo_text.png" alt="Just One API Logo" width="200">
@@ -65,6 +49,22 @@ print(response.message)  # 服务端消息
 print(response.data)     # 实际业务数据
 ```
 
+微信公众号文章搜索示例：
+
+```python
+response = client.weixin.search_article_v1(
+    keyword="人工智能",
+    publish_time_type="SEVEN_DAYS",
+    sort_type="LATEST",
+    current_page=1,
+)
+
+# V2 可按文章类别筛选
+response = client.weixin.search_article_v2(keyword="人工智能", sub_search_type="HOT")
+```
+
+`keyword` 必填。SDK 会自动提交 POST 表单和 Token。连续分页时，按接口文档传回上一页响应中的 `offset` 和 `cookies_buffer`，并设置 `current_page`。
+
 ## 返回结构
 
 每个 API 方法都会返回一个 `ApiResponse` 对象，包含以下字段：

{justoneapi-3.0.97 → justoneapi-3.0.98}/justoneapi/_resource.py

@@ -12,3 +12,15 @@ class BaseResource:
 
     def _get(self, path: str, params: dict[str, Any]) -> ApiResponse[Any]:
         return self._transport.get(path, params)
+
+    def _post(
+        self,
+        path: str,
+        params: dict[str, Any],
+        *,
+        data: dict[str, Any] | None = None,
+        token_in_form: bool = False,
+    ) -> ApiResponse[Any]:
+        return self._transport.post(
+            path, params, data=data, token_in_form=token_in_form
+        )

{justoneapi-3.0.97 → justoneapi-3.0.98}/justoneapi/_transport.py

@@ -37,11 +37,41 @@ class Transport:
         self._client.close()
 
     def get(self, path: str, params: dict[str, Any]) -> ApiResponse[Any]:
-        request_params = {"token": self._token, **self._clean_params(params)}
+        return self._request("GET", path, params)
+
+    def post(
+        self,
+        path: str,
+        params: dict[str, Any],
+        *,
+        data: dict[str, Any] | None = None,
+        token_in_form: bool = False,
+    ) -> ApiResponse[Any]:
+        return self._request(
+            "POST", path, params, data=data, token_in_form=token_in_form
+        )
+
+    def _request(
+        self,
+        method: str,
+        path: str,
+        params: dict[str, Any],
+        *,
+        data: dict[str, Any] | None = None,
+        token_in_form: bool = False,
+    ) -> ApiResponse[Any]:
+        request_params = self._clean_params(params)
+        request_data = self._clean_params(data) if data is not None else None
+        if token_in_form:
+            request_data = {"token": self._token, **(request_data or {})}
+        else:
+            request_params = {"token": self._token, **request_params}
         try:
-            response = self._client.get(path, params=request_params)
+            response = self._client.request(
+                method, path, params=request_params, data=request_data
+            )
         except httpx.HTTPError as exc:
-            raise TransportError(f"Request failed for GET {path}: {exc}") from exc
+            raise TransportError(f"Request failed for {method} {path}: {exc}") from exc
 
         log_message = response.headers.get("JUSTONEAPI_PYTHON_SDK_LOG_MESSAGE")
         if log_message:
@@ -51,12 +81,12 @@ class Transport:
             payload = response.json()
         except ValueError as exc:
             raise ProtocolError(
-                f"Server returned a non-JSON response for GET {path}"
+                f"Server returned a non-JSON response for {method} {path}"
             ) from exc
 
         if not isinstance(payload, dict):
             raise ProtocolError(
-                f"Server returned a non-object JSON payload for GET {path}"
+                f"Server returned a non-object JSON payload for {method} {path}"
             )
 
         api_response = ApiResponse(

justoneapi-3.0.98/justoneapi/_version.py

@@ -0,0 +1 @@
+__version__ = "3.0.98"

{justoneapi-3.0.97 → justoneapi-3.0.98}/justoneapi/generated/resources/weixin.py

@@ -37,28 +37,58 @@ class WeixinResource(BaseResource):
 
     def get_account_history_articles_v1(
         self,
+        *,
+        username: str,
+        item_show_type: str | None = "ARTICLE",
+        offset: str | None = "",
     ) -> ApiResponse[Any]:
         """
         Account Historical Articles
 
         Retrieves historical posts for a WeChat Official Account by username, with cursor pagination and article, video, audio, or image content tabs. Use it to browse an account's publishing history.
+
+        Args:
+            username: WeChat Official Account username with the gh_ prefix.
+            item_show_type: Content tab. Defaults to ARTICLE.  Available Values: - `ARTICLE`: Articles - `VIDEO`: Videos - `AUDIO`: Audio - `IMAGE`: Images
+            offset: Base64 pagination cursor. Leave empty for the first page; pass next_offset from the previous response for the next page. Send it in the URL-encoded form body.
         """
-        return self._get(
+        return self._post(
             "/api/weixin/get-account-history-articles/v1",
             {},
+            data={
+                "username": username,
+                "itemShowType": item_show_type,
+                "offset": offset,
+            },
+            token_in_form=True,
         )
 
     def get_account_history_articles_v2(
         self,
+        *,
+        ghid: str | None = "",
+        offset: str | None = "",
+        url: str | None = "",
     ) -> ApiResponse[Any]:
         """
         Account Historical Articles
 
         Retrieves historical articles for a WeChat Official Account identified by ghid or article URL, with an offset cursor from the previous page. Use it to continue through an account's article archive with cursor pagination.
+
+        Args:
+            ghid: WeChat Official Account original identifier, using the gh_ prefix returned by WeChat. Use either ghid or url.
+            offset: PagingInfo.Offset cursor returned by the previous response. Leave it empty for the first page. For this POST endpoint, send it in an application/x-www-form-urlencoded form body.
+            url: WeChat Official Account article URL used to identify the account and fetch historical articles. Use either ghid or url.
         """
-        return self._get(
+        return self._post(
             "/api/weixin/get-account-history-articles/v2",
             {},
+            data={
+                "ghid": ghid,
+                "offset": offset,
+                "url": url,
+            },
+            token_in_form=True,
         )
 
     def get_article_metrics_v1(
@@ -209,15 +239,27 @@ class WeixinResource(BaseResource):
 
     def get_article_comment_v1(
         self,
+        *,
+        article_url: str,
+        buffer: str | None = "",
     ) -> ApiResponse[Any]:
         """
         Article Comments
 
         Retrieves top-level comments for a WeChat Official Account article by URL, with an optional buffer cursor for pagination. Use it to review reader discussion or continue through comment pages for a known article.
+
+        Args:
+            article_url: WeChat Official Account article URL used to fetch top-level article comments.
+            buffer: Comment pagination buffer returned by the previous response. Leave it empty for the first page. For this POST endpoint, send it in an application/x-www-form-urlencoded form body.
         """
-        return self._get(
+        return self._post(
             "/api/weixin/get-article-comment/v1",
             {},
+            data={
+                "articleUrl": article_url,
+                "buffer": buffer,
+            },
+            token_in_form=True,
         )
 
     def get_article_sub_comment_v1(
@@ -280,41 +322,104 @@ class WeixinResource(BaseResource):
 
     def search_article_v1(
         self,
+        *,
+        keyword: str,
+        cookies_buffer: str | None = "",
+        current_page: int | None = 1,
+        offset: int | None = 0,
+        publish_time_type: str | None = "ALL",
+        sort_type: str | None = "COMPREHENSIVE",
     ) -> ApiResponse[Any]:
         """
         Article Search
 
         Searches WeChat Official Account articles by keyword with publish-time and sort filters plus page, offset, and continuation-state pagination. Use it to discover recent or high-interest articles for topic research and content monitoring.
-        """
-        return self._get(
+
+        Args:
+            keyword: Search keyword for WeChat Official Account articles.
+            cookies_buffer: Opaque pagination state returned by the previous WeChat web search response. Leave it empty for the first page. For this POST endpoint, send it in an application/x-www-form-urlencoded form body.
+            current_page: Current page number starting from 1 for WeChat web search pagination.
+            offset: Search result offset returned by the previous response. Use 0 for the first page.
+            publish_time_type: Publish time filter for WeChat Official Account article web search.  Available Values: - `ALL`: All time - `ONE_DAY`: Last day - `SEVEN_DAYS`: Last seven days - `HALF_YEAR`: Last half year
+            sort_type: Sort order for WeChat Official Account article web search results.  Available Values: - `COMPREHENSIVE`: Comprehensive sort - `LATEST`: Latest first - `HOT`: Hot first
+        """
+        return self._post(
             "/api/weixin/search-article/v1",
             {},
+            data={
+                "keyword": keyword,
+                "cookies_buffer": cookies_buffer,
+                "currentPage": current_page,
+                "offset": offset,
+                "publishTimeType": publish_time_type,
+                "sortType": sort_type,
+            },
+            token_in_form=True,
         )
 
     def search_article_v2(
         self,
+        *,
+        keyword: str,
+        cookies_buffer: str | None = "",
+        current_page: int | None = 1,
+        offset: int | None = 0,
+        sub_search_type: str | None = "ALL",
     ) -> ApiResponse[Any]:
         """
         Article Search
 
         Searches WeChat Official Account articles by keyword within a selected category such as followed accounts, latest, recently read, or hot, with continuation pagination. Use it to focus article discovery on a particular result stream.
+
+        Args:
+            keyword: Search keyword for categorized WeChat Official Account article web search.
+            cookies_buffer: Opaque pagination state returned by the previous WeChat web search response. Leave it empty for the first page. For this POST endpoint, send it in an application/x-www-form-urlencoded form body.
+            current_page: Current page number starting from 1 for WeChat web search pagination.
+            offset: Search result offset returned by the previous response. Use 0 for the first page.
+            sub_search_type: Subcategory filter for categorized WeChat Official Account article web search.  Available Values: - `ALL`: All - `FOLLOWED`: Followed accounts - `LATEST`: Latest - `RECENT_READ`: Recently read - `HOT`: Hot
         """
-        return self._get(
+        return self._post(
             "/api/weixin/search-article/v2",
             {},
+            data={
+                "keyword": keyword,
+                "cookies_buffer": cookies_buffer,
+                "currentPage": current_page,
+                "offset": offset,
+                "subSearchType": sub_search_type,
+            },
+            token_in_form=True,
         )
 
     def search_miniprogram_v1(
         self,
+        *,
+        keyword: str,
+        cookies_buffer: str | None = "",
+        current_page: int | None = 1,
+        offset: int | None = 0,
     ) -> ApiResponse[Any]:
         """
         Mini Program Search
 
         Searches WeChat Mini Programs by keyword with page, offset, and continuation-state pagination. Use it to discover mini programs related to a brand, service, topic, or product.
+
+        Args:
+            keyword: Search keyword for WeChat mini program web search.
+            cookies_buffer: Opaque pagination state returned by the previous WeChat web search response. Leave it empty for the first page. For this POST endpoint, send it in an application/x-www-form-urlencoded form body.
+            current_page: Current page number starting from 1 for WeChat web search pagination.
+            offset: Search result offset returned by the previous response. Use 0 for the first page.
         """
-        return self._get(
+        return self._post(
             "/api/weixin/search-miniprogram/v1",
             {},
+            data={
+                "keyword": keyword,
+                "cookies_buffer": cookies_buffer,
+                "currentPage": current_page,
+                "offset": offset,
+            },
+            token_in_form=True,
         )
 
     def search_wechat_index_v1(
@@ -375,7 +480,7 @@ class WeixinResource(BaseResource):
             keyword: Search keyword for WeChat Official Account profiles.
             page: Page number starting from 1 for WeChat Official Account profile search.
         """
-        return self._get(
+        return self._post(
             "/api/weixin/search-account/v1",
             {
                 "keyword": keyword,
@@ -385,15 +490,33 @@ class WeixinResource(BaseResource):
 
     def search_account_v2(
         self,
+        *,
+        keyword: str,
+        cookies_buffer: str | None = "",
+        current_page: int | None = 1,
+        offset: int | None = 0,
     ) -> ApiResponse[Any]:
         """
         Account Search
 
         Searches WeChat Official Accounts by keyword with page, offset, and continuation-state pagination. Use it to browse broader account results for creator, brand, or publisher discovery.
+
+        Args:
+            keyword: Search keyword for WeChat Official Account web search.
+            cookies_buffer: Opaque pagination state returned by the previous WeChat web search response. Leave it empty for the first page. For this POST endpoint, send it in an application/x-www-form-urlencoded form body.
+            current_page: Current page number starting from 1 for WeChat web search pagination.
+            offset: Search result offset returned by the previous response. Use 0 for the first page.
         """
-        return self._get(
+        return self._post(
             "/api/weixin/search-account/v2",
             {},
+            data={
+                "keyword": keyword,
+                "cookies_buffer": cookies_buffer,
+                "currentPage": current_page,
+                "offset": offset,
+            },
+            token_in_form=True,
         )
 
     def get_account_original_count_v1(

{justoneapi-3.0.97 → justoneapi-3.0.98}/justoneapi/generated/resources/weixin_channels.py

@@ -11,41 +11,101 @@ class WeixinChannelsResource(BaseResource):
 
     def search_video_v1(
         self,
+        *,
+        keyword: str,
+        cookies_buffer: str | None = "",
+        current_page: int | None = 1,
+        offset: int | None = 0,
+        publish_time_type: str | None = "ALL",
+        sort_type: str | None = "COMPREHENSIVE",
     ) -> ApiResponse[Any]:
         """
         Video Search
 
         Searches WeChat Channels videos by keyword with publish-time, sort, page, offset, and continuation-state controls. Use it to find recent or ordered video results and continue web-search pages.
+
+        Args:
+            keyword: Search keyword for WeChat Channels video results.
+            cookies_buffer: Opaque pagination state returned by the previous WeChat Channels web search response. Leave it empty for the first page. For this POST endpoint, send it in an application/x-www-form-urlencoded form body.
+            current_page: Current page number starting from 1 for WeChat Channels web search pagination.
+            offset: Search result offset returned by the previous WeChat Channels search response. Use 0 for the first page.
+            publish_time_type: Publish time filter for WeChat Channels video web search.  Available Values: - `ALL`: All publish times - `ONE_DAY`: Published in the last day - `SEVEN_DAYS`: Published in the last seven days - `HALF_YEAR`: Published in the last half year
+            sort_type: Sort order for WeChat Channels video search results.  Available Values: - `COMPREHENSIVE`: Comprehensive sort - `LATEST`: Latest first - `HOT`: Hot first
         """
-        return self._get(
+        return self._post(
             "/api/weixin-channels/search-video/v1",
             {},
+            data={
+                "keyword": keyword,
+                "cookies_buffer": cookies_buffer,
+                "currentPage": current_page,
+                "offset": offset,
+                "publishTimeType": publish_time_type,
+                "sortType": sort_type,
+            },
+            token_in_form=True,
         )
 
     def search_video_v2(
         self,
+        *,
+        keyword: str,
+        cookies_buffer: str | None = "",
+        current_page: int | None = 1,
+        offset: int | None = 0,
     ) -> ApiResponse[Any]:
         """
         Video Search
 
         Searches the WeChat Channels video category by keyword with page, offset, and continuation-state controls. Use it to retrieve categorized video results and continue additional pages.
+
+        Args:
+            keyword: Search keyword for categorized WeChat Channels video results.
+            cookies_buffer: Opaque pagination state returned by the previous WeChat Channels web search response. Leave it empty for the first page. For this POST endpoint, send it in an application/x-www-form-urlencoded form body.
+            current_page: Current page number starting from 1 for WeChat Channels web search pagination.
+            offset: Search result offset returned by the previous WeChat Channels search response. Use 0 for the first page.
         """
-        return self._get(
+        return self._post(
             "/api/weixin-channels/search-video/v2",
             {},
+            data={
+                "keyword": keyword,
+                "cookies_buffer": cookies_buffer,
+                "currentPage": current_page,
+                "offset": offset,
+            },
+            token_in_form=True,
         )
 
     def search_account_v1(
         self,
+        *,
+        keyword: str,
+        cookies_buffer: str | None = "",
+        current_page: int | None = 1,
+        offset: int | None = 0,
     ) -> ApiResponse[Any]:
         """
         Account Search
 
         Searches the WeChat Channels account category by keyword with page, offset, and continuation-state controls. Use it to discover creator accounts through paginated web-search results.
+
+        Args:
+            keyword: Search keyword for WeChat Channels account web search.
+            cookies_buffer: Opaque pagination state returned by the previous WeChat Channels account search response. Leave it empty for the first page. For this POST endpoint, send it in an application/x-www-form-urlencoded form body.
+            current_page: Current page number starting from 1 for WeChat Channels web search pagination.
+            offset: Search result offset returned by the previous WeChat Channels account search response. Use 0 for the first page.
         """
-        return self._get(
+        return self._post(
             "/api/weixin-channels/search-account/v1",
             {},
+            data={
+                "keyword": keyword,
+                "cookies_buffer": cookies_buffer,
+                "currentPage": current_page,
+                "offset": offset,
+            },
+            token_in_form=True,
         )
 
     def search_account_v2(
@@ -61,7 +121,7 @@ class WeixinChannelsResource(BaseResource):
         Args:
             keyword: Search keyword used to find WeChat Channels accounts and related video objects.
         """
-        return self._get(
+        return self._post(
             "/api/weixin-channels/search-account/v2",
             {
                 "keyword": keyword,
@@ -81,7 +141,7 @@ class WeixinChannelsResource(BaseResource):
         Args:
             keyword: Search keyword used to resolve a WeChat Channels account id.
         """
-        return self._get(
+        return self._post(
             "/api/weixin-channels/search-account/v3",
             {
                 "keyword": keyword,
@@ -90,15 +150,27 @@ class WeixinChannelsResource(BaseResource):
 
     def get_account_videos_v1(
         self,
+        *,
+        v2_name: str,
+        last_buffer: str | None = "",
     ) -> ApiResponse[Any]:
         """
         Account Videos
 
         Retrieves a paginated WeChat Channels account feed by v2Name with continuation-buffer support. Use it to browse videos and other feed entries published by a known creator account.
+
+        Args:
+            v2_name: WeChat Channels account unique id, usually ending with @finder.
+            last_buffer: Pagination buffer returned by the previous WeChat Channels account videos response. Leave it empty for the first page. For this POST endpoint, send it in an application/x-www-form-urlencoded form body.
         """
-        return self._get(
+        return self._post(
             "/api/weixin-channels/get-account-videos/v1",
             {},
+            data={
+                "v2Name": v2_name,
+                "last_buffer": last_buffer,
+            },
+            token_in_form=True,
         )
 
     def get_bound_channel_v1(
@@ -232,39 +304,84 @@ class WeixinChannelsResource(BaseResource):
 
     def get_video_metrics_v1(
         self,
+        *,
+        object_id: str,
+        last_buffer: str | None = "",
+        object_nonce_id: str | None = "",
     ) -> ApiResponse[Any]:
         """
         Video Metrics
 
         Retrieves interaction metrics for a WeChat Channels video by object ID with optional continuation-buffer input. Use it to review engagement for known video content.
+
+        Args:
+            object_id: WeChat Channels video object id used to fetch interaction metrics.
+            last_buffer: Pagination buffer returned by the previous WeChat Channels metrics response. Leave it empty for the first page. For this POST endpoint, send it in an application/x-www-form-urlencoded form body.
+            object_nonce_id: Optional WeChat Channels object nonce id.
         """
-        return self._get(
+        return self._post(
             "/api/weixin-channels/get-video-metrics/v1",
             {},
+            data={
+                "objectId": object_id,
+                "last_buffer": last_buffer,
+                "objectNonceId": object_nonce_id,
+            },
+            token_in_form=True,
         )
 
     def get_video_comment_v1(
         self,
+        *,
+        object_id: str,
+        last_buffer: str | None = "",
+        object_nonce_id: str | None = "",
     ) -> ApiResponse[Any]:
         """
         Video Comments
 
         Retrieves first-level comments for a WeChat Channels video by object ID with continuation-buffer pagination. Use it to review audience discussion on known video content.
+
+        Args:
+            object_id: WeChat Channels video object id used to fetch first-level comments. If you only have the exportId returned by a video search result, first call the Export Id Conversion (V1) endpoint at /api/weixin-channels/convert-export-id/v1 to convert it to an objectId.
+            last_buffer: Pagination buffer returned by the previous first-level WeChat Channels comment response. Leave it empty for the first page. For this POST endpoint, send it in an application/x-www-form-urlencoded form body.
+            object_nonce_id: Optional WeChat Channels object nonce id.
         """
-        return self._get(
+        return self._post(
             "/api/weixin-channels/get-video-comment/v1",
             {},
+            data={
+                "objectId": object_id,
+                "last_buffer": last_buffer,
+                "objectNonceId": object_nonce_id,
+            },
+            token_in_form=True,
         )
 
     def get_video_sub_comment_v1(
         self,
+        *,
+        object_id: str,
+        root_comment_id: str,
+        last_buffer: str | None = "",
     ) -> ApiResponse[Any]:
         """
         Video Sub Comments
 
         Retrieves replies under a first-level WeChat Channels video comment using the video and root-comment IDs. Use it to continue a threaded comment discussion with buffer pagination.
+
+        Args:
+            object_id: WeChat Channels video object id used to fetch second-level comment replies.
+            root_comment_id: Root first-level comment id returned by the WeChat Channels video comments endpoint.
+            last_buffer: Pagination buffer for WeChat Channels second-level comment replies. Use the first-level comment's last_buffer for the first reply page when present. For this POST endpoint, send it in an application/x-www-form-urlencoded form body.
         """
-        return self._get(
+        return self._post(
             "/api/weixin-channels/get-video-sub-comment/v1",
             {},
+            data={
+                "objectId": object_id,
+                "rootCommentId": root_comment_id,
+                "last_buffer": last_buffer,
+            },
+            token_in_form=True,
         )

justoneapi-3.0.97/README.md → justoneapi-3.0.98/justoneapi.egg-info/PKG-INFO

@@ -1,3 +1,19 @@
+Metadata-Version: 2.4
+Name: justoneapi
+Version: 3.0.98
+Summary: OpenAPI-driven Python SDK for Just One API
+Author-email: Just One API <support@justoneapi.com>
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx<0.29,>=0.28
+Requires-Dist: pydantic<3,>=2.12
+Provides-Extra: dev
+Requires-Dist: datamodel-code-generator<0.56,>=0.55; extra == "dev"
+Requires-Dist: PyYAML<7,>=6; extra == "dev"
+Requires-Dist: pytest<10,>=9; extra == "dev"
+Dynamic: license-file
+
 <p align="center">
   <a href="https://justoneapi.com/zh?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_official_justoneapi_python&utm_content=repo_readme_logo">
     <img src="https://justoneapi.com/logo/logo_text.png" alt="Just One API Logo" width="200">
@@ -49,6 +65,22 @@ print(response.message)  # 服务端消息
 print(response.data)     # 实际业务数据
 ```
 
+微信公众号文章搜索示例：
+
+```python
+response = client.weixin.search_article_v1(
+    keyword="人工智能",
+    publish_time_type="SEVEN_DAYS",
+    sort_type="LATEST",
+    current_page=1,
+)
+
+# V2 可按文章类别筛选
+response = client.weixin.search_article_v2(keyword="人工智能", sub_search_type="HOT")
+```
+
+`keyword` 必填。SDK 会自动提交 POST 表单和 Token。连续分页时，按接口文档传回上一页响应中的 `offset` 和 `cookies_buffer`，并设置 `current_page`。
+
 ## 返回结构
 
 每个 API 方法都会返回一个 `ApiResponse` 对象，包含以下字段：