Add public timeline API support and update timeline docs

README.md

@@ -101,32 +101,64 @@ uv run main.py
 
 ### get_user_timeline
 
-获取用户时间线
+根据用户 ID 获取某个用户发表内容的时间线
 
 **参数:**
-- `max_id` (str, 可选): 最大 ID，用于分页，默认为空字符串
-- `count` (int, 可选): 获取数量，默认 10 条
+- `user_id` (str, 可选): 用户 ID，如果为空则获取当前用户时间线
+- `max_id` (str, 可选): 返回列表中内容最新 ID，用于分页获取更早的内容
+- `count` (int, 可选): 获取数量，默认 5 条
 
 **返回:**
 - 用户时间线列表，包含以下字段：
-  - `饭否内容`: 饭否消息内容
-  - `图片链接`: 如果有图片，返回图片的大图链接
+  - `饭否内容`: 饭否消息内容（HTML 格式）
+  - `饭否 ID`: 消息的唯一标识符
+  - `发布时间`: 消息发布时间
+  - `发布者`: 发布者的显示名称
+  - `发布者 ID`: 发布者的用户 ID
+  - `图片链接`: 如果包含图片，则提供图片链接
 
 ### get_home_timeline
 
-获取首页时间线
+获取当前用户首页关注用户及自己的饭否时间线
+
+**功能:**
+- 调用饭否 API 的 /statuses/home_timeline.json 接口获取当前用户的首页时间线
+- 包含用户关注的所有人的最新消息
+- 注：通常用户询问「我的饭否」时，指的是该时间线，除非用户明确指出「某个用户的饭否」
 
 **参数:**
-- `count` (int, 可选): 获取数量，默认 20 条
-- `max_id` (str, 可选): 最大 ID，用于分页，默认为空字符串
+- `count` (int, 可选): 获取数量，默认 5 条
+- `max_id` (str, 可选): 返回列表中内容最新 ID，用于分页获取更早的内容
 
 **返回:**
 - 首页时间线列表，包含以下字段：
-  - `饭否内容`: 饭否消息内容
+  - `饭否内容`: 饭否消息内容（HTML 格式）
+  - `饭否 ID`: 消息的唯一标识符
+  - `发布时间`: 消息发布时间
+  - `发布者`: 发布者的显示名称
+  - `发布者 ID`: 发布者的用户 ID
+  - `图片链接`: 如果包含图片，则提供图片链接
+
+### get_public_timeline
+
+获取公开时间线
+
+**功能:**
+- 调用饭否 API 的 /statuses/public_timeline.json 接口获取饭否全站最新的公开消息
+- 这些是所有用户可见的公开饭否内容
+
+**参数:**
+- `count` (int, 可选): 获取数量，默认 5 条
+- `max_id` (str, 可选): 返回列表中内容最新 ID，用于分页获取更早的内容
+
+**返回:**
+- 公开时间线列表，包含以下字段：
+  - `饭否内容`: 饭否消息内容（HTML 格式）
+  - `饭否 ID`: 消息的唯一标识符
   - `发布时间`: 消息发布时间
-  - `发布者`: 发布者昵称
-  - `发布者 ID`: 发布者的用户ID
-  - `图片链接`: 如果有图片，返回图片的大图链接
+  - `发布者`: 发布者的显示名称
+  - `发布者 ID`: 发布者的用户 ID
+  - `图片链接`: 如果包含图片，则提供图片链接
 
 ## 许可证
 

fanfou_client.py

@@ -83,9 +83,10 @@ class FanFou:
 
     def request_user_timeline(self, user_id: str = '', max_id: str = '', count: int = 5) -> List[Dict[str, Any]]:
         """
-        根据用户 ID 获取某个用户饭否的时间线
+        根据用户 ID 获取某个用户发表内容的时间线
+        
         user_id 为用户 ID，如果为空，则获取当前用户时间线
-        max_id 为饭否内容最大 ID，如果为空，则获取最新时间线
+        max_id 为返回列表中内容最新 ID，如果为空，则获取最新时间线
         count 为获取数量，默认 5 条
         """
         print('------ request_user_timeline ------')
@@ -105,8 +106,9 @@ class FanFou:
 
     def get_home_timeline(self, count: int = 5, max_id: str = '') -> List[Dict[str, Any]]:
         """
-        获取当前用户首页饭否的时间线
-        max_id 为饭否内容最大 ID，如果为空，则获取最新时间线
+        获取当前用户首页关注用户及自己的饭否时间线
+
+        max_id 为返回列表中内容最新 ID，如果为空，则获取最新时间线
         count 为获取数量，默认 5 条
         """
         print('------ get_home_timeline ------')
@@ -118,5 +120,24 @@ class FanFou:
         token = oauth2.Token(self.token, self.token_secret)
         client = oauth2.Client(consumer, token)
 
+        response, content = client.request(url)
+        return json.loads(content)
+
+    def get_public_timeline(self, count: int = 5, max_id: str = '') -> List[Dict[str, Any]]:
+        """
+        获取公开时间线，获取饭否全站最新的公开消息
+        
+        max_id 为返回列表中内容最新 ID，如果为空，则获取最新时间线
+        count 为获取数量，默认 5 条
+        """
+        print('------ get_public_timeline ------')
+        url = f"http://api.fanfou.com/statuses/public_timeline.json?count={count}&format=html"
+        if max_id:
+            url += f"&max_id={max_id}"
+
+        consumer = oauth2.Consumer(self.api_key, self.api_secret)
+        token = oauth2.Token(self.token, self.token_secret)
+        client = oauth2.Client(consumer, token)
+
         response, content = client.request(url)
         return json.loads(content) 

main.py

@@ -124,17 +124,17 @@ def generate_oauth_token() -> Dict[str, str]:
         return {"error": str(e)}
 
 @mcp.tool()
-def get_user_timeline(user_id: str = '', max_id: str = '', count: int = 10) -> List[Dict[str, Any]]:
+def get_user_timeline(user_id: str = '', max_id: str = '', count: int = 5) -> List[Dict[str, Any]]:
     """
-    获取用户时间线
+    根据用户 ID 获取某个用户发表内容的时间线
     
     调用饭否 API 的 /statuses/user_timeline.json 接口获取指定用户的时间线。
     如果 user_id 为空，则获取当前登录用户的时间线。
     
     Args:
         user_id: 用户 ID，如果为空则获取当前用户时间线
-        max_id: 最大饭否 ID，用于分页获取更早的内容
-        count: 获取数量，默认 10 条，最大 60 条
+        max_id: 返回列表中内容最新 ID，用于分页获取更早的内容
+        count: 获取数量，默认 5 条
         
     Returns:
         用户时间线列表，每个元素包含：
@@ -171,16 +171,18 @@ def get_user_timeline(user_id: str = '', max_id: str = '', count: int = 10) -> L
         return [{"error": str(e)}]
 
 @mcp.tool()
-def get_home_timeline(count: int = 20, max_id: str = '') -> List[Dict[str, Any]]:
+def get_home_timeline(count: int = 5, max_id: str = '') -> List[Dict[str, Any]]:
     """
-    获取首页时间线
+    获取当前用户首页关注用户及自己的饭否时间线
     
     调用饭否 API 的 /statuses/home_timeline.json 接口获取当前用户的首页时间线，
     包含用户关注的所有人的最新消息。
+
+    注：通常用户询问「我的饭否」时，指的是该时间线，除非用户明确指出「某个用户的饭否」。
     
     Args:
-        count: 获取数量，默认 20 条，最大 60 条
-        max_id: 最大饭否 ID，用于分页获取更早的内容
+        count: 获取数量，默认 5 条
+        max_id: 返回列表中内容最新 ID，用于分页获取更早的内容
         
     Returns:
         首页时间线列表，每个元素包含：
@@ -216,6 +218,52 @@ def get_home_timeline(count: int = 20, max_id: str = '') -> List[Dict[str, Any]]
     except Exception as e:
         return [{"error": str(e)}]
 
+@mcp.tool()
+def get_public_timeline(count: int = 5, max_id: str = '') -> List[Dict[str, Any]]:
+    """
+    获取公开时间线
+    
+    调用饭否 API 的 /statuses/public_timeline.json 接口获取饭否全站最新的公开消息，
+    这些是所有用户可见的公开饭否内容。
+    
+    Args:
+        count: 获取数量，默认 5 条
+        max_id: 返回列表中内容最新 ID，用于分页获取更早的内容
+        
+    Returns:
+        公开时间线列表，每个元素包含：
+        - 饭否内容: 消息文本内容（HTML 格式）
+        - 饭否 ID: 消息的唯一标识符
+        - 发布时间: 消息发布时间
+        - 发布者: 发布者的显示名称
+        - 发布者 ID: 发布者的用户 ID
+        - 图片链接: 如果包含图片，则提供图片链接
+    """
+    try:
+        client = get_fanfou_client()
+        raw_data = client.get_public_timeline(count, max_id)
+        
+        # 过滤返回数据，只保留关键信息
+        filtered_data = []
+        for item in raw_data:
+            filtered_item = {
+                "饭否内容": item.get("text", ""),
+                "饭否 ID": item.get("id", ""),
+                "发布时间": item.get("created_at", ""),
+                "发布者": item.get("user", {}).get("screen_name", ""),
+                "发布者 ID": item.get("user", {}).get("id", "")
+            }
+            
+            # 如果有图片，添加 imageurl
+            if "photo" in item and item["photo"]:
+                filtered_item["图片链接"] = item["photo"].get("largeurl", "")
+            
+            filtered_data.append(filtered_item)
+        
+        return filtered_data
+    except Exception as e:
+        return [{"error": str(e)}]
+
 if __name__ == "__main__":
     # 启动服务器
     mcp.run()