Traffic4SEO CLI 使用ガイド

Traffic4SEO CLI は、グラフィカルインターフェースを必要とせずに、サーバーや個人用コンピュータ上で自動 SEO ワークフローを実行できる強力なコマンドラインツールです。

クイックインストール

Linux

curl -fsSL https://traffic4seo.com/install-cli | bash

{warning} Linuxで実行する場合の前提条件:

  1. ブラウザを解凍するために、システムに unzip がインストールされている必要があります。
  2. 画面のないLinuxサーバー（VPS）では、起動時のブラウザのクラッシュを防ぐために、必要なChromiumシステム依存ライブラリをインストールしてください:
    • 方法1 (推奨 - 全Linux対応の自動インストール):
        curl -fsSL https://traffic4seo.com/install-deps | sudo bash

      (Ubuntu 20/22/24、Debian 11/12、CentOS、RHEL、Rocky、AlmaLinuxを自動検出して適切なパッケージをインストールします)

    • 方法2 (OS別の手動インストール):
      • Ubuntu (20.04/22.04/24.04) / Debian (11/12):
          sudo apt-get update && sudo apt-get install -y unzip libnss3 libnspr4 libdrm2 libxkbcommon0 libxcomposite1 libxdamage1 libxfixes3 libxrandr2 libgbm1 libpango-1.0-0 libcairo2 libx11-6 libxcb1 libxext6 fonts-liberation $(apt-cache show libasound2t64 >/dev/null 2>&1 && echo "libasound2t64 libcups2t64 libatk1.0-0t64 libatk-bridge2.0-0t64 libatspi2.0-0t64" || echo "libasound2 libcups2 libatk1.0-0 libatk-bridge2.0-0")
      • CentOS / RHEL / Rocky / AlmaLinux:
          sudo dnf install -y unzip nss nspr atk at-spi2-atk cups-libs libdrm libxkbcommon libXcomposite libXdamage libXfixes libXrandr mesa-libgbm alsa-lib pango cairo libX11-xcb libxcb libxshmfence liberation-fonts

Windows (PowerShell)

irm https://traffic4seo.com/install-cli.ps1 | iex

基本的な使い方

インストール後、1つのコマンドを入力するだけで開始できます：

t4s-cli

1. ログイン（初回使用時）

初めて CLI を実行する場合、システムから アクセストークン の入力を求められます。

  1. Traffic4SEO ダッシュボードにアクセスしてトークンを取得します。
  2. プロンプトが表示されたら、ターミナルにトークンを貼り付けます。
  3. システムは 30日間 ログイン情報を記憶します。

2. ブラウザの自動インストール

初回実行時に適切なブラウザが見つからない場合、CLI は次のように尋ねます： "Do you want to download the Bundled Chromium? (y/n)" y と入力するだけで、システムが自動的にすべてをダウンロードして設定します。

高度なオプション

CLI は、セッションをカスタマイズするためのいくつかのパラメータをサポートしています：

オプション エイリアス デフォルト 説明
--token -t トークンを直接提供する（保存されたトークンを上書き）
--name -n Hostname インスタンスのカスタム表示名を設定（デフォルト: コンピュータのホスト名）
--tabs 30 並列実行するブラウザタブ数（最大30）
--headless true ブラウザウィンドウを表示する場合は false に設定
--no-monitor TUI 監視インターフェースを無効にしてプレーンログを表示
--proxy -p プロキシ接続 URI 文字列 (http://user:pass@host:port) (推奨)
--proxy-host -ph プロキシサーバーのホスト名またはIP (レガシー)
--proxy-port -pp プロキシサーバーのポート (レガシー)
--proxy-type -pt http プロキシの種類 (http, https, socks5) (レガシー)
--memory 80 システムが使用できる最大 RAM の割合 % (1-99)
--only-warmup ブラウザとクッキーを初期化して終了
--force -f 同梱の Chromium を強制的に再インストール
--restart 指定された時間（分）の経過後に CLI を自動再起動します（正の整数を指定）

高度な設定例

カスタム名 VPS-US-01、10 個のタブ、SOCKS5 プロキシ URI を指定して CLI を実行する：

t4s-cli --name="VPS-US-01" --tabs=10 --proxy="socks5://user:[email protected]:1080"

バックグラウンド実行 (Linux)

ターミナルを閉じた後も CLI を実行し続けるには（VPS など）、Screen の使用をお勧めします：

  1. 新しいセッションを作成：screen -S t4s
  2. コマンドを実行：t4s-cli
  3. Ctrl + A を押してから D を押してデタッチ（切り離し）します。
  4. いつでも再アタッチ可能：screen -r t4s

アンインストール

インストールディレクトリと設定ディレクトリを削除します：

rm -rf ~/.t4s-cli
rm -rf ~/.config/t4s-cli

トラブルシューティング

アップデートのロック競合 (アップデートの中断)

起動時に以下の警告が表示される場合：

[AutoUpdater] ERROR: Update process seems to be stuck or failed!
Timeout waiting for lock directory: versions/vX.Y.Z.lock

これは、前回のアップデート処理が完了してファイルロックが解除される前に、クラッシュまたは強制終了された場合に発生します。

解決策：

他の t4s-cli インスタンスが実行されていないことを確認し、ロックディレクトリを手動で削除します。

Linux:

rm -rf ~/.t4s-cli/versions/*.lock

Windows (PowerShell):

Remove-Item -Path "$HOME\.t4s-cli\versions\*.lock" -Recurse -Force

Windows (CMD):

rmdir /s /q "%USERPROFILE%\.t4s-cli\versions\vX.Y.Z.lock"

プロキシ接続のリトライと終了コード 43

プロキシ接続環境下で実行する場合、初期 API リクエスト（トークン検証、インスタンス初期化および開始）で一時的なネットワーク遅延が発生することがあります。 CLI は 5 秒ごとに最大 3 回 自動的にリトライします。

3 回のリトライ後も失敗が続く場合：

  • CLI はネットワークエラーを記録し、終了コード 43 で終了します。
  • 終了コード 43 は、プロセス管理ツール（ラッパー、PM2、systemd スクリプトなど）に対して CLI プロセスを自動再起動して再試行するよう通知します。