抖音数据分析

交付物是一页带出处的简报：查到时的播放、点赞和评论，开头钩子，一句观众原话，以及跟或不跟。一次完全不查询的运行也是完整运行——粘贴过来的文案、数量和评论就够用。

适用范围与相邻路线

这条路线是：一条抖音链接或一个关键词、可选的公开读取、一页带出处的简报。适用于需要看清一条片子或一个词在做什么，而不是今天就要发出去的稿。

今天能发的稿，归热点工作流。完整的账号诊断，归账号拆解工作流。

输入与默认值

一个硬性输入：抖音从哪里来。可以是一条公开抖音作品链接、一个关键词，或用户已经复制的文案、数量和评论。任何一种都够用。

对话里已经说过的商品、品类，以及这份简报用来干什么，直接复用。默认一条作品；若跑查询，读一页一级评论；简报固定四块：数字、钩子、一句原话、跟或不跟。把这些默认值说出来，而不是拿去问。

用户想读一条公开抖音作品、评论、作者、关键词搜索或热搜榜时，这个软件包可以查询，见查询抖音。每一次查询都是付费的、可选的，并且在跑之前单独确认。平台的白名单里没有操作，就没有查询——用用户粘过来的内容继续。没有查询时，就根据粘贴的材料写简报，而不是去编造播放、点赞或评论数字。

标准流程

用户带来的材料就能免费写成简报。唯一的付费调用是一次可选查询，而且只有用户主动要求、并确认过它自己的价格之后才会发生。

**在写简报之前，只有用户主动要求时才做：**读一条抖音作品和它的一页评论，或按关键词搜一页抖音视频再读用户挑中的那一条，见查询抖音。用户已经粘贴了文案、数量和评论时就跳过查询。

收齐证据。 来自查询载荷，或来自用户粘贴的内容。每一个数字都标明出处——查到的带着读取时间，用户提供的标成用户提供。
读片子 找钩子、数字和一句原话，见写简报。
写简报： 一页带出处的读法，有播放、点赞和评论（若有）、钩子、一句原话，以及跟或不跟。文案允许免费改一版。
交付简报。若跑过查询，还要交付任务 ID、终态，以及 billing.net_charged_credits。查询没有模型、尺寸或时长可报。

需要确认的决定

每一次查询都在跑之前单独确认，没有例外。说明将要读什么、对应哪一个操作、beatra.social.tools.get 刚刚返回的积分价格，以及计划里一共几次查询，每一页算一次。停在这里，用户已经粘过来的内容仍然能写出一份能用的简报。

以下同样要确认，而不是自己决定：第二页评论或搜索结果、一次 60 积分的抖音视频搜索、读完作品后再读作者、热搜榜，以及查询已经跑过之后的任何改动。每一个改动过的参数都是新的付费工作，需要新的请求标识和重新批准。

查到的数字标成查到的，并带上读取日期。用户提供的数字继续标成用户提供。缺的数量就说缺，不要估算、插值，也不要从“类似作品通常怎样”里补。某条片子为什么表现好仍然是推断——标成推断，并给出证据。

执行

所有远程 Beatra 工具只通过随包的 scripts/mcp_client.py 调用，工具名作为命令行参数，工具的参数以 JSON 从标准输入传入：

printf '%s' '{"query":"video","platform":"douyin","capability_family":"content"}' | python3 scripts/mcp_client.py call beatra.social.tools.search

不要配置或调用宿主 Beatra Connector，也不要使用 REST/OpenAPI 作为回退。每一个逻辑上的付费请求，给它一个稳定且不透明的 client_request_id，并且只提交一次。

交付与复核

交付一页简报、播放、点赞和评论数字、钩子、原话，以及跟或不跟。若跑过查询，交付返回的载荷、task_id、终态，以及 billing.net_charged_credits。不要去找解析后的模型或生成出来的媒体文件。只报告任务真正返回的事实。

恢复

任务 ID 丢失时，用 beatra.tasks.list 列出可能的任务，用 beatra.tasks.get 核对匹配项，然后在同一个 client_request_id 下重放逐字节一致的参数。只写重放这一半，就等于授权一次重复扣费。

查询失败时，保留 error.code，并阅读 error.message 里的平台措辞。只有当那条消息点名了某个字段或 ID 时才改参数，然后换一个新的 client_request_id。否则保持同一个 ID 和同一份载荷。不要建议换模型。

按任务查阅参考

读一条抖音作品、它的评论、作者、一次关键词搜索或热搜榜，每次查询要花多少，以及数字如何标注来源：查询抖音
写成带出处的简报：写简报
确切载荷、确认、翻页与恢复：抖音简报工作流
首次安装或授权过期：安装与认证
不计费的软件包注册：安装注册
任务轮询、产物与结果字段：任务与结果
余额、校验与结构化错误：计费、错误与恢复
随包客户端连不上时：随包 MCP Client 连接诊断
更新保证与开关：自动更新与安全
移除软件包或共享凭据：卸载与断开连接

运行时与安全自动更新

随包客户端会在每个安装中静默检查是否有新版本，最多每 24 小时一次。发现更高版本时，不另行确认地自动安装。它只从本软件包、本渠道、本语言对应的固定 Beatra 官方发现地址与不可变 CDN 路径下载，在替换之前校验发现数据、压缩包、清单，以及每个文件的大小和校验和，并且只替换本包拥有的文件。它会拒绝重定向、降级、软件包/渠道/语言/版本对不上的数据、非预期的 URL、不安全的压缩包，以及任何落在所属目标目录之外的文件。

更新的检查、下载、校验、替换和回滚，失败时都不阻断：当前安装保持可用，原本请求的命令会继续执行。更新失败绝不构成重试一次付费查询的理由。这个设置会在本安装之后的命令中持续生效。

python3 scripts/mcp_client.py update --auto off
python3 scripts/mcp_client.py update --auto on
python3 scripts/mcp_client.py update --check

--auto off 关闭静默检查，--auto on 重新开启，--check 报告官方可用版本但不替换文件。详见自动更新与安全。