> 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.

# 微信视频号指南

> 从账号合集和历史直播查找演示，记录原链接、场次和已确认的片段。

定位某个已确认微信视频号账号的历史演示出处时，先用 `wechat_channels.v2.fetch_user_collections` 读取账号合集、用 `wechat_channels.v2.fetch_live_history` 读取历史直播，再用 `wechat_channels.v2.fetch_collection_videos` 或 `wechat_channels.v2.fetch_live_detail` 核对具体片段与回放详情。数据来源选择、作品目录、评论复盘、Python 研究和号内搜索见下方任务指南。

## 开始研究

* [选择视频号数据来源](/zh/guides/wechat-channels-data-access)
* [视频号作品目录](/zh/guides/wechat-channels-video-inventory)
* [视频号评论复盘](/zh/guides/wechat-channels-comment-review)
* [Python作品与评论研究](/zh/guides/wechat-channels-python-research)
* [号内主题搜索](/zh/guides/wechat-channels-channel-search)

## 客服说这段演示在以前的直播里，怎么帮同事找回出处？

读取账号合集和历史直播，再核对片段和时间点。

1. 分清要找的是合集里已经剪好的教学视频，还是直播历史里的一场演示，先查最可能有素材的列表。线索同时指向合集和直播时，用同一个已核对的 `v2_…@finder` 账号标识各读一页。需要先确认账号标识时，先查[视频号作品目录](/zh/guides/wechat-channels-video-inventory)。
2. 请求账号合集和历史直播：

```json
{"action":"wechat_channels.v2.fetch_user_collections","params":{"username":"<已确认的视频号username>"}}
```

```json
{"action":"wechat_channels.v2.fetch_live_history","params":{"username":"<同一个视频号username>","last_buffer":""}}
```

3. 把每段 JSON POST 到 `https://api.beatapi.io/v1/social-data/call`，用 BeatAPI Bearer 鉴权。
4. 在已存的直播历史里按日期或主题筛选，再核对账号。历史直播响应的 `continue_flag` 为真且返回新的 `last_buffer` 时，才用新的 `last_buffer` 继续读下一页历史直播。
5. 找到目标合集后，用目标合集实际的 `topic_id` 调 `wechat_channels.v2.fetch_collection_videos`，核对标题和作品。`topic_id` 保持原始数字字符串；合集记录中有 `topic_type` 时沿用合集记录里的 `topic_type`：

```json
{"action":"wechat_channels.v2.fetch_collection_videos","params":{"topic_id":"<合集记录中的数字ID>","username":"<同一个视频号username>","last_buffer":""}}
```

6. 合集响应的 `down_continue` 为真时，把合集响应的 `last_buffer` 原样带到下一次合集请求。合集游标和直播历史游标分别保存。
7. 直播历史只定位到场次时，把场次实际返回的 `live_id` 作为字符串交给 `wechat_channels.v2.fetch_live_detail` 补读详情。回放能打开时，再核对演示片段和时间点。
8. 给客服的表保留账号、合集或直播名称、标题、时间、可打开的原链接和请求号。直播记录里只有标题和日期时，先记「已定位场次」；打开可用的回放并找到片段后，再填具体时间点。

## 相关内容

[微信视频号 常见问题](/zh/faq/wechat-channels)