alchaincyf/huashu-skills / huashu-douyin-script
huashu-douyin-script
Flagged抖音爆款脚本创作工作流。从竞品视频拆解到脚本生成的完整流程:下载抖音视频→Gemini视频分析→爆款公式提炼→脚本+分镜生成→AI味审校。 当用户提到"抖音脚本"、"爆款拆解"、"竞品分析"、"带货脚本"、"千川素材"、"种草脚本"、"视频拆解"、"抖音视频分析"时使用此技能。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 13.4 KB |
| install.shexecutable | script | 1.9 KB |
| references/analysis-dimensions.md | markdown | 6.0 KB |
| references/proven-formulas.md | markdown | 6.6 KB |
| references/script-style-samples.md | markdown | 7.0 KB |
| scripts/analyze_video.py | script | 7.7 KB |
| scripts/download_douyin.py | script | 7.2 KB |
scripts/download_douyin.py
View on GitHub#!/usr/bin/env python3
# /// script
# requires-python = ">=3.10"
# dependencies = []
# ///
"""
抖音视频下载工具。
使用 yt-dlp + cookies 下载无水印视频。
支持短链、分享链接、页面链接、从分享文本中提取URL。
Usage:
uv run download_douyin.py --urls "https://v.douyin.com/xxx" "https://www.douyin.com/video/123"
uv run download_douyin.py --urls "7.56 复制打开抖音,看看【某某的作品】 https://v.douyin.com/xxx"
uv run download_douyin.py --output-dir /path/to/output
"""
import argparse
import json
import os
import re
import subprocess
import sys
from pathlib import Path
def clear_proxy_for_douyin():
"""清除代理环境变量,避免国内站点走代理导致失败。"""
proxy_vars = ['http_proxy', 'https_proxy', 'HTTP_PROXY', 'HTTPS_PROXY',
'all_proxy', 'ALL_PROXY']
cleared = []
for var in proxy_vars:
if var in os.environ:
del os.environ[var]
cleared.append(var)
if cleared:
print(f" 已清除代理环境变量: {', '.join(cleared)}", file=sys.stderr)
def extract_douyin_urls(texts: list[str]) -> list[str]:
"""从文本列表中提取抖音URL。支持短链、页面链接、分享文本中的URL。"""
url_pattern = re.compile(
r'https?://(?:v\.douyin\.com|www\.douyin\.com|www\.iesdouyin\.com)[^\s\'"<>]*'
)
urls = []
for text in texts:
text = text.strip()
# 如果本身就是URL
if re.match(r'^https?://', text) and 'douyin.com' in text:
urls.append(text.split('?')[0] if 'www.douyin.com/video/' in text else text)
else:
# 从分享文本中提取URL
found = url_pattern.findall(text)
urls.extend(found)
return urls
def extract_video_id(url: str) -> str:
"""尝试从URL中提取视频ID。"""
# 长链接格式:www.douyin.com/video/7xxxxxxxxx
match = re.search(r'douyin\.com/video/(\d+)', url)
if match:
return match.group(1)
# 短链接格式:v.douyin.com/xxx - 无法直接提取,用URL hash
return re.sub(r'[^\w]', '', url)[-12:]
def download_video(url: str, output_dir: Path, index: int, cookies_browser: str) -> dict:
"""用 yt-dlp 下载单个抖音视频。"""
video_id = extract_video_id(url)
output_template = str(output_dir / f"douyin-{index}-{video_id}.%(ext)s")
cmd = [
"yt-dlp",
"--cookies-from-browser", cookies_browser,
"--output", output_template,
"--no-warnings",
"--proxy", "", # 强制不使用代理(国内站点)
"--no-check-certificates",
url
]
print(f" [{index}] 下载中: {url}", file=sys.stderr)
try:
result = subprocess.run(
cmd,
capture_output=True,
text=True,
timeout=180
)
if result.returncode != 0:
error_msg = result.stderr.strip() or "未知错误"
# 检查常见错误
if "cookies" in error_msg.lower() or "login" in error_msg.lower():
error_msg = f"需要登录Cookie: {error_msg[:200]}"
elif "not found" in error_msg.lower() or "unavailable" in error_msg.lower():
error_msg = f"视频不存在或已删除: {error_msg[:200]}"
print(f" [{index}] 下载失败: {error_msg}", file=sys.stderr)
return {"url": url, "success": False, "error": error_msg}
# 查找下载的文件
downloaded = list(output_dir.glob(f"douyin-{index}-{video_id}.*"))
video_files = [f for f in downloaded if f.suffix.lower() in ('.mp4', '.webm', '.mkv', '.flv')]
if video_files:
file_path = str(video_files[0])
size_mb = video_files[0].stat().st_size / (1024 * 1024)
print(f" [{index}] 下载成功: {video_files[0].name} ({size_mb:.1f}MB)", file=sys.stderr)
return {"url": url, "success": True, "path": file_path, "size_mb": round(size_mb, 1)}
else:
print(f" [{index}] 下载完成但未找到视频文件", file=sys.stderr)
return {"url": url, "success": False, "error": "下载完成但未找到视频文件"}
except subprocess.TimeoutExpired:
print(f" [{index}] 下载超时(180秒)", file=sys.stderr)
return {"url": url, "success": False, "error": "下载超时(180秒)"}
except FileNotFoundError:
print(f" [{index}] 未找到yt-dlp,请安装: pip install yt-dlp 或 brew install yt-dlp", file=sys.stderr)
return {"url": url, "success": False, "error": "未安装yt-dlp"}
def main():
parser = argparse.ArgumentParser(description="抖音视频下载工具")
parser.add_argument(
"--urls", "-u", nargs="+", required=True,
help="抖音视频URL(1-5个),支持短链、页面链接、分享文本"
)
parser.add_argument(
"--output-dir", "-o",
default=str(Path.cwd() / "_temp" / "douyin-downloads"),
help="输出目录(默认:当前目录/_temp/douyin-downloads/)"
)
parser.add_argument(
"--cookies-browser", "-c", default="chrome",
help="从哪个浏览器提取cookies(默认:chrome)"
)
args = parser.parse_args()
# 提取URL
urls = extract_douyin_urls(args.urls)
if not urls:
print("错误:未从输入中提取到有效的抖音URL", file=sys.stderr)
print("支持的格式:", file=sys.stderr)
print(" - https://v.douyin.com/xxx(短链)", file=sys.stderr)
print(" - https://www.douyin.com/video/123(页面链接)", file=sys.stderr)
print(" - 分享文本(包含URL的文本)", file=sys.stderr)
sys.exit(1)
if len(urls) > 5:
print(f"警告:输入了{len(urls)}个URL,仅处理前5个", file=sys.stderr)
urls = urls[:5]
# 清除代理(国内站点不走代理)
clear_proxy_for_douyin()
# 创建输出目录
output_dir = Path(args.output_dir)
output_dir.mkdir(parents=True, exist_ok=True)
print(f"准备下载 {len(urls)} 个视频到 {output_dir}", file=sys.stderr)
print(f"使用 {args.cookies_browser} 浏览器Cookie", file=sys.stderr)
print("", file=sys.stderr)
# 逐个下载
results = []
for i, url in enumerate(urls, 1):
result = download_video(url, output_dir, i, args.cookies_browser)
results.append(result)
# 汇总结果
success_count = sum(1 for r in results if r["success"])
fail_count = len(results) - success_count
print("", file=sys.stderr)
print(f"下载完成:{success_count} 成功,{fail_count} 失败", file=sys.stderr)
if fail_count > 0:
print("", file=sys.stderr)
print("下载失败的视频可以尝试:", file=sys.stderr)
print(" 1. 确认Chrome浏览器已登录抖音", file=sys.stderr)
print(" 2. 使用 --cookies-browser edge/firefox 切换浏览器", file=sys.stderr)
print(" 3. 手动下载视频后放入输出目录", file=sys.stderr)
# JSON输出(供调用方解析)
output = {
"total": len(results),
"success": success_count,
"failed": fail_count,
"output_dir": str(output_dir),
"results": results
}
print(json.dumps(output, ensure_ascii=False, indent=2))
if __name__ == "__main__":
main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |