coros-activity-downloader

Coros活动数据下载技能

Purpose

从 COROS Training Hub 自动下载跑步活动记录（FIT 格式），支持智能去重和增量同步，适用于：

• 定期备份运动数据
• 批量导出活动记录
• 自动化数据同步任务

Prerequisites

1. COROS 账户：已登录 COROS Training Hub（https://t.coros.com）
2. Chrome DevTools MCP：已配置 Chrome DevTools MCP 连接器，确保浏览器已登录 COROS 账户
3. Python 环境：Python 3.6+（用于辅助脚本）
4. 配置文件：config.json 中设置正确的 downloadDir

Usage

自动化任务调用

调用 coros-activity-downloader 技能，下载最新的不重复的跑步记录

执行步骤

1. 使用 mcp_Chrome_DevTools_MCP_navigate_page 访问活动列表页面 https://t.coros.com/admin/views/activities
2. 使用 mcp_Chrome_DevTools_MCP_evaluate_script 执行 JavaScript 提取活动列表数据（labelId、name、sportType）
3. 筛选 sportType=100 的跑步活动
4. 扫描下载目录，基于 labelId 去重
5. 将未下载的活动列表作为 --activities-json 参数传入 Python 脚本
6. 脚本通过 HTTP 直接请求 COROS CDN 下载 FIT 文件
7. 保存到配置的下载目录

命令行脚本

# 使用 Chrome DevTools MCP 获取活动后，通过脚本下载
python scripts/download_coros.py --count 15 --activities-json '<JSON>'

# 指定下载目录
python scripts/download_coros.py --download-dir "D:\COROS_Backup" --activities-json '<JSON>'

# 仅验证现有文件
python scripts/download_coros.py --validate-only

# JSON 输出模式（便于程序化调用）
python scripts/download_coros.py --json-output --activities-json '<JSON>'

参数说明

参数	类型	默认值	说明
--count	int	10	下载数量
--activities-json	string	-	活动列表 JSON 字符串
--label-ids	string	-	直接指定 labelId（逗号分隔）
--user-id	string	config.json 配置值	COROS 用户 ID
--download-dir	string	config.json 配置值	下载目录
--sport-type	int	100	运动类型（100=跑步）
--validate-only	flag	false	仅验证，不下载
--json-output	flag	false	JSON 格式输出
--show-config	flag	false	显示当前配置并退出

Architecture

┌──────────────────────────────────────────────────────────────────────────┐
│                          执行流程                                        │
├──────────────────────────────────────────────────────────────────────────┤
│                                                                          │
│  1. 访问活动页面                                                          │
│     navigate_page(url="https://t.coros.com/admin/views/activities")       │
│            │                                                             │
│            ▼                                                             │
│  2. 提取活动数据                                                          │
│     evaluate_script(提取 labelId + name + sportType)                      │
│            │                                                             │
│            ▼                                                             │
│  3. 筛选跑步活动                                                          │
│     filter(sportType === 100)                                            │
│            │                                                             │
│            ▼                                                             │
│  4. 去重检查                                                              │
│     scan(downloadDir) → existing labelIds                                │
│            │                                                             │
│            ▼                                                             │
│  5. 传入 Python 脚本                                                      │
│     --activities-json '<新活动JSON>'                                       │
│            │                                                             │
│            ▼                                                             │
│  6. 脚本通过 HTTP 请求 COROS CDN 下载 FIT                                  │
│     urllib → https://oss.coros.com/fit/{userId}/{labelId}.fit            │
│            │                                                             │
│            ▼                                                             │
│  7. 保存文件                                                              │
│     {name}_{labelId}.fit                                                 │
│                                                                          │
└──────────────────────────────────────────────────────────────────────────┘