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

# 用Python搜快手、读评论，整理露营装备的真实使用问题

> 保存搜索原件，人工选有明确使用场景的作品，再读取评论，交付有原句、条件和来源的问题表。

要知道露营装备在实际使用中还有哪些问题值得解释，先用 Python 脚本 `ks_read.py` 保存一次快手搜索（`kuaishou.app.search_video_v2`），选出有真实使用场景的作品，再用同一个脚本保存每条入选作品的第一页评论（`kuaishou.app.fetch_video_comment`），读其中的携带、收纳、供电问题。交付物是一张“问题—原句—使用条件—来源—下一步”表，产品或内容同事可以直接接手。

已有核对过的作品 ID 时，跳过搜索，直接取评论；已经保存过响应时，先读已存文件，再决定要不要发新请求。

## 1. 准备首轮范围

`ks_read.py` 只用 Python 3 标准库。在本地环境配置 `BEATAPI_API_KEY`。`ks_read.py` 每次运行只发一个请求，不把鉴权头写进文件。

首轮是一次搜索，加三条入选作品各一页评论，最多 4 次请求。费用按[价格页](https://beatapi.io/zh/pricing)的现价估算。

## 2. 保存一次请求与响应

把下面的脚本存为 `ks_read.py`。`search` 模式调用 `kuaishou.app.search_video_v2`，`comments` 模式调用 `kuaishou.app.fetch_video_comment`；两种模式第一页的 `pcursor` 都为空。

```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 {"search", "comments"}:
    raise SystemExit("Usage: python3 ks_read.py search|comments VALUE NEW_DIRECTORY")
mode, value, directory = sys.argv[1:]
if not value.strip():
    raise SystemExit("Supply a keyword or a verified photo ID")
key = os.environ.get("BEATAPI_API_KEY")
if not key:
    raise SystemExit("Set BEATAPI_API_KEY in your local environment")
if mode == "search":
    action = "kuaishou.app.search_video_v2"
    params = {"keyword": value, "pcursor": ""}
else:
    action = "kuaishou.app.fetch_video_comment"
    params = {"photo_id": value, "pcursor": ""}
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"))
```

取得首批搜索：

```bash
python3 ks_read.py search '露营装备' ks-search-01
```

新目录里有 `request.json`（输入）、`attempt.json`（尝试时间）、`call.json`（调用记录）和 `response.json`（原响应）。`ks_read.py` 只核对公共执行信封（`status`、`error`、`action`），平台内容标为 `platform_review: required`，下一步要人工读实际材料。所有 HTTP 返回都会保存；网络在最终响应前断开时，脚本写入 `transport-error.json`，不自动重发，先核对这次尝试的请求再决定是否重跑。

## 3. 按研究问题选作品

1. 在 `ks-search-01/response.json` 里确认每条作品和作品的作者。
2. 优先选有户外环境、使用经过或具体演示的作品；只有宣传口号、无关同名或单纯成品展示的，记下排除理由。
3. 每条入选作品保留原作品标识、来源、选择理由和取得时间。
4. 作品要对得上研究问题：研究携带，看收纳与移动场景；研究供电，选有具体设备与使用条件的作品。不要把所有装备当成同一种产品。
5. 作品可能是视频、图集或只有文字，记下实际读的是哪一种，见[作品形式](/zh/faq/kuaishou-post-formats)。

`kuaishou.app.search_video_v2` 只接受关键词与游标。要按发布时间、时长或点赞排序筛选，改用[综合筛选](/zh/guides/kuaishou-filtered-search)。

## 4. 读取选中作品的评论

传入已确认的作品 ID 和一个新目录名：

```bash
python3 ks_read.py comments '<confirmed_photo_id>' ks-comments-01
```

先确认评论讨论的是作品里的同一种装备。“背包放得下吗”是携带问题；“我用了一晚上”还要知道具体设备、负载与环境。评论者说出的条件和仍缺的信息分开记，不替评论者补经历。

入选的一级评论下有作者解释或纠正时，按[评论上下文](/zh/faq/kuaishou-comment-pagination)读这条一级评论的回复，保留作品 ID 和 `root_comment_id`。`ks_read.py` 只取第一页评论，不自动翻页，也不展开回复分支。

## 5. 整理同事可以接手的问题

人工表里每个问题保存主题、支持原句、作品与评论来源、父子关系、使用条件、已有回答、待核项和下一步。按评论 ID 去重，支持评论数与不同作品数分开记。

例如收纳尺寸问题交给规格说明核对；作者已经答复的问题，把作者的答复放回问题旁边；只有“同问”的回复，结合这条回复的父评论再归组。每个主题附原句，不要只输出正负面标签。

整理完导出 UTF-8 CSV，一条待核问题一行。下面是一行虚构的交接记录，来源列指向这次保存的目录和评论表的 C01 行。

```csv
问题,评论原句,来源,还需确认,下一步
能放进背包吗,背包放得下吗,ks-comments-01/response.json · C01,背包内尺寸和设备收纳尺寸,对照规格后补一张收纳图
```

交给同事时一并提供评论表，确保从 C01 找得到原句、对应作品和评论标识。

给助手可以这样交代：

> 复用这轮快手搜索和评论原件，挑有实际露营场景的作品。按携带、收纳、供电等真实问题整理原句与条件，必要时指出要补哪段回复。每个发现附来源、可回答内容和待核项，说明本轮范围。

先处理已存评论能支撑的问题，再按缺口补材料。`ks_read.py` 每条命令只运行一次；定时运行、存储与通知在你自己的任务环境里配置。