{"skill":{"slug":"douyin-scraper-v2","displayName":"抖音爆款爬虫 v2","summary":"爬取抖音热榜和搜索建议数据，支持关键词搜索、热榜获取、搜索建议等功能。无需登录即可使用。","description":"---\nname: douyin-scraper\ndescription: 爬取抖音热榜和搜索建议数据，支持关键词搜索、热榜获取、搜索建议等功能。无需登录即可使用。\nversion: 2.0.0\n---\n\n# 抖音爆款爬虫 Skill\n\n## 功能概述\n\n获取抖音热榜和搜索数据。当前版本使用抖音 Web API，**无需登录**。\n\n## 功能特性\n\n- 🔥 **热榜获取** - 获取当前抖音热搜榜 (无需登录)\n- 🔍 **关键词搜索** - 在热榜中匹配关键词 + 获取搜索建议 (无需登录)\n- 💡 **搜索建议** - 获取关键词联想 (无需登录)\n\n## ⚠️ 重要说明\n\n抖音搜索 API 需要登录态，当前版本在**无登录**环境下使用以下替代方案：\n- 热榜 API：直接获取当前热搜话题\n- 搜索建议 API：获取关键词联想\n- 搜索时：先在热榜中匹配，再补充搜索建议\n\n如需完整搜索功能，需要提供抖音登录 Cookie。\n\n## 安装\n\n```bash\ncd <skill-dir>\nnpm install\n```\n\nPlaywright 浏览器（可选，用于完整搜索）:\n```bash\nnpx playwright install chromium\n```\n\n## 使用方法\n\n### Node.js 版本\n\n```bash\n# 搜索关键词\nnode scripts/douyin_scraper.js search \"海鲜\" 20\n\n# 获取热榜\nnode scripts/douyin_scraper.js hot 50\n\n# 获取搜索建议\nnode scripts/douyin_scraper.js suggest \"海鲜售卖\"\n\n# 保存到文件\nnode scripts/douyin_scraper.js search \"海鲜\" 10 --output result.json\n```\n\n### Python 版本\n\n```bash\n# 搜索关键词\npython scripts/scraper.py search --keyword \"海鲜\" --limit 20\n\n# 获取热榜\npython scripts/scraper.py hot --limit 50\n\n# 获取搜索建议\npython scripts/scraper.py suggest --keyword \"海鲜售卖\"\n```\n\n## 自然语言处理指南\n\n当用户用自然语言请求抖音相关数据时，按以下规则解析：\n\n### 搜索意图识别\n\n| 用户说法 | 意图 | 命令 |\n|---------|------|------|\n| 搜索一下海鲜视频 / 找一些海鲜视频 | 搜索 | `search \"海鲜\"` |\n| 看看抖音热榜 / 抖音最近什么火 | 热榜 | `hot` |\n| 海鲜相关的搜索建议 | 建议 | `suggest \"海鲜\"` |\n| 海鲜售卖视频文案 | 搜索 | `search \"海鲜售卖\"` |\n| 分析这个视频链接 xxx | 暂不支持 | 提示用户 |\n\n### 关键词提取\n\n从自然语言中提取关键词：\n- \"搜索一下**海鲜**视频\" → 关键词: `海鲜`\n- \"找一些**海鲜售卖**相关的视频\" → 关键词: `海鲜售卖`\n- \"**小龙虾**怎么做\" → 关键词: `小龙虾`\n- \"最近**美食**领域什么火\" → 关键词: `美食` (搜索热榜匹配)\n\n### 执行流程\n\n1. 解析用户意图 (搜索/热榜/建议)\n2. 提取关键词\n3. 执行对应命令\n4. 格式化展示结果\n\n## 输出数据格式\n\n### 搜索结果\n\n```json\n{\n  \"keyword\": \"海鲜\",\n  \"matched_hot\": [\n    {\n      \"rank\": 1,\n      \"word\": \"海鲜话题\",\n      \"hot_value\": 5000000,\n      \"video_count\": 10\n    }\n  ],\n  \"suggestions\": [\n    { \"word\": \"海鲜小哥\", \"group_id\": \"xxx\" }\n  ],\n  \"hot_list\": [...],\n  \"note\": \"在热榜中找到 1 个匹配话题\"\n}\n```\n\n### 热榜数据\n\n```json\n[\n  {\n    \"rank\": 1,\n    \"word\": \"热搜话题\",\n    \"hot_value\": 12000000,\n    \"video_count\": 6,\n    \"group_id\": \"xxx\",\n    \"sentence_id\": \"xxx\"\n  }\n]\n```\n\n## 注意事项\n\n1. **请求频率** - 避免频繁调用，建议间隔 >5 秒\n2. **数据用途** - 仅供学习和研究\n3. **API 限制** - 搜索 API 需登录，热榜和建议 API 无需登录\n4. **IP 风控** - 异常请求可能导致 IP 被限\n\n## 故障排除\n\n| 问题 | 解决方案 |\n|------|---------|\n| API 返回 2483 | 搜索需要登录，使用 `hot` 或 `suggest` 替代 |\n| 网络超时 | 检查网络连接，重试 |\n| 无匹配结果 | 关键词可能不在热榜，尝试 `suggest` 获取相关词 |\n","topics":["抖音"],"tags":{"latest":"2.0.1"},"stats":{"comments":0,"downloads":579,"installsAllTime":21,"installsCurrent":0,"stars":0,"versions":6},"createdAt":1778348505660,"updatedAt":1780890571368},"latestVersion":{"version":"2.0.1","createdAt":1780890571368,"changelog":"v2.0.1: 重写为真实API, 支持热榜/搜索建议/关键词搜索, 无需登录, 支持自然语言入口","license":"MIT-0"},"metadata":null,"owner":{"handle":"terrycarter1985","userId":"s17brwfrqyjhbjgadkvar20h8x8492g8","displayName":"terrycarter1985","image":"https://avatars.githubusercontent.com/u/1542987?v=4"},"moderation":null}