SuperAPI AI 工具集

soia-pkm-clip-douyin

通用与其它

查看项目

更新于 10-16 09:29

技能介绍

用途:把单条抖音视频的元数据与文案沉淀进 Obsidian vault,便于检索和双链;视频本体留在本机磁盘,不放进 git 追踪的知识库。

主要能力:用 Playwright 无头浏览器拦截抖音签名接口,递归匹配目标 aweme_id 的响应,取作者、文案、发布时间、时长、互动数及视频直链;按 play_addr→play_addr_h264→download_addr 顺序尝试下载;MP4 落地 ~/Downloads/soia-pkm-clip-douyin/<video_id>/video.mp4,vault 笔记仅存本地路径索引;按 frontmatter url 去重,重复归档默认 SKIP。

用法:在 vault 根目录执行 python3 scripts/archive_douyin.py <URL>,不在 vault 内时加 --vault <path>;仅抓元数据可加 --metadata-only;覆盖已归档加 --force;拦截超时可用 --timeout。安装依赖:pip install playwright && python -m playwright install chromium。安装技能:npx skills add soia-team/soia-open-pkm-clip-skills -g -a '*' -s soia-pkm-clip-douyin -y。

配置:vault 与文章目录按命令行参数、环境变量 OBSIDIAN_VAULT/OBSIDIAN_ARTICLES、私有 config.yml、向上自动发现 vault 的顺序定位。

限制:依赖真实浏览器拦截,无纯 HTTP 取数方式;--metadata-only 后需重新完整运行才能获得视频;短链去重可能失效,建议用完整 /video/<id> 链接;接口改版、视频私密或地区不可见时会明确报错。签名直链含 token,不写入 vault、日志或标准输出。