实时搜索/Weibo Realtime Search

微博实时搜索/Weibo Realtime Search

功能说明/Function

基于微博搜索实时流（s.weibo.com）抓取“实时”结果页面，解析为结构化数据，仅需传入搜索词与页码。
内置按页面惯例自动补全的固定参数：rd=realtime、tw=realtime、Refer=weibo_realtime。

参数说明/Parameters

• query (必填/Required): 搜索关键词/Search keyword
  • 类型/Type: string
  • 示例/Example: "yu7"
• page (可选/Optional): 页码/Page number
  • 类型/Type: integer
  • 默认值/Default: 1

分页示例/Pagination examples

# 第1页
await fetch_realtime_search(query="苹果发布会", page=1)
# 第2页
await fetch_realtime_search(query="苹果发布会", page=2)

返回数据结构/Response schema

{
  "code": 200,
  "data": {
    "parsed_data": {
      "results": [
        {
          "weibo_id": "5092682368025584",
          "user_name": "用户名",
          "user_nick": "昵称",
          "user_url": "https://weibo.com/xxxx",
          "user_avatar": "https://…jpg",
          "publish_time": "5分钟前",
          "post_url": "https://weibo.com/…",
          "source": "iPhone客户端",
          "weibo_type": "original|repost",
          "content": "正文文本 …",
          "media": {
            "has_image": true,
            "has_video": true,
            "images": ["https://…/large/xxx.jpg"],
            "videos": [
              {
                "type": "video",
                "poster": "https://…jpg",
                "src": "https://video.weibocdn.com/…mp4",
                "streams": ["https://video.weibocdn.com/…mp4", "…"],
                "duration": "00:12",
                "page_url": "https://weibo.com/tv/show/…",
                "fid": "1034:xxxxx"
              }
            ]
          },
          "interaction": {
            "repost_count": 12,
            "comment_count": 34,
            "like_count": 256
          }
        }
      ],
      "result_count": 20,
      "pagination": {
        "current_page": 1,
        "total_pages": 50,
        "has_next_page": true,
        "next_page_url": "/weibo?q=…&page=2"
      },
      "search_stats": {
        "search_stats": "共找到约xxx条结果",
        "filter_type": "综合|实时|热门…"
      },
      "parse_success": true
    }
  }
}

字段说明/Field notes

• results[].weibo_type: original=原创，repost=转发
• results[].media.images: 已尽量转换为大图/原图链接（thumb150、orj360 → large）
• results[].media.videos:
  • src: 若页面可见的 会给出直链；
  • streams: video.weibocdn.com mp4 直链候选；
  • poster/duration/page_url/fid: 分别为封面、时长、播放页、视频标识。
• pagination: 从页面页码区域解析当前页、总页数、下一页。

注意事项/Notes

• 返回结构与“高级搜索”解析结果一致。
• 页面样式调整可能影响解析效果；建议在前端容错展示（字段缺失时回退）。
• 视频直链可能受时效/地区限制；如无 src 可使用 page_url + fid 进行后续解析。
• 视频需要设置合适的请求头（Referer=https://weibo.com/）才能播放。