用途 matriz-espiar 用于查看同一账号下哪些内容表现更好。它抓取指定公开账号的内容，按浏览量中位数计算每条的相对表现（倍数），并把结果列成清单，供用户挑选要深入分析的视频。
支持的平台：instagram（默认抓取 Reels）、instagram-posts（需要抓取轮播图和照片时使用）、tiktok、youtube、x。只处理公开账号；如果抓取工具返回账号为私密或不存在，流程会停止并说明。
运行前准备 脚本位于插件根目录下。需要先检查配置项：APIFY_TOKEN 缺失时必须停止流程，并到 https://apify.com/sign-up 获取。GEMINI_API_KEY 为可选项：有该 key 时，视频分析走音频路线；没有时改用画面内嵌字幕的读取方式，对外部付费 API 的调用为零，流程不中断。perfil.json 不是必需文件，但若存在会读取其中的赛道信息，用于过滤无关内容。
主要能力
- 抓取与成本确认：先运行估算，展示预计抓取数量、估算费用和费用上限，等待用户确认后才执行。新账号默认上限 40 条、费用上限 1.00，已查看过的账号默认 15 条、上限 0.50。原始数据保存在 fuentes/ 目录，且不再编辑。
- 排序展示：按表现倍数从高到低输出编号列表，包含日期、文案前 8 个词、浏览量、倍数、是否有可下载视频及链接。没有浏览量的条目标记为 s/d 并排在末尾，不当作零处理。
- 选择与下载：展示列表后暂停，询问用户要分析哪几条（最热门的 3 条、5 条、自选编号或不分析）。只下载用户选中的条目。视频链接有效期较短，下载失败（403/404）时报告并继续下一条。
- 视频分析：对含视频的条目调用分析子代理，根据配置自动选择音频分析或逐帧读取内嵌字幕。Gemini 不可用（缺少或无效 key、配额、网络问题）时自动回退到逐帧方式并明确说明；若是其他错误则报告并停止。轮播图、图片或纯文本条目不做视频分析，只分析文本，并将仅视频可见的信息（视觉钩子、节奏、时长、转录）标记为 s/d。
- 结果文件：每条分析写入 transcripciones/<id>.json，包含固定的 7 个键和 _meta 块，便于后续矩阵工具按字段读取，并与 fuentes/ 中的原始数据按 id 关联。钩子原文照录，未知信息一律标记为 s/d，不转成零或平均值。
单条 URL 模式 如果输入以 http 开头的单条视频 URL，则直接下载该视频并分析。需要注意的是：descargar.mjs 只能下载直链视频文件，不能处理帖子页面；若链接是帖子页面或 YouTube 页面，应改用同技能包中的 /matriz-ver（用 yt-dlp 下载）。单条视频没有账号整体数据，因此无法计算中位数，表现倍数记为 s/d；它只能说明视频是怎么做的，不能说明是否有效。若需要帖子指标，则要提供账号名和平台。
使用方式 调用时传入账号名与平台（两个词）进入账号模式；传入 URL 进入单条模式；参数为空时先询问账号与平台，不进行猜测。命令语法为位置参数，脚本会拒绝不认识的参数标志。
结束时的处理 如果存在 perfil.json，会把该账号连同日期和来源文件加入竞品列表；统计 transcripciones/ 中已有多少条分析，达到 10 条时建议运行 /matriz-construir，不足则说明还差几条；若抓取服务返回真实费用则如实说明，否则标记 s/d；最后列出本次写出的文件路径。
限制 仅限公开账号；APIFY_TOKEN 是必需项；需要费用确认后才执行抓取；视频分析依赖可选的 Gemini key，或依赖画面中存在内嵌字幕；单条 URL 模式无法给出表现倍数；轮播图等无视频内容无法分析视频层面的特征。具体费用数值仅为资料中给出的估算区间与默认上限，实际以抓取服务返回为准。