新品Reel评论里哪些问题还没答?怎样连同回复一起核对?
要查新品 Reel 评论里哪些问题已经有人回答,先用 instagram.fetch_post_comments_v2 读 Reel 的一级评论:把 Reel 的数字媒体 pk 作为 media_id 传入,结果导出为 comments.csv。挑出与配件、清洁或杯型有关的问题,再用 instagram.fetch_comment_replies 按问题所在的一级评论 ID 读回复。最后把每个问题标为 answered(已答)、needs_context(待补上下文)或 no_answer_observed(本轮未见答案)。
例如观众问「可以用矮杯吗」,就保留原句和 Reel 链接。有回复提到杯高限制时,把这条回复与问题配对,再拿杯高限制去核对产品说明。
一条问题怎样走到下一步?
- 认准 Reel。 复用已保存帖子详情里的媒体 ID,按帖子到评论交接准备请求。
- 保存一级评论。 查看
comments.csv里选定的页数,找出与产品使用有关的提问;归纳时把每条问题的原句放在旁边。 - 读取选中问题的回复。 一级评论下的回复预览不代表整楼已读完。某个问题需要上下文时,为这条一级评论生成回复请求,回复分支保存到单独目录。
- 核对回复有没有回答问题。 读问题和返回的回复;
resolution.json里的每个判断都用实际回复 ID 和逐字原句支持。 - 交接后续工作。 每个问题写清要核实什么、由谁核实。生成
resolution.json不会回复观众,也不会关闭任何问题。
把审核交给已连接 BeatAPI 的助手时,可以这样布置:
整理这条新品Reel里与配件和清洁有关的提问。每条保留原句,选中需要上下文的楼层读回复。把有回复证据的答案、还缺条件的提问和本次未见答案的问题分别列出,说明下一步。
最后看哪几个结果?
answered 需要一条已保存回复的原文支持答案;needs_context 表示已保存的回复不足以判断;no_answer_observed 只描述本次保存的样本。使用任何答案之前,先与产品说明核对。
下面第 1–7 步依次完成取数、导出、读回复和审核。Python 脚本只处理已保存的文件;save_call.sh 每运行一次发一次数据请求。已有响应时直接复用。
1. 准备媒体 ID 和页数预算
使用已保存帖子详情里与 Reel 短码匹配的那条记录的原始数字字符串 pk,不用 URL 短码,也不用快照 CSV 的通用 id 列。链接到评论的交接流程从 v2 的 data.data.pk 或 v3 匹配的 data.items[].pk 取值,生成完整的首页请求。复用帖子快照指南保存的帖子详情,不再付费转换。在请求记录里写明媒体 ID 属于哪条 Reel:评论响应本身不标明是哪条 Reel。
一级评论用 data:instagram.fetch_post_comments_v2 请求,当前单价见价格页。先定本轮购买的页数;一级评论、选中回复和可选详情的请求数分开计算。条数以实际返回为准,本地导出不发请求。
2. 保存第一页和请求记录
写好 request-1.json,把示例媒体 ID 换成已确认的数字媒体 ID:
把下面的脚本保存为 save_call.sh,在已批准的页数预算内每页运行一次 bash save_call.sh request-1.json root-call-1。每次运行发一次收费请求,不重试;curl -q 忽略本机 curlrc 里的重试和重定向设置。输出目录必须事先不存在。
save_call.sh 保留实际提交的请求、响应头和正文、本机 UTC 请求开始时间和 HTTP 状态。save_call.sh 只在 HTTP 200 后生成 entry.json,instagram_comments.py 还会再检查响应包装。把每个生成的 entry.json 对象放进 pages.json 数组。下面的示例展示了 pages.json 的预期格式。curl、网络或 HTTP 失败时停止并保留目录,不要在同一目录再次运行 save_call.sh。日志里不写授权头。
3. 导出已保存页面,准备下一页请求
把下面的脚本保存为 instagram_comments.py。脚本读取 /v1/social-data/call 的直接响应,不读 MCP 截断预览。相对的 response_file 路径按 pages.json 所在目录解析;save_call.sh 已经记录绝对路径。脚本检查所有页面属于同一媒体 ID 和同一明确排序、采集时间带时区且按时间先后排列、游标链连续。缺少 data.comments 的响应会让导出停止,不会当作空页。comments.csv 对每条一级评论保留第一次观察值,原始页保留之后的变化。回复不计入一级评论数。
4. 在预算内继续翻页
运行 python3 instagram_comments.py pages.json review-1。如果生成了 review-1/next-request.json,文件里的 min_id 就是上一页 next_min_id 的原样字符串。不要解析后重写 next-request.json,不要手改转义,也不要换媒体 ID 或排序后复用。决定购买下一页时运行 bash save_call.sh review-1/next-request.json root-call-2,把 root-call-2/entry.json 作为新对象追加到 pages.json 数组,再导出到新目录,例如 review-2。不编辑已保存的请求,不手工重建游标;终止页之后不再追加页面。
达到预算,或导出报告 provider_end、更多标记为 true 却返回空页、游标重复或缺失、更多标记不是布尔值、网关失败时,都停止。出现这些情况时 instagram_comments.py 不生成 next-request.json。字段缺失是需要上报的结构问题,不是零评论:保留响应和 request_id 联系支持,不要自动换另一个收费接口试探。成功返回 comments: [] 且更多标记为 false 时,输出只有表头的 CSV,并记录正常结束。
5. 交付证据,不把样本说成全部评论
comments.csv 每个已观察到的一级评论 ID 一行,含原文(已做防表格公式转义)、点赞数、原始时间戳、声明回复数、预览对象数、请求 ID 和采集时间。在 Excel 里把媒体 ID 和评论 ID 按文本导入,防止长整数丢精度。零保持为零,缺失留空。原始时间戳不按猜测的时区或单位换算。表格有意不输出用户名和头像。
reply-previews.jsonl 把文档记录的回复预览对象挂在出现位置的一级评论下,不补造回复内部字段,也不代表完整楼层。coverage.json 记录每一页、页面哈希、声明总数和停止原因;raw-page-*.json 保存原始字节。这些源文件可能含个人信息,限制访问,对外另做脱敏副本。平台声明的总数不保证能取到多少条;到达 provider_end 也不代表已取到被删除、隐藏或私密的评论。
整理新品反馈时,在 comments.csv 的行上人工填写 decision、topic 和逐字来源原句。排除推广和重复内容时写明理由,并报告已审和未审的一级评论数以及 Reel 数。投诉只在已审样本内计数,计数不代表客户数、购买数、人群比例或产品缺陷。以公式字符开头的引文要对照原始 JSON 核对,不对照转义后的 CSV 单元格。承诺任何回复结果之前,先读回复覆盖边界。
证据和验证范围
评论 V2 响应的评论 ID、正文、计数、时间戳和游标字段都在 data 下。导出新一批数据前,先用已保存的响应核对 data 下的字段路径,并将本页示例中的占位 ID 和时间替换为实际请求值。
6. 为一个选定根评论展开回复证据表
某条一级评论提出了尚未解决的产品问题时,从 comments.csv 取这条一级评论的 comment_id。一级评论导出目录保持原样:instagram_replies.py 先核对一级评论所在原页的哈希、请求 ID,并确认这条一级评论确实出现,才接受回复页。预览对象不并入回复计数。
回复用 data:instagram.fetch_comment_replies 请求:传同一个媒体 ID,并把选中一级评论的 pk 作为 comment_id。每条一级评论的回复保存为独立分支,按计划页数和当前价格估算费用。
把第一条回复请求保存为 reply-request-1.json,两个示例 ID 换成选定的媒体 ID 和一级评论 ID。运行 bash save_call.sh reply-request-1.json reply-call-1,再把 reply-call-1/entry.json 放进 reply-pages.json 数组:
请将上面示例中的 ID 和时间替换为实际请求值。把下面的脚本保存为 instagram_replies.py,运行 python3 instagram_replies.py review-2 reply-pages.json replies-1,其中 review-2 换成实际的一级评论导出目录。
replies.csv 把 requested_root_id 和每条返回的 parent_comment_id 分开保存,因为回复的直接父评论不一定是请求的一级评论。每行保留原始回复 ID、正文、点赞数和原始时间戳。coverage.json 记录一级评论原页的哈希和为这条一级评论取到的回复页。复核时同时保留一级评论导出目录和回复目录。
回复分页通过 data.page_info.next_min_id 续页。响应元数据中可能同时包含 next_min_child_cursor,由于两个不同名字段不可互换,instagram_replies.py 不会用 next_min_child_cursor 代替。更多标记为 true 但缺少 data.page_info.next_min_id 时,脚本以 missing_cursor 停止,保留响应查证。游标正常时,next-request.json 写好同一媒体 ID、同一一级评论 ID 和游标,用于下一页收费请求。与一级评论相同,追加实际请求记录并导出到新目录。
审核每个问题时,把一级评论原文和 replies.csv 一起读,人工把 resolution 填为 answered、needs_context 或 no_answer_observed,并写上支持判断的回复 ID 和逐字原句。provider_end 只表示分页结束,不证明不存在隐藏或已删除的回复。整个流程不给评论者发消息。
标识符精度前提
超过 9007199254740991 的 JSON 裸数字按 float64 解码时会发生舍入,在到达 Python 脚本前就可能丢失精度,因此脚本拒绝超过 9007199254740991 的裸数字 ID,而原本以字符串返回的 ID 保持精确。不要给已经舍入的值加引号来“修复”:应停止本次导出,保存 request_id 查证。Python 大整数和表格文本格式都无法恢复已经舍入丢失的数字。
每个观测先校验,再去重
两个导出脚本在跳过重复 ID 之前,先校验计数、时间戳和返回的父评论 ID,所以后页的坏数据不会因为前页出现过同一 ID 而被跳过。合法的变化值仍按 CSV 保留首次观察值的规则处理;原始页保存每一次观察,CSV 不是合并后的最新状态。计数接受 0、安全范围内的非负整数和原始 ASCII 数字字符串;负值、缩写、布尔值或超出安全范围的裸数字会停止导出。缺失的计数留空。成功包装里同时带 error 时,脚本拒绝这份响应。
7. 把一个问题收口为有证据的人工审核结论
replies.csv 本身还不是产品支持结论。针对一条选定的一级评论,读一级评论和已保存的回复,再人工判断。只有拿得出已保存的回复 ID 和逐字匹配的支持原句时,才能用 answered。needs_context 表示已保存的证据不足;no_answer_observed 表示在已保存样本里没找到答案,不表示从来没有人回答。
用实际的一级评论 ID 和回复 ID 填写 review.json。下面的示例展示了 review.json 的预期格式:
no_answer_observed 不填 reply_id 和 quote,在 reviewer_note 里写明审阅了哪些页。needs_context 可以附一条匹配的原句,也可以两个证据字段都不填。resolve_question.py 只检查证据能否对应到已保存的回复,不判断回复内容是否正确、建议是否有用。
把下面的脚本保存为 resolve_question.py,运行 python3 resolve_question.py review-2 replies-1 review.json question-review,把两个目录换成实际的一级评论导出目录和回复导出目录。输出的 resolution.json 包含选定的一级评论、人工判断、逐字原句及其来源、观察到的回复数和采集停止原因;review-input.json 保留原始人工输入。脚本不发 API 请求,也不回复评论者。
question-review 目录作为私有工作资料保存,引用内容审阅后再对外分享。resolve_question.py 把引用原句与原始响应正文核对,不与防公式转义后的表格单元格核对。原始字节被改动、媒体 ID 或一级评论不对、ID 缺失、原句是编造的或覆盖数量不一致,都会让审核停止。本地哈希只证明文件前后一致,不是服务器签名。answered 是人工判断,不代表已验证购买、客服工单已解决或已取到全部回复。后续汇总时,不要把未审阅的一级评论算作未回答。

