:從安裝配置到評論采集與轉(zhuǎn)寫的上手指南)
抖音批量下載實戰(zhàn)從安裝配置到評論采集與轉(zhuǎn)寫的上手指南【免費下載鏈接】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)作者近 30 天的作品連同 BGM、封面和元數(shù)據(jù)一起歸檔到本地時你通常要做的是逐條復(fù)制鏈接、逐個等待下載、手動重命名、再自建檔案。抖音批量下載是可以完整交給工具完成的任務(wù)。本文以開源項目 douyin-downloader 為例。它是一套命令行加配置文件驅(qū)動的抖音批量下載工具支持視頻、圖集、合集、音樂的無水印獲取提供 SQLite 去重、增量下載與瀏覽器兜底配套的圖形化桌面端叫 Douzy兩者共享同一套下載后端。 能力速覽一次拉全一個主頁它處理的是一次拉全的任務(wù)指定創(chuàng)作者主頁后它分頁抓取作品列表自動挑選無水印源并按最高碼率下載與手動復(fù)制鏈接不同你可以直接給出主頁地址做全量拉取。每個作品可同時產(chǎn)出封面、背景音樂、元數(shù)據(jù) JSON、評論 JSON 和語音轉(zhuǎn)寫文件。SQLite 歷史記錄與磁盤文件雙重檢查負責(zé)去重和增量分頁被風(fēng)控攔截時會自動啟動瀏覽器兜底。桌面端 Douzy 把同一后端包進圖形化工作臺粘貼鏈接即可開始在任務(wù)中心查看每個任務(wù)的結(jié)果。? 最小安裝與首次運行環(huán)境要求是 Python 3.8macOS、Linux、Windows 均可運行??寺『髲?fù)制一份示例配置填好鏈接字段即可啟動git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt cp config.example.yml config.yml python run.py -c config.yml涉及收藏夾等登錄態(tài)內(nèi)容時先運行內(nèi)置的認證工具完成抖音登錄Cookie 會寫回配置文件python -m tools.cookie_fetcher --config config.yml。如果打算使用瀏覽器兜底再額外安裝 playwright 和 chromium 瀏覽器內(nèi)核。命令行參數(shù)也可以臨時覆蓋配置例如-u追加鏈接、-t調(diào)整并發(fā)。?? 關(guān)鍵配置鏈接、模式與增量開關(guān)完成一次批量下載只需要動五個配置項其余字段都有合理默認值完整字段清單和默認值見 config/default_config.pylink: [https://www.douyin.com/user/MS4wLjABxxxx] # 主頁或單作品鏈接 mode: [post] # post/like/mix/music 可組合 number: {post: 0} # 0 表示不限 increase: {post: true} # 增量下載跳過已有 thread: 5 # 并發(fā)數(shù)link 可以是主頁、單作品、合集或音樂鏈接程序會自動識別類型mode 決定抓取內(nèi)容類型可一次指定多個同一作品在不同模式間自動去重。number 按模式分別限額start_time 和 end_time 則用于按發(fā)布日期做時間過濾。 任務(wù)一批量拉取某賬號的全部作品與合集配置片段只抓最近 30 天的作品并拉全合集分頁被攔截時自動轉(zhuǎn)瀏覽器link: [https://www.douyin.com/user/MS4wLjABxxxx] mode: [post, mix] number: {post: 50, mix: 0} start_time: 2026-08-18 browser_fallback: {enabled: true, headless: false}預(yù)期產(chǎn)出folderstyle 為 true 時每個作品獨占一個目錄媒體與封面、BGM、元數(shù)據(jù)同目錄存放合集作品落在 mix/ 下Downloaded/旅行攝影日記/ ├── post/2026-08-20_黃昏延時_7341xxxx/{mp4, music.mp3, cover.jpg, data.json} └── mix/城市漫游路線合集_7342xxxx/任務(wù)跑完后下載目錄根部還有一份 download_manifest.jsonl 記錄本次任務(wù)的清單方便核對遺漏。 任務(wù)二只提取背景音樂與封面素材配置片段做音樂素材庫時把 mode 切到 music 并打開封面開關(guān)不需要下載視頻本體link: [https://www.douyin.com/user/MS4wLjABxxxx] mode: [music] music: true cover: true預(yù)期產(chǎn)出原聲文件落入作者目錄下的 music/ 子目錄封面留在各作品文件夾里Downloaded/旅行攝影日記/ ├── music/城市漫步_7343xxxx/track.mp3 └── post/2026-08-20_.../cover.jpgmusic 模式優(yōu)先取直接音頻源取不到時會退回第一個關(guān)聯(lián)作品的音頻所以產(chǎn)物數(shù)量可能與作品數(shù)略有差異。 任務(wù)三評論采集與語音轉(zhuǎn)寫做分析配置片段打開 comments 與 transcript 兩個開關(guān)即可轉(zhuǎn)寫調(diào)用 OpenAI Transcriptions 接口建議通過環(huán)境變量傳密鑰mode: [post] comments: {enabled: true, max_comments: 200} transcript: {enabled: true, model: gpt-4o-mini-transcribe, response_formats: [txt, json]}include_replies 設(shè)為 true 會額外抓取二級回復(fù)API 調(diào)用量會明顯增加按需開啟。預(yù)期產(chǎn)出評論和轉(zhuǎn)寫文件生成在媒體旁邊轉(zhuǎn)寫只對視頻作品生效狀態(tài)會記入數(shù)據(jù)庫的 transcript_job 表。桌面端任務(wù)中心可以核對成功與失敗數(shù)量并直接打開輸出目錄post/2026-08-20_街頭采訪_7344xxxx/ ├── video.mp4 ├── video_comments.json └── video_transcript.txt / video_transcript.json 文件組織與數(shù)據(jù)機制命名模板與 SQLite 去重默認布局是作者目錄之下再按模式分一層Downloaded/ └── 旅行攝影日記/ # author_dir: nickname / sec_uid / nickname_uid ├── post/{date}_{title}_{id}/ └── like/ mix/ music/ collect/ dy_downloader.db # 下載歷史位于工作目錄filename_template 與 folder_template 支持 {id}、{title}、{date}、{type} 等變量變量白名單和渲染規(guī)則見 utils/naming.py模板里帶 {id} 是避免重名覆蓋的關(guān)鍵。author_dir 可選昵稱、sec_uid 或昵稱_uid最后一項兼顧直觀與唯一。去重靠數(shù)據(jù)庫記錄 本地文件雙重檢查increase 為 true 時只有磁盤上主媒體非空的作品才會被跳過刪掉本地文件下一次運行就會重新下載數(shù)據(jù)庫記錄本身不會阻止新下載。想強制重下全部內(nèi)容需要把目錄和數(shù)據(jù)庫一并清理。 高頻卡點排查分頁停在二十條左右就結(jié)束可能是作品列表請求觸發(fā)了平臺風(fēng)控翻頁被限制在前幾頁。處理方式是把 browser_fallback.enabled 設(shè)為 true、headless 設(shè)為 false在彈出的瀏覽器窗口里手動完成驗證并不要提前關(guān)閉窗口有桌面端的話它的請求經(jīng)由內(nèi)置登錄窗口發(fā)出可直接用于這類場景。請求返回 403 或數(shù)據(jù)為空可能原因有兩個Cookie 過期或?qū)?yīng)接口被平臺風(fēng)控限制單作品、合集、音樂與點贊收藏夾近兩個月已受簽名機制限制。先運行 cookie_fetcher 重新獲取認證仍無效時改用桌面端處理這類內(nèi)容或等待接口恢復(fù)。轉(zhuǎn)寫文件沒有生成按順序檢查transcript.enabled 是否為 true下載對象是否為視頻圖集不轉(zhuǎn)寫OPENAI_API_KEY 是否有效response_formats 里是否包含 txt 或 json。四項都正常仍無輸出時查一下數(shù)據(jù)庫里 transcript_job 表的錯誤信息。下載速度慢或頻繁超時可能是并發(fā)過高或網(wǎng)絡(luò)質(zhì)量差。把 thread 降到 3retry_times 提到 5必要時給 proxy 指定一個出口進度階段開著 progress.quiet_logs: true 即可保持日志干凈調(diào)試時用 -v 參數(shù)看詳細輸出。想強制重下某個作品程序把本地文件缺失視為需要重下而數(shù)據(jù)庫有記錄且文件在會繼續(xù)跳過。刪掉對應(yīng)作品文件夾目錄名包含 aweme_id后重跑即可要整體重下某個作者則清空該作者目錄并刪除數(shù)據(jù)庫里對應(yīng)記錄。從一條主頁鏈接到包含媒體、元數(shù)據(jù)、評論與轉(zhuǎn)寫的可復(fù)跑檔案任務(wù)douyin-downloader 把抖音批量下載變成日常操作??梢岳^續(xù)擴展 --search 關(guān)鍵詞檢索或 REST API 服務(wù)模式。本工具僅限個人學(xué)習(xí)、研究與數(shù)據(jù)管理用途請尊重創(chuàng)作者版權(quán)?!久赓M下載鏈接】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)作聲明:本文部分內(nèi)容由AI輔助生成(AIGC),僅供參考