CMM VK采集

概述

按关键词和时间段采集 VK 帖子，以及这些帖子下命中同一关键词的评论，最后导出 Excel。

• 远端负责登录校验和采集。每个账号最多 20 次；每一次是一组关键词表达式 + 一个时间段的完整「搜帖 + 拉评论」流程。帖子翻页和评论翻页最多各 10 页。额度与页数只由后端执行，对话里不要改参数绕过。
• 不输出 Token、密码；数据源为 CMM 平台。
• AND / 逗号 / 分号表示必须同时出现；OR 分次搜索再按链接取并集。用户写了 OR 就原样传递，不要改成 AND。

接口见 @references/api.md。首次回复不要读取 references。

首次启动（最高优先级）

首次调用时，先立即显示下面这句话，再在同一轮自动执行登录检查，不要等待用户回复：

开始前将检查登录状态；如果尚未登录，会自动打开邮箱验证页。首次验证会自动创建账号，无需设置密码，验证后会继续当前任务。每个账号有 20 次免费采集额度。

使用 WorkBuddy 的托管 Python 执行，不要依赖系统 Python：

python scripts/client.py login

客户端支持 Windows、macOS 和 Linux。所有命令输出都是 ASCII-safe JSON。命令会先检查已有 Token：已登录时不会打开窗口，未登录时只打开一个浏览器页面。不要并行或重复执行 login；返回 login_in_progress 时，只提醒用户完成已经打开的页面。

Windows 沙箱若没有自动打开窗口：把命令返回的固定 login_url 和 8 位 authorization_code 告诉用户，让用户在固定登录页的「授权码」框输入。authorization_pending 或 HTTP 202 表示仍在等待验证，继续等待即可。不要输出 device_code、带参数地址或 Token。Token 只写本机 ~/.cmm-vk-collect/api_token。

login 返回 already_authenticated: true 或登录成功后，直接继续查额度，禁止再次登录。

用户要登出时执行 python scripts/client.py logout。

健康检查失败则停止，不要用公开网页搜索冒充采集结果。

1. 确认采集条件和额度

登录完成后立即询问；用户已经说过的不要重复问：

1. 关键词（支持 AND / OR）；
2. 开始日期和结束日期（东八区，YYYY-MM-DD）；
3. 可选：帖子页数、评论页数（各 1–10，默认各 10）。

使用简短话术：

请提供：①关键词（AND 同时出现，OR 分次合并）②开始日期 ③结束日期。未指定页数时，帖子和评论默认各翻 10 页。

登录刚完成、尚未取得额度时只执行一次：

python scripts/client.py quota

把剩余额度告诉用户：每个账号一共 20 次，一次关键词表达式 + 时间段算 1 次。

若剩余次数不足 1，原话说明已超限额，请联系技能作者 chloechen1688@gmail.com（或微信 13911516301）申请更大限额。不要拆成多次调用绕过。

注意：额度会不定期重置。

2. 采集

用户确认后再执行。未指定页数时用 10。

python scripts/client.py collect --query "самокат AND segway" --start-time "2026-10-01" --end-time "2026-10-19" --pages 10 --comment-pages 10

命令会把结果写到本机 JSON，并打印帖子数、评论数、扣次和剩余额度。对话里只转述汇总，不要粘贴全部正文。

后端若返回超限或参数错误，把后端原文告诉用户并停止。

3. 导出

导出脚本只使用 Python 标准库生成 .xlsx。必须用 WorkBuddy 托管 Python：

python scripts/export_excel.py --input <采集 JSON 路径>

把生成的 Excel 路径告诉用户，并附上帖子数、评论数。0 条命中也会导出带表头的空表。有 warnings 时说明评论翻页上限等情况。

红线

• 不把公开搜索结果混进采集表。
• 不输出 Token、密码，不说出上游接口名称。
• 登录只给固定地址 http://microearthbot.work/login。
• 必须先显示登录说明，再自动检查并按需打开登录页；登录已成功或正在进行时，不得再次执行 login。
• 页数上限 10，账号上限 20 次，都以后端结果为准。
• 不要为正文再调详情接口；不要拉取某个指定账号的全部帖子流。
• 登出必须执行 python scripts/client.py logout。