X Harness
導入ガイド

画像なし（例外）

※ この手順は上のアドレスを開くだけのため、画像はありません。開いた画面は、次の手順2の画像で確認できます。

この画面は英語ですが、入力するのは2つだけです。

Email: メールアドレス
Password: 新しく決めるパスワード（画面の案内どおり、8文字以上・数字1つ以上・記号1つ以上）

「Continue with Google」でGoogleアカウントから作ることもできます（人によって異なります）。このガイドはメールアドレスで登録する前提で進めます。画像のメールアドレスは記入例です。ご自身のものを入力してください。

画面の「私はロボットではありません」にチェックを入れてから、「Sign up」を押します。

登録したメールアドレスに、Cloudflareから確認メールが届きます。メール内の確認ボタン（Verify email）を押せば、アカウント作成は完了です。

画像なし（例外）

※ メール画面のため、画像はありません。もし、メールが見当たらないときは、迷惑メールフォルダも確認してください。

画像なし（例外）

※ この手順は上のアドレスを開くだけのため、画像はありません。開いた画面は、次の手順6の画像で確認できます。

緑色の「Node.js®を入手」ボタンを押して、インストーラをダウンロードします。「LTS版」と書かれているものが安定版です。

ダウンロードしたファイルを開き、画面の案内どおり「続ける」（Windowsは「Next」）を押していけばインストール完了です。設定を変える必要はありません。

画像なし（例外）

※ パソコンのインストール画面のため、画像はありません。

ここから「ターミナル」という黒い画面を使います。コマンド（命令文）をコピーして貼り付けるだけなので、難しい操作はありません。

Mac: 画面右上の虫めがね（Spotlight）を押して「ターミナル」と入力し、Enter
Windows: スタートボタンを押して「PowerShell」と入力し、Enter

画像なし（例外）

※ パソコンの画面のため、画像はありません。

ターミナルに次をコピーして貼り付け、Enterを押します。

node -v

v22.18.0 のように「v」から始まる数字が出ればOKです（20以上であれば大丈夫です）。

画像なし（例外）

※ ターミナルの画面のため、画像はありません。

ターミナルに次をコピーして貼り付け、Enterを押します。

npx create-x-harness

画像なし（例外）

※ ターミナルの画面のため、画像はありません。

最初にファイルのダウンロードが走り（「X Harness をダウンロード中...」→「ダウンロード完了」→「依存関係インストール中...」）、続いて環境チェックが流れます。そのあと、次の案内が出ます。

 X Harness セットアップ

X Harness は 3 Step で導入できます。

  Step 1. Cloudflare アカウント設定
  Step 2. X (Twitter) API 認証情報の取得
  Step 3. プロジェクト名の入力

残りの作業（D1 作成・Worker / Admin デプロイ等）は自動で行います。

このガイドのPart 3以降は、この3つのStepを順番になぞっていきます。

画像なし（例外）

※ ターミナルの画面のため、画像はありません。

ターミナルに次の案内が表示され、少し待つとブラウザが自動で開きます。

═══ Step 1. Cloudflare アカウント設定 ═══

Cloudflare の無料枠で Worker と D1 をホストします。
アカウントがない場合は事前に作成してください:

https://dash.cloudflare.com/sign-up
→ メールアドレス・パスワードを登録
→ メール認証を完了

完了したら下のログイン画面に進みます（ブラウザが自動で開きます）。

続けて「ブラウザが開きます。Cloudflare にログインしてください。」と表示されます。Part 1 で作ったアカウント（メールアドレスとパスワード、またはGoogle）でログインします。

ログインすると、Wrangler（ラングラー）というツールにアカウントへのアクセスを許可するか、英語の確認画面が出ます。許可のボタン（Allow）を押してください。

ターミナルに「Cloudflare ログイン完了」と出れば成功です。ブラウザのタブは閉じてOKです。

画像なし（例外）

※ ログイン後の画面のため、画像はありません。

Cloudflareに複数のアカウントがある方は、ここで次の質問が出ます（出なければ、そのまま次へ進んでください）。

使用する Cloudflare アカウントを選択してください

矢印キーで自分のアカウントを選んでEnterを押します。選ぶと「Cloudflare アカウント:」に続けて英数字が表示されます。

画像なし（例外）

※ ターミナルの画面のため、画像はありません。

ターミナルに、次の道順が表示されます。

■ Step 2-1. X Developer アカウント申請

https://developer.x.com にアクセス
→ コンソールへ
→ X アカウントでログイン
→ ユースケース説明を **英語で 250 文字以上** 入力
  （後述のサンプルをコピペで OK）
→ 利用規約に同意して送信

※ 英語の説明文は X のレビューを通すために必須です。日本語不可。
  以下のサンプルをそのままコピペして使えます。

開くと、下の画像の画面が出ます。

画面の「コンソールへ」を押します。

Xのログイン画面に移るので、自動運用したいXアカウントでログインします。

画像なし（例外）

※ この手順はログイン後の画面のため、画像はありません。画面内の道順は、上のターミナル表示のとおりです。

「このAPIを何に使うか」を英語で250文字以上書く欄が出ます。ターミナルにも書いてあるとおり「英語の説明文は X のレビューを通すために必須です。日本語不可。」——ターミナルに表示される次のサンプルを、そのままコピーして貼り付けてOKです。

I will use the X (Twitter) API to automate my own X account for
personal marketing purposes. Specifically, I will use the API to:
(1) post tweets and threads on a schedule, (2) reply to mentions
of my own account, (3) read public engagement metrics (likes,
retweets, replies) on my own posts to measure marketing
effectiveness, and (4) verify whether specific users have liked,
retweeted, or followed my account so that I can deliver promised
rewards to them. I will not display tweets or aggregate Twitter
data outside of Twitter, and I will not share data with any
government entity. All actions are limited to my own account.

内容は「自分のアカウントだけを、自分のために自動化する」という説明です。書き換えずにそのまま使えます。

画像なし（例外）

※ この手順はログイン後の画面のため、画像はありません。画面内の道順は、上のターミナル表示のとおりです。

利用規約のチェックを入れて、送信ボタンを押します。

画像なし（例外）

※ この手順はログイン後の画面のため、画像はありません。画面内の道順は、上のターミナル表示のとおりです。

申請が終わったらターミナルに戻り、Enterを押します。

Developer アカウント申請が完了したら Enter を押してください

画像なし（例外）

※ ターミナルの画面のため、画像はありません。

ターミナルに、次の案内が表示されます。

■ X Developer Console でクレジットを購入

※ 基本は 5 ドルの課金のみで十分です。
※ X Harness が課金することはありませんのでご安心ください。

X Developer Consoleの左のメニューで「請求書作成」→「クレジット」を開きます。「クレジット／無料およびプリペイドクレジットを管理します。」と書かれた画面が出るので、右上の「クレジットを購入する」を押して、クレジットカードを登録し5ドル分を購入します。

ターミナルにも書いてあるとおり「X Harness が課金することはありませんのでご安心ください」——支払いはX社に対してのものだけです。

画像の金額の部分は、こちらのアカウントの残高のため伏せています。

クレジット購入手続きが完了したら Enter を押してください

画像なし（例外）

※ ターミナルの画面のため、画像はありません。

ターミナルに、次の道順が表示されます。

■ Step 2-1.5. プロジェクトとアプリ作成

Developer Console にログインした状態で:
→ アプリ → 新規作成
→ プロジェクト名・用途を入力
→ アプリ名（任意の名前）、Environment（Development）を入力
→ 作成完了

実際の画面では、左のメニューの「アプリ」を開き、画面の右上にある「＋」を押します。ターミナルには「新規作成」と書かれていますが、画面のボタンに文字はなく、＋の記号だけです。

押すと、プロジェクト名・用途・アプリ名の入力に進みます。プロジェクト名・アプリ名は、特に決まっていない方は自分の屋号やサービス名でOKです。Environment（環境）は、道順のとおり Development を選びます。

画像のアプリ名など、こちらのアカウントの情報は伏せています。

プロジェクト・アプリ作成が完了したら Enter を押してください

画像なし（例外）

※ ターミナルの画面のため、画像はありません。

ターミナルに、次の案内が表示されます。

■ Step 2-2. コンシューマーキー / Secret Key 取得

そのままの画面でコンシューマーキー / Secret Key を収録します。

※ この画面を閉じると二度と表示されません。両方コピーしてから次へ進んでください

画像なし（例外）

※ この手順はログイン後の画面のため、画像はありません。画面内の道順は、上のターミナル表示のとおりです。

コピーしたコンシューマーキーを貼り付けて、Enterを押します。

コンシューマーキー
表示されたコンシューマーキーを貼り付け

画像なし（例外）

※ ターミナルの画面のため、画像はありません。

続けてSecret Keyを貼り付けて、Enterを押します。

Secret Key
表示された Secret Key を貼り付け

画像なし（例外）

※ ターミナルの画面のため、画像はありません。

ターミナルに、次の道順が表示されます。

■ ユーザ認証設定（重要：アクセストークン生成より前に必ず実施）

→ ユーザ認証設定 → セットアップ
→ アプリの権限
→ 「読み書きおよびダイレクトメッセージ」をチェック
→ 変更を保存する

※ ここを先に設定しないと、後で生成するアクセストークンが
  Read のみとなり投稿・返信・DM が動作しません。

※ コールバック URI やウェブサイト URL は後のステップで案内します。
  ここではアプリ権限の変更だけでOKです。

実際の画面では、左のメニューの「アプリ」→ 作ったアプリの行 →右上の「設定」と進みます。「認証設定」という画面が開き、一番上に「アプリの権限（必須）」があります。

選択肢は3つです。一番下の「読み書きおよびダイレクトメッセージ」（説明文は「投稿とプロフィール情報を読み取る、ダイレクトメッセージを読み取るおよび投稿する」）を選び、画面の一番下にある「変更を保存する」を押します。ここではこれだけでOKです。コールバックURIとウェブサイトURLは Part 12 で設定します。

アプリ権限の設定が完了したら Enter を押してください

画像なし（例外）

※ ターミナルの画面のため、画像はありません。

ターミナルに、次の道順が表示されます。

■ Step 2-3. アクセストークン / アクセストークンシークレット 取得

同じ画面で
→ OAuth 1.0 キー セクション
→ アクセストークン → 「生成する」
→ 表示された **「アクセストークン」** と **「アクセスシークレット」** をコピー

権限を変更した画面の右上にある「キーに戻る」を押すと、「Keys & Tokens」（キーとトークン）の画面に戻ります。その中の「OAuth 1.0 キー」——画像で赤く囲んでいるところです——の「アクセストークン」の行で、生成のボタンを押します。表示された2つの文字列を、両方コピーします。

画像は、すでにトークンを作ったあとの状態のため「再生成」と表示されています。まだ作っていない場合は、同じ場所に生成のボタンが出ます。

この画面では、コンシューマーキーは「●」で隠れていて読めません。Part 7 でその場でコピーしておく必要があったのは、このためです。

コピーしたアクセストークンを貼り付けて、Enterを押します。

アクセストークン

画像なし（例外）

※ ターミナルの画面のため、画像はありません。

続けてアクセスシークレットを貼り付けて、Enterを押します。

アクセスシークレット

画像なし（例外）

※ ターミナルの画面のため、画像はありません。

ターミナルに、次の道順が表示されます。

■ Step 2-4. X User ID 取得

https://develop.tools/x-idcheck/ にアクセス
→ X のユーザー名（@ から始まる ID）を入力
→ 「取得実行」をクリック
→ 表示されたユーザ ID の数字をコピー

画像なし（例外）

※ この手順は上のアドレスを開くだけのため、画像はありません。開いた画面は、次の手順34の画像で確認できます。

「スクリーンネーム」と書かれた欄に、自分のXのユーザー名（@から始まるID）を入力します。

画面には「安全 取得結果は記録されず、どこにも公開もされません。」と書かれています。画像のユーザー名は記入例です。ご自身のものを入力してください。

入力できたら「取得実行」を押します。

ボタンを押すと、画面の下に結果の表が出ます。次の内容が並びます。

このうち「ユーザーID」の数字だけをコピーします。

画像なし（例外）

※ この画面は入力した内容によって表示が変わるため、画像はありません。

コピーした数字を貼り付けて、Enterを押します。

X User ID（数字）

数字以外を入れると「X User ID は数字で入力してください」と出ます。

画像なし（例外）

※ ターミナルの画面のため、画像はありません。

ターミナルに、次の案内が表示されます。

■ Step 2-5. X ユーザー名

X プロフィールの @ から始まる ID（@ は付けずに入力）

X ユーザー名（@ なし）
例: elonmusk

@を付けずに、ユーザー名だけを入力してEnterを押します（画面にも「例: elonmusk」と表示されます）。@を付けると「@ なしで入力してください」と出ます。

画像なし（例外）

※ ターミナルの画面のため、画像はありません。

═══ Step 3. プロジェクト名 ═══

Worker と D1 データベースの名前に使われます。
英小文字・数字・ハイフンのみ使用できます（例: my-x-bot）。

特に決まっていない方は、そのままEnterでOKです（自動で x-harness という名前になります）。自分で決める場合は、画面の案内どおり英小文字・数字・ハイフンだけが使えます。

画像なし（例外）

※ ターミナルの画面のため、画像はありません。

ここから先は全部自動です。ターミナルに次のような進行表示が流れます。数分かかることがあります（目安です）。

D1 データベース作成中...
D1 データベース作成完了
テーブル作成中...
テーブル作成完了
Worker デプロイ中...
Worker デプロイ完了
シークレット設定中...
シークレット設定完了
X アカウント登録中...
X アカウント登録完了
Admin UI ビルド中...
Admin UI ビルド完了
Admin UI デプロイ中...
Admin UI デプロイ完了

途中で手を動かす必要はありません。画面を閉じずにそのまま待ちます。

画像なし（例外）

※ ターミナルの画面のため、画像はありません。

ターミナルに、あなた専用のURLが2つ表示されます。

■ X Developer Console でコールバック URI を設定してください

→ ユーザ認証設定 → セットアップ → アプリ情報

  コールバックURI / リダイレクトURL（必須）:
    ＜あなたのWorker URL＞/auth/callback

  ウェブサイトURL（必須）:
    ＜あなたのAdmin URL＞

※ これを設定しないと X Harness との OAuth 連携が動作しません。

Part 8 と同じ「認証設定」の画面（左のメニューの「アプリ」→ アプリの行 →右上の「設定」）を開き、下にスクロールします。「アプリ情報」の中の「コールバックURI / リダイレクトURL（必須）」に1つ目を、その下の「ウェブサイトURL」に2つ目を貼り付けて、画面の一番下の「変更を保存する」を押します。

画面上の「ウェブサイトURL」には（必須）が付いていませんが、ターミナルの案内どおり2つとも入力してください。「組織名」「組織のURL」「利用規約」「プライバシーポリシー」は空のままでOKです。

画像の入力欄の中身は、こちらのアカウントのURLのため伏せています。

コールバック URI の設定が完了したら Enter を押してください

画像なし（例外）

※ ターミナルの画面のため、画像はありません。

ターミナルに、次の案内と質問が表示されます。

═══ オプション: 無料収集(twitter-cli)セットアップ ═══

X の読み取り(検索・投稿収集・メトリクス)を X API 課金なしで行えます。
仕組み: twitter-cli(Cookie 認証)を Claude Code / Codex の MCP 経由で実行します。

■ 必要なもの
  1. twitter-cli:  uv tool install twitter-cli  (または pipx install twitter-cli)
  2. X の Cookie 2 つ(auth_token, ct0)

■ Cookie の取得方法
  ブラウザで x.com にログイン → 開発者ツール → Application → Cookies → x.com
  → auth_token と ct0 の値をコピー

⚠ 凍結リスクの注意: 収集専用のサブアカウントの Cookie を推奨します。
  投稿(write)は X API 経由なので、メインアカウントの Cookie は不要です。
  Cookie はローカルの設定ファイルにのみ保存され、サーバーには送信されません。

無料収集をセットアップしますか?(後から .mcp.json に手動追加も可能)

いま「いいえ」を選ぶのは、ターミナルにも書いてある凍結リスクの注意があるためです。導入した直後に、メインアカウントのCookieを入れる必要はありません。あとから設定できます。

なお、この質問への答えにかかわらず、Claude CodeとCodex用のスキルはインストールされます（「スキルをインストールしました: .claude/skills/ と .codex/skills/ (x-growth-discover / x-growth-article / x-growth-video)」と表示されます）。

画像なし（例外）

※ ターミナルの画面のため、画像はありません。

ターミナルに、完了の案内が表示されます。

X Harness セットアップ完了！

Worker URL:
   ＜あなたのWorker URL＞

Admin URL（こちらが管理画面になります）:
   ＜あなたのAdmin URL＞

API Key:
   ＜自動生成されたキー（xh_ で始まる）＞
   → この値は再表示できません。安全な場所に保存してください

X アカウント:
   @＜あなたのユーザー名＞ (＜ユーザーID＞)

管理画面のログインに API Key を使用します

あわせて「Admin URL」も控えておきます。次のPartで開く管理画面のアドレスです。

画像なし（例外）

※ ターミナルの画面のため、画像はありません。

パソコンのブラウザで、手順44の「Admin URL」（<code>.pages.dev</code> で終わるURL）を開きます。

画像なし（例外）

※ アドレスは人によって違うため、画像はありません。開いた画面は、次の手順46の画像で確認できます。

「X Harness」「Xアカウント自動化ダッシュボード」と書かれたログイン画面が出ます。「API Key」の欄に、手順44で保存したAPI Keyを貼り付けます。

API Keyは秘密の値のため、画像では欄を空のままにしています。

貼り付けたら「ログイン」を押します。

ダッシュボードが開き、左側の「Xアカウント」に自分の@から始まるIDと表示名が出ていれば——セットアップは全て完了です。おつかれさまでした 🎉

これで、予約投稿・スレッド・自動返信・エンゲージメントゲートなどの機能が使える状態になっています。