达人分析与匹配

交付物是一份 8 到 12 人的短名单备忘：粉丝量、查到时的近期播放中位数、互动、内容支柱，以及谈或不谈。一次完全不查询的运行也是完整运行——粘贴过来的简介、数量和作品就够用。

适用范围与相邻路线

这条路线是：一个品类或几批账号、可选的公开读取、一份短名单。适用于需要决定找谁谈，而不是诊断一个账号，也不是写出第一条作品。短名单就是交付物。外联文案和代发不是本包。

完整的账号诊断，归账号拆解工作流。做出第一条作品，归同一条拆解并起号的路线。UGC 广告和付费社媒素材，归广告工作流。

输入与默认值

硬输入是品类，加上预算或粉丝带，再加上地区；或者用户已经有的账号链接和 @。空泛的「找达人」不够——先把这些字段问清。

对话里已经说过的平台、品类、预算和市场，直接复用。默认八到十二人；若跑查询，每人读一页近作；备忘写上粉丝量、近期播放、互动、支柱和谈或不谈。把这些默认值说出来，而不是拿去问。

用户想从公开账号或一次品类搜索里读达人时，这个软件包可以在 TikTok、抖音、小红书、Instagram、YouTube 和 X 上查询，见查询达人。每一次查询都是付费的、可选的，并且在跑之前单独确认。平台的白名单里没有操作，就没有查询——用用户粘过来的内容继续。X 这里没有用户搜索：用户必须给出账号。YouTube 这里没有频道搜索：用户必须给出频道网址。没有查询时，就根据粘贴的材料写短名单，而不是去编造粉丝量或播放数字。

标准流程

用户带来的账号就能免费写成短名单。唯一的付费调用是一次可选查询，而且只有用户主动要求、并确认过它自己的价格之后才会发生。不要默认只查主页。近作与题材拟合必须来自内容证据，再收成八到十二人。

**在写备忘之前，只有用户主动要求时才做：**按点名的品类搜一页达人，或读一个给出的账号和那人的一页作品，见查询达人。用户已经粘贴了简介、数量和作品时就跳过查询。

收齐候选人。 来自查询载荷，或来自用户粘贴的内容。每个人都标明出处——查到的带着读取时间，用户提供的标成用户提供。
打分看品类契合、预算带、市场、近期播放和互动，见写短名单。
写备忘： 八到十二人，每人有粉丝量、查到时的近期播放中位数、互动、内容支柱，以及谈或不谈。文案允许免费改一版。
交付备忘。若跑过查询，还要交付任务 ID、终态，以及 billing.net_charged_credits。查询没有模型、尺寸或时长可报。

需要确认的决定

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

以下同样要确认，而不是自己决定：第二页作品或搜索结果、一次 60 积分的小红书主页、用户搜索或笔记页、在作品页之后再读一页 Instagram Reels、先解析 YouTube 频道再读频道，以及查询已经跑过之后的任何改动。每一个改动过的参数都是新的付费工作，需要新的请求标识和重新批准。

查到的数字标成查到的，并带上读取日期。用户提供的数字继续标成用户提供。缺的数量就说缺，不要估算、插值，也不要从“类似达人通常怎样”里补。某人为何合适仍然是推断——标成推断，并给出证据。

执行

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

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

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

交付与复核

交付 8 到 12 人的短名单、粉丝量和近期播放数字、互动读法、内容支柱，以及谈或不谈。若跑过查询，交付返回的载荷、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 报告官方可用版本但不替换文件。详见自动更新与安全。