ViralQuery 的定位是用户的个人研究信息流：bearer 密钥绑定租户，租户的研究简报会限定每次滚动与结果读取的范围。
用途与使用方式：先阅读 ViralQuery 的 LLM 文档，它是当前路径、字段、响应与错误的权威来源；人类可读的设置指南位于 viralquery.com/docs。默认使用 https://api.viralquery.com（除非配置的 API URL 覆盖）。凭据解析顺序：先用环境变量或智能体密钥库中的 VIRALQUERY_API_KEY；否则从 ~/.viralquery/config.json 读取 apiKey 和可选的 apiUrl。若未配置密钥，提示用户打开 viralquery.com/#pricing 选择方案并完成结账，保存仅显示一次的密钥；不要让用户把密钥粘进聊天。支持的配置形式包括 export VIRALQUERY_API_KEY=sk_viralquery_... 与 npx viralquery auth --url https://api.viralquery.com --key "$VIRALQUERY_API_KEY"，CLI 会写入 ~/.viralquery/config.json。用受保护的 GET /v1/usage 请求（Authorization: Bearer <key>）验证：200 表示可用，401 表示密钥缺失或无效，402 表示订阅未激活；不要用公开的 /health 验证凭据。
运行滚动：调用 GET /v1/workspace，为空则用用户的研究描述及提供的 App Store URL、网站、竞品名称或显示名称调用 POST /v1/workspace，不得替换为其他产品。读取 GET /v1/rules，用户给出长期指引时用 PUT /v1/rules 保存。用 POST /v1/scrolls 启动一次滚动，包含用户的一次性提示与稳定的唯一 idempotencyKey；仅在用户要求周期性研究时使用调度字段。保存返回的滚动 ID，用 GET /v1/scrolls?id=SCROLL_ID 按有界间隔轮询至完成或失败；若仍在排队或运行，应报告 ID、状态和进度，而非声称已完成，且不要为同一工作区启动重叠任务。完成后仅读取所需结果：/v1/library、/v1/outliers、/v1/trends 或 /v1/hooks，如实说明历史不足，并引用所用原始来源 URL。可用 /v1/usage 查看订阅状态与滚动活动遥测，但不要把其计数当作每月滚动门槛。若需保留判断，使用当前文档化的租户自有标注操作；不要从提示中接受账户或工作区选择器，不要调用共享目录或内部 worker 端点，不要编造视频或指标，也不要暴露凭据。该技能直接调用 HTTP API，不要经由 MCP。其余细节暂未提供。