X Harness

X（旧Twitter）向けオープンソースマーケティングオートメーション。
X Harness本体のソフトウェア利用料は 0円 です。X APIの利用料、Cloudflareの契約・利用量、独自ドメイン、導入・保守、接続する外部AIサービスの費用は別です。

費用の条件は開発元の公式料金説明で確認できます。Cloudflare D1の無料プランは日次の読み書き上限に達するとクエリがエラーになり、有料プランの超過課金とは挙動が異なります。外部AIを接続する場合は、たとえばClaudeのプラン・API料金を別に確認してください（2026年9月6日確認）。

公式情報・検証資料

X Harnessの製品名、開発者、運営法人、公開コード、研究資料の関係は以下を正本とします。各Researchサイトは開発元が運営する一次情報であり、独立した第三者レビューではありません。

機能

• エンゲージメントゲート — リプライ + いいね/リポスト/フォロー条件でLINE連携・verify API
• キャンペーンウィザード — 投稿→条件→LINE連携→プレビューの4ステップで一括設定
• 投稿管理 — テキスト・画像・動画投稿、スレッド作成、スケジュール投稿
• リプライ管理 — 受信リプライの確認、ワンクリックいいね/リポスト、返信、自分のリプライ表示
• 引用ツイート — 引用RT自動検出、DB永続化、引用RTで返しアクション
• DM管理 — 会話一覧（プロフィール表示）、メッセージ履歴、送受信
• フォロワー管理 — ゲート通過者の管理、タグ付け、セグメント分け
• フォロワー数トラッキング — 日次スナップショット、推移グラフ、7日/30日増減表示
• API使用量 — エンドポイント別、ゲート別のコスト可視化
• スタッフ管理 — owner / admin / editor / viewer の4ロール、APIキーごとの権限制御
• 無料スクレイピング収集 — twitter-cli(Cookie 認証)で検索・投稿収集・メトリクス取得が X API 課金ゼロ(scrape_* MCP ツール)
• 動画コンテンツ自動化 — 海外動画バズ発見 → /video/1 URL 引用投稿の生成・予約(x-growth-video スキル)
• 記事自動生成 — ネタ収集 → 長文記事下書き → ダッシュボードレビュー(x-growth-discover / x-growth-article スキル)
• 画像込み記事の全自動投稿 — body の markdown に ![](url) を書くだけでインライン画像を自動アップロードして X Article を draft 作成→公開(undocumented スキーマの実測ガイドは docs/manual/07-articles-api.md)
• MCP Server — Claude Code / AI エージェントから自然言語でX操作
• Codex CLI 対応 — MCP・スキルとも Claude Code / Codex CLI の両方で動作
• SDK — TypeScript SDK でプログラマティックに全機能を操作
• 管理画面 — Next.js ダッシュボードで直感的に操作
• マルチアカウント — サイドバーでアカウント切替、全ページが選択アカウントに連動
• L Harness連携 — クロスプラットフォームキャンペーン（X→LINE特典配布）
• ステルス設計 — ジッター・レート制限・テンプレート変異でBAN対策

競合比較

技術スタック

アーキテクチャ

X Platform (API v2) ←→ CF Workers (Hono) → D1
                              |
                        Cron (*/5 * * * *)
                              |
                   リプライ検出 (since_id)
                   + フォロワー数スナップショット
                   + 引用RT DB保存

Next.js 15 (Dashboard) → Workers API → D1
TypeScript SDK → Workers API → D1
MCP Server → Workers API → D1
L Harness → Verify API → D1

MCP Server (AI連携)

Claude Code や他のMCPクライアントから、自然言語でXアカウントを操作できます。

セットアップ

// .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": "your-api-key"
      }
    }
  }
}

Codex CLI から使う

~/.codex/config.toml に追加すると Codex CLI からも同じツールが使えます:

[mcp_servers.x-harness]
command = "npx"
args = ["-y", "@x-harness/mcp@latest"]

[mcp_servers.x-harness.env]
X_HARNESS_API_URL = "https://your-worker.workers.dev"
X_HARNESS_API_KEY = "your-api-key"
# 無料収集を使う場合(下記セクション参照)
TWITTER_AUTH_TOKEN = "your-auth-token"
TWITTER_CT0 = "your-ct0"

無料収集セットアップ(twitter-cli)

X の読み取り(検索・投稿収集・メトリクス)を X API 課金ゼロで行えます。twitter-cli(Cookie 認証)を MCP がラップし、scrape_user_posts / scrape_search / scrape_post / scrape_user ツールとして使えます。書き込み(投稿・予約)は従来通り X API 経由です。

1. twitter-cli をインストール

uv tool install twitter-cli   # または: pipx install twitter-cli

2. Cookie を取得

ブラウザで x.com にログイン → 開発者ツール → Application → Cookies → x.com から auth_token と ct0 の値をコピー。

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

3. MCP の env に設定

.mcp.json(Claude Code)または ~/.codex/config.toml(Codex)の x-harness サーバーの env に追加:

"env": {
  "X_HARNESS_API_URL": "...",
  "X_HARNESS_API_KEY": "...",
  "TWITTER_AUTH_TOKEN": "your-auth-token",
  "TWITTER_CT0": "your-ct0"
}

twitter-cli が PATH 外にある場合は TWITTER_BIN でフルパスを指定できます。

4. 同梱スキル(記事・動画自動化)

skills/ に SKILL.md 標準のスキルが3本入っています(Claude Code / Codex 両対応)。.claude/skills/ と .codex/skills/ にコピーして使います(npx create-x-harness は自動でコピーします):

5. 毎日自動で回す(cron)

# Claude Code
30 5 * * * cd /path/to/project && claude -p "/x-growth-video --auto" --dangerously-skip-permissions

# Codex CLI
30 5 * * * cd /path/to/project && codex exec "x-growth-video スキルを --auto で実行"

利用可能なツール (39個)

5分デプロイガイド

前提条件

• Node.js 20+
• pnpm 9+
• Cloudflare アカウント
• X Developer アカウント (Pay-Per-Use 推奨)

1. X API アプリ設定

1. X Developer Portal でアプリを作成
2. App permissions を Read, Write, and Direct Messages に設定
3. 以下を控えておく:
   • Consumer Key / Consumer Secret
   • Access Token / Access Token Secret

2. リポジトリのセットアップ

git clone https://github.com/Shudesu/x-harness-oss.git
cd x-harness-oss
pnpm install

3. Cloudflare D1 データベース作成

npx wrangler d1 create x-harness
# 出力される database_id を apps/worker/wrangler.toml に記入

# スキーマを適用
npx wrangler d1 execute x-harness --file=packages/db/schema.sql

4. Workers のシークレット設定

npx wrangler secret put API_KEY   # ダッシュボードログイン用

5. Workers デプロイ

cd apps/worker
npx wrangler deploy

6. Xアカウント登録

# API経由でアカウントを登録
curl -X POST https://your-worker.workers.dev/api/x-accounts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "xUserId": "YOUR_X_USER_ID",
    "username": "YOUR_USERNAME",
    "accessToken": "ACCESS_TOKEN",
    "accessTokenSecret": "ACCESS_TOKEN_SECRET",
    "consumerKey": "CONSUMER_KEY",
    "consumerSecret": "CONSUMER_SECRET"
  }'

7. 管理画面デプロイ

cd apps/web
NEXT_PUBLIC_API_URL=https://your-worker.workers.dev npx next build
npx wrangler pages deploy out --project-name=x-harness-admin

8. 動作確認

1. 管理画面にアクセスしてAPIキーでログイン
2. サイドバーで登録したアカウントが表示されることを確認
3. リプライページでメンションが取得できることを確認

プロジェクト構成

x-harness/
├── apps/
│   ├── web/                # Next.js 管理画面
│   └── worker/             # Cloudflare Workers API
├── packages/
│   ├── db/                 # D1 スキーマ & クエリ
│   ├── sdk/                # TypeScript SDK (@x-harness/sdk)
│   ├── mcp/                # MCP Server (@x-harness/mcp)
│   ├── x-sdk/              # X API v2 ラッパー
│   ├── shared/             # 共有型定義
│   └── create-x-harness/   # CLI セットアップツール
└── docs/
    └── SPEC.md             # API仕様書

コスト

X API Pay-Per-Use プラン推奨。リプライトリガーアーキテクチャにより、since_id 差分取得でAPIコールを最小化。

無料収集(twitter-cli)を使う場合: 読み取りは $0。X API 課金は書き込みのみになります(目安: URL 入りポスト $0.20/件 — 動画引用投稿を1日3本で月 ≈ $18)。

L Harness 連携

X Harness はクロスプラットフォームキャンペーンのための verify API を提供:

GET /api/engagement-gates/:id/verify?username=johndoe

{
  "eligible": true,
  "conditions": {
    "reply": true,
    "like": true,
    "repost": true,
    "follow": true
  }
}

キャンペーンウィザードを使えば、L Harness のフォーム作成・リンク生成まで自動化されます。

ライセンス

MIT

開発者 / Author

野田修一（Shudesu） — Harness シリーズ（L Harness / IG Harness / X Harness）開発者、AIエージェント株式会社 代表

• GitHub: @Shudesu
• X: @ai_shunoda
• YouTube: 野田 修一 | The Harnessで0円
• 公式ドキュメント: Harness Wiki
• 商用ツールとの比較・料金データ: The Harness Lab