作者主頁作品一次歸檔到本地素材庫)
抖音批量下載工具 douyin-downloader把創(chuàng)作者主頁作品一次歸檔到本地素材庫【免費下載鏈接】douyin-downloaderA practical Douyin downloader for both single-item and profile batch downloads, with progress display, retries, SQLite deduplication, and browser fallback support. 抖音批量下載工具去水印支持視頻、圖集、合集、音樂(原聲)。項目地址: https://gitcode.com/GitHub_Trending/do/douyin-downloader當你需要把某位創(chuàng)作者的全部作品、合集或賬號收藏夾歸檔到本地素材庫時douyin-downloader 是一個開源的抖音批量下載工具支持視頻、圖文、合集、音樂原聲的無水印下載內置增量去重、失敗重試、進度展示與瀏覽器兜底。項目能力全景一句話定位面向個人歸檔與素材管理的 CLI 工具同一套后端也支撐其桌面客戶端 Douzy內測中。核心能力多粒度批量下載作者主頁作品post、點贊like、合集mix、音樂原聲music以及登錄賬號收藏夾collect/collectmix無水印優(yōu)先自動選擇無水印視頻源并按video.bit_rate檔位挑選最高畫質雙重去重與增量下載SQLite 記錄 本地文件掃描只補下新作品瀏覽器兜底API 翻頁受限時啟動真實瀏覽器支持人工過驗證碼穩(wěn)定性機制指數(shù)退避重試1s/2s/5s、限速默認 2 請求/秒、Content-Length 完整性校驗可選擴展評論采集、OpenAI 轉寫、直播錄制、REST API 服務、完成通知推送快速跑通1. 安裝git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt瀏覽器兜底功能需要額外安裝 Playwright 與 Chromiumpip install playwright python -m playwright install chromium2. 配置復制示例配置字段說明見 config.example.yml填入你要下載的鏈接link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: [post] number: post: 0 # 0 表示不限數(shù)量 thread: 5 database: true3. 獲取 Cookie 并運行Cookie 用于解鎖點贊、收藏夾等登錄內容tools/cookie_fetcher.py 可自動完成抓取python -m tools.cookie_fetcher --config config.yml在彈出的瀏覽器中登錄抖音回到終端按 EnterCookie 會寫回配置文件。然后啟動下載python run.py -c config.yml命令行參數(shù)也可以直接追加鏈接與并發(fā)數(shù)例如python run.py -c config.yml -u 鏈接 -t 8 -p ./Downloaded。核心能力拆解下載邏輯位于 core/每種類型有獨立下載器統(tǒng)一由run.py調度。批量下載用 mode 選擇粒度mode決定掃描范圍post為作者發(fā)布的作品like為點贊作品mix為合集music為音樂原聲。number下按模式設置數(shù)量上限0表示全量。多模式可同時配置同一個 aweme_id 跨模式不會重復下載。收藏夾模式collect/collectmix僅對 Cookie 對應的登錄賬號生效且必須單獨使用不能與 post/like/mix/music 混用。關鍵配置mode: [post, mix] number: post: 50 mix: 0無水印源與畫質選擇下載時自動選擇無水印視頻源。抖音 API 為每個視頻返回多檔碼率video_quality決定選用哪一檔original會額外探測上傳原片比轉碼檔可能大數(shù)倍代價是多一次探測請求highest為默認的最高轉碼檔也支持指定1440p/1080p等分辨率匹配不到時自動降級。雙重去重與增量下載程序用數(shù)據庫記錄 本地文件雙重檢查判斷是否跳過只刪數(shù)據庫不刪文件不會觸發(fā)重下只刪文件不刪數(shù)據庫會觸發(fā)重下。開啟increase后每次運行只補下新內容increase: post: true database: true翻頁受限時用瀏覽器兜底當 API 翻頁被風控攔截時browser_fallback會啟動真實瀏覽器讀取頁面自己發(fā)出的作品列表請求并支持人工完成驗證碼。該機制目前僅對post模式做過完整驗證browser_fallback: enabled: true headless: false max_scrolls: 240可選擴展評論、轉寫與直播評論采集comments.enabled: true后每個作品旁生成*_comments.json可選拉取二級回復視頻轉寫transcript.enabled: true并配置OPENAI_API_KEY生成xxx.transcript.txt/json僅視頻圖文不轉寫直播錄制鏈接指向live.douyin.com/{room_id}時生效FLV 直接可播中斷時保留已錄字節(jié)關鍵配置速查最常改動的配置項匯總如下完整字段以 config.example.yml 為準。配置項作用示例值mode下載范圍post/like/mix/music收藏夾用 collect/collectmix[post]number.post等各模式數(shù)量上限0 為不限50increase.post等增量下載開關跳過已下載作品truethread并發(fā)下載數(shù)5retry_times失敗重試次數(shù)3proxyAPI 與媒體下載的 HTTP/HTTPS 代理http://127.0.0.1:7890database/database_path啟用 SQLite 去重與歷史true/dy_downloader.dbvideo_quality畫質選擇original/highest/lowest/指定分辨率highestbrowser_fallback.enabled翻頁受限時啟動瀏覽器兜底truestart_time/end_time按發(fā)布時間過濾格式 YYYY-MM-DD2025-01-01folderstyle/author_dir按作品建子目錄作者目錄命名方式true/nickname_uidfilename_template文件命名模板必須含{id}防重名{date}_{title}_{id}progress.quiet_logs進度階段靜默日志減少刷屏true典型工作流場景一把某創(chuàng)作者全部作品歸檔到本地第一步將鏈接填入linkmode設為[post]number.post設為 0 表示全量第二步開啟folderstyle: true并按author_dir: nickname_uid組織目錄文件按日期標題ID 命名第三步保持browser_fallback.enabled: true且headless: false運行時若彈出驗證窗口手動完成后再等待其繼續(xù)第四步運行python run.py -c config.yml下載完成后在Downloaded/作者名/post/下按作品分目錄查看并可用download_manifest.jsonl核對清單。場景二定期增量更新關注的主頁第一步首次全量下載后將increase.post保持為true且database: true第二步之后每次運行同一配置程序只下載新發(fā)布的作品磁盤上已存在主文件的會跳過第三步若需要重下某個作品刪除其本地目錄目錄名含 aweme_id并執(zhí)行sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id aweme_id;。場景三備份登錄賬號的收藏合集第一步用 cookie_fetcher 登錄目標賬號獲取 Cookie第二步鏈接填https://www.douyin.com/user/self?showTabfavorite_collectionmode設為[collect]或[collectmix]二選一單獨使用第三步運行后文件分別落入collect/與collectmix/目錄。注意收藏夾模式不支持增量截斷number中對應值設為 0 即拉取全部。常見問題與排障現(xiàn)象原因解法只能抓到約 20 個作品翻頁中斷抖音翻頁風控攔截了 API 分頁確保browser_fallback.enabled: true、headless: false彈窗出現(xiàn)后手動完成驗證不要過早關閉CLI 下載單個視頻/合集/音樂報 403ArgusSecurityPlugin自 2026-09 起這些接口需要真實網頁 SDK 生成的簽名CLI 直連請求無法攜帶點贊/收藏夾類自 2026-08 起同樣被攔截post 模式依賴瀏覽器兜底點贊、收藏、單視頻等內容改用桌面客戶端 Douzy見 ReleasesCookie 失效登錄類內容下載失敗Cookie 過期重新執(zhí)行python -m tools.cookie_fetcher --config config.yml進度條刷屏、日志重復日志未靜默保持progress.quiet_logs: true調試時臨時加--show-warnings或-v刪除文件后沒有重新下載數(shù)據庫記錄仍在去重以庫記錄 本地文件雙重判斷刪除記錄sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id id;轉寫文件未生成僅對視頻作品生效圖文不轉寫依次檢查transcript.enabled、OPENAI_API_KEY是否有效、response_formats是否含 txt/json進階玩法REST API 服務安裝fastapi uvicorn后執(zhí)行python run.py --serve --serve-port 8000通過POST /api/v1/download提交任務GET /api/v1/jobs/{job_id}查詢狀態(tài)熱搜與搜索python run.py --hot-board 30導出熱搜榜 JSONLpython run.py --search 關鍵詞 --search-max 100導出搜索結果完成通知notifications.providers支持 Bark / Telegram / Webhook企業(yè)微信、飛書、釘釘機器人 URL 同樣可用單個推送失敗不阻塞下載Docker 部署倉庫自帶 Dockerfile掛載config.yml與下載目錄即可運行douyin-downloader 把收集—去重—歸檔做成了可重復執(zhí)行的流程配置一次鏈接與模式之后靠增量下載持續(xù)同步配合數(shù)據庫記錄隨時可查、可重下。項目采用 MIT 協(xié)議請僅用于個人學習與數(shù)據管理。小貼士模板命名務必保留{id}變量避免不同作品重名互相覆蓋作者目錄推薦nickname_uid昵稱重名或改名時目錄不會錯亂。【免費下載鏈接】douyin-downloaderA practical Douyin downloader for both single-item and profile batch downloads, with progress display, retries, SQLite deduplication, and browser fallback support. 抖音批量下載工具去水印支持視頻、圖集、合集、音樂(原聲)。項目地址: https://gitcode.com/GitHub_Trending/do/douyin-downloader創(chuàng)作聲明:本文部分內容由AI輔助生成(AIGC),僅供參考