初心者向け・はじめての運用ガイド
X（旧Twitter）の投稿・返信・DM・フォロワー分析などを「自動化・一元管理」するための自分専用ツールです。
たとえるなら「あなた専属のX運用秘書」。これを自分のCloudflareアカウント上に設置して使います。月額固定費ゼロで動き、PCを閉じていてもクラウド上で24時間自動で働き続けます（投稿の自動送信などはCloudflareのサーバーが行うため）。
「自分でやる」か「AIと会話してやる」かの二択ではありません。両方使えて、混ぜるのが正解です。
ブラウザで画面をポチポチ。一般的なSNS管理ツールと同じ感覚。
「明日7時にこれ投稿して」と話すだけ。
運用を始める前に、自分の環境の以下3つを手元に控えておきましょう（デプロイ時に決まった値）。
| 項目 | 何の値か / どこにあるか |
|---|---|
| 管理画面URL | あなたがデプロイした Cloudflare Pages のURL（例: https://<your-project>.pages.dev）。ブックマーク推奨 |
| ログイン用 API_KEY | デプロイ時に wrangler secret put API_KEY で設定した値。管理画面ログインに使う |
| 登録したXアカウント | X Developer Portal で取得したキーで登録済みのアカウント（複数可） |
できること一覧。各機能を「管理画面のどこ」「AIへの頼み方」で対比しました。
| やりたいこと | 管理画面（メニュー） | AIへの頼み方（例） |
|---|---|---|
| 今すぐ投稿 | 投稿管理 → 新規投稿 | 「〇〇という内容で今すぐ投稿して」 |
| 予約投稿 | 予約投稿 | 「明日朝7時に〇〇を予約して」 |
| スレッド投稿 | 投稿管理（スレッド作成） | 「この内容を3連投のスレッドにして投稿して」 |
| リプライ確認・返信 | リプライ | 「最近のリプライを見せて」「これに返信して」 |
| 引用ツイート管理 | 引用 | 「自分への引用RTを一覧して」 |
| DM送受信 | DM | 「〇〇さんにDMを送って」 |
| フォロワー管理・タグ付け | フォロワー / タグ | 「フォロワーを〇〇でタグ分けして」 |
| フォロワー数の推移 | フォロワー（推移グラフ） | 「直近7日のフォロワー増減を教えて」 |
| エンゲージメントゲート | エンゲージメントゲート | 「いいね＆フォローで特典を配るゲートを作って」 |
| キャンペーン一括設定 | キャンペーン作成 | 「投稿→条件→LINE連携まで一括で作って」 |
| API使用量・コスト確認 | API使用量 | 「今月いくら使ってるか教えて」 |
| スタッフ追加（権限管理） | スタッフ | 「閲覧専用のスタッフを追加して」 |
「何時に何を投稿するか」を事前に登録すると、クラウドが時間になったら自動で投稿します。
「文章を考えて → 投稿/予約する」を丸ごと任せられる、いちばん強力な使い方です。
X Harness 同梱の MCP Server を Claude Code 等のAIクライアントに接続する、一度きりの設定です。接続すると、毎回URLやキーを意識せず、自然言語でXを操作できます（ツール30種）。
お使いのAIクライアントの .mcp.json に、以下を追記します（< > の部分は自分の環境の値に置き換え）。
// .mcp.json
{
"mcpServers": {
"x-harness": {
"command": "npx",
"args": ["-y", "@x-harness/mcp@latest"],
"env": {
"X_HARNESS_API_URL": "https://<your-worker>.workers.dev",
"X_HARNESS_API_KEY": "<あなたのログイン用API_KEY>"
}
}
}
}
X Harness自体は無料（Cloudflare無料枠で稼働）ですが、X公式APIの利用料が「投稿ごと」にかかります（従量課金）。
| 操作 | 料金（1回） | 円換算(約¥155/$) |
|---|---|---|
| テキスト/画像投稿（URLなし） | $0.015 | 約 2.3円 |
| URLを含む投稿 | $0.200 | 約 31円 |
| 投稿の読み取り（リプライ取得等） | $0.005 | 約 0.8円 |
※ 2026年時点のX API Pay-Per-Use料金（公式料金ページ）。料金は改定されることがあるため、必ず最新を公式で確認してください。
迷ったらこの型をマネしてください。
| 症状・疑問 | 対処 |
|---|---|
| 管理画面にログインできない | デプロイ時に設定したAPI_KEYを正確にコピペ。前後の空白に注意 |
| 予約したのに投稿されない | 最大5分待つ（cron間隔）。それでもダメなら「失敗(failed)」表示とXアプリ権限を確認 |
| 投稿が「失敗」になる | 多くはX側の権限不足かレート制限。レート制限は自動リトライ。権限はDeveloper PortalでRead+Write+DMか確認（変更後はAccess Tokenを再生成） |
| 思ったより課金が多い | URL付き投稿($0.20)が原因のことが多い。第7章の節約テク参照 |
| 複数アカウントを運用したい | 各アカウントのAPIキー4種を用意して登録。管理画面サイドバーで切替できる |
| 操作方法がわからない | AI（Claude Code等）に日本語で「〇〇したいんだけどどうやる？」と聞くのが一番早い |
| 用語 | かみくだいた意味 |
|---|---|
| API / APIキー | ソフト同士をつなぐ窓口と、その鍵。X Harnessはこの鍵でXを操作する |
| セルフホスト | 他社サービスに頼らず、自分のアカウント（ここではCloudflare）上に自分で設置して動かすこと |
| Worker / Cloudflare | ツールを動かしているクラウドの「サーバー」。24時間ずっと起きている |
| cron（クロン） | 「決まった間隔で自動実行する仕掛け」。ここでは5分ごとに予約投稿をチェック |
| MCP | AIに“専用の道具箱”を持たせる仕組み。連携するとXを会話で安定操作できる |
| エンゲージメントゲート | 「いいね＆フォローした人だけに特典URLを渡す」ような“条件付き配布の関所” |
| キャンペーン | 投稿＋参加条件＋特典配布を“ひとまとめ”で設定する機能 |
| スレッド | 連続したツイート（ツリー投稿） |
| 従量課金 | 使った分だけ払う方式。X APIは「投稿1回ごと」に課金 |