YouTube Shorts 分析系统 v2.0：数据收集、分析实操全流程分享

前言：更好的阅读体验见飞书文档 一个完整的 YouTube Shorts 数据收集和分析系统 https://rlwxa0zgke.feishu.cn/docx/YImFdq9DbopPB5xaEUSczCG... YouTube Shorts 分析系统版本 v2.0一个完整的 YouTube Shorts 数据收集和分析系统🏠 系统概述功能介绍YouTube Shorts 分析系统是一个专业的数据收集和分析工具，帮助您：✅ 通过关键词批量收集 YouTube Shorts 视频数据✅ 支持时间范围过滤，精确控制数据收集时段✅ 提供交互式 HTML 分析仪表板，直观展示数据✅ 多维度统计分析：观看数、点赞数、评论数、时长等✅ 热门频道分析和标签趋势追踪✅ 支持数据分页浏览和月度数据详细分析✅ 一键导出分析报告系统要求操作系统：Windows 7 及以上版本浏览器：Chrome、Edge、Firefox 等现代浏览器网络：需要互联网连接以访问 YouTube API授权：需要有效的卡密激活许可证版本信息当前版本：v2.0发布日期：2025-11-20🚀 快速开始按照以下三个步骤，快速开始使用系统：1️⃣ 授权激活1. 启动程序，在授权界面输入您的激活卡密,找我要，点赞过100，送100个激活码卡密授权问卷 填写你的生财有术数据ID即可2. 点击"激活"按钮3. 等待服务器验证，激活成功后自动进入主界面卡密会自动保存在本地，下次启动时自动验证，无需重复输入。2️⃣ 数据收集1. 切换到"数据收集"标签页2. 输入 YouTube API Key（首次使用需要获取，详见下文）3. 输入搜索关键词（例如：Roblox）4. 设置最大结果数（建议 50-10000）5. 可选：设置时间范围（留空表示所有时间）6. 点击"🚀 开始收集"按钮收集完成后，数据会自动保存到 shorts.json 文件。3️⃣ 查看分析结果1. 切换到"Data Analysis"标签页2. 点击"📊 分析所有数据 (HTML)"按钮3. 系统会在浏览器中打开分析仪表板，自动加载数据4. 浏览各种图表和统计信息分析仪表板会自动从 localStorage 加载数据，无需手动导入文件。📊 数据收集详解YouTube API Key 获取YouTube API Key 是访问 YouTube 数据的必要凭证。获取步骤：1. 访问Google Cloud Console2. 创建新项目或选择现有项目3. 启用"YouTube Data API v3"4. 创建凭据 → API 密钥5. 复制生成的 API KeyAPI Key 会自动保存在本地（api_key.txt），使用 Base64 编码存储，下次启动时自动填充。搜索关键词关键词用于搜索相关的 YouTube Shorts 视频。关键词技巧：单个词：Roblox、Minecraft、Python多个词："iPhone 16 review"（使用引号表示精确匹配）热门话题：trending、viral、challenge语言：支持中文、英文等多种语言最大结果数设置要收集的视频数量上限。数量范围适用场景预计耗时50-100快速测试、小规模分析1-2 分钟500-1000中等规模分析、趋势观察5-10 分钟5000-10000大规模数据分析、深度研究30-60 分钟YouTube API 有每日配额限制（默认 10,000 单位/天），每次搜索消耗约 100 单位配额。合理规划使用量。时间范围过滤⭐ v2.0 新功能限制只收集最近 N 天内发布的视频。使用方式：留空：收集所有历史视频（默认）填写天数：例如 180 表示最近 180 天典型应用场景：天数用途说明留空历史数据分析获取所有时间的视频7一周热门追踪最新热点话题30月度趋势分析最近一个月表现90季度分析观察三个月趋势180半年报告半年期数据洞察365年度总结一整年数据回顾时间范围过滤在 YouTube API 服务器端执行，可以提高收集效率并节省配额。数据存储位置收集的数据保存在以下位置：开发模式：D:\Source\python\youtube3-fnally\shorts.json打包后 (EXE)：与 exe 文件同目录下的shorts.json预览文件：shorts.preview.json（前 3 个视频）📈 数据分析详解HTML 分析仪表板系统提供交互式 HTML 分析仪表板，包含以下功能：📊 6 大统计卡片：视频总数、观看总数、点赞总数、评论总数、平均数据📈 8 个交互式图表：互动分布、时长分析、观看点赞相关性、时间轴、频道排行等🎯 关键洞察分析：自动识别数据特征和趋势📄 热门视频列表：支持分页浏览📥 导出报告功能自动数据加载⭐ v2.0 新功能系统现在使用 localStorage 技术自动保存和加载数据。工作原理：1. 在主页面加载 shorts.json 文件时，数据自动保存到浏览器 localStorage2. 打开分析页面时，自动从 localStorage 读取数据3. 无需手动点击"加载数据文件"按钮4. 数据在浏览器本地存储，更安全、更快速现在您只需点击"分析所有数据"按钮，页面会自动显示分析结果，无需任何额外操作！分页功能⭐ v2.0 新功能热门视频列表支持灵活的分页浏览。功能特点：每页显示数量：可选 10 / 20 / 50 / 100 条智能按钮显示：第一页：只显示"下一页 →"中间页：显示"← 上一页"和"下一页 →"最后一页：只显示"← 上一页"第一页：只显示"下一页 →"中间页：显示"← 上一页"和"下一页 →"最后一页：只显示"← 上一页"页面信息：显示"第 X / Y 页"分页功能解决了"只能看 10 个视频"的问题，现在可以轻松浏览成千上万条数据！时间轴交互功能⭐ v2.0 新功能时间轴图表支持鼠标交互，查看特定月份的详细数据。交互方式：鼠标悬停：显示该月份的视频数量点击：打开新页面，显示该月份的详细分析只分析该月发布的视频所有图表和统计数据都针对该月页面标题显示"YouTube Shorts 分析仪表板 - 2025 11"只分析该月发布的视频所有图表和统计数据都针对该月页面标题显示"YouTube Shorts 分析仪表板 - 2025 11"示例：点击时间轴上的 "2025 11" 点 ↓打开新页面 analytics_detail.html?date=2025-11 ↓自动从 localStorage 读取所有数据 ↓筛选出 2025 年 11 月发布的视频 ↓展示该月份的专属分析报告频道点击跳转⭐ v2.0 新功能"热门频道"图表支持点击跳转到 YouTube 频道页面。使用方法：1. 在"热门频道"图表中，鼠标悬停在橙色横向柱状图上2. 点击柱状图3. 自动在新标签页打开该频道的 YouTube 页面区分鼠标悬停和点击：悬停只显示数据提示，点击才会跳转到 YouTube。图表详解分析仪表板包含 8 个专业图表：1. 📊 互动分布（柱状图）展示观看数、点赞数、评论数的分布情况帮助识别高互动视频2. ⏱️ 时长分析（直方图）按时长区间统计视频数量识别最受欢迎的视频时长3. 👁️ 观看数与点赞数相关性（散点图）分析观看数和点赞数的关系识别异常高点赞率的视频4. 📅 发布时间趋势（折线图）按月份展示视频发布数量支持点击查看月度详细数据⭐ 新功能5. 📺 热门频道（横向柱状图）展示发布视频最多的前 10 个频道支持点击跳转到 YouTube 频道⭐ 新功能6. 🏷️ 热门标签（词云图）展示最常用的标签字体大小表示使用频率7. 🎯 参与度指标（雷达图）综合评估视频的互动表现包括观看、点赞、评论等多个维度8. 📊 观看数分布（饼图）按观看数区间展示视频占比识别热门视频的比例导出报告系统支持一键导出分析报告。导出步骤：1. 在分析仪表板页面，点击"📥 导出报告"按钮2. 系统会生成包含所有统计数据的报告3. 报告以 JSON 格式保存，包含：总体统计数据前 20 个热门视频前 10 个热门频道前 20 个热门标签🔧 高级功能时间范围筛选详解深入理解时间范围过滤的工作原理。三层筛选机制：第一层：YouTube API 服务器端过滤 ↓ 参数：publishedAfter = "2024-05-24T00:00:00Z" 作用：YouTube 只返回此日期之后发布的视频 优势：减少数据传输，节省配额第二层：客户端时长筛选 ↓ 条件：duration_seconds <= 60 作用：确保只收集真正的 YouTube Shorts 原因：API 的 "short" 参数包含 0-4 分钟视频第三层：客户端数量限制 ↓ 条件：len(collected) >= max_results 作用：确保不超过用户设置的最大结果数计算示例：假设当前时间为 2025-11-20，用户输入时间范围为 180 天：from datetime import datetime, timedelta# 当前时间now = datetime.now() # 2025-11-20 00:00:00# 计算 180 天前days = 180published_after = (now - timedelta(days=180)).isoformat() + 'Z'# 结果published_after = "2024-05-24T00:00:00Z"# 传递给 YouTube APIsearch_params['published_after'] = "2024-05-24T00:00:00Z"数据格式说明shorts.json 文件采用 JSON 数组格式存储视频数据。数据结构示例：[ { "video_id": "Wo_3-OTOOGA", "title": "ROUBE UM BRAINROT ao VIVO #roblox", "channel_id": "UCrbsOc3NRxMHPu_TjrdrBoQ", "channel_title": "Gxstavo7", "published_at": "2025-11-19T14:58:25Z", "duration_seconds": 56, "view_count": 5201, "like_count": 344, "comment_count": 0 }, { "video_id": "abc123xyz", "title": "Another Video", ... }]字段说明：字段名类型说明video_id字符串YouTube 视频唯一标识符title字符串视频标题channel_id字符串频道唯一标识符channel_title字符串频道名称published_at字符串发布时间（ISO 8601 格式）duration_seconds整数视频时长（秒）view_count整数观看次数like_count整数点赞次数comment_count整数评论次数API Key 存储机制为了便利性和基本安全性，系统会保存您的 API Key。存储位置：文件名：api_key.txt开发模式：D:\Source\python\youtube3-fnally\api_key.txt打包后：与 exe 文件同目录存储方式：使用 Base64 编码（基本隐私保护）：# 保存时import base64encoded = base64.b64encode(api_key.encode()).decode()# 存储到文件# 加载时import base64api_key = base64.b64decode(encoded.encode()).decode()# 自动填充到输入框Base64 不是加密，只是编码。任何人都可以解码还原原始 API Key。请妥善保管您的 api_key.txt 文件。❓ 常见问题 (FAQ)Q1: 如何获取 YouTube API Key？A:访问 Google Cloud Console → 创建项目 → 启用 YouTube Data API v3 → 创建凭据 → API 密钥。详细步骤请参考"数据收集详解 - API Key 获取"章节。Q2: API 配额限制是多少？A:YouTube Data API v3 默认每天 10,000 单位配额。每次搜索请求消耗约 100 单位，获取视频详情每 50 个视频消耗 1 单位。建议合理规划使用量。Q3: 为什么收集的视频少于设置的数量？A:可能原因：1) 该关键词的 Shorts 视频总数不足；2) 时长筛选（>60秒的被过滤）；3) 时间范围限制（超出时间范围的被过滤）；4) API 配额不足。Q4: 数据文件保存在哪里？A:开发模式下保存在脚本所在目录，打包后保存在 exe 文件同目录。文件名为 shorts.json 和 shorts.preview.json。Q5: 如何备份数据？A:直接复制 shorts.json 文件到其他位置即可。也可以使用"导出报告"功能生成摘要报告。Q6: API Key 保存在哪里？安全吗？A:保存在 api_key.txt 文件中，使用 Base64 编码（基本隐私保护，不是加密）。建议不要将此文件分享给他人。Q7: 如何查看特定月份的数据？A:在分析仪表板中，点击"发布时间趋势"图表上的任意月份点，即可打开该月份的专属分析页面。Q8: 为什么现在不需要手动加载 JSON 文件了？A:v2.0 版本引入了 localStorage 自动加载机制。主页面加载数据时会自动保存到浏览器本地存储，分析页面打开时自动读取，无需手动操作。Q9: 时间范围过滤和时间轴点击有什么区别？A:时间范围过滤是在数据收集阶段限制收集的时间范围（例如只收集最近180天的视频）。时间轴点击是在已收集的数据中筛选查看特定月份的分析结果。Q10: 分页功能如何使用？A:在热门视频列表上方，选择每页显示数量（10/20/50/100），然后使用"上一页"/"下一页"按钮浏览。系统会智能显示可用的导航按钮。📝 更新日志v2.0 (2025-11-20)重大更新：✅时间范围过滤器：在数据收集阶段支持按天数过滤（留空=所有时间，填写天数=最近N天）✅localStorage 自动加载：分析页面自动从浏览器本地存储加载数据，无需手动导入文件✅分页功能：热门视频列表支持 10/20/50/100 条分页浏览，智能按钮显示✅时间轴点击查看月度数据：点击时间轴上的月份可以打开该月份的详细分析页面✅热门频道点击跳转：点击"热门频道"图表的柱状图可以直接跳转到 YouTube 频道页面✅中文界面优化：所有 UI 文本中文化（数据保持原始语言）✅移除过时提示框：移除了"请手动加载 JSON 文件"的成功提示框，简化操作流程✅API Key 自动记忆：首次输入后自动保存，下次启动自动填充✅完整使用手册：提供本 HTML 格式的交互式使用手册改进：🔧 优化数据收集流程，支持三层筛选机制🔧 改进分析仪表板布局和交互体验🔧 增强错误提示信息的清晰度🔧 优化 API 配额使用效率修复：🐛 修复变量重复声明导致的 JavaScript 错误🐛 修复 CORS 策略阻止文件访问的问题（改用 localStorage）🐛 修复分页按钮显示逻辑v1.0初始版本：✅ 基本数据收集功能✅ HTML 分析仪表板✅ 8 个数据可视化图表✅ 卡密授权系统✅ 导出报告功能