Traffic4SEO CLI 使用ガイド

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

クイックインストール

Linux

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

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

  1. ブラウザを解凍するために、システムに unzip がインストールされている必要があります。
  2. 画面のないLinuxサーバー（VPS）では、起動時のブラウザのクラッシュを防ぐために、以下のChromiumシステム依存ライブラリをインストールする必要があります。
    • Ubuntu / Debian:
        sudo apt-get update && sudo apt-get install -y unzip libnss3 libnspr4 libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2 libxkbcommon0 libxcomposite1 libxdamage1 libxrandr2 libgbm1 libasound2 libpango-1.0-0 libcairo2 libx11-xcb1 libxcb-dri3-0 libxshmfence1
    • CentOS / RHEL / Rocky Linux:
        sudo dnf install -y unzip nss nspr atk at-spi2-atk cups-libs libdrm libxkbcommon libXcomposite libXdamage libXrandr mesa-libgbm alsa-lib pango cairo libX11-xcb libxcb libxshmfence

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 トークンを直接提供する（保存されたトークンを上書き）
--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) (レガシー)
--only-warmup ブラウザとクッキーを初期化して終了
--force -f 同梱の Chromium を強制的に再インストール
--restart 指定された時間（分）の経過後に CLI を自動再起動します（正の整数を指定）

高度な設定例

10 個のタブを使用し、SOCKS5 プロキシ URI 経由で CLI を実行する：

t4s-cli --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"