requestsとBeautifulSoupで作るTikTok動画ダウンローダープロジェクト

python -m venv myenv

myenv\Scripts\activate

python3 -m venv myenv

source myenv/bin/activate

requests==2.32.3
beautifulsoup4==4.13.4

pip install -r requirements.txt

# 必要なライブラリをインポート
import os  # ファイルやフォルダの操作に使用
import requests  # HTTP通信（ウェブとのやり取り）に使用
from bs4 import BeautifulSoup  # HTMLの解析に使用

class TikTokDownloader:
    def __init__(self, output_directory="downloaded_videos"):
        """
        TikTokDownloaderクラスを初期化する関数
        output_directory: 動画を保存するフォルダ名（初期値は"downloaded_videos"）
        """
        # 動画を保存するフォルダの名前を設定
        self.output_folder = output_directory
        
        # フォルダが存在しない場合は新しく作成
        # exist_ok=Trueにすることで、既にフォルダがあってもエラーにならない
        os.makedirs(self.output_folder, exist_ok=True)
        
        # API設定を初期化する関数を呼び出し
        self.setup_api_config()
        
        # 初期化完了のメッセージを表示
        print(f"TikTokDownloader初期化完了 - 保存先: {self.output_folder}")

    def setup_api_config(self):
        """
        API通信用の設定を準備する関数
        TikTok動画の情報を取得するためのAPIとヘッダー情報を設定
        """
        # TikTok動画の情報を取得するAPIのURL
        self.api_endpoint = "https://savetik.co/api/ajaxSearch"
        
        # HTTP通信で送信するヘッダー情報（ブラウザのふりをするため）
        self.request_headers = {
            # サーバーに「どんなデータでも受け取ります」と伝える
            'Accept': '*/*',
            # 「英語を優先して受け取ります」と伝える
            'Accept-Language': 'en-US,en;q=0.9',
            # 「フォームデータの形式で送信します」と伝える
            'Content-Type': 'application/x-www-form-urlencoded',
            # リクエストの送信元サイトを指定
            'Origin': 'https://savetik.co',
            # リクエストの優先度を設定
            'Priority': 'u=1, i',
            # 「このページからアクセスしました」という情報
            'Referer': 'https://savetik.co/en2',
            # ブラウザの種類とバージョンを伝える
            'Sec-Ch-Ua': '"Not/A)Brand";v="8", "Chromium";v="126", "Google Chrome";v="126"',
            # 「モバイル端末ではありません」と伝える
            'Sec-Ch-Ua-Mobile': '?0',
            # 使っているOSの情報を伝える
            'Sec-Ch-Ua-Platform': '"Windows"',
            # リクエストの目的地を指定
            'Sec-Fetch-Dest': 'empty',
            # CORS（別サイトへの）リクエストであることを示す
            'Sec-Fetch-Mode': 'cors',
            # 同じサイト内でのリクエストであることを示す
            'Sec-Fetch-Site': 'same-origin',
            # ブラウザの詳細な情報（Chrome126を使っているように見せる）
            'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36',
            # AjaxリクエストであることをAPIに知らせる
            'X-Requested-With': 'XMLHttpRequest'
        }
        
        # 設定完了のメッセージを表示
        print("API設定完了")

    def check_connection(self):
        """
        API接続のテストを行う関数
        設定したAPIに実際に接続できるかを確認
        """
        try:
            # テスト用のダミーデータを準備
            test_data = {
                'q': 'https://www.tiktok.com/@test/video/test',  # テスト用URL
                'lang': 'en'  # 言語設定
            }
            
            # APIに実際にPOSTリクエストを送信してテスト
            response = requests.post(
                self.api_endpoint,  # 送信先のAPI URL
                data=test_data,  # 送信するデータ
                headers=self.request_headers,  # 送信するヘッダー情報
                timeout=10  # 10秒でタイムアウト
            )
            # responseにはサーバーからの返事が入っている
            
            # ステータスコードを確認（200なら成功、それ以外はエラー）
            if response.status_code == 200:
                print("✓ API接続テスト成功")
                return True  # 成功を表すTrueを返す
            else:
                print(f"✗ API接続エラー - ステータスコード: {response.status_code}")
                return False  # 失敗を表すFalseを返す
                
        except requests.exceptions.RequestException as error:
            # 通信エラーが発生した場合の処理
            print(f"✗ 接続テスト失敗: {error}")
            return False

    def handle_request_error(self, error, url):
        """
        HTTPリクエストで発生したエラーを処理する関数
        error: 発生したエラーの情報
        url: エラーが発生したURL
        """
        # HTTPエラー（400番台、500番台のエラー）の場合
        if isinstance(error, requests.exceptions.HTTPError):
            print(f"HTTPエラーが発生しました - URL: {url}")
            print(f"ステータスコード: {error.response.status_code}")
        # 接続エラー（ネットワークに繋がらない等）の場合
        elif isinstance(error, requests.exceptions.ConnectionError):
            print(f"接続エラーが発生しました - URL: {url}")
            print("ネットワーク接続を確認してください")
        # タイムアウトエラー（時間内に応答がない）の場合
        elif isinstance(error, requests.exceptions.Timeout):
            print(f"タイムアウトエラーが発生しました - URL: {url}")
            print("時間をおいて再度お試しください")
        # その他のリクエストエラーの場合
        elif isinstance(error, requests.exceptions.RequestException):
            print(f"リクエストエラーが発生しました - URL: {url}")
            print(f"エラー詳細: {error}")
        # 予期しないエラーの場合
        else:
            print(f"予期しないエラーが発生しました: {error}")

def main():
    """
    TikTokDownloaderの基本動作をテストする関数
    クラスが正しく動作するかを確認
    """
    # プログラムのタイトルを表示
    print("=== TikTok動画ダウンローダー 設定テスト ===")
    
    # TikTokDownloaderクラスのインスタンス（実体）を作成
    downloader = TikTokDownloader()
    
    # 接続テストを実行
    print("\n--- API接続テスト実行中 ---")
    connection_result = downloader.check_connection()
    
    # テスト結果によって異なるメッセージを表示
    if connection_result:
        print("\n✓ 全ての設定が正常に動作しています")
    else:
        print("\n✗ 設定に問題があります")
        print("ネットワーク接続やAPI設定を確認してください")

# このファイルが直接実行された時のみmain関数を呼び出す
if __name__ == "__main__":
    main()

python src/video_downloader.py

    def extract_download_url(self, tiktok_url):
        """
        TikTokの動画URLから実際のダウンロード用URLを取得する関数
        tiktok_url: TikTokの動画URL
        """
        try:
            # APIに送信するデータを辞書形式で準備
            request_data = {
                'q': tiktok_url,  # TikTokの動画URL
                'lang': 'en'      # 言語設定（英語）
            }
            
            # 処理開始のメッセージを表示
            print(f"動画URL解析開始: {tiktok_url}")
            
            # APIにPOSTリクエストを送信
            api_response = requests.post(
                self.api_endpoint,           # 送信先のAPIエンドポイント
                data=request_data,           # 送信するデータ
                headers=self.request_headers # 送信するヘッダー情報
            )
            
            # HTTPエラーが発生した場合は例外を投げる
            api_response.raise_for_status()
            
            # APIから受け取ったHTMLを解析して、ダウンロードリンクを探す
            download_link = self.parse_download_link(api_response.text)
            
            # ダウンロードリンクが見つかった場合
            if download_link:
                print(f"✓ ダウンロードURL取得成功")
                return download_link
            else:
                print("✗ ダウンロードURLが見つかりませんでした")
                return None  # 見つからない場合はNoneを返す
                
        # HTTPエラー（400番台、500番台）が発生した場合
        except requests.exceptions.HTTPError as http_error:
            print(f"HTTPエラーが発生: ステータスコード {api_response.status_code}")
            self.handle_request_error(http_error, tiktok_url)
            return None
        # その他の通信エラーが発生した場合
        except requests.exceptions.RequestException as request_error:
            print(f"リクエストエラーが発生: {request_error}")
            self.handle_request_error(request_error, tiktok_url)
            return None
        # 予期しないエラーが発生した場合
        except Exception as unexpected_error:
            print(f"予期しないエラーが発生: {unexpected_error}")
            return None

    def parse_download_link(self, html_content):
        """
        APIから取得したHTMLを解析してダウンロードリンクを見つける関数
        html_content: APIから受け取ったHTML文字列
        """
        try:
            # BeautifulSoupを使ってHTML文書を解析しやすい形に変換
            soup = BeautifulSoup(html_content, 'html.parser')
            
            # HTML内の全てのaタグ（リンクタグ）を取得
            all_link_tags = soup.find_all('a')
            
            # 見つかったリンクの数を表示
            print(f"検索対象のリンク数: {len(all_link_tags)}")
            
            # 各リンクタグを一つずつ確認
            for link_tag in all_link_tags:
                # リンクのテキスト内容を取得（前後の空白は削除）
                link_text = link_tag.text.strip()
                # リンクのclass属性を取得（ない場合は空のリスト）
                link_classes = link_tag.get('class', [])
                
                # 'Download MP4 HD'というテキストまたは'dl-success'クラスを持つリンクを探す
                if 'Download MP4 HD' in link_text or 'dl-success' in link_classes:
                    # href属性からダウンロードURLを取得
                    download_url = link_tag.get('href')
                    
                    # URLが存在する場合
                    if download_url:
                        print(f"ダウンロードリンク発見: {link_text}")
                        # URLに含まれる不要な文字（\"）を除去
                        cleaned_url = download_url.replace('\\"', '')
                        return cleaned_url
            
            # 該当するリンクが見つからなかった場合
            print("該当するダウンロードリンクが見つかりませんでした")
            return None
            
        # HTML解析中にエラーが発生した場合
        except Exception as parse_error:
            print(f"HTML解析エラー: {parse_error}")
            return None

    def validate_tiktok_url(self, url):
        """
        入力されたURLがTikTokの正しい形式かを確認する関数
        url: 検証するURL文字列
        """
        # TikTokの有効なドメイン（サイトアドレス）のリスト
        valid_domains = [
            'tiktok.com',        # 基本のドメイン
            'www.tiktok.com',    # wwwありのドメイン
            'm.tiktok.com',      # モバイル版のドメイン
            'vm.tiktok.com'      # 短縮URL用のドメイン
        ]
        
        # URLが入力されているかをチェック
        if not url or not isinstance(url, str):
            print("✗ URLが入力されていません")
            return False
        
        # URLがhttpsまたはhttpで始まっているかをチェック
        if not (url.startswith('https://') or url.startswith('http://')):
            print("✗ URLはhttps://またはhttp://で始まる必要があります")
            return False
        
        # TikTokの有効なドメインが含まれているかをチェック
        # any()は条件に合うものが一つでもあればTrueを返す
        is_valid_domain = any(domain in url.lower() for domain in valid_domains)
        
        # 有効なドメインが含まれていない場合
        if not is_valid_domain:
            print("✗ TikTokのURLではありません")
            return False
        
        # 全てのチェックをパスした場合
        print("✓ URLの形式が正しいです")
        return True

    def get_video_download_url(self, tiktok_url):
        """
        TikTokのURLから動画ダウンロードURLを取得する一連の処理をまとめた関数
        tiktok_url: TikTokの動画URL
        """
        # 処理開始のメッセージを表示
        print(f"\n=== 動画URL取得処理開始 ===")
        
        # Step1: URLの形式が正しいかを検証
        if not self.validate_tiktok_url(tiktok_url):
            return None  # 検証に失敗した場合は処理を終了
        
        # Step2: ダウンロードURLを抽出
        download_url = self.extract_download_url(tiktok_url)
        
        # 結果によって異なるメッセージを表示
        if download_url:
            print(f"✓ 動画ダウンロードURL取得完了")
            return download_url
        else:
            print("✗ 動画ダウンロードURL取得失敗")
            return None

def main():
    """
    TikTokDownloaderの動画URL取得機能をテストする関数
    実際のTikTokURLを使用してダウンロードURL抽出をテスト
    """
    # プログラムのタイトルを表示
    print("=== TikTok動画ダウンローダー URL取得テスト ===")
    
    # TikTokDownloaderクラスのインスタンスを作成
    downloader = TikTokDownloader()
    
    # 最初にAPI接続テストを実行
    print("\n--- API接続テスト実行中 ---")
    connection_result = downloader.check_connection()
    
    # API接続に問題がある場合は処理を終了
    if not connection_result:
        print("API接続に問題があります。処理を終了します。")
        return
    
    # テスト用のTikTokURL（実際のURLに置き換えてテスト可能）
    test_url = "https://www.tiktok.com/@test/video/test"
    
    # 動画URL取得テストを実行
    print(f"\n--- 動画URL取得テスト実行中 ---")
    download_url = downloader.get_video_download_url(test_url)
    
    # 結果によって異なるメッセージを表示
    if download_url:
        # URLが長い場合は最初の50文字だけ表示
        print(f"\n✓ テスト成功 - ダウンロードURL: {download_url[:50]}...")
    else:
        print(f"\n✗ テスト失敗 - ダウンロードURLを取得できませんでした")
        print("※ test_urlを実際のTikTok動画URLに変更してテストしてください")

# このファイルが直接実行された時のみmain関数を呼び出す
if __name__ == "__main__":
    main()

python src/video_downloader.py

    def download_video_file(self, download_url, save_filename):
        """
        動画ファイルをダウンロードして指定された場所に保存する関数
        download_url: 動画のダウンロードURL
        save_filename: 保存するファイル名
        """
        try:
            # ダウンロード開始のメッセージを表示
            print(f"動画ダウンロード開始: {save_filename}")
            
            # URLに含まれる不要な文字（エスケープ文字）を削除
            cleaned_url = download_url.replace('\\"', '')
            
            # 実際に動画ファイルをダウンロード（30秒でタイムアウト）
            video_response = requests.get(cleaned_url, timeout=30)
            
            # HTTPエラーが発生した場合は例外を投げる
            video_response.raise_for_status()
            
            # ダウンロードした動画のファイルサイズを計算（MB単位）
            file_size_mb = len(video_response.content) / (1024 * 1024)
            print(f"ダウンロードサイズ: {file_size_mb:.2f} MB")
            
            # 保存先のフルパスを作成
            save_path = os.path.join(self.output_folder, save_filename)
            
            # 動画ファイルをバイナリモード（'wb'）で保存
            with open(save_path, 'wb') as video_file:
                video_file.write(video_response.content)
            
            # 保存完了のメッセージを表示
            print(f"✓ 動画保存完了: {save_path}")
            return True  # 成功を表すTrueを返す
            
        # HTTPエラー（400番台、500番台）が発生した場合
        except requests.exceptions.HTTPError as http_error:
            print(f"ダウンロード中にHTTPエラーが発生: {http_error}")
            return False
        # タイムアウトエラーが発生した場合
        except requests.exceptions.Timeout:
            print("ダウンロードがタイムアウトしました（30秒）")
            return False
        # その他の通信エラーが発生した場合
        except requests.exceptions.RequestException as request_error:
            print(f"ダウンロード中にエラーが発生: {request_error}")
            return False
        # ファイル保存時にエラーが発生した場合
        except IOError as io_error:
            print(f"ファイル保存中にエラーが発生: {io_error}")
            return False
        # 予期しないエラーが発生した場合
        except Exception as unexpected_error:
            print(f"予期しないエラーが発生: {unexpected_error}")
            return False

    def generate_filename(self, download_url):
        """
        ダウンロードURLから適切なファイル名を自動生成する関数
        download_url: 動画のダウンロードURL
        """
        try:
            # URLを「/」で分割してリストにする
            url_parts = download_url.split('/')
            
            # URLの最後の部分を取得し、「?」以降のパラメータを除去
            video_id = url_parts[-1].split('?')[0]
            
            # ファイル名として使用可能な文字のみを定義
            safe_chars = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-_"
            
            # 安全な文字のみを残してファイル名を作成
            cleaned_id = ''.join(char for char in video_id if char in safe_chars)
            
            # ファイル名が短すぎる場合はタイムスタンプを追加
            if len(cleaned_id) < 5:
                import time  # 時間関連の機能をインポート
                timestamp = int(time.time())  # 現在時刻のタイムスタンプを取得
                cleaned_id = f"video_{timestamp}"
            
            # ファイル名に拡張子（.mp4）を追加
            filename = f"{cleaned_id}.mp4"
            
            # 生成されたファイル名を表示
            print(f"生成されたファイル名: {filename}")
            return filename
            
        # ファイル名生成中にエラーが発生した場合
        except Exception as filename_error:
            print(f"ファイル名生成エラー: {filename_error}")
            # エラー時は現在時刻を使ったフォールバック名を生成
            import time
            timestamp = int(time.time())
            return f"tiktok_video_{timestamp}.mp4"

    def process_video_download(self, tiktok_url):
        """
        TikTokのURLから動画をダウンロードする全ての工程をまとめた関数
        tiktok_url: TikTokの動画URL
        """
        # 処理開始の区切り線とメッセージを表示
        print(f"\n{'='*50}")
        print(f"動画ダウンロード処理開始")
        print(f"URL: {tiktok_url}")
        print(f"{'='*50}")
        
        # Step1: ダウンロードURLを取得
        download_url = self.get_video_download_url(tiktok_url)
        if not download_url:
            print("✗ ダウンロードURL取得に失敗しました")
            return False  # 失敗時はFalseを返す
        
        # Step2: ファイル名を生成
        filename = self.generate_filename(download_url)
        
        # Step3: 動画ファイルをダウンロード
        download_success = self.download_video_file(download_url, filename)
        
        # 結果によって異なるメッセージを表示
        if download_success:
            print(f"✓ 動画ダウンロード完了: {filename}")
            return True  # 成功時はTrueを返す
        else:
            print("✗ 動画ダウンロードに失敗しました")
            return False  # 失敗時はFalseを返す

    def run_interactive_mode(self):
        """
        対話式の動画ダウンロードモードを実行する関数
        ユーザーが終了するまで繰り返し動画をダウンロード
        """
        # プログラムの説明とタイトルを表示
        print("\n" + "="*60)
        print("TikTok動画ダウンローダー - 対話モード")
        print("="*60)
        print("使い方:")
        print("1. TikTokの動画URLを入力してください")
        print("2. 'exit'と入力すると終了します")
        print("3. 'help'と入力すると使い方を再表示します")
        print("-"*60)
        
        # ダウンロード成功数をカウントするための変数
        download_count = 0
        
        # 無限ループでユーザー入力を受け付け
        while True:
            try:
                # ユーザーからの入力を受け取り、前後の空白を削除
                user_input = input("\nTikTok動画URL >>> ").strip()
                
                # 「exit」と入力された場合は終了
                if user_input.lower() == 'exit':
                    print(f"\n動画ダウンローダーを終了します")
                    print(f"総ダウンロード数: {download_count}個")
                    break  # ループから抜ける
                
                # 「help」と入力された場合は使い方を表示
                if user_input.lower() == 'help':
                    print("\n--- 使い方 ---")
                    print("TikTokの動画URLを入力: 動画をダウンロード")
                    print("exit: プログラムを終了")
                    print("help: この使い方を表示")
                    continue  # ループの最初に戻る
                
                # 何も入力されていない場合はスキップ
                if not user_input:
                    print("URLを入力してください")
                    continue
                
                # 動画ダウンロード処理を実行
                success = self.process_video_download(user_input)
                
                # ダウンロードが成功した場合はカウンターを増やす
                if success:
                    download_count += 1
                
            # Ctrl+Cでプログラムが中断された場合
            except KeyboardInterrupt:
                print(f"\n\nプログラムが中断されました")
                print(f"総ダウンロード数: {download_count}個")
                break  # ループから抜ける
            
            # 予期しないエラーが発生した場合
            except Exception as interface_error:
                print(f"エラーが発生しました: {interface_error}")
                print("続行しますか？ (y/n)")
                continue_choice = input(">>> ").strip().lower()
                # 「y」または「yes」以外が入力された場合は終了
                if continue_choice not in ['y', 'yes']:
                    break

def main():
    """
    TikTokDownloaderのフル機能をテストする関数
    対話式モードでユーザーからの入力を受け付け
    """
    # プログラムのタイトルを表示
    print("=== TikTok動画ダウンローダー ===")
    
    # TikTokDownloaderクラスのインスタンスを作成
    downloader = TikTokDownloader()
    
    # 最初にAPI接続テストを実行
    print("\n--- 初期接続テスト ---")
    connection_result = downloader.check_connection()
    
    # API接続に問題がある場合はプログラムを終了
    if not connection_result:
        print("API接続に問題があります。プログラムを終了します。")
        return
    
    # 接続テスト完了のメッセージを表示
    print("✓ 接続テスト完了")
    
    # 対話式モードを開始
    downloader.run_interactive_mode()

# このファイルが直接実行された時のみmain関数を呼び出す
if __name__ == "__main__":
    main()

python src/video_downloader.py

# Virtual environment
myenv/

# Downloaded videos
downloaded_videos/
*.mp4
*.mov
*.avi

# Cache files
__pycache__/
*.pyc
*.pyo

# TikTok動画ダウンローダー

## プロジェクト内容

TikTokの動画URLから動画ファイルを直接ダウンロードできるツールです。WebスクレイピングとHTTP通信を使用して、TikTokの動画情報を取得し、ローカルに保存する機能を実装しています。PythonによるWeb API連携、HTMLパース、ファイル操作技術を学習することを目的として開発しました。

## プロジェクト構成

```
tiktok_downloader/
├── src/
│   └── video_downloader.py    # メインプログラム
├── downloaded_videos/         # ダウンロード動画保存フォルダ
├── requirements.txt           # 依存関係管理
├── README.md                  # プロジェクト説明書
└── .gitignore                # Git除外ファイル設定
```

## 必要要件/開発環境

- **Python 3.7以上**
- **VSCode** (開発環境)
- **Git** (バージョン管理)
- **インターネット接続** (動画ダウンロード用)

### 使用ライブラリ

- **requests** HTTP通信とAPI連携処理
- **beautifulsoup4** HTML解析とWebスクレイピング
- **os** ファイルシステム操作

## 機能

- **TikTokURL検証** 入力されたURLの形式確認と妥当性チェック
- **動画情報取得** WebスクレイピングによるダウンロードURL抽出
- **動画ダウンロード** 取得したURLからの動画ファイル取得
- **ファイル自動保存** ダウンロード動画の自動命名と保存
- **対話式インターフェース** ユーザーフレンドリーなコマンドライン操作
- **エラーハンドリング** 通信エラーやファイル操作エラーの適切な処理
- **ファイルサイズ表示** ダウンロード動画のサイズ確認
- **連続ダウンロード** 複数動画の連続処理機能

## 実行方法

### 1. リポジトリのクローン

```bash
git clone https://github.com/yourusername/tiktok_downloader.git
cd tiktok_downloader
```

### 2. 仮想環境の作成・アクティベート

**Windows**

```bash
python -m venv myenv
myenv\Scripts\activate
```

**macOS**

```bash
python3 -m venv myenv
source myenv/bin/activate
```

### 3. 依存関係のインストール

```bash
pip install -r requirements.txt
```

### 4. プログラムの実行

```bash
python src/video_downloader.py
```

実行後、対話式インターフェースが起動し、TikTokの動画URLを入力するとdownloaded_videosフォルダに動画が保存されます。

## 使用方法

1. プログラムを実行すると対話式モードが開始されます
2. `TikTok動画URL >>>` のプロンプトに動画のURLを入力します
3. 動画のダウンロードが自動で実行されます
4. `exit` と入力するとプログラムが終了します
5. `help` と入力すると使い方が表示されます

## データ形式について

- **入力データ** TikTokの動画URL（https://www.tiktok.com/...）
- **出力データ** MP4形式の動画ファイル
- **保存場所** downloaded_videosフォルダ内

## 注意事項

- このツールは教育目的で作成されています
- ダウンロードする動画の著作権を尊重してください
- 大量のダウンロードはサーバーに負荷をかける可能性があります

## 開発者

YuYu