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

# Channels video and comment research

> Save one Channels account page and one comment page per selected video with a Python script, then turn viewer comments into sourced updates for a video tour.

To learn from viewer comments whether a museum's video tours need clearer directions, reservations or accessibility details, run the Python script `channels_read.py` below. `python3 channels_read.py list` saves one account page from `wechat_channels.v2.fetch_user_videos`. You choose the relevant videos, and `python3 channels_read.py comments` saves one comment page per selected video from `wechat_channels.v2.fetch_video_comments`. Deliver the original comment wording, the video sources and concrete updates for the tour.

## Prepare the account and scope

Start from a verified finder username. If you have a short ID or a share link instead, follow the [identifier workflow](/faq/wechat-channels-identifiers) first. If you already have the target video ID, go straight to the comments. One inventory page plus one comment page for each of two selected videos is a plan of up to three requests. See current [pricing](https://beatapi.io/pricing).

The script uses only the Python 3 standard library. Set `BEATAPI_API_KEY` in your local environment and save the script below as `channels_read.py`. Each run sends one initial request and saves the request and the original response in a new directory.

```python
import json
import os
import sys
from datetime import datetime, timezone
from pathlib import Path
from urllib.error import HTTPError, URLError
from urllib.request import Request, urlopen

if len(sys.argv) != 4 or sys.argv[1] not in {"list", "comments"}:
    raise SystemExit("Usage: python3 channels_read.py list|comments VALUE NEW_DIRECTORY")
mode, value, directory = sys.argv[1:]
if not value.strip():
    raise SystemExit("Supply a verified finder username or numeric work ID")
key = os.environ.get("BEATAPI_API_KEY")
if not key:
    raise SystemExit("Set BEATAPI_API_KEY in your local environment")
if mode == "list":
    action = "wechat_channels.v2.fetch_user_videos"
    params = {"username": value, "last_buffer": "", "raw": False}
else:
    action = "wechat_channels.v2.fetch_video_comments"
    params = {"object_id": value, "comment_id": "", "last_buffer": "", "raw": False}
body = {"action": action, "params": params}
out = Path(directory)
out.mkdir(parents=True, exist_ok=False)
(out / "request.json").write_text(json.dumps(body, ensure_ascii=False, indent=2), encoding="utf-8")
started = datetime.now(timezone.utc).isoformat()
(out / "attempt.json").write_text(json.dumps({"started_at": started, "action": action}), encoding="utf-8")
request = Request("https://api.beatapi.io/v1/social-data/call",
                  data=json.dumps(body).encode("utf-8"), method="POST",
                  headers={"Authorization": "Bearer " + key, "Content-Type": "application/json"})
try:
    with urlopen(request, timeout=60) as response:
        status, raw = response.status, response.read()
except HTTPError as error:
    status, raw = error.code, error.read()
except URLError:
    (out / "transport-error.json").write_text(json.dumps({"outcome": "unknown", "action": action}), encoding="utf-8")
    raise SystemExit("No final response saved; review the attempted request before repeating")
(out / "response.json").write_bytes(raw)
(out / "call.json").write_text(json.dumps({"action": action, "params": params,
    "http_status": status, "started_at": started,
    "finished_at": datetime.now(timezone.utc).isoformat(),
    "response_file": "response.json", "platform_review": "required"},
    ensure_ascii=False, indent=2), encoding="utf-8")
try:
    payload = json.loads(raw)
except (ValueError, UnicodeError):
    raise SystemExit("Saved a non-JSON response; inspect response.json")
if status != 200 or not isinstance(payload, dict) or payload.get("status") != "succeeded" or payload.get("error") is not None or payload.get("action") != action:
    raise SystemExit("Saved a failed or unexpected response; inspect response.json")
print("Saved response for platform-content review: " + str(out / "response.json"))
```

## Review the videos and select comment samples

```bash
python3 channels_read.py list '<finder_username>' museum-list-01
python3 channels_read.py comments '<numeric_work_id>' museum-comments-01
```

Run the first command, review the videos in `data.videos` and replace the placeholder in the second command with the numeric `id` of a relevant video. Record a reason for each selected video, such as “shows the route from the subway, so the video can help assess directions.” Like counts can help you find candidates, but select each video by its actual content.

In each output directory, `call.json` records the request conditions, the HTTP status and the time, and `response.json` keeps the original response for review and export. Continue the video inventory with `up_continue` and the comments with `down_continue`; each continuation passes the `last_buffer` from its own preceding page. `channels_read.py` fetches only the first page of each. The inventory and comment review guides linked in the next section cover continuation and replies.

Keep two sheets: the inventory sheet has one row per video, and the question sheet has one row per comment excerpt. Link the two sheets with the numeric video ID. If two comments ask where the elevator is, keep both comment references before you group the two comments under one follow-up. If a different video explains the accessible entrance, cite that other video by its own ID.

## Reuse the exporters and propose specific updates

Prepare a separate manifest for each saved page, following the [inventory](/guides/wechat-channels-video-inventory) and [comment review](/guides/wechat-channels-comment-review) export workflows. Copy action, params and http_status from `call.json`, use finished_at as collected_at, and set the response path relative to the manifest. Export the comments of each video separately, and use the video ID to connect the inventory with the question table.

Find the specific questions, then rewatch each video concerned. If viewers ask separately about the east entrance and the elevator, group both questions under directions and keep both quotes and sources. If an author reply already names the entrance, consider moving the entrance information earlier in the tour. Deliver the pages actually reviewed, the selection reasons, the original comments and the proposed updates.