微博 MCP 服务：在 Claude、Cursor 里查数据

一条命令接入微博

Qovia 同时是一个 MCP 服务。在 Claude Code 里运行下面这条命令，查找和查看接口不需要 Key；调用接口时按 MCP 文档配置你的 API Key。Cursor 和 VS Code 的配置也在那里。

终端

claude mcp add --transport http qovia https://api.qovia.ai/mcp

微博的 7 个接口，AI 都能调用

每个接口的参数、返回字段和代码示例见 API 参考。

微博详情GET /v1/raw/weibo/post单条微博：全文（长微博也是全文）、作者、点赞/评论/转发数、阅读数和视频播放量（微博展示时）、话题、图片、视频时长、发布时间、被转发的原微博和链接。传 mid 或链接里的 mblogid 均可。微博不存在或已删除时返回 404，不计费。必填参数：post_id
微博评论GET /v1/raw/weibo/comments微博的一级评论（按热度），按游标翻页，每页最多 20 条：评论内容、点赞数、回复数、IP 属地、时间、是否被博主赞过和评论者。把上一页返回的 cursor 传回即可翻页，has_more 为 false 时停止。回复用 raw.weibo.comment_replies 获取。没有评论或微博不存在时返回空结果，不计费。必填参数：post_id
微博评论回复GET /v1/raw/weibo/comment_replies某条评论下的回复（楼中楼），按游标翻页，每页最多 20 条：回复内容、点赞数、IP 属地、时间、回复对象和回复者。把上一页返回的 cursor 传回即可翻页，has_more 为 false 时停止；偶尔某页会先返回空结果，重试一次即可。没有回复时返回空结果，不计费。必填参数：comment_id
微博用户资料GET /v1/raw/weibo/user微博用户主页资料：粉丝、关注、微博数、累计获赞、认证信息、简介、性别、所在地、个性域名和头像。传 uid 或个性域名（weibo.com/<域名>）其中一个。用户不存在时返回 404，不计费。
微博用户发布列表GET /v1/raw/weibo/user_posts一个用户发布的微博，置顶在前，其余从新到旧，每页约 20 条，记录与微博详情相同（同一 id）；长微博只有开头（extra.truncated 为 true，全文用 raw.weibo.post 获取）。按 page 翻页，has_more 为 false 时停止。没有微博时返回空结果，用户不存在时返回 404，均不计费。必填参数：uid
微博搜索GET /v1/raw/weibo/search按关键词搜索微博，可限定发布日期范围（北京时间，按天），可只看热门、原创、认证用户、媒体或观点，可只看含图片、视频、音乐或链接的微博；记录与微博详情相同（同一 id），正文可能被截断（extra.truncated），互动数不提供。每页条数不固定（最多约 20 条），按 page 翻页，最多 50 页，返回空结果时停止。没有结果时返回空结果，不计费。必填参数：keyword
微博热搜榜GET /v1/raw/weibo/hot_search微博实时热搜榜，按排名：热搜词、热度、标签（新、热、沸、爆等）、分类、是否话题和搜索链接，以及置顶在榜首之上的话题（pinned）。广告位不返回。无需参数，约每分钟更新。

请求与返回示例

微博搜索（GET /v1/raw/weibo/search）。示例取自接口目录，不是实时数据；完整返回还带 request_id 和 meta。

cURL

curl 'https://api.qovia.ai/v1/raw/weibo/search?keyword=%E9%95%BF%E5%BE%81&start_date=2026-10-20&end_date=2026-10-21' \
  -H "Authorization: Bearer $QOVIA_KEY"

返回的 data 部分 · 200 OK

{
  "data": {
    "items": [
      {
        "id": "soc_wei_66be530dfcd9",
        "src": "social",
        "platform": "weibo",
        "lang": "zh-CN",
        "text": "【#活动散场后男子吹响冲锋号全场沸腾#】近日，天津一场长征胜利90周年纪念活动散场后，一名男子吹响冲锋号，瞬间全场沸腾。该男子接受中新网采访时表示，当时散场后大家说再吹一个，于是就贴合主题吹了冲锋号。中国新闻网的微博视频（中国新闻网）",
        "author": {
          "uid_hash": "f879ebcea33e",
          "followers": null,
          "nickname": "工人日报",
          "uid": "3840768703"
        },
        "metrics": {
          "likes": null,
          "comments": null,
          "shares": null
        },
        "extra": {
          "source_id": "5356593191060572",
          "mblogid": "RnKfl4rU0",
          "published_at": "2026-10-21T23:00:00+08:00",
          "content_type": "video",
          "topic": "#活动散场后男子吹响冲锋号全场沸腾",
          "topics": [
            "活动散场后男子吹响冲锋号全场沸腾"
          ],
          "images": [],
          "cover_url": null,
          "video_dur_s": null,
          "ip_location": null,
          "truncated": false,
          "repost_of": null,
          "url": "https://weibo.com/3840768703/RnKfl4rU0"
        },
        "prov": {
          "hash": "0xdc59f6580c0f1192",
          "ts": "2026-10-21T23:50:00+08:00",
          "source": "live"
        }
      },
      {
        "id": "soc_wei_efafe027096e",
        "src": "social",
        "platform": "weibo",
        "lang": "zh-CN",
        "text": "#晚安，广西！#【#周深献唱纪念红军长征胜利90周年MV#】九十年长风不息，烽烟虽远，星火滚烫。@卡布叻_周深倾情演唱的《万里长风》，以歌声回望来路，循先辈足迹，奔赴属于我们的新征程。#跨越90年的回信#（来源：央视新闻）央视新闻的微博视频",
        "author": {
          "uid_hash": "8a692ede06c2",
          "followers": null,
          "nickname": "广西新闻网",
          "uid": "1986954045"
        },
        "metrics": {
          "likes": null,
          "comments": null,
          "shares": null
        },
        "extra": {
          "source_id": "5356593190540232",
          "mblogid": "RnKfl2gxq",
          "published_at": "2026-10-21T23:00:00+08:00",
          "content_type": "video",
          "topic": "#晚安，广西！",
          "topics": [
            "晚安，广西！",
            "周深献唱纪念红军长征胜利90周年MV",
            "跨越90年的回信"
          ],
          "images": [],
          "cover_url": null,
          "video_dur_s": null,
          "ip_location": null,
          "truncated": false,
          "repost_of": null,
          "url": "https://weibo.com/1986954045/RnKfl2gxq"
        },
        "prov": {
          "hash": "0xd5cc0da71c4fbd32",
          "ts": "2026-10-21T23:50:00+08:00",
          "source": "live"
        }
      }
    ],
    "page": 1,
    "has_more": true,
    "prov": {
      "hash": "0x0454d79596c740cd",
      "ts": "2026-10-21T23:50:00+08:00",
      "source": "live"
    }
  }
}

常见问题

怎么把微博 MCP 接到 Claude Code？

运行 claude mcp add --transport http qovia https://api.qovia.ai/mcp。查找和查看接口不需要 Key；调用接口时在 MCP 配置里加上 Authorization: Bearer 加你的 API Key（见 MCP 文档）。新账号有 50 次试用调用。

AI 能用微博 MCP 做什么？

服务提供四个工具：search_endpoints、get_endpoint、call_endpoint 和 get_account。让 AI 先用 search_endpoints 搜索 weibo，找到7个接口里合适的那个，再用 call_endpoint 拉取微博、评论、用户资料、关键词搜索和热搜榜。调用和 HTTP API 一样计费。

微博有官方开放的数据 API 吗？

微博开放平台的接口要先创建应用、经用户授权才能调用，按关键词搜索全站微博、拿任意微博的评论这类公开数据，普通开发者一般拿不到。Qovia 把微博的公开数据做成了统一接口，拿 API Key 就能调用。

能拿到微博的哪些数据？

单条微博（全文、作者、点赞/评论/转发数，微博展示时还有阅读数和视频播放量，以及话题、图片、发布时间和 IP 属地）、评论和评论回复、用户资料和发布列表、关键词搜索（可限定日期范围，只看热门、原创或认证用户等），以及微博热搜榜。

微博搜索能拿多少条？

每页最多约 20 条，按页翻，最多 50 页。搜索结果里的正文可能被截断，也不带互动数；需要全文和点赞、评论、转发数时，用微博 ID 调微博详情接口。

需要提供微博账号或 cookie 吗？

不需要。你只需要一个 Qovia 的 API Key，不用自己维护账号、cookie、代理或签名算法。

怎么计费？

预充值，按次计费，只对返回了数据的成功调用扣费；空结果、报错和超时都不扣费，每次返回里都写着这次扣了多少（meta.charged_usd）。每个接口的单价见 API 参考。

使用这些数据要注意什么？

Qovia 提供的是数据接口服务，不拥有也不转售底层内容。拿到的数据请按适用法律和微博的平台规则使用，详见服务条款。

一条命令接入微博

微博的 7 个接口，AI 都能调用

请求与返回示例

常见问题

相关页面

你的 Agent 能看到什么，取决于你给它什么数据