X ／ 公式リポジトリの日本語解説
X Harness OSS版を、コードを読まずに理解する
X Harnessは、X（旧Twitter）の投稿・リプライ・DM・キャンペーンをまとめて扱う、オープンソースのソフトウェアです。公式リポジトリの内容を、発信する人の目線で整理しました。
- ソフトウェア利用料
- 0円（MIT License）
- 別にかかる費用
- X APIの利用料、Cloudflareの利用料、独自ドメイン、導入・保守、外部AI
- 必要なアカウント
- XのDeveloperアカウントとアプリ、Cloudflareアカウント
- AIの扱い
- 内蔵のAI（Grok）は下書きと分析まで。MCP接続では投稿・DMの操作もできる
X Harnessで何ができるか
LINEと連動したキャンペーン
LINEで本人を確認して一人ずつ合言葉を発行し、Xの投稿と照らし合わせて参加を確認します。参加者がXのIDを入力する必要はありません。先着・抽選・参加賞を設定できます。
条件付きの特典配布
リプライに加えて、いいね・リポスト・フォローを条件にし、満たした人にLINEで特典を渡す流れを作れます。
投稿の管理
テキスト・画像・動画の投稿、スレッドの作成、日時を決めた予約投稿。
反応への対応
届いたリプライの確認と返信、引用リポストの検出、DMの送受信を管理画面で扱えます。
数字の確認
フォロワー数の推移（7日・30日の増減）と、X APIの使用量をエンドポイント別・キャンペーン別に確認できます。
AIと複数アカウント
Claude CodeやCodex CLIから自然な言葉で操作できます（MCP経由では投稿・DM送信も可能）。複数アカウントの切り替えと、4段階の権限を持つスタッフ管理があります。
どんな人に向いているか
- Xで発信していて、反応した人をLINEにつなげたい事業者
- プレゼント企画や先着企画を、手作業の確認なしで回したい人
- X APIの費用を、使った分だけ見える形で管理したい人
先に知っておきたいこと
- X APIの利用料は、ソフトウェアとは別に従量でかかります。
- XのDeveloperアカウントで、アプリの作成と権限の設定を自分で行う必要があります。
押して進める
動かすまでの6ステップ
-
XのDeveloperアカウントを用意する
X Developer Portalでアプリを作成します。従量課金のプランが推奨されています。
-
アプリの権限を設定する
App permissionsを「Read, Write, and Direct Messages」にします。
- Consumer Key／Consumer Secret／Access Token／Access Token Secretの4つを控えます。この4つは人に送ったり、チャットに貼ったりしないでください。
-
Cloudflareアカウントを用意する
本体とデータベースは、自分のCloudflareアカウントで動きます。
-
セットアップを実行する
セットアップ用のCLI（create-x-harness）を使い、データベースの作成、本体と管理画面の配置を進めます。
- npmで配布されているCLIは、ひとつ前の版の場合があります。最新版の機能を使う場合は、リリースごとの手順に従います。
- すでに使っている環境を更新するときは、新規の手順ではなく移行の手順を先に確認します。
-
Xのアカウントを登録する
控えておいた4つのキーとXのユーザー情報を登録します。
-
管理画面で確かめる
管理画面にAPIキーでログインし、登録したアカウントが表示されること、リプライのページにメンションが取得されることを確認します。
費用が膨らまないようにする設定
X APIは使った分だけ費用がかかります。X Harnessには、アプリ側で利用を止める基準があります。
- 初期設定では、X APIの利用が月50ドル相当、AI（Grok）が月5ドル相当に達すると、アプリ側で止めます。
- これはアプリの停止基準で、請求額の上限を保証するものではありません。X側の支出上限も別に設定するよう案内されています。
- 料金の計算に使う単価は設定で変えられる見積もりで、請求書と突き合わせたものではありません。
- 反応の確認は差分だけを取りにいく仕組みで、APIの呼び出しを少なくする設計です。
よくある質問
無料で使えますか？
X Harness本体のソフトウェア利用料は0円です。X APIの利用料、Cloudflareの契約・利用量、独自ドメイン、導入や保守、外部AIの費用は別にかかります。
AIが勝手に投稿しませんか？
X Harnessに内蔵されたAI（Grok）の機能が作るのは下書きと分析で、投稿やメッセージの送信はしません。一方、Claude CodeやCodex CLIからMCPで接続した場合は、投稿やDM送信のツールも使えます。AIに渡すAPIキーの権限と、送信前に人が確認する手順を決めてから使ってください。
予約投稿が二重に出ることはありますか？
予約投稿は、処理を始めるときに記録を残し、同時に動いた処理が同じ投稿を二重に送らないようにしています。送信の成否が分からない場合は、手作業で確認する前提です。
LINEと一緒に使えますか？
L Harnessと連携して、Xでの参加をLINEで確認し、特典をLINEで届けるキャンペーンを作れます。連携には、LINE側の更新と共有キーの設定が必要です。
スタッフに一部だけ任せられますか？
管理者・編集者・閲覧者などの役割を分けられます。編集者は投稿やキャンペーン、閲覧者は読み取りだけ、といった分け方です。
次に読む1本
Threads Harnessの解説 →
X以外にも投稿を広げるなら、次はThreadsです。複数アカウントの予約投稿とインサイトの確認を、同じ考え方で扱えます。
このページの特典（無料）
AIにそのまま貼る X投稿のお願い文10
ChatGPTやClaudeなど、ふだん使っているAIに貼るだけで、Xの投稿の下書きが返ってくる「お願い文」です。［ ］を埋めて貼るだけです。
- 自己紹介・1週間分の投稿ネタ
- よくある質問を投稿にする
- 新商品・イベントの告知
- プレゼント企画の告知（注意点の一覧つき）
- リプライへの返信と、投稿前の見直し
友だち追加すると、この特典がLINEで届きます。配信が不要になったら、いつでもブロックで止められます。
- Xに投稿する、1週間分（7本）の下書きを作って…
- ・お店：［店名・業種］
- 条件：1本140字以内。
- → AIが下書きを返してくれます