> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# 拿到一条微博链接，怎样确认对象并继续读正文或评论？

> 区分uid、数字微博ID和电脑版bid，按已确认编号接正文或评论，保留原链接和对象核对信息。

先确认微博的数字 ID，再把 ID 填进 `weibo.web_v2.fetch_post_detail` 的 `id` 读正文，或填进 `weibo.web_v2.fetch_post_comments` 的 `id` 读评论。微博主页里的 `uid` 指账号，数字 `mid` 指一条微博，电脑版链接末段常见的字母数字混排编号是 `bid`。

例如同事发来服务公告的链接，先对照作者和公告内容。已有核对过的微博 ID、只需要留言时，直接查评论；要核对公告全文时，再取长文。

## 三种编号分别指什么？

| 信息                                | 含义与用法                              |
| --------------------------------- | ---------------------------------- |
| `weibo.com/u/` 后的数字               | 用户 `uid`，用于用户资料与账号内容动作             |
| 手机上的 `/detail/` 或 `/status/` 后的数字 | 若确为目标微博的数字ID，按原始字符串保存              |
| 电脑版 `weibo.com/<用户段>/<字母数字段>` 的末段 | 常见的 `bid` 写法，不把它误作用户uid或直接当已确认数字ID |
| 搜索或已有原响应中的微博编号                    | 对照正文与作者后复用，保留原字段与来源                |

在表格里用文本列保存编号，避免表格软件自动转换数字。保留原链接，方便接手的人回到来源。链接路径同时包含用户段和微博段时，不按“最长的一串数字”猜微博。

## 已有确认的微博ID，下一步怎么做？

要读完整文字，把微博 ID 填进 `weibo.web_v2.fetch_post_detail` 的 `id`，`is_get_long_text` 设为字符串 `"true"`：

```json
{
  "action": "weibo.web_v2.fetch_post_detail",
  "params": {"id": "<confirmed_post_id>", "is_get_long_text": "true"}
}
```

只需要公告的留言时，把同一个微博 ID 填进 `weibo.web_v2.fetch_post_comments` 的 `id`，第一页 `max_id` 为空：

```json
{
  "action": "weibo.web_v2.fetch_post_comments",
  "params": {"id": "<confirmed_post_id>", "count": 10, "max_id": ""}
}
```

把选好的 JSON 发到 `POST https://api.beatapi.io/v1/social-data/call`，使用常规 BeatAPI Bearer 鉴权。按需要的材料选动作；查评论前不必先查详情。

## 只有电脑版短码或分享文字怎么办？

先找到数字微博 ID：`weibo.web_v2.fetch_post_detail` 和 `weibo.web_v2.fetch_post_comments` 只接受 `id`，没有 `url` 参数。BeatAPI 也没有登记微博分享链接展开或 `bid` 转换能力，所以不能像别家那样直接粘贴分享文字。

1. 已有搜索或账号结果时，在结果里找到目标微博，对照作者和正文确认微博 ID。
2. 没有结果时，向分享人要这条微博的手机版数字链接，链接里含微博 ID。
3. 只剩未确认的短码时，把短码记为待补定位信息；不要把 `uid` 当微博 ID 试查。

重新找内容可用[关键词搜索](/zh/faq/weibo-keyword-search)，但同标题和同文转发的微博仍需逐条核对。

## 结果如何交给下一位研究者？

交接时保留原链接、已确认的微博 ID、作者 `uid`（有则记录）、查询动作与输入、实际时间和请求号。`weibo.web_v2.fetch_post_detail` 和 `weibo.web_v2.fetch_post_comments` 尚未登记固定输出结构：读实际保存结果后再确认正文、作者、评论与所属微博，不预设 `author.id` 等统一键。

例如交接“公告中这一步找不到入口”这条评论时，附上公告来源和评论原句。如果评论来自某位用户转发公告的微博，注明评论属于那条转发微博，不属于官方公告。

给助手的任务可以这样写：

> 确认这条服务公告的微博对象，分别保留原链接、微博ID和作者。已有准确ID就复用，按需要读正文与留言。围绕操作疑问保留原句和来源；定位尚未确认的链接列待补项，不替换成同名内容。

选定的详情请求和评论页按[价格页](https://beatapi.io/zh/pricing)的当前价格规划。已保存的原响应直接用于后续阅读。