redfox-python-sdk 0.1.0__tar.gz → 0.2.1__tar.gz

{redfox-python-sdk-0.1.0 → redfox-python-sdk-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: redfox-python-sdk
-Version: 0.1.0
+Version: 0.2.1
 Summary: RedFox 红狐数据平台 Python SDK
 Home-page: https://redfox.hk
 Author: RedFox

{redfox-python-sdk-0.1.0 → redfox-python-sdk-0.2.1}/redfox/__init__.py

@@ -3,5 +3,5 @@
 from .client import RedFoxClient
 from .exceptions import RedFoxAPIError, RedFoxAuthError, RedFoxRateLimitError
 
-__version__ = "0.1.0"
+__version__ = "0.2.1"
 __all__ = ["RedFoxClient", "RedFoxAPIError", "RedFoxAuthError", "RedFoxRateLimitError"]

{redfox-python-sdk-0.1.0 → redfox-python-sdk-0.2.1}/redfox/client.py

@@ -5,6 +5,15 @@ from typing import Optional, Dict, Any
 
 from .exceptions import RedFoxAPIError, RedFoxAuthError, RedFoxRateLimitError
 from .endpoints.douyin import DouyinAPI
+from .endpoints.xiaohongshu import XiaohongshuAPI
+from .endpoints.wechat import WechatAPI
+from .endpoints.bilibili import BilibiliAPI
+from .endpoints.toutiao import ToutiaoAPI
+from .endpoints.tiktok import TikTokAPI
+from .endpoints.gpt_image import GPTImageAPI
+from .endpoints.doubao_image import DoubaoImageAPI
+from .endpoints.doubao_video import DoubaoVideoAPI
+from .endpoints.ai_search import AISearchAPI
 
 
 class RedFoxClient:
@@ -20,8 +29,14 @@ class RedFoxClient:
         # 搜索抖音作品
         result = client.douyin.search_articles(keyword="AI")
 
-        # 获取账号信息
-        user = client.douyin.get_user(account_id="dy_user123")
+        # 搜索小红书作品
+        result = client.xiaohongshu.search_articles(keyword="AI")
+
+        # 搜索公众号文章
+        result = client.wechat.search_articles(keyword="AI")
+
+        # AI 搜索
+        task = client.ai_search.kimi_submit(inquiry_text="夏日茶饮推荐")
 
     :param api_key: RedFox API Key，在 https://redfox.hk/settings/api-keys?source=github 获取
     :param base_url: API 基础地址，默认 https://redfox.hk
@@ -54,6 +69,15 @@ class RedFoxClient:
 
         # 初始化各平台 API 模块
         self.douyin = DouyinAPI(self)
+        self.xiaohongshu = XiaohongshuAPI(self)
+        self.wechat = WechatAPI(self)
+        self.bilibili = BilibiliAPI(self)
+        self.toutiao = ToutiaoAPI(self)
+        self.tiktok = TikTokAPI(self)
+        self.gpt_image = GPTImageAPI(self)
+        self.doubao_image = DoubaoImageAPI(self)
+        self.doubao_video = DoubaoVideoAPI(self)
+        self.ai_search = AISearchAPI(self)
 
     def request(
         self,

redfox-python-sdk-0.2.1/redfox/endpoints/ai_search.py

@@ -0,0 +1,87 @@
+"""AI 搜索工具 API 端点"""
+
+from typing import Optional, Dict, Any
+
+
+class AISearchAPI:
+    """
+    AI 搜索工具 API 集合
+
+    支持 Kimi、豆包、Deepseek 三种 AI 搜索引擎。
+    每种引擎均为异步模式：先 submit 提交任务，再 result 查询结果。
+    """
+
+    def __init__(self, client):
+        self._client = client
+
+    # ─── Kimi ───────────────────────────────────────────────
+
+    def kimi_submit(self, inquiry_text: str) -> dict:
+        """
+        Kimi 纯文字搜索 - 提交任务
+
+        :param inquiry_text: 搜索文本（必填）
+        :return: 包含 taskId 的字典
+        """
+        return self._client.post(
+            "/story/api/kimi/submit", data={"inquiryText": inquiry_text}
+        )
+
+    def kimi_result(self, task_id: str) -> dict:
+        """
+        Kimi 纯文字搜索 - 查询任务结果
+
+        :param task_id: 任务 ID
+        :return: 任务结果字典，包含 completed/content/webPages
+        """
+        return self._client.post(
+            "/story/api/kimi/result", data={"taskId": task_id}
+        )
+
+    # ─── 豆包 ───────────────────────────────────────────────
+
+    def doubao_submit(self, inquiry_text: str) -> dict:
+        """
+        豆包纯文字搜索 - 提交任务
+
+        :param inquiry_text: 搜索文本（必填）
+        :return: 包含 taskId 的字典
+        """
+        return self._client.post(
+            "/story/api/deepSearch/dbSubmit", data={"inquiryText": inquiry_text}
+        )
+
+    def doubao_result(self, task_id: str) -> dict:
+        """
+        豆包纯文字搜索 - 查询任务结果
+
+        :param task_id: 任务 ID
+        :return: 任务结果字典
+        """
+        return self._client.post(
+            "/story/api/deepSearch/dbResult", data={"taskId": task_id}
+        )
+
+    # ─── Deepseek ───────────────────────────────────────────
+
+    def deepseek_submit(self, inquiry_text: str) -> dict:
+        """
+        Deepseek 纯文字搜索 - 提交任务
+
+        :param inquiry_text: 搜索文本（必填）
+        :return: 包含 taskId 的字典
+        """
+        return self._client.post(
+            "/story/api/deepSearch/dsSubmit", data={"inquiryText": inquiry_text}
+        )
+
+    def deepseek_result(self, task_id: str) -> dict:
+        """
+        Deepseek 纯文字搜索 - 查询任务结果
+
+        :param task_id: 任务 ID
+        :return: 任务结果字典
+        """
+        return self._client.post(
+            "/story/api/deepSearch/dsResult", data={"taskId": task_id}
+        )

redfox-python-sdk-0.2.1/redfox/endpoints/bilibili.py

@@ -0,0 +1,123 @@
+"""哔哩哔哩平台 API 端点"""
+
+from typing import Optional, Dict, Any
+
+
+class BilibiliAPI:
+    """
+    哔哩哔哩平台 API 集合
+
+    包含 B 站账号查询、作品搜索、作品详情等接口。
+    """
+
+    def __init__(self, client):
+        self._client = client
+
+    def get_account(self, mid: str) -> dict:
+        """
+        获取哔哩哔哩账号信息（优质库）
+
+        :param mid: 账号 MID（B 站用户唯一 ID，必填）
+        :return: 账号信息字典
+        """
+        return self._client.post(
+            "/story/api/bili/data/accountDetail", data={"mid": mid}
+        )
+
+    def get_work(
+        self,
+        bvid: str = None,
+        work_url: str = None,
+    ) -> dict:
+        """
+        获取哔哩哔哩作品内容详情（优质库）
+
+        bvid 和 work_url 至少传一个。
+
+        :param bvid: 作品 BV 号
+        :param work_url: 作品链接，支持 bilibili.com/video/BV1xxx 或 b23.tv 格式
+        :return: 作品详情字典
+        """
+        data: Dict[str, Any] = {}
+        if bvid:
+            data["bvId"] = bvid
+        if work_url:
+            data["workUrl"] = work_url
+        return self._client.post("/story/api/bili/data/workDetail", data=data)
+
+    def search_users(
+        self,
+        keyword: str,
+        page: int = 1,
+        page_size: int = None,
+        order: str = None,
+    ) -> dict:
+        """
+        搜索关键词获取哔哩哔哩账号（优质库）
+
+        :param keyword: 搜索关键词（必填）
+        :param page: 页码，从 1 开始（必填）
+        :param page_size: 每页条数，默认 10，最大 50
+        :param order: 排序：follower=粉丝数 / like=获赞数，默认相关性
+        :return: 搜索结果字典
+        """
+        data: Dict[str, Any] = {"keyword": keyword, "page": str(page)}
+        if page_size is not None:
+            data["pageSize"] = page_size
+        if order is not None:
+            data["order"] = order
+        return self._client.post("/story/api/bili/data/accountSearch", data=data)
+
+    def search_articles(
+        self,
+        keyword: str,
+        page: int = 1,
+        page_size: int = None,
+        order: str = None,
+    ) -> dict:
+        """
+        搜索关键词获取哔哩哔哩作品（优质库）
+
+        :param keyword: 搜索关键词（必填）
+        :param page: 页码，从 1 开始（必填）
+        :param page_size: 每页条数，默认 10，最大 50
+        :param order: 排序：time=发布时间 / play=播放数 / like=点赞数 / comment=评论数 / favorite=收藏数，默认 time
+        :return: 搜索结果字典
+        """
+        data: Dict[str, Any] = {"keyword": keyword, "page": str(page)}
+        if page_size is not None:
+            data["pageSize"] = page_size
+        if order is not None:
+            data["order"] = order
+        return self._client.post("/story/api/bili/data/workSearch", data=data)
+
+    def get_user_works(
+        self,
+        mid: str = None,
+        account_url: str = None,
+        page: int = 1,
+        page_size: int = None,
+        order: str = None,
+    ) -> dict:
+        """
+        获取哔哩哔哩账号作品列表（优质库）
+
+        mid 和 account_url 至少传一个。
+
+        :param mid: 账号 MID
+        :param account_url: 主页链接，如 https://space.bilibili.com/946974
+        :param page: 页码，默认 1
+        :param page_size: 每页条数，默认 10，最大 50
+        :param order: 排序：time=发布时间 / play=播放数 / like=点赞数，默认 time
+        :return: 作品列表字典
+        """
+        data: Dict[str, Any] = {"page": str(page)}
+        if mid:
+            data["mid"] = mid
+        if account_url:
+            data["accountUrl"] = account_url
+        if page_size is not None:
+            data["pageSize"] = page_size
+        if order is not None:
+            data["order"] = order
+        return self._client.post("/story/api/bili/data/accountWorkList", data=data)

redfox-python-sdk-0.2.1/redfox/endpoints/doubao_image.py

@@ -0,0 +1,121 @@
+"""豆包图片生成工具 API 端点"""
+
+from typing import Optional, Dict, Any, Union, List
+
+
+class DoubaoImageAPI:
+    """
+    豆包图片生成工具 API 集合
+
+    支持 Seedream 5.0 Pro 和 Seedream 5.0 Lite 两个模型。
+    """
+
+    def __init__(self, client):
+        self._client = client
+
+    # ─── Seedream 5.0 Pro ───────────────────────────────────
+
+    def pro_submit(
+        self,
+        prompt: str,
+        size: str = "2048x2048",
+        image: Union[str, List[str]] = None,
+        output_format: str = "jpeg",
+        response_format: str = "url",
+        watermark: bool = True,
+        optimize_prompt: bool = False,
+        optimize_mode: str = "standard",
+    ) -> dict:
+        """
+        提交 Seedream 5.0 Pro 图片生成任务
+
+        :param prompt: 图片生成提示词（必填）
+        :param size: 尺寸，支持 1K/2K 或像素值如 "2048x2048"
+        :param image: 图生图输入图片，支持 URL 或 Base64
+        :param output_format: 输出格式，png/jpeg
+        :param response_format: 返回格式，url/b64_json
+        :param watermark: 是否添加 AI 生成水印
+        :param optimize_prompt: 是否开启提示词优化
+        :param optimize_mode: 优化模式，standard/fast
+        :return: 包含 taskId 的字典
+        """
+        data: Dict[str, Any] = {
+            "prompt": prompt,
+            "size": size,
+            "outputFormat": output_format,
+            "responseFormat": response_format,
+            "watermark": watermark,
+        }
+        if image is not None:
+            data["image"] = image
+        if optimize_prompt:
+            data["optimizePromptOptions"] = {"mode": optimize_mode}
+        return self._client.post("/story/api/parseWork/imageGen/arkProSubmit", data=data)
+
+    def pro_result(self, task_id: str) -> dict:
+        """
+        查询 Seedream 5.0 Pro 任务结果
+
+        :param task_id: 任务 ID
+        :return: 任务结果字典
+        """
+        return self._client.post(
+            "/story/api/parseWork/imageGen/arkProResult", data={"taskId": task_id}
+        )
+
+    # ─── Seedream 5.0 Lite ──────────────────────────────────
+
+    def lite_submit(
+        self,
+        prompt: str,
+        size: str = "2048x2048",
+        image: Union[str, List[str]] = None,
+        output_format: str = "jpeg",
+        response_format: str = "url",
+        watermark: bool = True,
+        sequential: str = "disabled",
+        max_images: int = 4,
+        optimize_prompt: bool = False,
+        optimize_mode: str = "standard",
+    ) -> dict:
+        """
+        提交 Seedream 5.0 Lite 图片生成任务
+
+        :param prompt: 图片生成提示词（必填）
+        :param size: 尺寸，支持 2K/3K/4K 或像素值
+        :param image: 图生图输入图片
+        :param output_format: 输出格式，png/jpeg
+        :param response_format: 返回格式，url/b64_json
+        :param watermark: 是否添加 AI 生成水印
+        :param sequential: 组图控制，auto/disabled
+        :param max_images: 组图最大数量，1~10
+        :param optimize_prompt: 是否开启提示词优化
+        :param optimize_mode: 优化模式，standard/fast
+        :return: 包含 taskId 的字典
+        """
+        data: Dict[str, Any] = {
+            "prompt": prompt,
+            "size": size,
+            "outputFormat": output_format,
+            "responseFormat": response_format,
+            "watermark": watermark,
+            "sequentialImageGeneration": sequential,
+        }
+        if image is not None:
+            data["image"] = image
+        if sequential == "auto":
+            data["sequentialImageGenerationOptions"] = {"maxImages": max_images}
+        if optimize_prompt:
+            data["optimizePromptOptions"] = {"mode": optimize_mode}
+        return self._client.post("/story/api/parseWork/imageGen/arkSubmit", data=data)
+
+    def lite_result(self, task_id: str) -> dict:
+        """
+        查询 Seedream 5.0 Lite 任务结果
+
+        :param task_id: 任务 ID
+        :return: 任务结果字典
+        """
+        return self._client.post(
+            "/story/api/parseWork/imageGen/arkResult", data={"taskId": task_id}
+        )

redfox-python-sdk-0.2.1/redfox/endpoints/doubao_video.py

@@ -0,0 +1,74 @@
+"""豆包视频生成 API 端点（Seedance 2.0）"""
+
+from typing import Optional, Dict, Any, List
+
+
+class DoubaoVideoAPI:
+    """
+    豆包视频生成 API 集合（Seedance 2.0）
+
+    包含视频生成任务提交与结果查询接口。
+    """
+
+    def __init__(self, client):
+        self._client = client
+
+    def submit(
+        self,
+        content: List[Dict[str, Any]],
+        model: str = None,
+        resolution: str = "720p",
+        ratio: str = "adaptive",
+        duration: int = 5,
+        seed: int = -1,
+        watermark: bool = False,
+        generate_audio: bool = True,
+        return_last_frame: bool = False,
+    ) -> dict:
+        """
+        提交视频生成任务（Seedance 2.0）
+
+        content 是一个列表，每个元素是一个字典，支持以下 type：
+        - text: {"type": "text", "text": "描述文字"}
+        - image_url: {"type": "image_url", "imageUrl": "图片URL", "imageRole": "first_frame/reference_image"}
+        - video_url: {"type": "video_url", "videoUrl": "视频URL", "videoRole": "reference_video"}
+        - audio_url: {"type": "audio_url", "audioUrl": "音频URL", "audioRole": "reference_audio"}
+
+        :param content: 输入内容列表（必填），每项包含 type 及对应字段
+        :param model: 模型名称，如 "doubao-seedance-2-0-260128"
+        :param resolution: 视频分辨率：480p/720p/1080p（Seedance 2.0 fast 不支持 1080p）
+        :param ratio: 宽高比：adaptive/16:9/4:3/1:1/3:4/9:16/21:9
+        :param duration: 视频时长（秒），[4,15] 或 -1（智能）
+        :param seed: 随机种子，-1 为随机，范围 [-1, 2^32-1]
+        :param watermark: 是否添加水印
+        :param generate_audio: 是否生成同步音频（仅 Seedance 2.0 系列）
+        :param return_last_frame: 是否返回尾帧图像（用于连续视频生成）
+        :return: 含 taskId 的字典
+        """
+        data: Dict[str, Any] = {
+            "content": content,
+            "resolution": resolution,
+            "ratio": ratio,
+            "duration": duration,
+            "seed": seed,
+            "watermark": watermark,
+            "generateAudio": generate_audio,
+            "returnLastFrame": return_last_frame,
+        }
+        if model is not None:
+            data["model"] = model
+        return self._client.post(
+            "/story/api/parseWork/videoGen/submit", data=data
+        )
+
+    def result(self, task_id: str) -> dict:
+        """
+        查询视频生成任务结果
+
+        :param task_id: 任务 ID（submit 接口返回）
+        :return: 视频生成结果字典
+        """
+        return self._client.post(
+            "/story/api/parseWork/videoGen/result",
+            data={"taskId": task_id},
+        )

redfox-python-sdk-0.2.1/redfox/endpoints/gpt_image.py

@@ -0,0 +1,77 @@
+"""GPT 图片生成工具 API 端点"""
+
+from typing import Optional, Dict, Any, List
+
+
+class GPTImageAPI:
+    """
+    GPT 图片生成工具 API 集合
+
+    支持文生图和图生图，基于 image2-GPT 模型。
+    """
+
+    def __init__(self, client):
+        self._client = client
+
+    def submit(
+        self,
+        prompt: str,
+        n: int = 1,
+        size: str = "1024x1024",
+        quality: str = "medium",
+        background: str = "auto",
+        output_format: str = "png",
+        output_compression: int = None,
+        model_name: str = "gpt-image-2",
+        operation: str = "generate",
+        input_fidelity: str = None,
+        images: List[Dict[str, str]] = None,
+    ) -> dict:
+        """
+        提交 GPT 图片生成任务
+
+        :param prompt: 图片生成提示词（必填）
+        :param n: 生成数量，1~10
+        :param size: 图片尺寸，如 "1024x1024"
+        :param quality: 质量，支持 low/medium/high/auto
+        :param background: 背景类型，支持 transparent/opaque/auto
+        :param output_format: 输出格式，支持 png/jpeg/webp
+        :param output_compression: 输出压缩比，0~100
+        :param model_name: 模型名称，默认 gpt-image-2
+        :param operation: 操作类型，generate（文生图）/ edit（图生图）
+        :param input_fidelity: 输入图保真度，编辑模式（operation=edit）支持 high/low
+        :param images: 图片编辑输入图列表，operation=edit 时必填
+        :return: 包含 taskId 的字典
+        """
+        parameters: Dict[str, Any] = {
+            "modelName": model_name,
+            "n": n,
+            "size": size,
+            "quality": quality,
+            "background": background,
+            "outputFormat": output_format,
+        }
+        if output_compression is not None:
+            parameters["outputCompression"] = output_compression
+        if input_fidelity is not None:
+            parameters["inputFidelity"] = input_fidelity
+
+        data: Dict[str, Any] = {
+            "prompt": prompt,
+            "operation": operation,
+            "parameters": parameters,
+        }
+        if images is not None:
+            data["images"] = images
+        return self._client.post("/story/api/parseWork/imageGen/submitSkill", data=data)
+
+    def result(self, task_id: str) -> dict:
+        """
+        查询 GPT 图片生成任务结果
+
+        :param task_id: 任务 ID（由 submit 接口返回）
+        :return: 任务结果字典，包含 status/imagePaths/failReason
+        """
+        return self._client.post(
+            "/story/api/parseWork/imageGen/result", data={"taskId": task_id}
+        )

redfox-python-sdk-0.2.1/redfox/endpoints/tiktok.py

@@ -0,0 +1,33 @@
+"""TikTok 平台 API 端点"""
+
+from typing import Optional, Dict, Any
+
+
+class TikTokAPI:
+    """
+    TikTok 平台 API 集合
+
+    包含 TikTok 账号搜索等接口。
+    """
+
+    def __init__(self, client):
+        self._client = client
+
+    def search_users(
+        self,
+        keyword: str,
+        cursor: int = 0,
+        rid: str = None,
+    ) -> dict:
+        """
+        TikTok 关键词搜索账号
+
+        :param keyword: 搜索关键词（必填）
+        :param cursor: 翻页游标，第一页为 0，每页 +10
+        :param rid: 数据返回的 rid，翻页时传入，第一页传空
+        :return: 搜索结果字典，包含 cursor/hasMore/userList
+        """
+        data: Dict[str, Any] = {"keyword": keyword, "cursor": cursor}
+        if rid is not None:
+            data["rid"] = rid
+        return self._client.post("/story/api/deepSearch/tk/searchUser", data=data)

redfox-python-sdk-0.2.1/redfox/endpoints/toutiao.py

@@ -0,0 +1,40 @@
+"""今日头条平台 API 端点"""
+
+from typing import Optional, Dict, Any
+
+
+class ToutiaoAPI:
+    """
+    今日头条平台 API 集合
+
+    包含今日头条作品搜索、作品详情等接口（实时）。
+    """
+
+    def __init__(self, client):
+        self._client = client
+
+    def search_works(
+        self,
+        keyword: str,
+        offset: int = 0,
+    ) -> dict:
+        """
+        获取今日头条账号作品列表（实时）
+
+        :param keyword: 搜索关键词（必填）
+        :param offset: 翻页偏移量，从 0 开始，每页 +1
+        :return: 作品列表
+        """
+        data: Dict[str, Any] = {"keyword": keyword, "offset": str(offset)}
+        return self._client.post("/story/api/toutiao/searchWork", data=data)
+
+    def get_work(self, opus_id: str) -> dict:
+        """
+        获取今日头条作品内容详情（实时）
+
+        :param opus_id: 作品 ID（必填）
+        :return: 作品详情字典
+        """
+        return self._client.post(
+            "/story/api/toutiao/workDetail", data={"opusId": opus_id}
+        )

redfox-python-sdk-0.2.1/redfox/endpoints/wechat.py

@@ -0,0 +1,159 @@
+"""微信公众号平台 API 端点"""
+
+from typing import Optional, Dict, Any
+
+
+class WechatAPI:
+    """
+    微信公众号平台 API 集合
+
+    包含公众号账号查询、作品搜索、文章详情等接口。
+    """
+
+    def __init__(self, client):
+        self._client = client
+
+    # ─── 账号相关 ───────────────────────────────────────────
+
+    def get_account(self, account: str, account_name: str = None) -> dict:
+        """
+        获取公众号账号信息（优质库）
+
+        :param account: 公众号微信号（必填）
+        :param account_name: 公众号名称（可选）
+        :return: 账号信息字典
+        """
+        data: Dict[str, Any] = {"account": account}
+        if account_name is not None:
+            data["accountName"] = account_name
+        return self._client.post("/story/api/gzhData/queryUser", data=data)
+
+    def search_users(
+        self,
+        keyword: str,
+        offset: int = 0,
+        sort_type: str = None,
+    ) -> dict:
+        """
+        搜索关键词获取公众号账号（优质库）
+
+        :param keyword: 搜索关键词（必填）
+        :param offset: 偏移量，从 0 开始，每页 +20
+        :param sort_type: 排序方式：_0=默认，_2=最新，_4=最热
+        :return: 搜索结果字典
+        """
+        data: Dict[str, Any] = {"keyword": keyword}
+        if offset is not None:
+            data["offset"] = offset
+        if sort_type is not None:
+            data["sortType"] = sort_type
+        return self._client.post("/story/api/gzhData/searchUser", data=data)
+
+    # ─── 作品相关 ───────────────────────────────────────────
+
+    def get_work(self, work_uuid: str) -> dict:
+        """
+        根据作品 UUID 获取公众号作品（优质库）
+
+        :param work_uuid: 作品 UUID（必填）
+        :return: 作品详情字典
+        """
+        return self._client.post(
+            "/story/api/gzhData/queryWork", data={"workUuid": work_uuid}
+        )
+
+    def get_article_detail(self, url: str) -> dict:
+        """
+        根据作品地址获取公众号文章（优质库）
+
+        :param url: 文章链接（必填）
+        :return: 文章详情字典
+        """
+        return self._client.post(
+            "/story/api/gzhData/queryArticleDetail", data={"url": url}
+        )
+
+    def search_articles(
+        self,
+        keyword: str,
+        offset: int = 0,
+        sort_type: str = None,
+    ) -> dict:
+        """
+        搜索关键词获取公众号作品（优质库）
+
+        :param keyword: 搜索关键词（必填）
+        :param offset: 偏移量，从 0 开始，每页 +20
+        :param sort_type: 排序方式
+        :return: 搜索结果字典
+        """
+        data: Dict[str, Any] = {"keyword": keyword}
+        if offset is not None:
+            data["offset"] = offset
+        if sort_type is not None:
+            data["sortType"] = sort_type
+        return self._client.post("/story/api/gzhData/searchArticle", data=data)
+
+    def get_user_works(
+        self,
+        account: str,
+        account_name: str = None,
+        offset: int = 0,
+        sort_type: str = None,
+        publish_time_start: str = None,
+        publish_time_end: str = None,
+    ) -> dict:
+        """
+        获取公众号账号作品列表（优质库）
+
+        :param account: 公众号微信号（必填）
+        :param account_name: 公众号名称（可选）
+        :param offset: 偏移量，从 0 开始，每页 +20
+        :param sort_type: 排序方式：_0=默认，_2=最新，_4=最热
+        :param publish_time_start: 发布时间起始，最早 2026-04-01，不传默认 2026-04-01
+        :param publish_time_end: 发布时间结束，不传默认当前时间
+        :return: 作品列表字典
+        """
+        data: Dict[str, Any] = {"account": account}
+        if account_name:
+            data["accountName"] = account_name
+        if offset is not None:
+            data["offset"] = offset
+        if sort_type is not None:
+            data["sortType"] = sort_type
+        if publish_time_start is not None:
+            data["publishTimeStart"] = publish_time_start
+        if publish_time_end is not None:
+            data["publishTimeEnd"] = publish_time_end
+        return self._client.post("/story/api/gzhData/queryWorkList", data=data)
+
+    # ─── AI 作品 ────────────────────────────────────────────
+
+    def search_ai_articles(
+        self,
+        keyword: str,
+        page_num: int = 1,
+        page_size: int = 20,
+        start_time: str = None,
+        end_time: str = None,
+    ) -> dict:
+        """
+        搜索关键词获取公众号 AI 创作作品（优质库）
+
+        :param keyword: 搜索关键词（必填）
+        :param page_num: 页码，默认 1（必填）
+        :param page_size: 每页条数，默认 20（必填）
+        :param start_time: 开始时间，格式 "2026-06-01 00:00:00"
+        :param end_time: 结束时间，格式 "2026-06-01 23:59:59"
+        :return: 搜索结果字典
+        """
+        data: Dict[str, Any] = {
+            "keyword": keyword,
+            "pageNum": page_num,
+            "pageSize": page_size,
+        }
+        if start_time is not None:
+            data["startTime"] = start_time
+        if end_time is not None:
+            data["endTime"] = end_time
+        return self._client.post("/story/api/parseWork/queryAiMsgs", data=data)

redfox-python-sdk-0.2.1/redfox/endpoints/xiaohongshu.py

@@ -0,0 +1,143 @@
+"""小红书平台 API 端点"""
+
+from typing import Optional, Dict, Any
+
+
+class XiaohongshuAPI:
+    """
+    小红书平台 API 集合
+
+    包含小红书账号查询、作品搜索、笔记详情等接口。
+    """
+
+    def __init__(self, client):
+        self._client = client
+
+    # ─── 账号相关 ───────────────────────────────────────────
+
+    def search_users(
+        self,
+        keyword: str,
+        offset: int = 0,
+        sort_type: str = None,
+    ) -> dict:
+        """
+        搜索关键词获取小红书账号（优质库）
+
+        :param keyword: 搜索关键词（必填）
+        :param offset: 偏移量
+        :param sort_type: 排序方式
+        :return: 搜索结果字典
+        """
+        data: Dict[str, Any] = {"keyword": keyword}
+        if offset is not None:
+            data["offset"] = offset
+        if sort_type is not None:
+            data["sortType"] = sort_type
+        return self._client.post(
+            "/story/api/redBookData/searchUser", data=data
+        )
+
+    def get_account(
+        self,
+        account_id: str,
+        user_id: str = None,
+    ) -> dict:
+        """
+        获取小红书账号信息（优质库）
+
+        :param account_id: 小红书号（必填）
+        :param user_id: 用户 ID（可选）
+        :return: 账号信息字典
+        """
+        data: Dict[str, Any] = {"accountId": account_id}
+        if user_id is not None:
+            data["userId"] = user_id
+        return self._client.post(
+            "/story/api/redBookData/queryUser", data=data
+        )
+
+    # ─── 作品相关 ───────────────────────────────────────────
+
+    def search_articles(
+        self,
+        keyword: str,
+        offset: int = 0,
+        sort_type: str = None,
+    ) -> dict:
+        """
+        搜索关键词获取小红书作品（优质库）
+
+        :param keyword: 搜索关键词（必填）
+        :param offset: 偏移量
+        :param sort_type: 排序方式
+        :return: 搜索结果字典
+        """
+        data: Dict[str, Any] = {"keyword": keyword}
+        if offset is not None:
+            data["offset"] = offset
+        if sort_type is not None:
+            data["sortType"] = sort_type
+        return self._client.post(
+            "/story/api/redBookData/searchArticle", data=data
+        )
+
+    def get_work(
+        self,
+        work_id: str = None,
+        work_link: str = None,
+    ) -> dict:
+        """
+        获取小红书作品内容详情（优质库）
+
+        work_id 和 work_link 至少传一个。
+
+        :param work_id: 作品 ID
+        :param work_link: 作品链接，如 https://www.xiaohongshu.com/explore/xxx
+        :return: 作品详情字典
+        """
+        data: Dict[str, Any] = {}
+        if work_id:
+            data["workId"] = work_id
+        if work_link:
+            data["workLink"] = work_link
+        return self._client.post(
+            "/story/api/redBookData/queryWork", data=data
+        )
+
+    # ─── AI 作品 ────────────────────────────────────────────
+
+    def search_ai_articles(
+        self,
+        keyword: str,
+        page_num: int = 1,
+        page_size: int = 20,
+        start_time: str = None,
+        end_time: str = None,
+        source: str = None,
+    ) -> dict:
+        """
+        搜索关键词获取小红书 AI 创作作品（优质库）
+
+        :param keyword: 搜索关键词（必填）
+        :param page_num: 页码，默认 1
+        :param page_size: 每页条数，默认 20
+        :param start_time: 起始时间，格式 "2026-06-01 00:00:00"
+        :param end_time: 结束时间，格式 "2026-06-02 00:00:00"
+        :param source: 来源平台（可选）
+        :return: 搜索结果字典
+        """
+        data: Dict[str, Any] = {
+            "keyword": keyword,
+            "pageNum": page_num,
+            "pageSize": page_size,
+        }
+        if start_time is not None:
+            data["startTime"] = start_time
+        if end_time is not None:
+            data["endTime"] = end_time
+        if source is not None:
+            data["source"] = source
+        return self._client.post(
+            "/story/api/parseWork/queryAiMsgs", data=data
+        )

{redfox-python-sdk-0.1.0 → redfox-python-sdk-0.2.1}/redfox_python_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: redfox-python-sdk
-Version: 0.1.0
+Version: 0.2.1
 Summary: RedFox 红狐数据平台 Python SDK
 Home-page: https://redfox.hk
 Author: RedFox

redfox-python-sdk-0.2.1/redfox_python_sdk.egg-info/SOURCES.txt

@@ -0,0 +1,21 @@
+README.md
+setup.py
+redfox/__init__.py
+redfox/client.py
+redfox/exceptions.py
+redfox/endpoints/__init__.py
+redfox/endpoints/ai_search.py
+redfox/endpoints/bilibili.py
+redfox/endpoints/doubao_image.py
+redfox/endpoints/doubao_video.py
+redfox/endpoints/douyin.py
+redfox/endpoints/gpt_image.py
+redfox/endpoints/tiktok.py
+redfox/endpoints/toutiao.py
+redfox/endpoints/wechat.py
+redfox/endpoints/xiaohongshu.py
+redfox_python_sdk.egg-info/PKG-INFO
+redfox_python_sdk.egg-info/SOURCES.txt
+redfox_python_sdk.egg-info/dependency_links.txt
+redfox_python_sdk.egg-info/requires.txt
+redfox_python_sdk.egg-info/top_level.txt

{redfox-python-sdk-0.1.0 → redfox-python-sdk-0.2.1}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="redfox-python-sdk",
-    version="0.1.0",
+    version="0.2.1",
     description="RedFox 红狐数据平台 Python SDK",
     long_description=open("README.md", encoding="utf-8").read(),
     long_description_content_type="text/markdown",

redfox-python-sdk-0.1.0/redfox_python_sdk.egg-info/SOURCES.txt

@@ -1,12 +0,0 @@
-README.md
-setup.py
-redfox/__init__.py
-redfox/client.py
-redfox/exceptions.py
-redfox/endpoints/__init__.py
-redfox/endpoints/douyin.py
-redfox_python_sdk.egg-info/PKG-INFO
-redfox_python_sdk.egg-info/SOURCES.txt
-redfox_python_sdk.egg-info/dependency_links.txt
-redfox_python_sdk.egg-info/requires.txt
-redfox_python_sdk.egg-info/top_level.txt