viral-app

用途：在智能体中通过本地 viral-app CLI 访问 viral.app API，完成分析查询与资源管理。主要能力：查询分析数据（账号、视频、KPI、导出）；管理追踪的账号、视频、排除项与刷新任务；管理项目与创作者中心资源；拉取 Facebook、TikTok、Instagram、YouTube 的实时平台数据。使用方式：确保 CLI 在 PATH 中，运行 viral-app --help；设置密钥 export VIRAL_API_KEY="..."（密钥来自 viral.app 面板 Settings -> API Keys）；用 viral-app accounts-list --per-page 1 验证访问。执行具体操作前用 viral-app <command> --help 查看参数与请求体结构。读取示例：accounts-list --per-page 10、videos-list --per-page 10、analytics-get-kpis、analytics-top-videos、integrations-apps-list。写入示例：projects-create、accounts-tracked-refresh、projects-add-to-account。支付变更：先执行 payouts-calculate，再执行 payouts-initiate，并原样传入返回的 calculation 与 integrityToken，不得自行编造或重算；使用 autoApproveTalentir=true 时需同时设置 acknowledgeFullPayoutLiability=true 并说明风险。限制与安全：POST、PUT、PATCH、DELETE 前需确认意图；先用窄查询再扩大导出；默认输出 JSON，自动分页默认关闭。401 表示密钥缺失、无效或过期；429 需按 Retry-After 退避重试；数据为空时检查过滤条件、ID 与日期范围；不要提交密钥，测试后轮换。链接回 viral.app 时优先使用具体页面，账号与创作者使用筛选列表，多值过滤用逗号分隔，日期范围用 df 与 dt（YYYY-MM-DD）。