用途:面向短剧创作者与 MCN 运营,按关键词扫描抖音上跑量较猛的短剧作品,把标题和点赞铺成终端表格,再按题材聚类成一份可用于定选题、对标拍片的短剧日报。
主要能力:抓取爆款短剧列表并渲染 Markdown 表格(核心字段为 title、likeCount);支持翻页与每页条数;按题材方向聚类,如战神、复仇、甜宠、重生、赘婿等;输出一句选题洞察。
使用方式:先设置环境变量 export DOUBAOYA_API_KEY="dyh_你的口令",口令需登录 doubaoya.com 后在口令中心生成。调用脚本:python3 "$SKILL_PATH/scripts/fetch_playlet_feed.py" "短剧";翻页可用 python3 "$SKILL_PATH/scripts/fetch_playlet_feed.py" "古装短剧" --page 2 --size 30。接口为 POST https://doubaoya.com/api/apis/douyin/douyin-playlet-feed/call,鉴权头 Authorization: Bearer $DOUBAOYA_API_KEY,请求体为 {"keyword": "短剧", "pageNum": 1, "pageSize": 20}。
限制与注意:keyword 必填,一次只扫一个关键词;先判断返回信封 success 为 true 再读 data,否则读 error.code 与 error.message。常见错误包括 401 口令缺失或无效、400 参数不合法、402 额度不足、502 上游临时故障(已自动退款,可安全重试)。脚本零依赖(urllib),失败时向 stderr 打印 [error] CODE: message 并退出码 1。口令绝不能打印、写入文件或回显。字段可能缺失,缺失应留空,不要臆造链接或作者。