YST KPI Daily Report Collector

采集指定月份范围的日报数据

⚠️ 重要：使用前请先确保已登录！

推荐流程：

1. 先调用 check_login_status 检查登录状态

2. 如果未登录，调用 browser_login 进行登录

3. 登录成功后，再调用本工具采集数据

这样可以避免采集过程被登录流程阻塞。

Args: start_month: 起始月份，格式 YYYY-MM (例如: 2025-07) end_month: 结束月份，格式 YYYY-MM (例如: 2025-09) output_file: 输出文件路径（可选，默认为 ~/.yst_mcp/output/new.md 或项目目录下 data/new.md） auto_login: 未登录时是否自动启动浏览器登录（默认 False，不推荐设为 True）

Returns: 采集结果描述

启动浏览器进行登录（后台执行，不阻塞）

✅ 新版本改进：

• 立即返回，不再阻塞等待

• 在后台线程中启动浏览器

• 用户可以使用 check_login_status 检查登录是否完成

✅ 推荐使用流程：

1. 调用此工具启动浏览器（立即返回）

2. 在浏览器中完成 Google 登录（约1分钟）

3. 调用 check_login_status 检查登录状态

4. 登录成功后，调用 collect_reports 采集数据

工作流程：

1. 立即返回"浏览器启动中..."

2. 后台打开浏览器窗口

3. 等待您完成 Google OAuth 登录

4. 自动提取并保存 Cookie

5. 保存浏览器会话

Args: use_persistent: 是否使用持久化浏览器上下文（推荐，默认 True） timeout: 登录超时时间（秒），默认 300 秒（5 分钟）

Returns: 启动状态（立即返回，不等待登录完成）

保存浏览器 Cookie（用于首次登录）

使用方法：

1. 使用 chrome_devtools_mcp 登录 https://kpi.drojian.dev

2. 登录成功后，从浏览器复制 Cookie 字符串

3. 调用此工具保存 Cookie

Args: cookie_string: Cookie 字符串，格式如 "name1=value1; name2=value2" 或者完整的 curl 命令中的 -b 参数内容

Returns: 保存结果

检查当前登录状态（建议第一步调用）

✅ 推荐工作流程：

1. 首先调用此工具检查登录状态

2. 如果返回"未登录"，则调用 browser_login 进行登录

3. 登录成功后，调用 collect_reports 采集数据

Returns: 登录状态信息： - "✓ 已登录，Cookie 有效" -> 可以直接采集数据 - "❌ Cookie 已过期" -> 需要调用 browser_login 重新登录 - "❌ 未找到保存的 Cookie" -> 需要调用 browser_login 首次登录

清除已保存的 Cookie

Returns: 清除结果