SuperAPI AI 工具集

twitter-media-downloader

通用与其它

查看项目

更新于 10-16 01:50

技能介绍

用途:从 X/Twitter 下载图片和视频,底层使用 gallery-dl。支持单条推文、用户时间线、用户媒体页、用户点赞、书签和列表等 URL 类型。

主要能力:可指定输出目录,按视频或图片过滤,限制下载数量,下载用户时间线时可包含转推和回复,并可用 --json 输出包含文件路径、推文 ID、输出目录、URL、成功状态和错误信息的结构化结果,便于与其他技能集成。

使用方式:运行 uv run scripts/download.py "URL" --output ./downloads。受保护内容(点赞、书签、私密账号)需认证,可用 --cookies /path/to/cookies.txt,或推荐用 --browser firefox 自动提取浏览器 cookies。常用选项包括 --output、--cookies、--browser、--videos-only、--images-only、--limit、--retweets、--replies、--json、--debug。文件命名格式为 {output_dir}/twitter_{username}{tweet_id}{num}.{ext}。

限制与排错:可能遇到速率限制,可用 --sleep 2 增加延迟;需要登录时使用 cookies 或浏览器认证;视频下载缺失时需确保已安装 yt-dlp;可用 --debug 获取详细输出。具体依赖版本、平台支持范围及收费情况暂未提供。