← Back to Skills Marketplace
terrycarter1985

抖音爆款爬虫 Pro

by terrycarter1985 · GitHub ↗ · v2.0.0 · MIT-0
cross-platform ⚠ suspicious
42
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install douyin-scraper-pro
Description
爬取抖音爆款视频和文案数据,支持自然语言搜索请求。使用 Playwright 自动化浏览器操作,支持搜索关键词、获取热榜、提取视频信息和文案。
README (SKILL.md)

抖音爆款爬虫 Skill

Agent 指南:自然语言解析

当用户用自然语言发请求时,按以下规则提取参数并执行对应命令:

请求类型识别

用户说法示例 类型 命令
搜索一下海鲜视频 / 找一些海鲜售卖的视频 / 帮我搜海鲜 search search --keyword "\x3C关键词>"
看看抖音热榜 / 热榜有什么 / 抖音热搜 hot hot
分析这个视频链接 https://v.douyin.com/xxx analyze analyze --url "\x3Curl>"

关键词提取规则

  1. 去掉无意义动词/助词:「搜索一下」「帮我找」「看看」「有没有」
  2. 提取核心搜索词:「搜索一下海鲜视频」→ keyword=海鲜
  3. 如果用户指定数量则用之,否则默认 --limit 10
  4. 如果用户指定输出文件则用之,否则默认 stdout

执行方式

优先使用 Python 脚本(更稳定的数据提取):

cd {{SKILL_DIR}} && bash scripts/run.sh search --keyword "海鲜" --limit 10

如果 Python 环境不可用,回退到 Node.js:

cd {{SKILL_DIR}} && node scripts/douyin_scraper.js search "海鲜" 10

输出解读

脚本输出 JSON 数组,每个元素包含:

  • title — 视频标题
  • description — 视频描述/文案
  • author — 作者昵称
  • play_count / like_count / comment_count / share_count — 互动数据
  • url — 视频链接
  • tags — 标签列表
  • publish_time — 发布时间

Agent 应将结果整理为用户友好的格式呈现,而非直接 dump JSON。

完整命令参考

搜索

# Python
bash scripts/run.sh search --keyword "海鲜" --limit 10
bash scripts/run.sh search --keyword "海鲜售卖" --limit 20 --output result.json

# Node.js
node scripts/douyin_scraper.js search "海鲜" 10

热榜

# Python
bash scripts/run.sh hot --limit 20
bash scripts/run.sh hot --category "美食" --limit 20

# Node.js
node scripts/douyin_scraper.js hot 20

分析视频链接

bash scripts/run.sh analyze --url "https://v.douyin.com/xxxxx/"

安装

首次使用前需安装依赖:

cd {{SKILL_DIR}}
pip install playwright
playwright install chromium

或使用 Node.js:

cd {{SKILL_DIR}}
npm install
npx playwright install chromium

注意事项

  • 遵守抖音平台规则,合理使用,避免频繁请求
  • 请求之间有默认 2 秒延时
  • 数据仅供学习研究使用
  • 不要登录账号,避免风控
  • 注意 IP 限制风险
Usage Guidance
Install only if you are comfortable with a skill that can run Playwright browser automation, install local dependencies, and write export files. Use it only for Douyin URLs, avoid logging into accounts, review output paths before saving, and consider adding URL allowlisting before using the analyze command.
Capability Assessment
Purpose & Capability
Search, hot-list scraping, metadata extraction, Playwright use, dependency installation, and optional exports fit the stated Douyin scraper purpose, but the Python analyze command accepts and opens any URL instead of limiting itself to Douyin video links.
Instruction Scope
Natural-language triggers include broad phrases such as generic search and link analysis, and there is no confirmation or domain validation before launching browser automation for a supplied URL.
Install Mechanism
The install flow is disclosed and mostly conventional for Playwright: it creates a virtual environment, installs Playwright, installs Chromium, optionally runs npm install, and includes a separate Docker helper. These are setup side effects users should expect to review.
Credentials
Browser automation is expected for scraping Douyin, but the scripts launch Chromium with no-sandbox flags and the analyze command can navigate to non-Douyin URLs, making the network/browser capability broader than necessary.
Persistence & Privilege
The skill creates a local venv, generated run script, Playwright browser files, and optional output files. It does not show credential access, background persistence, account login, or automatic exfiltration.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install douyin-scraper-pro
  3. After installation, invoke the skill by name or use /douyin-scraper-pro
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.0.0
v2: 真实数据提取(移动端 Playwright)、自然语言搜索支持、analyze 子命令、过滤广告
Metadata
Slug douyin-scraper-pro
Version 2.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is 抖音爆款爬虫 Pro?

爬取抖音爆款视频和文案数据,支持自然语言搜索请求。使用 Playwright 自动化浏览器操作,支持搜索关键词、获取热榜、提取视频信息和文案。 It is an AI Agent Skill for Claude Code / OpenClaw, with 42 downloads so far.

How do I install 抖音爆款爬虫 Pro?

Run "/install douyin-scraper-pro" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is 抖音爆款爬虫 Pro free?

Yes, 抖音爆款爬虫 Pro is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does 抖音爆款爬虫 Pro support?

抖音爆款爬虫 Pro is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created 抖音爆款爬虫 Pro?

It is built and maintained by terrycarter1985 (@terrycarter1985); the current version is v2.0.0.

💬 Comments