redfox-python-sdk 0.5.1__tar.gz → 0.6.0__tar.gz

{redfox_python_sdk-0.5.1 → redfox_python_sdk-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: redfox-python-sdk
-Version: 0.5.1
+Version: 0.6.0
 Summary: RedFox 红狐数据平台 Python SDK — 同步+异步双客户端，自动重试，零配置
 Home-page: https://redfox.hk
 Author: RedFox
@@ -36,7 +36,7 @@ Dynamic: summary
   </a>
 </p>
 
-[RedFoxHub](https://redfox.hk/?source=github) Python SDK，提供 [抖音](https://redfox.hk/apis/douyin/0OT1E306)、[小红书](https://redfox.hk/apis/xiaohongshu/4IVIDHEN)、[公众号](https://redfox.hk/apis/gongzhonghao/6C4A77XR)、[B站](https://redfox.hk/apis/bilibili/TIN1NMTZ)、[今日头条](https://redfox.hk/apis/jinritoutiao/28CFGF5I)、[TikTok](https://redfox.hk/apis/tool-tiktok/20070019)、快手、视频号、YouTube、X (Twitter)、Instagram、懂车帝、易车、汽车之家 14 大内容平台的数据采集接口，多平台热点榜单聚合接口，短视频去水印下载与素材上传工具，以及 GPT 图片生成、豆包图片/视频生成、AI 搜索（Kimi/豆包/Deepseek/元宝/千问/百度）AI 能力接口。
+[RedFoxHub](https://redfox.hk/?source=github) Python SDK，提供 [抖音](https://redfox.hk/apis/douyin/0OT1E306)、[小红书](https://redfox.hk/apis/xiaohongshu/4IVIDHEN)、[公众号](https://redfox.hk/apis/gongzhonghao/6C4A77XR)、[B站](https://redfox.hk/apis/bilibili/TIN1NMTZ)、[今日头条](https://redfox.hk/apis/jinritoutiao/28CFGF5I)、[TikTok](https://redfox.hk/apis/tool-tiktok/20070019)、快手、视频号、YouTube、X (Twitter)、Instagram、微博、百家号、知乎、懂车帝、易车、汽车之家 17 大内容平台的数据采集接口，多平台热点榜单聚合接口，短视频去水印下载与素材上传工具，以及 GPT 图片生成、豆包图片/视频生成、AI 搜索（Kimi/豆包/Deepseek/元宝/千问/百度）AI 能力接口。
 
 ## 为什么选择 RedFoxHub
 
@@ -155,11 +155,14 @@ result = client.ai_search.kimi_result(task_id=task["taskId"])
 | 🎵 TikTok | `client.tiktok` | 4 | 用户搜索、视频搜索、作品详情、用户作品列表 |
 | 🎬 快手 | `client.kuaishou` | 6 | 作品搜索、作品详情、账号作品、账号搜索、视频提文案 |
 | 💚 视频号 | `client.wechat_channels` | 7 | 作品搜索、作品详情、账号作品、链接实时详情、账号搜索、链接提文案 |
-| ▶️ YouTube | `client.youtube` | 4 | 视频搜索、视频详情、视频评论、视频提文案（字幕提取） |
-| 🐦 X (Twitter) | `client.twitter` | 4 | 推文搜索、推文详情、用户信息、推文评论 |
+| ▶️ YouTube | `client.youtube` | 5 | 视频搜索、视频详情、视频评论、视频提文案（字幕提取）、字幕详情 |
+| 🐦 X (Twitter) | `client.twitter` | 7 | 推文搜索、推文详情、用户信息、推文评论、关注列表、用户发帖、热门账号榜 |
 | 📸 Instagram | `client.instagram` | 4 | 综合搜索、帖子详情、帖子评论、用户信息 |
+| 🔵 微博 | `client.weibo` | 3 | 账号搜索、内容详情、用户详情 |
+| 📰 百家号 | `client.baijiahao` | 5 | 账号搜索、作品搜索、视频详情、作品内容 html、账号信息 |
+| 💡 知乎 | `client.zhihu` | 1 | 关键词搜索作品 |
 | 🚗 懂车帝 | `client.dongchedi` | 4 | 作品搜索、作品详情、用户作品、用户搜索 |
-| 🚙 易车 | `client.yiche` | 5 | 作品搜索、文章详情、视频详情、账号作品、账号搜索 |
+| 🚙 易车 | `client.yiche` | 6 | 作品搜索、文章详情、文章详情V2、视频详情、账号作品、账号搜索 |
 | 🚘 汽车之家 | `client.autohome` | 4 | 作品搜索、文章详情、视频详情、账号作品 |
 | 🔥 热点榜单 | `client.hotspot` | 3 | 各平台热点榜、全网热搜查询、全网聚合热点 TOP10 |
 | 🖼️ GPT 图片 | `client.gpt_image` | 2 | 图片生成、结果查询 |
@@ -406,6 +409,9 @@ client.youtube.get_comments(video_id="sa8AzBK4dao", sort_by="top")
 
 # 视频提文案（提取字幕/口播文案）
 client.youtube.get_transcript(video_url="https://www.youtube.com/watch?v=sa8AzBK4dao")
+
+# 获取视频字幕详情（视频信息 + 可用字幕语言列表）
+client.youtube.get_info(video_url="https://www.youtube.com/watch?v=sa8AzBK4dao")
 ```
 
 ### X (Twitter)
@@ -422,6 +428,15 @@ client.twitter.get_user(screen_name="elonmusk")
 
 # 获取推文评论
 client.twitter.get_comments(tweet_id="1957000000000000000")
+
+# 获取用户关注列表
+client.twitter.get_following(screen_name="elonmusk")
+
+# 获取用户发帖（screen_name / rest_id 至少传一个）
+client.twitter.get_user_works(screen_name="elonmusk")
+
+# X 热门账号榜（rank_date 必填，支持性别/行业筛选）
+client.twitter.get_hot_account_rank(rank_date="2026-09-23", page_num=1, gender="all")
 ```
 
 ### Instagram
@@ -440,6 +455,45 @@ client.instagram.get_comments(code_or_url="DRhvwVLAHAG", sort_by="recent")
 client.instagram.get_user(username="natgeo")
 ```
 
+### 微博
+
+```python
+# 搜索账号
+client.weibo.search_users(keyword="汽水音乐", page=1)
+
+# 获取微博内容详情
+client.weibo.get_work(opus_id="5200000000000000")
+
+# 获取用户详情
+client.weibo.get_user(user_id="7799374443")
+```
+
+### 百家号
+
+```python
+# 账号关键词搜索（第一页 page="0"，下一页传返回数据中的 page 值）
+client.baijiahao.search_users(keyword="头条", page="0")
+
+# 关键词搜索作品（pn 翻页 +10，sort="1" 焦点排序 / "2" 时间排序）
+client.baijiahao.search_works(keyword="新能源汽车", pn="0", sort="2")
+
+# 获取视频详情
+client.baijiahao.get_video(sv_id="1000000000000000000")
+
+# 获取作品内容 html
+client.baijiahao.get_article_html(article_id="1000000000000000000")
+
+# 获取账号信息
+client.baijiahao.get_user(uk="d0000000000000000")
+```
+
+### 知乎
+
+```python
+# 关键词搜索作品（offset +20 翻页，支持排序/时间范围/类型筛选）
+client.zhihu.search_works(keyword="人工智能", offset="0", sort="upvoted_count", vertical="answer")
+```
+
 ### 懂车帝
 
 ```python
@@ -465,6 +519,9 @@ client.yiche.search_works(keyword="小米SU7", page=1, source_type="xinwen")
 # 获取文章详情
 client.yiche.get_article(url="https://news.yiche.com/hao/wenzhang/xxx.html")
 
+# 获取文章详情 V2
+client.yiche.get_article_v2(url="https://news.yiche.com/hao/wenzhang/xxx.html")
+
 # 获取视频详情
 client.yiche.get_video(work_id="50000000")
 

{redfox_python_sdk-0.5.1 → redfox_python_sdk-0.6.0}/README.md

@@ -12,7 +12,7 @@
   </a>
 </p>
 
-[RedFoxHub](https://redfox.hk/?source=github) Python SDK，提供 [抖音](https://redfox.hk/apis/douyin/0OT1E306)、[小红书](https://redfox.hk/apis/xiaohongshu/4IVIDHEN)、[公众号](https://redfox.hk/apis/gongzhonghao/6C4A77XR)、[B站](https://redfox.hk/apis/bilibili/TIN1NMTZ)、[今日头条](https://redfox.hk/apis/jinritoutiao/28CFGF5I)、[TikTok](https://redfox.hk/apis/tool-tiktok/20070019)、快手、视频号、YouTube、X (Twitter)、Instagram、懂车帝、易车、汽车之家 14 大内容平台的数据采集接口，多平台热点榜单聚合接口，短视频去水印下载与素材上传工具，以及 GPT 图片生成、豆包图片/视频生成、AI 搜索（Kimi/豆包/Deepseek/元宝/千问/百度）AI 能力接口。
+[RedFoxHub](https://redfox.hk/?source=github) Python SDK，提供 [抖音](https://redfox.hk/apis/douyin/0OT1E306)、[小红书](https://redfox.hk/apis/xiaohongshu/4IVIDHEN)、[公众号](https://redfox.hk/apis/gongzhonghao/6C4A77XR)、[B站](https://redfox.hk/apis/bilibili/TIN1NMTZ)、[今日头条](https://redfox.hk/apis/jinritoutiao/28CFGF5I)、[TikTok](https://redfox.hk/apis/tool-tiktok/20070019)、快手、视频号、YouTube、X (Twitter)、Instagram、微博、百家号、知乎、懂车帝、易车、汽车之家 17 大内容平台的数据采集接口，多平台热点榜单聚合接口，短视频去水印下载与素材上传工具，以及 GPT 图片生成、豆包图片/视频生成、AI 搜索（Kimi/豆包/Deepseek/元宝/千问/百度）AI 能力接口。
 
 ## 为什么选择 RedFoxHub
 
@@ -131,11 +131,14 @@ result = client.ai_search.kimi_result(task_id=task["taskId"])
 | 🎵 TikTok | `client.tiktok` | 4 | 用户搜索、视频搜索、作品详情、用户作品列表 |
 | 🎬 快手 | `client.kuaishou` | 6 | 作品搜索、作品详情、账号作品、账号搜索、视频提文案 |
 | 💚 视频号 | `client.wechat_channels` | 7 | 作品搜索、作品详情、账号作品、链接实时详情、账号搜索、链接提文案 |
-| ▶️ YouTube | `client.youtube` | 4 | 视频搜索、视频详情、视频评论、视频提文案（字幕提取） |
-| 🐦 X (Twitter) | `client.twitter` | 4 | 推文搜索、推文详情、用户信息、推文评论 |
+| ▶️ YouTube | `client.youtube` | 5 | 视频搜索、视频详情、视频评论、视频提文案（字幕提取）、字幕详情 |
+| 🐦 X (Twitter) | `client.twitter` | 7 | 推文搜索、推文详情、用户信息、推文评论、关注列表、用户发帖、热门账号榜 |
 | 📸 Instagram | `client.instagram` | 4 | 综合搜索、帖子详情、帖子评论、用户信息 |
+| 🔵 微博 | `client.weibo` | 3 | 账号搜索、内容详情、用户详情 |
+| 📰 百家号 | `client.baijiahao` | 5 | 账号搜索、作品搜索、视频详情、作品内容 html、账号信息 |
+| 💡 知乎 | `client.zhihu` | 1 | 关键词搜索作品 |
 | 🚗 懂车帝 | `client.dongchedi` | 4 | 作品搜索、作品详情、用户作品、用户搜索 |
-| 🚙 易车 | `client.yiche` | 5 | 作品搜索、文章详情、视频详情、账号作品、账号搜索 |
+| 🚙 易车 | `client.yiche` | 6 | 作品搜索、文章详情、文章详情V2、视频详情、账号作品、账号搜索 |
 | 🚘 汽车之家 | `client.autohome` | 4 | 作品搜索、文章详情、视频详情、账号作品 |
 | 🔥 热点榜单 | `client.hotspot` | 3 | 各平台热点榜、全网热搜查询、全网聚合热点 TOP10 |
 | 🖼️ GPT 图片 | `client.gpt_image` | 2 | 图片生成、结果查询 |
@@ -382,6 +385,9 @@ client.youtube.get_comments(video_id="sa8AzBK4dao", sort_by="top")
 
 # 视频提文案（提取字幕/口播文案）
 client.youtube.get_transcript(video_url="https://www.youtube.com/watch?v=sa8AzBK4dao")
+
+# 获取视频字幕详情（视频信息 + 可用字幕语言列表）
+client.youtube.get_info(video_url="https://www.youtube.com/watch?v=sa8AzBK4dao")
 ```
 
 ### X (Twitter)
@@ -398,6 +404,15 @@ client.twitter.get_user(screen_name="elonmusk")
 
 # 获取推文评论
 client.twitter.get_comments(tweet_id="1957000000000000000")
+
+# 获取用户关注列表
+client.twitter.get_following(screen_name="elonmusk")
+
+# 获取用户发帖（screen_name / rest_id 至少传一个）
+client.twitter.get_user_works(screen_name="elonmusk")
+
+# X 热门账号榜（rank_date 必填，支持性别/行业筛选）
+client.twitter.get_hot_account_rank(rank_date="2026-09-23", page_num=1, gender="all")
 ```
 
 ### Instagram
@@ -416,6 +431,45 @@ client.instagram.get_comments(code_or_url="DRhvwVLAHAG", sort_by="recent")
 client.instagram.get_user(username="natgeo")
 ```
 
+### 微博
+
+```python
+# 搜索账号
+client.weibo.search_users(keyword="汽水音乐", page=1)
+
+# 获取微博内容详情
+client.weibo.get_work(opus_id="5200000000000000")
+
+# 获取用户详情
+client.weibo.get_user(user_id="7799374443")
+```
+
+### 百家号
+
+```python
+# 账号关键词搜索（第一页 page="0"，下一页传返回数据中的 page 值）
+client.baijiahao.search_users(keyword="头条", page="0")
+
+# 关键词搜索作品（pn 翻页 +10，sort="1" 焦点排序 / "2" 时间排序）
+client.baijiahao.search_works(keyword="新能源汽车", pn="0", sort="2")
+
+# 获取视频详情
+client.baijiahao.get_video(sv_id="1000000000000000000")
+
+# 获取作品内容 html
+client.baijiahao.get_article_html(article_id="1000000000000000000")
+
+# 获取账号信息
+client.baijiahao.get_user(uk="d0000000000000000")
+```
+
+### 知乎
+
+```python
+# 关键词搜索作品（offset +20 翻页，支持排序/时间范围/类型筛选）
+client.zhihu.search_works(keyword="人工智能", offset="0", sort="upvoted_count", vertical="answer")
+```
+
 ### 懂车帝
 
 ```python
@@ -441,6 +495,9 @@ client.yiche.search_works(keyword="小米SU7", page=1, source_type="xinwen")
 # 获取文章详情
 client.yiche.get_article(url="https://news.yiche.com/hao/wenzhang/xxx.html")
 
+# 获取文章详情 V2
+client.yiche.get_article_v2(url="https://news.yiche.com/hao/wenzhang/xxx.html")
+
 # 获取视频详情
 client.yiche.get_video(work_id="50000000")
 

{redfox_python_sdk-0.5.1 → redfox_python_sdk-0.6.0}/redfox/__init__.py

@@ -3,7 +3,7 @@
 from .client import RedFoxClient, AsyncRedFoxClient
 from .exceptions import RedFoxAPIError, RedFoxAuthError, RedFoxRateLimitError
 
-__version__ = "0.5.1"
+__version__ = "0.6.0"
 __all__ = [
     "RedFoxClient",
     "AsyncRedFoxClient",

{redfox_python_sdk-0.5.1 → redfox_python_sdk-0.6.0}/redfox/client.py

@@ -31,6 +31,9 @@ from .endpoints.doubao_image import DoubaoImageAPI
 from .endpoints.doubao_video import DoubaoVideoAPI
 from .endpoints.ai_search import AISearchAPI
 from .endpoints.tools import ToolsAPI
+from .endpoints.weibo import WeiboAPI
+from .endpoints.baijiahao import BaijiahaoAPI
+from .endpoints.zhihu import ZhihuAPI
 
 logger = logging.getLogger("redfox")
 
@@ -67,13 +70,22 @@ class _RequestMixin:
         self, method: str, path: str,
         params: Optional[Dict[str, Any]] = None,
         data: Optional[Dict[str, Any]] = None,
+        source: Optional[str] = None,
     ) -> tuple:
-        """准备请求 URL 和清洗后的参数"""
+        """准备请求 URL 和清洗后的参数
+
+        source 为调用来源标识：GET 请求放入 query，其余放入请求体 body。
+        """
         url = f"{self.base_url}{path}"
         if data:
             data = {k: v for k, v in data.items() if v is not None}
         if params:
             params = {k: v for k, v in params.items() if v is not None}
+        if source is not None:
+            if method.upper() == "GET":
+                params = {**(params or {}), "source": source}
+            else:
+                data = {**(data or {}), "source": source}
         return url, params, data
 
     def _handle_response(self, response) -> dict:
@@ -224,6 +236,9 @@ class RedFoxClient(_RequestMixin):
         self.doubao_video = DoubaoVideoAPI(self)
         self.ai_search = AISearchAPI(self)
         self.tools = ToolsAPI(self)
+        self.weibo = WeiboAPI(self)
+        self.baijiahao = BaijiahaoAPI(self)
+        self.zhihu = ZhihuAPI(self)
 
     def request(
         self,
@@ -231,6 +246,7 @@ class RedFoxClient(_RequestMixin):
         path: str,
         params: Optional[Dict[str, Any]] = None,
         data: Optional[Dict[str, Any]] = None,
+        source: Optional[str] = None,
     ) -> dict:
         """
         发送 API 请求（含自动重试 + 指数退避）
@@ -242,7 +258,7 @@ class RedFoxClient(_RequestMixin):
         :return: API 响应 data 字段内容
         :raises RedFoxAPIError: 重试耗尽后仍失败时抛出
         """
-        url, params, data = self._prepare_request(method, path, params, data)
+        url, params, data = self._prepare_request(method, path, params, data, source)
         last_exception = None
 
         for attempt in range(self.max_retries + 1):
@@ -285,13 +301,15 @@ class RedFoxClient(_RequestMixin):
         # 重试耗尽
         raise self._map_exception(last_exception) if last_exception else RedFoxAPIError("请求失败")
 
-    def post(self, path: str, data: Optional[Dict[str, Any]] = None) -> dict:
+    def post(self, path: str, data: Optional[Dict[str, Any]] = None,
+             source: Optional[str] = None) -> dict:
         """发送 POST 请求"""
-        return self.request("POST", path, data=data)
+        return self.request("POST", path, data=data, source=source)
 
-    def get(self, path: str, params: Optional[Dict[str, Any]] = None) -> dict:
+    def get(self, path: str, params: Optional[Dict[str, Any]] = None,
+            source: Optional[str] = None) -> dict:
         """发送 GET 请求"""
-        return self.request("GET", path, params=params)
+        return self.request("GET", path, params=params, source=source)
 
     def upload(
         self,
@@ -299,6 +317,7 @@ class RedFoxClient(_RequestMixin):
         file,
         data: Optional[Dict[str, Any]] = None,
         field_name: str = "file",
+        source: Optional[str] = None,
     ) -> dict:
         """
         上传文件（multipart/form-data，含自动重试）
@@ -313,6 +332,8 @@ class RedFoxClient(_RequestMixin):
         filename, content = self._read_file(file, field_name)
         if data:
             data = {k: v for k, v in data.items() if v is not None}
+        if source is not None:
+            data = {**(data or {}), "source": source}
         last_exception = None
 
         for attempt in range(self.max_retries + 1):
@@ -438,6 +459,9 @@ class AsyncRedFoxClient(_RequestMixin):
         self.doubao_video = DoubaoVideoAPI(self)
         self.ai_search = AISearchAPI(self)
         self.tools = ToolsAPI(self)
+        self.weibo = WeiboAPI(self)
+        self.baijiahao = BaijiahaoAPI(self)
+        self.zhihu = ZhihuAPI(self)
 
     async def request(
         self,
@@ -445,6 +469,7 @@ class AsyncRedFoxClient(_RequestMixin):
         path: str,
         params: Optional[Dict[str, Any]] = None,
         data: Optional[Dict[str, Any]] = None,
+        source: Optional[str] = None,
     ) -> dict:
         """
         异步发送 API 请求（含自动重试 + 指数退避）
@@ -455,7 +480,7 @@ class AsyncRedFoxClient(_RequestMixin):
         :param data: 请求体 JSON 数据
         :return: API 响应 data 字段内容
         """
-        url, params, data = self._prepare_request(method, path, params, data)
+        url, params, data = self._prepare_request(method, path, params, data, source)
         last_exception = None
 
         for attempt in range(self.max_retries + 1):
@@ -495,13 +520,15 @@ class AsyncRedFoxClient(_RequestMixin):
 
         raise self._map_exception(last_exception) if last_exception else RedFoxAPIError("请求失败")
 
-    async def post(self, path: str, data: Optional[Dict[str, Any]] = None) -> dict:
+    async def post(self, path: str, data: Optional[Dict[str, Any]] = None,
+                   source: Optional[str] = None) -> dict:
         """异步发送 POST 请求"""
-        return await self.request("POST", path, data=data)
+        return await self.request("POST", path, data=data, source=source)
 
-    async def get(self, path: str, params: Optional[Dict[str, Any]] = None) -> dict:
+    async def get(self, path: str, params: Optional[Dict[str, Any]] = None,
+                  source: Optional[str] = None) -> dict:
         """异步发送 GET 请求"""
-        return await self.request("GET", path, params=params)
+        return await self.request("GET", path, params=params, source=source)
 
     async def upload(
         self,
@@ -509,6 +536,7 @@ class AsyncRedFoxClient(_RequestMixin):
         file,
         data: Optional[Dict[str, Any]] = None,
         field_name: str = "file",
+        source: Optional[str] = None,
     ) -> dict:
         """
         异步上传文件（multipart/form-data，含自动重试）
@@ -523,6 +551,8 @@ class AsyncRedFoxClient(_RequestMixin):
         filename, content = self._read_file(file, field_name)
         if data:
             data = {k: v for k, v in data.items() if v is not None}
+        if source is not None:
+            data = {**(data or {}), "source": source}
         last_exception = None
 
         for attempt in range(self.max_retries + 1):

{redfox_python_sdk-0.5.1 → redfox_python_sdk-0.6.0}/redfox/endpoints/ai_search.py

@@ -16,7 +16,7 @@ class AISearchAPI:
 
     # ─── Kimi ───────────────────────────────────────────────
 
-    def kimi_submit(self, inquiry_text: str) -> dict:
+    def kimi_submit(self, inquiry_text: str, source: str = "Kimi 联网 AI 搜索-SDK") -> dict:
         """
         Kimi 纯文字搜索 - 提交任务
 
@@ -24,10 +24,10 @@ class AISearchAPI:
         :return: 包含 taskId 的字典
         """
         return self._client.post(
-            "/story/api/kimi/submit", data={"inquiryText": inquiry_text}
+            "/story/api/kimi/submit", data={"inquiryText": inquiry_text}, source=source
         )
 
-    def kimi_result(self, task_id: str) -> dict:
+    def kimi_result(self, task_id: str, source: str = "查询 Kimi 搜索任务结果-SDK") -> dict:
         """
         Kimi 纯文字搜索 - 查询任务结果
 
@@ -35,12 +35,12 @@ class AISearchAPI:
         :return: 任务结果字典，包含 completed/content/webPages
         """
         return self._client.post(
-            "/story/api/kimi/result", data={"taskId": task_id}
+            "/story/api/kimi/result", data={"taskId": task_id}, source=source
         )
 
     # ─── 豆包 ───────────────────────────────────────────────
 
-    def doubao_submit(self, inquiry_text: str) -> dict:
+    def doubao_submit(self, inquiry_text: str, source: str = "豆包联网 AI 搜索-SDK") -> dict:
         """
         豆包纯文字搜索 - 提交任务
 
@@ -48,10 +48,10 @@ class AISearchAPI:
         :return: 包含 taskId 的字典
         """
         return self._client.post(
-            "/story/api/deepSearch/dbSubmit", data={"inquiryText": inquiry_text}
+            "/story/api/deepSearch/dbSubmit", data={"inquiryText": inquiry_text}, source=source
         )
 
-    def doubao_result(self, task_id: str) -> dict:
+    def doubao_result(self, task_id: str, source: str = "查询豆包搜索任务结果-SDK") -> dict:
         """
         豆包纯文字搜索 - 查询任务结果
 
@@ -59,12 +59,12 @@ class AISearchAPI:
         :return: 任务结果字典
         """
         return self._client.post(
-            "/story/api/deepSearch/dbResult", data={"taskId": task_id}
+            "/story/api/deepSearch/dbResult", data={"taskId": task_id}, source=source
         )
 
     # ─── Deepseek ───────────────────────────────────────────
 
-    def deepseek_submit(self, inquiry_text: str) -> dict:
+    def deepseek_submit(self, inquiry_text: str, source: str = "Deepseek 联网 AI 搜索-SDK") -> dict:
         """
         Deepseek 纯文字搜索 - 提交任务
 
@@ -72,10 +72,10 @@ class AISearchAPI:
         :return: 包含 taskId 的字典
         """
         return self._client.post(
-            "/story/api/deepSearch/dsSubmit", data={"inquiryText": inquiry_text}
+            "/story/api/deepSearch/dsSubmit", data={"inquiryText": inquiry_text}, source=source
         )
 
-    def deepseek_result(self, task_id: str) -> dict:
+    def deepseek_result(self, task_id: str, source: str = "查询 Deepseek 搜索任务结果-SDK") -> dict:
         """
         Deepseek 纯文字搜索 - 查询任务结果
 
@@ -83,12 +83,12 @@ class AISearchAPI:
         :return: 任务结果字典
         """
         return self._client.post(
-            "/story/api/deepSearch/dsResult", data={"taskId": task_id}
+            "/story/api/deepSearch/dsResult", data={"taskId": task_id}, source=source
         )
 
     # ─── 元宝 ───────────────────────────────────────────────
 
-    def yuanbao_submit(self, inquiry_text: str) -> dict:
+    def yuanbao_submit(self, inquiry_text: str, source: str = "元宝联网 AI 搜索-SDK") -> dict:
         """
         元宝纯文字搜索 - 提交任务
 
@@ -96,10 +96,10 @@ class AISearchAPI:
         :return: 包含 taskId 的字典
         """
         return self._client.post(
-            "/story/api/deepSearch/ybSubmit", data={"inquiryText": inquiry_text}
+            "/story/api/deepSearch/ybSubmit", data={"inquiryText": inquiry_text}, source=source
         )
 
-    def yuanbao_result(self, task_id: str) -> dict:
+    def yuanbao_result(self, task_id: str, source: str = "查询元宝搜索任务结果-SDK") -> dict:
         """
         元宝纯文字搜索 - 查询任务结果
 
@@ -107,12 +107,12 @@ class AISearchAPI:
         :return: 任务结果字典
         """
         return self._client.post(
-            "/story/api/deepSearch/ybResult", data={"taskId": task_id}
+            "/story/api/deepSearch/ybResult", data={"taskId": task_id}, source=source
         )
 
     # ─── 千问 ───────────────────────────────────────────────
 
-    def qianwen_submit(self, inquiry_text: str) -> dict:
+    def qianwen_submit(self, inquiry_text: str, source: str = "千问联网 AI 搜索-SDK") -> dict:
         """
         千问纯文字搜索 - 提交任务
 
@@ -120,10 +120,10 @@ class AISearchAPI:
         :return: 包含 taskId 的字典
         """
         return self._client.post(
-            "/story/api/deepSearch/qwSubmit", data={"inquiryText": inquiry_text}
+            "/story/api/deepSearch/qwSubmit", data={"inquiryText": inquiry_text}, source=source
         )
 
-    def qianwen_result(self, task_id: str) -> dict:
+    def qianwen_result(self, task_id: str, source: str = "查询千问搜索任务结果-SDK") -> dict:
         """
         千问纯文字搜索 - 查询任务结果
 
@@ -131,12 +131,12 @@ class AISearchAPI:
         :return: 任务结果字典
         """
         return self._client.post(
-            "/story/api/deepSearch/qwResult", data={"taskId": task_id}
+            "/story/api/deepSearch/qwResult", data={"taskId": task_id}, source=source
         )
 
     # ─── 百度 ───────────────────────────────────────────────
 
-    def baidu_submit(self, inquiry_text: str) -> dict:
+    def baidu_submit(self, inquiry_text: str, source: str = "百度联网 AI 搜索-SDK") -> dict:
         """
         百度纯文字搜索 - 提交任务
 
@@ -144,10 +144,10 @@ class AISearchAPI:
         :return: 包含 taskId 的字典
         """
         return self._client.post(
-            "/story/api/deepSearch/bdSubmit", data={"inquiryText": inquiry_text}
+            "/story/api/deepSearch/bdSubmit", data={"inquiryText": inquiry_text}, source=source
         )
 
-    def baidu_result(self, task_id: str) -> dict:
+    def baidu_result(self, task_id: str, source: str = "查询百度搜索任务结果-SDK") -> dict:
         """
         百度纯文字搜索 - 查询任务结果
 
@@ -155,5 +155,5 @@ class AISearchAPI:
         :return: 任务结果字典
         """
         return self._client.post(
-            "/story/api/deepSearch/bdResult", data={"taskId": task_id}
+            "/story/api/deepSearch/bdResult", data={"taskId": task_id}, source=source
         )

{redfox_python_sdk-0.5.1 → redfox_python_sdk-0.6.0}/redfox/endpoints/autohome.py

@@ -19,6 +19,7 @@ class AutohomeAPI:
         offset: str = "0",
         page: str = "1",
         source_type: str = "video",
+        source: str = "汽车之家关键词搜索作品-SDK",
     ) -> dict:
         """
         汽车之家关键词搜索作品
@@ -35,9 +36,9 @@ class AutohomeAPI:
             "page": str(page),
             "sourceType": source_type,
         }
-        return self._client.post("/story/api/autohome/searchWork", data=data)
+        return self._client.post("/story/api/autohome/searchWork", data=data, source=source)
 
-    def get_article(self, work_id: str, page: int = 0) -> dict:
+    def get_article(self, work_id: str, page: int = 0, source: str = "获取汽车之家文章详情-SDK") -> dict:
         """
         汽车之家文章详情（车家号）
 
@@ -48,9 +49,10 @@ class AutohomeAPI:
         return self._client.post(
             "/story/api/autohome/articleDetail",
             data={"workId": work_id, "page": page},
+            source=source,
         )
 
-    def get_video(self, video_id: str, video_type: int) -> dict:
+    def get_video(self, video_id: str, video_type: int, source: str = "获取汽车之家视频详情-SDK") -> dict:
         """
         汽车之家视频详情（原创账号+车家号）
 
@@ -61,9 +63,10 @@ class AutohomeAPI:
         return self._client.post(
             "/story/api/autohome/videoDetail",
             data={"videoId": video_id, "videoType": video_type},
+            source=source,
         )
 
-    def get_user_works(self, author_id: str, page: int = 0) -> dict:
+    def get_user_works(self, author_id: str, page: int = 0, source: str = "获取汽车之家作者作品列表-SDK") -> dict:
         """
         汽车之家作品列表（原创账号）
 
@@ -74,4 +77,5 @@ class AutohomeAPI:
         return self._client.post(
             "/story/api/autohome/workList",
             data={"authorId": author_id, "page": page},
+            source=source,
         )