SuperAPI AI 工具集

soia-pkm-clip-douyin

通用与其它

查看项目

更新于 10-16 09:48

技能介绍

用途:把单条抖音视频的元数据与文案沉淀为 Obsidian vault 内可检索的 Markdown 笔记,视频本体留在本机磁盘,避免大体积二进制进入 git 追踪的知识库。

主要能力:用一次性 headless Playwright 上下文匿名打开视频页,按内容递归匹配响应体中的 aweme_id,获取作者昵称/UID、文案、发布时间、时长、点赞/评论/收藏/转发等互动数据,并取 play_addr → play_addr_h264 → download_addr 直链;用标准库 urllib 流式下载 MP4 到 ~/Downloads/soia-pkm-clip-douyin/<video_id>/video.mp4,校验字节数与 MP4 magic bytes;按 frontmatter url: 去重,已归档则 SKIP;写入 frontmatter 与「原文」「摘要」「我的看法」等正文结构,文件名含日期、作者与文案片段。

使用方式:在 vault 根目录运行 python3 scripts/archive_douyin.py <URL>,不在 vault 内加 --vault <path>;支持 --metadata-only 跳过下载、--force 覆盖、--articles-dir、--timeout。安装可整体装插件:claude plugin marketplace add soia-team/soia-open-skills 与 claude plugin install soia-pkm-vault@soia;单技能用 npx skills add soia-team/soia-open-pkm-vault-skills -g -a '*' -s soia-pkm-clip-douyin -y(与插件同时安装会出现两份索引,建议二选一)。vault 定位优先级为 CLI 参数、OBSIDIAN_VAULT、私有 config.yml、从 cwd 向上自动发现。

适用场景:需要把抖音内容转为可双链、可搜索的文字知识资产的个人知识库用户。

限制:强依赖 playwright,缺失时停止并提示 pip install playwright && python -m playwright install chromium;视频删除、私密、地区不可见或接口改版会拦截超时并报错;直链短时效,metadata-only 后需重新运行才能取视频;短链归档可能影响去重匹配。私密信息与中间数据规则、字段细节及回执格式以原资料为准。