利用者:夜泣き/スクリプト

‎とりあえず取り急ぎ。バグ報告は利用者・トーク:夜泣き

コード

‎

#!/usr/bin/env python3

"""Twitter自動収集スクリプト

ver4.0.5 2023/10/1恒心

当コードは恒心停止してしまった https://rentry.co/7298g の降臨ショーツイート自動収集スクリプトの復刻改善版です
前開発者との出会いに感謝

Examples:
    定数類は状況に応じて変えてください。
    ::

        $ python3 (ファイル名)

    オプションに ``--krsw`` とつけると自動モードになります。
    ::

        $ python3 (ファイル名) --krsw

    ``--no_browser`` オプションでTor Browserを使用しないモードに、
    ``--disable_script`` オプションでTor BrowserのJavaScriptを使用しないモードになります。

    自動モードではユーザーは降臨ショー、クエリはなし、取得上限まで自動です。
    つまりユーザー入力が要りません。

Note:
    * Pythonのバージョンは3.11以上
    * 環境は玉葱前提です。

        * Tor Browserを入れておくか、torコマンドでプロキシを立てておくことが必要です。

    * Whonix-Workstation, MacOSで動作確認済

        * MacOSの場合はbrewでtorコマンドを導入し、実行

    * PySocks, bs4, seleniumはインストールしないと標準で入ってません
    * requestsも環境によっては入っていないかもしれない

        * ``$ python3 -m pip install bs4 requests PySocks selenium``

    * pipも入っていなければ ``$ sudo apt install pip``
    * `ffmpeg <https://ffmpeg.org>`_ が入っていると動画も自動取得しますが、無くても動きます
    * バグ報告は `利用者・トーク:夜泣き#利用者:夜泣き/スクリプトについて \
        <https://krsw-wiki.org/wiki/利用者・トーク:夜泣き#利用者:夜泣き/スクリプトについて>`_
"""

import codecs
import json
import logging
import os
import platform
import random
import re
import subprocess
import sys
import warnings
from argparse import ArgumentParser, Namespace
from collections.abc import Callable
from datetime import datetime
from enum import Enum
from logging import Logger, getLogger
from re import Match
from time import sleep
from types import MappingProxyType, TracebackType
from typing import Any, Final, NoReturn, Self
from urllib.parse import quote, unquote, urljoin
from zoneinfo import ZoneInfo

import requests
from bs4 import BeautifulSoup
from bs4.element import NavigableString, ResultSet, Tag
from selenium import webdriver
from selenium.common.exceptions import (NoSuchElementException,
                                        WebDriverException)
from selenium.webdriver.common.by import By
from selenium.webdriver.firefox.options import Options as FirefoxOptions
from selenium.webdriver.support import expected_conditions as ec
from selenium.webdriver.support.wait import WebDriverWait

logging.basicConfig(level=logging.INFO,
                    format='{asctime} [{levelname:.4}] : {message}', style='{')
logger: Logger = getLogger(__name__)

# おそらくはツイートの内容によってMarkupResemblesLocatorWarningが吐き出されることがあるので無効化
warnings.simplefilter('ignore')


class AccessError(Exception):
    """RequestsとSeleniumで共通のアクセスエラー。
    """
    pass


class ReCaptchaRequiredError(Exception):
    """JavaScriptがオフの時にreCAPTCHAを要求された場合のエラー。
    """
    pass


class AbstractAccessor:
    """HTTPリクエストでWebサイトに接続するための基底クラス。
    """

    WAIT_TIME: Final[int] = 1
    """Final[int]: HTTPリクエスト成功失敗関わらず待機時間。

    1秒待つだけで行儀がいいクローラーだそうなので既定では1秒。
    しかし日本のポリホーモは1秒待っていても捕まえてくるので注意。
    https://ja.wikipedia.org/wiki/?curid=2187212
    """

    WAIT_RANGE: Final[int] = 5
    """Final[int]: ランダムな時間待機するときの待機時間の幅。
    """

    REQUEST_TIMEOUT: Final[int] = 30
    """Final[int]: HTTPリクエストのタイムアウト秒数。
    """

    def _random_sleep(self) -> None:
        """ランダムな秒数スリープする。

        自動操縦だとWebサイトに見破られないため。
        """
        sleep(random.randrange(self.WAIT_TIME,
                               self.WAIT_TIME + self.WAIT_RANGE))


class RequestsAccessor(AbstractAccessor):
    """RequestsモジュールでWebサイトに接続するためのクラス。
    """

    HEADERS: Final[dict[str, str]] = {
        'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:109.0) Gecko/20100101 Firefox/118.0'
    }
    """Final[dict[str, str]]: HTTPリクエスト時のヘッダ。
    """

    PROXIES_WITH_BROWSER: Final[dict[str, str]] = {
        'http': 'socks5h://127.0.0.1:9150',
        'https': 'socks5h://127.0.0.1:9150'
    }
    """Final[dict[str, str]]: Tor Browserを起動しているときのHTTPプロキシの設定。
    """

    PROXIES_WITH_COMMAND: Final[dict[str, str]] = {
        'http': 'socks5h://127.0.0.1:9050',
        'https': 'socks5h://127.0.0.1:9050'
    }
    """Final[dict[str, str]]: torコマンドを起動しているときのHTTPプロキシの設定。
    """

    TOR_CHECK_URL: Final[str] = 'https://check.torproject.org/api/ip'
    """Final[str]: Ｔor経由で通信しているかチェックするサイトのURL。
    """

    def __init__(self) -> None:
        """コンストラクタ。
        """
        self._proxies: dict[str, str] | None = None
        self._proxies = self._choose_tor_proxies()  # Ｔorに必要なプロキシをセット

    def _execute(self,
                 url: str,
                 proxies: dict[str, str] | None) -> requests.models.Response:
        """引数のURLにRequestsモジュールでHTTP接続する。

        Args:
            url (str): 接続するURL。
            proxies (dict[str, str] | None): 接続に利用するプロキシ。
                デフォルトでは :func:`~_choose_tor_proxies` で設定した値を利用する。

        Raises:
            requests.exceptions.ConnectionError: Ｔorで接続ができないなど、接続のエラー。
            AccessError: ステータスコードが200でない場合のエラー。

        Returns:
            requests.models.Response: レスポンスのオブジェクト。
        """
        sleep(self.WAIT_TIME)  # DoS対策で待つ
        try:
            res: requests.models.Response = requests.get(
                url,
                timeout=self.REQUEST_TIMEOUT,
                headers=self.HEADERS,
                allow_redirects=False,
                proxies=proxies if proxies is not None else self._proxies)
            res.raise_for_status()  # HTTPステータスコードが200番台以外でエラー発生
        except requests.exceptions.ConnectionError:
            raise
        except requests.exceptions.RequestException as e:
            # requestsモジュール固有の例外を共通の例外に変換
            raise AccessError(str(e)) from e
        return res

    def get(self,
            url: str,
            proxies: dict[str, str] | None = None) -> str:
        """引数のURLにRequestsモジュールでHTTP接続する。

        Args:
            url (str): 接続するURL。
            proxies (dict[str, str] | None, optional): 接続に利用するプロキシ。
                デフォルトでは :func:`~_choose_tor_proxies` で設定した値を利用する。

        Raises:
            requests.exceptions.ConnectionError: Ｔorで接続ができないなど、接続のエラー。
            AccessError: ステータスコードが200でない場合のエラー。

        Returns:
            str: レスポンスのHTML。
        """
        try:
            return self._execute(url, proxies).text
        except (requests.exceptions.ConnectionError, AccessError):
            raise

    def get_image(self, url: str) -> bytes | None:
        """引数のURLから画像のバイナリ列を取得する。

        Args:
            url (str): 接続するURL。

        Raises:
            requests.exceptions.ConnectionError: Ｔorで接続ができないなど、接続のエラー。
            AccessError: ステータスコードが200でない場合のエラー。

        Returns:
            bytes | None: 画像のバイナリ。画像でなければNone。
        """
        try:
            res: requests.models.Response = self._execute(url, self._proxies)
        except (requests.exceptions.ConnectionError, AccessError):
            raise

        if 'image' in res.headers['content-type']:
            return res.content
        else:
            return None

    def _choose_tor_proxies(self) -> dict[str, str] | None | NoReturn:
        """Ｔorを使うのに必要なプロキシ情報を返す。

        プロキシなしで接続できればNone、
        Tor Browserのプロキシで接続できるなら :const:`~PROXIES_WITH_BROWSER`、
        torコマンドのプロキシで接続できるなら :const:`~PROXIES_WITH_COMMAND`。
        いずれでもアクセスできなければ異常終了する。

        Raises:
            AccessError: :const:`~TOR_CHECK_URL` にアクセスできない場合のエラー。

        Returns:
            dict[str, str] | None | NoReturn: プロキシ情報。
        """
        logger.info('Ｔorのチェック中ですを')
        # プロキシなしでTorにアクセスできるかどうか
        res: str = self.get(self.TOR_CHECK_URL, proxies=None)
        is_tor: bool = json.loads(res)['IsTor']
        if is_tor:
            logger.info('Ｔor connection OK')
            return None

        # Tor BrowserのプロキシでTorにアクセスできるかどうか
        try:
            res = self.get(self.TOR_CHECK_URL,
                           proxies=self.PROXIES_WITH_BROWSER)
            is_tor = json.loads(res)['IsTor']
            if is_tor:
                logger.info('Ｔor connection OK')
                return self.PROXIES_WITH_BROWSER
        except requests.exceptions.ConnectionError:
            pass

        # torコマンドのプロキシでTorにアクセスできるかどうか
        try:
            res = self.get(self.TOR_CHECK_URL,
                           proxies=self.PROXIES_WITH_COMMAND)
            is_tor = json.loads(res)['IsTor']
            if is_tor:
                logger.info('Ｔor proxy OK')
                return self.PROXIES_WITH_COMMAND
            else:
                raise AccessError('サイトにＴorのIPでアクセスできていないなりを')
        except requests.exceptions.ConnectionError as e:
            logger.critical(e)
            logger.critical('通信がＴorのSOCKS proxyを経由していないなりを')
            sys.exit(1)

    @property
    def proxies(self) -> dict[str, str] | None:
        """オブジェクトのプロキシ設定を返す。

        Returns:
            dict[str, str] | None: プロキシ設定。
        """
        return self._proxies


class SeleniumAccessor(AbstractAccessor):
    """SeleniumでWebサイトに接続するためのクラス。
    """

    TOR_BROWSER_PATHS: MappingProxyType[str, str] = MappingProxyType({
        'Windows': 'C:\\Program Files\\Tor Browser\\Browser\\firefox.exe',
        'Darwin': '/Applications/Tor Browser.app/Contents/MacOS/firefox',
        'Linux': '/usr/bin/torbrowser'
    })
    """MappingProxyType[str, str]: OSごとのTor Browserのパス。
    """

    WAIT_TIME_FOR_INIT: Final[int] = 15
    """Final[int]: 最初のTor接続時の待機時間。
    """

    WAIT_TIME_FOR_RECAPTCHA: Final[int] = 10000
    """Final[int]: reCAPTCHAのための待機時間。
    """

    def __init__(self, enable_javascript: bool) -> None:
        """コンストラクタ。

        Tor Browserを自動操縦するためのSeleniumドライバを初期化する。

        Args:
            enable_javascript (bool): JavaScriptを有効にするかどうか。reCAPTCHA対策に必要。
        """
        self._javascript_enabled: bool = enable_javascript

        options: FirefoxOptions = FirefoxOptions()
        options.binary_location = self.TOR_BROWSER_PATHS[platform.system()]

        if enable_javascript:
            logger.warning('reCAPTCHA対策のためJavaScriptをonにしますを')

        options.preferences.update({  # type: ignore
            'javascript.enabled': enable_javascript,
            'intl.accept_languages': 'en-US, en',
            'intl.locale.requested': 'US',
            'font.language.group': 'x-western',
            'dom.webdriver.enabled': False  # 自動操縦と見破られないための設定
        })

        try:
            self._driver: webdriver.Firefox = webdriver.Firefox(
                options=options)
            sleep(1)
            wait_init: WebDriverWait = WebDriverWait(self._driver,
                                                     self.WAIT_TIME_FOR_INIT)
            wait_init.until(  # type: ignore
                ec.element_to_be_clickable((By.ID, 'connectButton'))
            )
            self._driver.find_element(By.ID, 'connectButton').click()
            # Torの接続が完了するまで待つ
            wait_init.until(ec.url_contains('about:blank'))  # type: ignore
        except BaseException:
            self.quit()
            raise

    def quit(self) -> None:
        """Seleniumドライバを終了する。
        """
        if hasattr(self, '_driver'):
            self._driver.quit()

    def _check_recaptcha(self) -> None:
        """reCAPTCHAが表示されているかどうか判定して、入力を待機する。

        Raises:
            ReCaptchaRequiredError: JavaScriptがオフの状態でreCAPTCHAが要求された場合のエラー。

        Todo:
            botバレしたときに自動で他のＴorサーキットに接続し直す。
        """
        try:
            self._driver.find_element(  # 要素がない時に例外を吐く
                By.CSS_SELECTOR,
                'script[src^="https://www.google.com/recaptcha/api.js"]')
            if self._javascript_enabled:
                logger.warning('reCAPTCHAを解いてね（笑）、それはできるよね。')
                logger.warning('botバレしたらNew Tor circuit for this siteを選択するナリよ')
                WebDriverWait(
                    self._driver,
                    self.WAIT_TIME_FOR_RECAPTCHA).until(  # type: ignore
                    ec.staleness_of(
                        self._driver.find_element(
                            By.CSS_SELECTOR,
                            'script[src^="https://www.google.com/recaptcha/api.js"]')))
                sleep(self.WAIT_TIME)  # DoS対策で待つ
            else:
                raise ReCaptchaRequiredError(
                    'JavaScriptがオフの状態でreCAPTCHAが要求されました。 URL: '
                    + self._driver.current_url)
        except NoSuchElementException:
            # reCAPTCHAの要素がなければそのまま
            pass

    def get(self, url: str) -> str:
        """引数のURLにSeleniumでHTTP接続する。

        Args:
            url (str): 接続するURL。

        Raises:
            AccessError: 通信に失敗した場合のエラー。

        Returns:
            str: レスポンスのHTML。
        """
        self._random_sleep()  # DoS対策で待つ
        try:
            self._driver.get(url)
            self._check_recaptcha()
        except WebDriverException as e:
            # Selenium固有の例外を共通の例外に変換
            raise AccessError(str(e)) from e
        return self._driver.page_source


class AccessorHandler:
    """WebサイトからHTMLを取得するためのクラス。

    RequestsとSeleniumのどちらかを選択して使用することができ、その違いを隠蔽する。
    """

    LIMIT_N_REQUESTS: Final[int] = 5
    """Final[int]: HTTPリクエスト失敗時の再試行回数。
    """

    WAIT_TIME_FOR_ERROR: Final[int] = 4
    """Final[int]: HTTPリクエスト失敗時にさらに追加する待機時間。
    """

    def __init__(self, use_browser: bool, enable_javascript: bool) -> None:
        """コンストラクタ。

        Requestのみを利用するか、Seleniumも利用するか引数で選択して初期化する。

        Args:
            use_browser (bool): TrueならSeleniumを利用する。FalseならRequestsのみでアクセスする。
            enable_javascript (bool): SeleniumでJavaScriptを利用する場合はTrue。
        """
        self._selenium_accessor: SeleniumAccessor | None = SeleniumAccessor(
            enable_javascript) if use_browser else None
        self._requests_accessor: RequestsAccessor = RequestsAccessor()

    def __enter__(self) -> Self:
        """withブロックの開始時に実行する。

        Returns:
            Self: オブジェクト自身。
        """
        return self

    def __exit__(self,
                 exc_type: type[BaseException] | None,
                 exc_value: BaseException | None,
                 traceback: TracebackType | None) -> None:
        """withブロックの終了時に実行する。

        Args:
            exc_type (type[BaseException] | None): コンテキスト内で例外を吐いた場合の例外タイプ。
            exc_value (BaseException | None): コンテキスト内で例外を吐いた場合の例外。
            traceback (TracebackType | None): コンテキスト内で例外を吐いた場合のトレースバック。
        """
        if self._selenium_accessor is not None:
            self._selenium_accessor.quit()

    def request_once(self, url: str) -> str:
        """引数のURLにHTTP接続する。

        Args:
            url (str): 接続するURL。

        Returns:
            str: レスポンスのテキスト。

        Raises:
            AccessError: アクセスエラー。

        Note:
            失敗かどうかは呼出側で要判定。
        """
        try:
            if self._selenium_accessor is not None:
                return self._selenium_accessor.get(url)
            else:
                return self._requests_accessor.get(url)
        except AccessError:
            raise

    def _request_with_callable(self,
                               url: str,
                               request_callable: Callable[[str], Any]
                               ) -> Any | None:
        """request_callableの実行を :const:`~LIMIT_N_REQUESTS` で定義された回数まで試す。

        成功すると結果を返す。
        接続失敗が何度も起きるとNoneを返す。

        Args:
            url (str): 接続するURL
            request_callable (Callable[[str], Any]): 1回リクエストを行うメソッド。

        Returns:
            Any | None: レスポンス。接続失敗が何度も起きるとNoneを返す。
        """
        for i in range(1, self.LIMIT_N_REQUESTS + 1):
            try:
                res: Any = request_callable(url)
            except AccessError:
                logger.warning(
                    url
                    + 'への通信失敗ナリ  '
                    + f'{i}/{self.LIMIT_N_REQUESTS}回')
                if i < self.LIMIT_N_REQUESTS:
                    sleep(self.WAIT_TIME_FOR_ERROR)  # 失敗時は長めに待つ
            else:
                return res
        return None

    def request(self, url: str) -> str | None:
        """HTTP接続を :const:`~LIMIT_N_REQUESTS` で定義された回数まで試す。

        成功すると結果を返す。
        接続失敗が何度も起きるとNoneを返す。

        Args:
            url (str): 接続するURL

        Returns:
            str | None: レスポンスのテキスト。接続失敗が何度も起きるとNoneを返す。

        Note:
            失敗かどうかは呼出側で要判定
        """
        return self._request_with_callable(url, self.request_once)

    def request_with_requests_module(self, url: str) -> str | None:
        """RequestsモジュールでのHTTP接続を :const:`~LIMIT_N_REQUESTS` で定義された回数まで試す。

        成功すると結果を返す。
        接続失敗が何度も起きるとNoneを返す。

        Args:
            url (str): 接続するURL

        Returns:
            str | None: レスポンスのテキスト。接続失敗が何度も起きるとNoneを返す。

        Note:
            失敗かどうかは呼出側で要判定
        """
        return self._request_with_callable(url, self._requests_accessor.get)

    def request_image(self, url: str) -> bytes | None:
        """Requestsモジュールで画像ファイルを取得する。

        成功すると結果を返す。
        接続失敗が何度も起きるとNoneを返す。

        Args:
            url (str): 接続するURL

        Returns:
            bytes | None: レスポンスのバイト列。接続失敗が何度も起きるとNoneを返します。

        Note:
            失敗かどうかは呼出側で要判定
        """
        return self._request_with_callable(url,
                                           self._requests_accessor.get_image)

    @property
    def proxies(self) -> dict[str, str] | None:
        """RequestsAccessorオブジェクトのプロキシ設定を返す。

        Returns:
            dict[str, str] | None: RequestsAccessorオブジェクトのプロキシ設定。
        """
        return self._requests_accessor.proxies


class TableBuilder:
    """Wikiの表を組み立てるためのクラス。
    """
    def __init__(self, date: datetime) -> None:
        """コンストラクタ。

        Args:
            date (datetime): 記録するツイートの最新日付。
        """
        self._tables: list[str] = ['']
        self._count: int = 0  # 記録数
        self._date: datetime = date

    @property
    def count(self) -> int:
        """表に追加したツイートの件数を返す。

        Returns:
            int: 表に追加したツイートの件数。
        """
        return self._count

    def append(self, tweet_archive_template: str, text: str) -> None:
        """ツイートを表に追加する。

        Args:
            archived_tweet_url (str): ツイートのURLをCallinshowLinkテンプレートに入れたもの。
            text (str): ツイートの本文。
        """
        self._tables[-1] = '!' + tweet_archive_template + '\n|-\n|\n' \
            + text \
            + '\n|-\n' \
            + self._tables[-1]
        self._count += 1

    def dump_file(self) -> None:
        """Wikiテーブルをファイル出力する。
        """
        self._next_day()
        result_txt: Final[str] = '\n'.join(reversed(self._tables))

        with codecs.open('tweet.txt', 'w', 'utf-8') as f:
            f.write(result_txt)
        logger.info('テキストファイル手に入ったやで〜')

    def next_day_if_necessary(self, date: datetime) -> None:
        """引数dateがインスタンスの持っている日付より前の場合、日付更新処理をする。

        Args:
            date (datetime): 次のツイートの日付。
        """
        if (date.year != self._date.year or date.month != self._date.month
                or date.day != self._date.day):
            self._next_day(date)

    def _next_day(self, date: datetime | None = None) -> None:
        """Wikiテーブルに日付の見出しを付与する。

        Args:
            date (datetime | None, optional): 次に記録するツイートの日付。
        """
        if self._tables[-1]:
            self._tables[-1] = self._convert_to_text_table(self._tables[-1])
            if platform.system() == 'Windows':
                self._tables[-1] = self._date.strftime(
                    '\n=== %#m月%#d日 ===\n') + self._tables[-1]
                logger.info(self._date.strftime('%#m月%#d日のツイートを取得完了ですを'))
            else:
                self._tables[-1] = self._date.strftime(
                    '\n=== %-m月%-d日 ===\n') + self._tables[-1]
                logger.info(self._date.strftime('%-m月%-d日のツイートを取得完了ですを'))
        if date is not None:
            self._date = date
            if self._tables[-1]:
                self._tables.append('')

    def _convert_to_text_table(self, text: str) -> str:
        """Wikiでテーブル表示にするためのヘッダとフッタをつける。

        Args:
            text (str): ヘッダとフッタがないWikiテーブル。

        Returns:
            str: テーブル表示用のヘッダとフッタがついたWikiテーブル。
        """
        return '{|class="wikitable" style="text-align: left;"\n' + text + '|}'

    @staticmethod
    def escape_wiki_reserved_words(text: str) -> str:
        """MediaWikiの文法と衝突する文字を無効化する。

        Args:
            text (str): ツイートの文字列。

        Returns:
            str: MediaWikiの文法と衝突する文字がエスケープされたツイートの文字列。
        """
        def escape_nolink_urls(text: str) -> str:
            """Archiveテンプレートの中にないURLがWikiでaタグに変換されないよう無効化する。

            Args:
                text (str): ツイートの文字列。

            Returns:
                str: Archiveテンプレートの中にないURLがnowikiタグでエスケープされた文字列。
            """
            is_in_archive_template: bool = False
            i: int = 0
            while i < len(text):
                if is_in_archive_template:
                    if text[i:i + len('}}')] == '}}':
                        is_in_archive_template = False
                        i += len('}}')
                else:
                    if (text[i:i + len('{{Archive|')] == '{{Archive|'
                            or text[i:i + len('{{Archive|')] == '{{archive|'):
                        is_in_archive_template = True
                        i += len('{{Archive|')
                    elif text[i:i + len('https://')] == 'https://':
                        text = text[:i] + \
                            '<nowiki>https://</nowiki>' + \
                            text[i + len('https://'):]
                        i += len('<nowiki>https://</nowiki>')
                    elif text[i:i + len('http://')] == 'http://':
                        text = text[:i] + \
                            '<nowiki>http://</nowiki>' + \
                            text[i + len('http://'):]
                        i += len('<nowiki>http://</nowiki>')
                i += 1
            return text

        text = text.replace('\n', '<br>\n')
        text = re.sub(r'^ ', '&nbsp;', text, flags=re.MULTILINE)
        text = re.sub(
            r'^([\*#:;])',
            r'<nowiki>\1</nowiki>',
            text,
            flags=re.MULTILINE)
        text = re.sub(
            r'^----',
            '<nowiki>----</nowiki>',
            text,
            flags=re.MULTILINE)
        text = escape_nolink_urls(text)
        return text

    @staticmethod
    def archive_url(
            url: str,
            archived_url: str,
            text: str | None = None) -> str:
        """URLをArchiveテンプレートでラップする。

        Args:
            url (str): ラップするURL。
            archive_url (str): ラップするURLの魚拓のURL。
            text (str | None, optional): ArchiveテンプレートでURLの代わりに表示する文字列。

        Returns:
            str: ArchiveタグでラップしたURL。
        """
        if text is None:
            return '{{Archive|1=' + unquote(url) + '|2=' + archived_url + '}}'
        else:
            return '{{Archive|1=' + \
                unquote(url) + '|2=' + archived_url + '|3=' + text + '}}'

    @staticmethod
    def callinshowlink_url(url: str, archived_url: str) -> str:
        """URLをCallinShowLinkテンプレートでラップする。

        Args:
            url (str): ラップするURL。
            archive_url (str): ラップするURLの魚拓のURL。

        Returns:
            str: CallinShowLinkタグでラップしたURL。
        """
        return '{{CallinShowLink|1=' + url + '|2=' + archived_url + '}}'


class FfmpegStatus(Enum):
    """ffmpegでの動画保存ステータス。
    """
    MP4 = 1
    """mp4の取得に成功したときのステータス。
    """
    TS = 2
    """tsの取得までは成功したが、mp4への変換に失敗したときのステータス。
    """
    FAILED = 3
    """m3u8からtsの取得に失敗したときのステータス。
    """


class TwitterArchiver:
    """ツイートをWikiの形式にダンプするクラス。

    Nitterからツイートを取得し、Wikiの形式にダンプする。
    削除されたツイートや編集前のツイートは取得できない。
    """

    NITTER_INSTANCE: Final[str] = 'http://nitter.pjsfkvpxlinjamtawaksbnnaqs2fc2mtvmozrzckxh7f3kis6yea25ad.onion/'
    """Final[str]: Nitterのインスタンス。

    生きているのは https://github.com/zedeus/nitter/wiki/Instances で確認。

    Note:
        末尾にスラッシュ必須。

        インスタンスによっては画像の取得ができない。
        Ｔor用のインスタンスでないと動画の取得ができない。
    """

    ARCHIVE_TODAY: Final[str] = 'http://archiveiya74codqgiixo33q62qlrqtkgmcitqx5u2oeqnmn5bpcbiyd.onion/'
    """Final[str]: archive.todayの魚拓のonionドメイン。

    ページにアクセスして魚拓があるか調べるのにはonion版のarchive.todayを使用。

    Note:
        末尾にスラッシュ必須。
    """

    ARCHIVE_TODAY_STANDARD: Final[str] = 'https://archive.vn/'
    """Final[str]: archive.todayの魚拓のクリアネットドメイン。

    記事にはクリアネット用のarchive.todayリンクを貼る。

    Note:
        末尾にスラッシュ必須。
    """

    TWITTER_URL: Final[str] = 'https://twitter.com/'
    """Final[str]: TwitterのURL。

    Note:
        末尾にスラッシュ必須。
    """

    TWITTER_MEDIA_URL: Final[str] = 'https://pbs.twimg.com/media/'
    """Final[str]: TwitterのメディアのURL。
    """

    CALLINSHOW: Final[str] = 'CallinShow'
    """Final[str]: 降臨ショーのユーザーネーム。
    """

    LIMIT_N_TWEETS: Final[int] = 100
    """Final[int]: 取得するツイート数の上限。
    """

    REPORT_INTERVAL: Final[int] = 5
    """Final[int]: 記録件数を報告するインターバル。
    """

    TWEETS_OR_REPLIES: Final[str] = 'with_replies'
    """Final[str]: NitterのURLのドメインとユーザーネーム部分の接続部品。
    """

    NITTER_ERROR_TITLE: Final[str] = 'Error|nitter'
    """Final[str]: Nitterでユーザーがいなかったとき返ってくるページのタイトル。

    万が一仕様変更で変わったとき用。
    """

    NO_ARCHIVE: Final[str] = 'No results'
    """Final[str]: archive.todayで魚拓がなかったときのレスポンス。

    万が一仕様変更で変わったとき用。
    """

    NEWEST: Final[str] = 'Load newest'
    """Final[str]: Nitterの前ページ読み込み部分の名前。

    万が一仕様変更で変わったとき用。
    """

    MEDIA_DIR: Final[str] = 'tweet_media'
    """Final[str]: 画像などのツイートメディアをダウンロードするディレクトリ。
    """

    def __init__(self) -> None:
        """コンストラクタ。
        """
        self._check_slash()  # スラッシュが抜けてないかチェック
        self._has_ffmpeg: bool = self._check_ffmpeg()  # ffmpegがあるかチェック

    def _set_queries(self, accessor: AccessorHandler, krsw: bool) -> None:
        """検索条件を設定する。

        :class:`~TwitterArchiver` のメンバをセットし、ツイートを収集するアカウントと
        検索クエリ、終わりにするツイートを入力させる。

        Args:
            accessor (AccessorHandler): アクセスハンドラ
            krsw (bool): Trueの場合、名前が :const:`~CALLINSHOW` になり、
                クエリと終わりにするツイートが無しになる。
        """

        # ユーザー名取得
        if krsw:
            logger.info('名前は自動的に' + self.CALLINSHOW + 'にナリます')
        self._name: str = self.CALLINSHOW if krsw else self._get_name(accessor)

        # 検索クエリとページ取得
        self._query_strs: list[str] = []
        if krsw:
            logger.info('クエリは自動的になしにナリます')
        else:
            self._get_query()
        page_optional: str | None = accessor.request(
            urljoin(self.NITTER_INSTANCE, self._name + '/'
                    + self.TWEETS_OR_REPLIES))
        if page_optional is None:
            self._on_fail()
        self._page: str = page_optional

        # 終わりにするツイート取得
        if krsw:
            logger.info('終わりにするツイートは自動的になしにナリます')
        self._stop: str = '' if krsw else self._stop_word()

        # 日付取得
        timeline_item: Tag | NavigableString | None = BeautifulSoup(
            self._page, 'html.parser').find(
            class_='timeline-item')
        assert isinstance(timeline_item, Tag)
        date: datetime = self._tweet_date(timeline_item)

        self._table_builder: TableBuilder = TableBuilder(date)

    def _check_slash(self) -> None | NoReturn:
        """URLの最後にスラッシュが付いていなければエラーを出す。

        Returns:
            None | NoReturn: すべてのURLが正しければNone。失敗したら例外を出す。

        Raises:
            RuntimeError: URLの最後にスラッシュがついていない場合に出る。
        """
        if self.NITTER_INSTANCE[-1] != '/':
            raise RuntimeError('NITTER_INSTANCEの末尾をには/が必須です')
        if self.ARCHIVE_TODAY[-1] != '/':
            raise RuntimeError('ARCHIVE_TODAYの末尾をには/が必須です')
        if self.ARCHIVE_TODAY_STANDARD[-1] != '/':
            raise RuntimeError('ARCHIVE_TODAY_STANDARDの末尾をには/が必須です')
        if self.TWITTER_URL[-1] != '/':
            raise RuntimeError('TWITTER_URLの末尾をには/が必須です')

    def _check_ffmpeg(self) -> bool:
        """ffmpegがインストールされているかチェックする。

        Returns:
            bool: ffmpegがインストールされているか。
        """
        return subprocess.run(['which', 'ffmpeg'],
                              stdout=subprocess.DEVNULL,
                              stderr=subprocess.DEVNULL).returncode == 0

    def _check_nitter_instance(
            self, accessor: AccessorHandler) -> None | NoReturn:
        """Nitterのインスタンスが生きているかチェックする。

        死んでいたらそこで終了。
        接続を一回しか試さない :func:`~_request_once` を使っているのは、
        激重インスタンスが指定されたとき試行回数増やして偶然成功してそのまま実行されるのを躱すため。

        Args:
            accessor (AccessorHandler): アクセスハンドラ

        Returns:
            None | NoReturn: NitterにアクセスできればNone。できなければ終了。
        """
        logger.info('Nitterのインスタンスチェック中ですを')
        try:
            accessor.request_once(self.NITTER_INSTANCE)
        except AccessError as e:
            logger.critical(e)
            logger.critical('インスタンスが死んでますを')
            sys.exit(1)
        logger.info('Nitter OK')

    def _check_archive_instance(
            self, accessor: AccessorHandler) -> None | NoReturn:
        """archive.todayのTor用インスタンスが生きているかチェックする。

        Args:
            accessor (AccessorHandler): アクセスハンドラ

        Returns:
            None | NoReturn: archive.todayのＴorインスタンスにアクセスできればNone。できなければ終了。
        """
        logger.info('archive.todayのＴorインスタンスチェック中ですを')
        try:
            accessor.request_once(self.ARCHIVE_TODAY)
        except AccessError as e:  # エラー発生時は終了
            logger.critical(e)
            logger.critical('インスタンスが死んでますを')
            sys.exit(1)
        logger.info('archive.today OK')

    def _invidious_instances(
            self,
            accessor: AccessorHandler) -> tuple[str, ...] | NoReturn:
        """Invidiousのインスタンスのタプルを取得する。

        Args:
            accessor (AccessorHandler): アクセスハンドラ

        Returns:
            tuple[str, ...] | NoReturn: Invidiousのインスタンスのタプル。インスタンスが死んでいれば終了。
        """
        logger.info('Invidiousのインスタンスリストを取得中ですを')
        invidious_json: Final[str | None] = (
            accessor.request_with_requests_module(
                'https://api.invidious.io/instances.json')
        )
        if invidious_json is None:
            logger.critical('Invidiousが死んでますを')
            sys.exit(1)
        instance_list: list[str] = []
        for instance_info in json.loads(invidious_json):
            instance_list.append(instance_info[0])

        # よく使われているものはチェック
        if 'piped.kavin.rocks' not in instance_list:
            instance_list.append('piped.kavin.rocks')
        if 'piped.video' not in instance_list:
            instance_list.append('piped.video')
        return tuple(instance_list)

    def _get_name(self, accessor: AccessorHandler) -> str | NoReturn:
        """ツイート収集するユーザー名を標準入力から取得する。

        何も入力しないと :const:`~CALLINSHOW` を指定する。

        Args:
            accessor (AccessorHandler): アクセスハンドラ。

        Returns:
            str | NoReturn: ユーザ名。ユーザページの取得に失敗したら終了。
        """
        while True:
            logger.info(
                'アカウント名を入れなければない。空白だと自動的に'
                + self.CALLINSHOW
                + 'になりますを')
            account_str: str = input()
            # 空欄で降臨ショー
            if account_str == '':
                return self.CALLINSHOW
            else:
                res: Final[str | None] = accessor.request(
                    urljoin(self.NITTER_INSTANCE, account_str))
                if res is None:  # リクエスト失敗判定
                    self._on_fail()
                soup: BeautifulSoup = BeautifulSoup(res, 'html.parser')
                if soup.title == self.NITTER_ERROR_TITLE:
                    logger.warning(account_str + 'は実在の人物ではありませんでした')
                else:
                    logger.info('最終的に出会ったのが@' + account_str + 'だった。')
                    return account_str

    def _get_query(self) -> None:
        """検索クエリを標準入力から取得する。
        """
        logger.info('検索クエリを入れるナリ。複数ある時は一つの塊ごとに入力するナリ。空欄を入れると検索開始ナリ。')
        logger.info('例：「無能」→改行→「脱糞」→改行→「弟殺し」→改行→空欄で改行')
        query_input: str = input()
        # 空欄が押されるまでユーザー入力受付
        while query_input != '':
            self._query_strs.append(query_input)
            query_input = input()
        logger.info('クエリのピースが埋まっていく。')

    def _on_fail(self) -> NoReturn:
        """接続失敗時処理。

        取得に成功した分だけファイルにダンプし、プログラムを終了する。
        """
        logger.critical('接続失敗しすぎで強制終了ナリ')
        if self._table_builder.count > 0:  # 取得成功したデータがあれば発行
            logger.critical('取得成功した分だけ発行しますを')
            self._table_builder.dump_file()
        sys.exit(1)

    def _stop_word(self) -> str:
        """ツイートの記録を中断するための文をユーザに入力させる。

        Returns:
            str: ツイートの記録を中断するための文。ツイート内容の一文がその文と一致したら記録を中断する。
        """
        logger.info(
            'ここにツイートの本文を入れる！すると・・・・なんとそれを含むツイートで記録を中断する！（これは本当の仕様です。）'
            + f'ちなみに、空欄だと{self.LIMIT_N_TWEETS}件まで終了しない。')
        end_str: Final[str] = input()
        return end_str

    def _download_media(
            self,
            media_name: str,
            accessor: AccessorHandler) -> bool:
        """ツイートの画像をダウンロードし、:const:`~MEDIA_DIR` に保存する。

        Args:
            media_name (str): 画像ファイル名。Nitter上のimgタグのsrc属性では、
                ``/pic/media%2F`` に後続する。
            accessor (AccessorHandler): アクセスハンドラ。

        Returns:
            bool: 保存に成功したかどうか。
        """
        os.makedirs(self.MEDIA_DIR, exist_ok=True)
        url: Final[str] = urljoin(self.TWITTER_MEDIA_URL, media_name)
        image_bytes: Final[bytes | None] = accessor.request_image(url)
        if image_bytes is not None:
            with open(os.path.join(self.MEDIA_DIR, media_name), 'wb') as f:
                f.write(image_bytes)
            return True
        else:
            return False

    def _download_m3u8(self,
                       media_path: str,
                       ts_filename: str,
                       mp4_filename: str,
                       proxies: dict[str, str] | None) -> FfmpegStatus:
        """ffmpegで動画をダウンロードし、:const:`~MEDIA_DIR` に保存する。

        Args:
            media_path (str): 動画のm3u8ファイルのNitter上でのパス。
            ts_filename (str): m3u8から取得したtsファイルのパス。
            mp4_filename (str): tsファイルから変換したmp4ファイルのパス。
            proxies (dict[str, str] | None): m3u8での通信に用いるプロキシ設定。

        Returns:
            FfmpegStatus: ffmpegでの保存ステータス。
        """
        if proxies is not None:
            returncode: int = subprocess.run(
                [
                    'ffmpeg', '-y', '-http_proxy',
                    'proxies["http"]', '-i',
                    urljoin(self.NITTER_INSTANCE, media_path),
                    '-c', 'copy', ts_filename
                ],
                stdout=subprocess.DEVNULL).returncode
        else:
            returncode: int = subprocess.run(
                [
                    'ffmpeg', '-y', '-i',
                    urljoin(self.NITTER_INSTANCE, media_path),
                    '-c', 'copy', ts_filename
                ],
                stdout=subprocess.DEVNULL).returncode

        # 取得成功したらtsをmp4に変換
        if returncode == 0:
            ts2mp4_returncode: int = subprocess.run(
                [
                    'ffmpeg', '-y', '-i', ts_filename,
                    '-acodec', 'copy', '-vcodec', 'copy', mp4_filename
                ],
                stdout=subprocess.DEVNULL).returncode
            if ts2mp4_returncode == 0:
                return FfmpegStatus.MP4
            else:
                return FfmpegStatus.TS
        else:
            return FfmpegStatus.FAILED

    def _tweet_date(self, tweet: Tag) -> datetime:
        """ツイートの時刻を取得する。

        Args:
            tweet (Tag): ツイート内容である ``.timeline-item`` タグを表すbeautifulsoup4タグ。

        Returns:
            datetime: ツイートの時刻。
        """
        tweet_date: Tag | NavigableString | None = tweet.find(
            class_='tweet-date')
        assert isinstance(tweet_date, Tag)
        tweet_date_a: Tag | None = tweet_date.a
        assert tweet_date_a is not None
        date_str: str | list[str] | None = tweet_date_a.get('title')
        assert isinstance(date_str, str)
        return datetime.strptime(
            date_str,
            '%b %d, %Y · %I:%M %p %Z').replace(
            tzinfo=ZoneInfo('UTC')).astimezone(
            ZoneInfo('Asia/Tokyo'))

    def _get_tweet_media(
            self,
            tweet: Tag,
            accessor: AccessorHandler) -> str:
        """ツイートの画像や動画を取得する。

        Args:
            tweet (Tag): ツイート内容である ``.timeline-item`` タグを表すbeautifulsoup4タグ。
            accessor (AccessorHandler): アクセスハンドラ

        Returns:
            str: Wiki記法でのファイルへのリンクの文字列。
        """
        # 引用リツイート内のメディアを選択しないように.tweet-body直下の.attachmentsを選択
        tweet_media: Tag | None = tweet.select_one(
            '.tweet-body > .attachments')
        media_txt: str = ''
        if tweet_media is not None:
            media_list: list[str] = []
            # ツイートの画像の取得
            for image_a in tweet_media.select('.attachment.image a'):
                try:
                    href: str | list[str] | None = image_a.get('href')
                    assert isinstance(href, str)
                    matched: Match[str] | None = re.search(
                        r'%2F([^%]*\.jpg)|%2F([^%]*\.jpeg)|%2F([^%]*\.png)|%2F([^%]*\.gif)',
                        href)
                    assert matched is not None
                    media_name: str = [
                        group for group in matched.groups() if group][0]
                    media_list.append(f'[[ファイル:{media_name}|240px]]')
                    if self._download_media(media_name, accessor):
                        logger.info(
                            os.path.join(self.MEDIA_DIR, media_name)
                            + ' をアップロードしなければない。')
                    else:
                        logger.info(
                            urljoin(self.TWITTER_MEDIA_URL, media_name)
                            + ' をアップロードしなければない。')
                except AttributeError:
                    tweet_link: Tag | NavigableString | None = tweet.find(
                        class_='tweet-link')
                    assert isinstance(tweet_link, Tag)
                    href: str | list[str] | None = tweet_link.get('href')
                    assert isinstance(href, str)
                    tweet_url: str = urljoin(
                        self.TWITTER_URL,
                        re.sub('#[^#]*$', '', href))
                    logger.error(f'{tweet_url}の画像が取得できませんでしたを 当職無能')
                    media_list.append('[[ファイル:(画像の取得ができませんでした)|240px]]')

            # ツイートの動画の取得。ffmpegが入っていなければ手動で取得すること
            for i, video_container in enumerate(
                    tweet_media.select('.attachment.video-container')):
                tweet_link: Tag | NavigableString | None = tweet.find(
                    class_='tweet-link')
                assert isinstance(tweet_link, Tag)
                href: str | list[str] | None = tweet_link.get('href')
                assert isinstance(href, str)
                tweet_url: str = urljoin(
                    self.TWITTER_URL,
                    re.sub('#[^#]*$', '', href))  # ツイートのURL作成

                if not self._has_ffmpeg:
                    logger.error(f'ffmpegがないため{tweet_url}の動画が取得できませんでしたを')
                    media_list.append('[[ファイル:(動画の取得ができませんでした)|240px]]')
                    continue

                # videoタグがない場合は取得できない
                video = video_container.select_one('video')
                if video is None:
                    logger.error(f'{tweet_url}の動画が取得できませんでしたを 当職無能')
                    media_list.append('[[ファイル:(動画の取得ができませんでした)|240px]]')
                    continue

                data_url: str | list[str] | None = video.get('data-url')
                assert isinstance(data_url, str)
                matched: Match[str] | None = re.search(r'[^\/]+$', data_url)
                assert matched is not None
                media_path: str = unquote(matched.group(0))
                tweet_id: str = tweet_url.split('/')[-1]
                ts_filename: str = (
                    f'{os.path.join(self.MEDIA_DIR, tweet_id)}_{i}.ts'
                )
                mp4_filename: str = (
                    f'{os.path.join(self.MEDIA_DIR, tweet_id)}_{i}.mp4'
                )

                match self._download_m3u8(
                        media_path,
                        ts_filename,
                        mp4_filename,
                        accessor.proxies):
                    case FfmpegStatus.MP4:
                        logger.info(f'{mp4_filename}をアップロードしなければない。')
                        media_list.append(f'[[ファイル:{tweet_id}_{i}.mp4|240px]]')
                    case FfmpegStatus.TS:
                        logger.info(f'{ts_filename}.tsをmp4に変換してアップロードしなければない。')
                        media_list.append(f'[[ファイル:{tweet_id}_{i}.mp4|240px]]')
                    case _:
                        logger.error(f'{tweet_url}の動画が取得できませんでしたを 当職無能')
                        media_list.append('[[ファイル:(動画の取得ができませんでした)|240px]]')

            media_txt = ' '.join(media_list)
        return media_txt

    def _get_tweet_quote(
            self,
            tweet: Tag,
            accessor: AccessorHandler) -> str:
        """引用リツイートの引用元へのリンクを取得する。

        Args:
            tweet (Tag): ツイート内容である ``.timeline-item`` タグを表すbeautifulsoup4タグ。
            accessor (AccessorHandler): アクセスハンドラ。

        Returns:
            str: Archiveテンプレートでラップされた引用元ツイートへのリンク。
        """
        tweet_quote: Final[Tag | None] = tweet.select_one(
            '.tweet-body > .quote.quote-big')  # 引用リツイートを選択
        quote_txt: str = ''
        if tweet_quote is not None:
            quote_link: Tag | None = tweet_quote.select_one('.quote-link')
            assert quote_link is not None
            link: str | list[str] | None = quote_link.get('href')
            assert isinstance(link, str)
            link = re.sub('#.*$', '', link)
            link = urljoin(self.TWITTER_URL, link)
            quote_txt = self._archive_url(link, accessor)
        tweet_quote_unavailable: Final[Tag | None] = tweet.select_one(
            '.tweet-body > .quote.unavailable')  # 引用リツイートを選択
        if tweet_quote_unavailable is not None:
            quote_txt = '(引用元が削除されました)'
        return quote_txt

    def _get_tweet_poll(self, tweet: Tag) -> str:
        """ツイートの投票結果を取得する。

        Args:
            tweet (Tag): ツイート内容である ``.timeline-item`` タグを表すbeautifulsoup4タグ。

        Returns:
            str: Wiki形式に書き直した投票結果。
        """
        tweet_poll: Final[Tag | None] = tweet.select_one(
            '.tweet-body > .poll')
        poll_txt: str = ''
        if tweet_poll is not None:
            poll_meters: Final[ResultSet[Tag]] = tweet_poll.select(
                '.poll-meter')
            poll_info: Tag | None = tweet_poll.select_one('.poll-info')
            assert poll_info is not None
            for poll_meter in poll_meters:
                poll_choice_value: Tag | None = poll_meter.select_one(
                    '.poll-choice-value')
                assert poll_choice_value is not None
                ratio: str = poll_choice_value.text
                poll_choice_option: Tag | None = poll_meter.select_one(
                    '.poll-choice-option')
                assert poll_choice_option is not None
                if 'leader' in poll_meter['class']:
                    poll_txt += ('<br>\n'
                                 '&nbsp; <span style="display: inline-block; '
                                 'width: 30em; background: linear-gradient('
                                 'to right, '
                                 f'rgba(29, 155, 240, 0.58) 0 {ratio}, '
                                 f'transparent {ratio} 100%); '
                                 'font-weight: bold;">') + \
                        ratio + ' ' + poll_choice_option.text + '</span>'
                else:
                    poll_txt += ('<br>\n'
                                 '&nbsp; <span style="display: inline-block; '
                                 'width: 30em; background: linear-gradient('
                                 'to right, '
                                 f'rgb(207, 217, 222) 0 {ratio}, '
                                 f'transparent {ratio} 100%);">') + \
                        ratio + ' ' + poll_choice_option.text + '</span>'
            poll_txt += '<br>\n&nbsp; <span style="font-size: small;">' + \
                poll_info.text + '</span>'
        return poll_txt

    def _get_timeline_items(self,
                            soup: BeautifulSoup) -> list[Tag]:
        """タイムラインのツイートを取得。

        基本的に投稿時刻の降順に取得し、リプライツリーは最後のツイートの時刻を基準として降順にひとまとまりにする。

        Args:
            soup (BeautifulSoup): Nitterのページを表すBeautifulSoupオブジェクト。

        Returns:
            list[Tag]: ツイートのアイテムである ``.timeline-item`` タグを表すTagオブジェクトのリスト。
        """
        timeline_item_list: list[Tag] = []
        for item_or_list in soup.select(
                '.timeline > .timeline-item, .timeline > .thread-line'):
            if 'unavailable' in item_or_list.attrs['class']:
                continue
            elif 'thread-line' in item_or_list.attrs['class']:
                # そのままtimeline-itemクラスをfind_allするとツイートの順番が逆転するので、順番通りに取得するよう処理
                for item in reversed(item_or_list.select('.timeline-item')):
                    timeline_item_list.append(item)
            else:
                timeline_item_list.append(item_or_list)
        return timeline_item_list

    def _archive_soup(
            self,
            tag: Tag,
            accessor: AccessorHandler) -> None:
        """ツイート内のaタグをテンプレートArchiveの文字列に変化させる。

        NitterリンクをYouTubeへのリンクに、bibliogramへのリンクをInstagramへのリンクに修正する。

        Args:
            tag (Tag): ツイート内容の本文である ``.media-body`` タグを表すbeautifulsoup4タグ。
            accessor (AccessorHandler): アクセスハンドラ
        """
        urls_in_tweet: Final[ResultSet[Tag]] = tag.find_all(
            'a')
        for url in urls_in_tweet:
            href: str | list[str] | None = url.get('href')
            assert isinstance(href, str)

            if href.startswith('https://') or href.startswith('http://'):
                # 先頭にhttpが付いていない物はハッシュタグの検索ページへのリンクなので処理しない
                if href.startswith('https' + self.NITTER_INSTANCE[4:]):
                    # Nitter上のTwitterへのリンクを直す
                    url_link: str = href.replace(
                        'https' + self.NITTER_INSTANCE[4:], self.TWITTER_URL)
                    url_link = re.sub('\\?.*$', '', url_link)
                    url.replace_with(self._archive_url(url_link, accessor))
                elif href.startswith('https://nitter.kavin.rocks/'):
                    # Nitter上のTwitterへのリンクを直す
                    url_link: str = href.replace(
                        'https://nitter.kavin.rocks/', self.TWITTER_URL)
                    url_link = re.sub('\\?.*$', '', url_link)
                    url.replace_with(self._archive_url(url_link, accessor))
                elif self._invidious_pattern.search(href):
                    # Nitter上のYouTubeへのリンクをInvidiousのものから直す
                    if re.match(
                            'https://[^/]+/[^/]+/',
                            href) or re.search(
                            '/@[^/]*$',
                            href):
                        href = self._invidious_pattern.sub('youtube.com', href)
                    else:
                        href = self._invidious_pattern.sub('youtu.be', href)
                    url.replace_with(self._archive_url(href, accessor))
                elif href.startswith('https://bibliogram.art/'):
                    # Nitter上のInstagramへのリンクをBibliogramのものから直す
                    # Bibliogramは中止されたようなのでそのうちリンクが変わるかも
                    url_link: str = href.replace(
                        'https://bibliogram.art/',
                        'https://www.instagram.com/')
                    url.replace_with(self._archive_url(url_link, accessor))
                else:
                    url.replace_with(self._archive_url(href, accessor))
            elif url.text.startswith('@'):
                url_link: str = urljoin(self.TWITTER_URL, href)
                url_text: str = url.text
                url.replace_with(
                    self._archive_url(
                        url_link, accessor, url_text))

    def _archive_url(
            self,
            url: str,
            accessor: AccessorHandler,
            text: str | None = None) -> str:
        """URLをArchiveテンプレートでラップする。

        フラグメント識別子がURLに含まれていたら、Archive側のURLにも反映させる。

        Args:
            url (str): ラップするURL。
            accessor (AccessorHandler): アクセスハンドラ。
            text (str | None, optional): ArchiveテンプレートでURLの代わりに表示する文字列。

        Returns:
            str: ArchiveタグでラップしたURL。
        """
        if '#' in url:  # フラグメント識別子の処理
            main_url, fragment = url.split('#', maxsplit=1)
            return self._table_builder.archive_url(
                url, self._archive(main_url, accessor) + '#' + fragment, text)
        else:
            return self._table_builder.archive_url(
                url, self._archive(url, accessor), text)

    def _callinshowlink_url(self, url: str, accessor: AccessorHandler) -> str:
        """URLをCallinShowLinkテンプレートでラップする。

        Args:
            url (str): ラップするURL。
            accessor (AccessorHandler): アクセスハンドラ。

        Returns:
            str: CallinShowLinkタグでラップしたURL。
        """
        return self._table_builder.callinshowlink_url(
            url, self._archive(url, accessor))

    def _archive(self, url: str, accessor: AccessorHandler) -> str:
        """URLから対応するarchive.todayのURLを返す。

        取得できれば魚拓ページのURLを返す。
        魚拓がなければその旨の警告を表示し、https://archive.ph/https%3A%2F%2Fxxxxxxxxの形で返される。
        アクセスに失敗すればその旨の警告を表示し、https://archive.ph/https%3A%2F%2Fxxxxxxxxの形で返される。

        Args:
            url (str): 魚拓を取得するURL。
            accessor (AccessorHandler): アクセスハンドラ。

        Returns:
            str: 魚拓のURL。
        """
        archive_url: str = urljoin(
            self.ARCHIVE_TODAY_STANDARD,
            quote(
                unquote(url),
                safe='&=+?%'))
        res: Final[str | None] = accessor.request(urljoin(
            self.ARCHIVE_TODAY, quote(unquote(url), safe='&=+?%')))
        if res is None:  # 魚拓接続失敗時処理
            # https://archive.ph/https%3A%2F%2Fxxxxxxxxの形で返される
            logger.error(archive_url + 'にアクセス失敗ナリ。出力されるテキストにはそのまま記載されるナリ。')
        else:
            soup: Final[BeautifulSoup] = BeautifulSoup(res, 'html.parser')
            content: Tag | NavigableString | None = soup.find(
                id='CONTENT')  # archive.todayの魚拓一覧ページの中身だけ取得
            if (content is None or content.get_text()[:len(self.NO_ARCHIVE)]
                    == self.NO_ARCHIVE):  # 魚拓があるかないか判定
                logger.warning(url + 'の魚拓がない。これはいけない。')
            else:
                assert isinstance(content, Tag)
                content_a: Tag | NavigableString | None = content.find('a')
                assert isinstance(content_a, Tag)
                href: str | list[str] | None = content_a.get('href')
                assert isinstance(href, str)
                archive_url = href.replace(
                    self.ARCHIVE_TODAY, self.ARCHIVE_TODAY_STANDARD)
        return archive_url

    def _get_tweet(self, accessor: AccessorHandler) -> None | NoReturn:
        """ページからツイート本文を ``TableBuilder`` インスタンスに収めていく。

        ツイートの記録を中断するための文を発見するか、記録したツイート数が :const:`~LIMIT_N_TWEETS` 件に達したら終了する。

        Args:
            accessor (AccessorHandler): アクセスハンドラ

        Returns:
            None | NoReturn: 終わりにするツイートを発見するか、記録件数が上限に達したら終了。
        """
        soup: Final[BeautifulSoup] = BeautifulSoup(
            self._page, 'html.parser')
        tweets: Final[list[Tag]] = self._get_timeline_items(
            soup)  # 一ツイートのブロックごとにリストで取得
        for tweet in tweets:  # 一ツイート毎に処理
            tweet_a: Tag | None = tweet.a
            assert tweet_a is not None
            if tweet_a.text == self.NEWEST:
                # Load Newestのボタンは処理しない
                continue
            if tweet.find(class_='retweet-header') is not None:
                # retweet-headerはリツイートを示すので入っていれば処理しない
                continue
            if tweet.find(class_='pinned') is not None:
                # pinnedは固定ツイートを示すので入っていれば処理しない
                continue
            if len(self._query_strs) > 0:
                # クエリが指定されている場合、一つでも含まないツイートは処理しない
                not_match: bool = False
                for query_str in self._query_strs:
                    if query_str not in tweet.text:
                        not_match = True
                        break
                if not_match:
                    continue

            tweet_link: Tag | NavigableString | None = tweet.find(
                class_='tweet-link')
            assert isinstance(tweet_link, Tag)
            href: str | list[str] | None = tweet_link.get('href')
            assert isinstance(href, str)
            tweet_url: str = urljoin(
                self.TWITTER_URL,
                re.sub('#[^#]*$', '', href))
            date: datetime = self._tweet_date(tweet)
            self._table_builder.next_day_if_necessary(date)
            archived_tweet_url: str = self._callinshowlink_url(
                tweet_url, accessor)
            tweet_content: Tag | NavigableString | None = tweet.find(
                class_='tweet-content media-body')
            assert isinstance(tweet_content, Tag)
            self._archive_soup(tweet_content, accessor)
            media_txt: str = self._get_tweet_media(tweet, accessor)
            quote_txt: str = self._get_tweet_quote(tweet, accessor)
            poll_txt: str = self._get_tweet_poll(tweet)
            self._table_builder.append(
                archived_tweet_url, '<br>\n'.join(
                    filter(
                        None,
                        [
                            self._table_builder.escape_wiki_reserved_words(
                                tweet_content.get_text()),
                            quote_txt, media_txt, poll_txt
                        ])))

            if self._table_builder.count % self.REPORT_INTERVAL == 0:
                logger.info(
                    f'ツイートを{self._table_builder.count}件も記録したンゴｗｗｗｗｗｗｗｗｗｗｗ')
            if self._stop != '' and self._stop in tweet_content.get_text():
                logger.info('目的ツイート発見でもう尾張屋根')
                self._table_builder.dump_file()
                sys.exit(0)
            if self._table_builder.count >= self.LIMIT_N_TWEETS:
                logger.info(f'{self.LIMIT_N_TWEETS}件も記録している。もうやめにしませんか。')
                self._table_builder.dump_file()
                sys.exit(0)

    def _go_to_new_page(self, accessor: AccessorHandler) -> None | NoReturn:
        """Nitterで次のページに移動する。

        次のページが無ければプログラムを終了する。

        Args:
            accessor (AccessorHandler): アクセスハンドラ

        Returns:
            None | NoReturn: Nitterで次のページが無ければ終了。
        """
        soup: Final[BeautifulSoup] = BeautifulSoup(self._page, 'html.parser')
        show_mores: Final[ResultSet[Tag]] = soup.find_all(class_='show-more')
        new_url: str = ''
        for show_more in show_mores:  # show-moreに次ページへのリンクか前ページへのリンクがある
            if show_more.text != self.NEWEST:  # 前ページへのリンクではないか判定
                show_more_a: Tag | None = show_more.a
                assert show_more_a is not None
                href: str | list[str] | None = show_more_a.get('href')
                assert isinstance(href, str)
                new_url = urljoin(
                    self.NITTER_INSTANCE,
                    self._name
                    + '/'
                    + self.TWEETS_OR_REPLIES
                    + href)  # 直下のaタグのhrefの中身取ってURL頭部分と合体
        res: Final[str | None] = accessor.request(new_url)
        if res is None:
            self._on_fail()
        new_page_soup: Final[BeautifulSoup] = BeautifulSoup(res, 'html.parser')
        if new_page_soup.find(
                class_='timeline-end') is None:
            # ツイートの終端ではtimeline-endだけのページになるので判定
            logger.info(new_url + 'に移動しますを')
            self._page = res  # まだ残りツイートがあるのでページを返して再度ツイート本文収集
        else:
            logger.info('急に残りツイートが無くなったな終了するか')
            self._table_builder.dump_file()
            sys.exit(0)

    def execute(self, krsw: bool = False, use_browser: bool = True,
                enable_javascript: bool = True) -> NoReturn:
        """通信が必要な部分のロジック。

        Args:
            krsw (bool, optional): Trueの場合、名前が自動で :const:`~CALLINSHOW` になり、
                クエリと終わりにするツイートが自動で無しになる。
            use_browser (bool, optional): TrueならSeleniumを利用する。
                FalseならRequestsのみでアクセスする。
            enable_javascript (bool, optional): SeleniumでJavaScriptを利用する場合は
                True。
        """
        # Seleniumドライバーを必ず終了するため、with文を利用する。
        with AccessorHandler(use_browser, enable_javascript) as accessor:
            # 実行前のチェック
            self._check_nitter_instance(accessor)
            self._check_archive_instance(accessor)
            # Invidiousのインスタンスリストの正規表現パターンを取得
            invidious_url_tuple: Final[tuple[str, ...]] = (
                self._invidious_instances(accessor)
            )
            self._invidious_pattern: re.Pattern[str] = re.compile(
                '|'.join(invidious_url_tuple))

            # 検索クエリの設定
            self._set_queries(accessor, krsw)

            # ツイートを取得し終えるまでループ
            while True:
                self._get_tweet(accessor)
                self._go_to_new_page(accessor)


if __name__ == '__main__':
    if sys.version_info.major < 3 or (
            sys.version_info.major == 3 and sys.version_info.minor < 11):
        logger.critical('Pythonのバージョンを3.11以上に上げて下さい')
        sys.exit(1)
    parser: ArgumentParser = ArgumentParser()
    parser.add_argument(
        '--krsw',
        action='store_true',
        help='指定すると、パカデブのツイートを取得上限数まで取得する。')
    parser.add_argument(
        '-n',
        '--no_browser',
        action='store_true',
        help='指定すると、Tor Browserを利用しない。')
    parser.add_argument(
        '-d',
        '--disable_script',
        action='store_true',
        help='指定すると、Tor BrowserでJavaScriptを利用しない。')
    args: Namespace = parser.parse_args()

    twitter_archiver: TwitterArchiver = TwitterArchiver()
    twitter_archiver.execute(
        args.krsw,
        not args.no_browser,
        not args.disable_script)
‎

実行例

20件での実行例。

12月10日

https://twitter.com/CallinShow/status/1601539154256744449(魚拓)
なお、ひめかファンのワタクシ、ブロックされております。 ひめかちゃんは整形なんかじゃない。
https://twitter.com/CallinShow/status/1601542511302160384(魚拓)
今日もお疲れ。 また明日な。
https://twitter.com/CallinShow/status/1601569138379718656(魚拓)
https://youtu.be/QR6Gj0MKcew(魚拓) 直生人へ。
https://twitter.com/CallinShow/status/1601572951463428096(魚拓)
菊地翔 エクシアポケモン図鑑名:キングオブポンジひめに夢中。キングオブポンジキャバ中毒の最終形。 一人称:オレ。 得意技:インスタライブでおらつく。 　　　ひめかに会いにいく。 　　　逃げる。 　　　ちょび髭を生やす。 　　　写真を加工する。 　　　アルファロメオに乗り換える。
https://twitter.com/CallinShow/status/1601588268487041024(魚拓)
日曜阪神11R 阪神JF ◎ブトンドール　4.5 ◯ミスヨコハマ 5 ▲リバーラ 4.5 △リバティアイランド 4 △アロマディオーサ 3.75 △ラヴェル 3.5 △ウインブライル 2.5 △ドゥーラ 1.5 △キタウイング 1.5

12月11日

https://twitter.com/CallinShow/status/1601859263928074240(魚拓)
とんでもない目にあったが、香港マイルで復活した。 https://twitter.com/CallinShow/status/1601588268487041024(魚拓)
https://twitter.com/CallinShow/status/1601870854669094912(魚拓)
今日は日曜日だ。エクシア合同会社のことについてツイートするのはやめようかと思ったんだ。 みんなどう思う？   56% 菊地翔は詐欺師だからツイートして欲しい。   16% 関戸直生人が逃げているからツイートして欲しい。   5% 高橋佑佳は、いつも菊地の横にいるからツイートしろ。   23% ひめかさんへの応援メッセージお願いします。   177 votes • Final results
https://twitter.com/CallinShow/status/1601888790489886720(魚拓)
ジョーカー菊地
https://twitter.com/CallinShow/status/1601889110507278339(魚拓)
た、た、大変だーーーーー ひめかさんの今年の売り上げ目標10億 言っちゃうんだな。 そこだよ。 いいところ。 今それ言えちゃう、鬼メンタル。 https://news.yahoo.co.jp/articles/7d3609cb0e6c284d5fae6301f35bf2f27573ef35?page=1(魚拓)
https://twitter.com/CallinShow/status/1601890607848296448(魚拓)
https://note.com/takahirokarasawa/n/na966edc6e6be(魚拓) エクシア合同会社は改めまして詐欺会社です。
https://twitter.com/CallinShow/status/1601904473906982913(魚拓)
いつも明るい菊地。 ファイル:1601904473906982913 0.mp4
https://twitter.com/CallinShow/status/1601915902538051584(魚拓)
依頼者から送られてきたけど、何の情報か教えて欲しいな。 エクシアの関係者なんでしょ。
https://twitter.com/CallinShow/status/1601916198425309185(魚拓)
発信している情報は全部裏を取ってるんだよね。 https://twitter.com/CallinShow/status/1601915902538051584(魚拓)
https://twitter.com/CallinShow/status/1601916490587901952(魚拓)
いくつか大きなネタはあるんだけど、今はあたためてる。 この事件は本当色んなことがあるんだ。
https://twitter.com/CallinShow/status/1601949819404066816(魚拓)
菊地翔が夢に出てきた。 オレも末期だな。 なぜか、スナックで一緒にカラオケを歌ってた。
https://twitter.com/CallinShow/status/1601954620204797953(魚拓)
3枚目と4枚目は微妙に口の開き方が違う。3枚目は「ね」、4枚目は「い」を発音しているときの口の開き方だ。 https://twitter.com/morumokoko/status/1601951502200774656(魚拓)

12月12日

https://twitter.com/CallinShow/status/1601955353792430081(魚拓)
エクシア合同会社のツイートの中に、岡ちゃんのツイートをリツイートしてしまってごめん。 本当に興味あるのは菊地翔じゃなくて岡ちゃんなんだ。 https://twitter.com/CallinShow/status/1601954620204797953(魚拓)
https://twitter.com/CallinShow/status/1601958600259371011(魚拓)
日曜日に誰もエクシア合同会社のことなんか、呟きたいなんて思わないのが普通だと思う。 でも、エクシア合同会社が詐欺会社であり、皆んな許せないと思ってやってるんだ。 エクシア合同会社を許してはいけない、そんな気持ちで我々会ったことのない大人達はつながっているんだ。
https://twitter.com/CallinShow/status/1601959896252981249(魚拓)
ときにはふざけたツイートをしているように思うかもしれない。 でも、本気なんだよ。 1人でも多くの人に知ってもらって、その声が大きくなって、これが社会問題化して、ちゃんと法の裁きを受ける。 その一心でいつもTwitterに臨んでいる。
https://twitter.com/CallinShow/status/1601961096528613376(魚拓)
エクシア合同会社と闘う大人たちがやっていることは、Twitterを使った世直し運動なんだ。 みんな正業があり、それぞれの生活の中で調べ、問題点を指摘し続けている。 政治はまだこの問題を見過ごしているけれど、一万人700億円の話。 これは人々が苦しんでいる話。 だから皆んな立ち上がっている。