HarnessWiki
X Harnessはじめに·

X Harnessを5分でセットアップする

Shudesuのプロフィール画像

Shudesu

Author

X Harness セットアップガイド

X（Twitter）のエンゲージメントゲートを構築するOSSツール。 いいね・RT・フォローを条件にコンテンツを解放するキャンペーンを作れます。

Cloudflare Workers + D1で動作。X API Pay-Per-Use プランで月$3-5程度。

必要なもの

項目備考
Node.js 20+
pnpm 9+npm install -g pnpm
Cloudflare アカウント無料プランOK
X Developer アカウントdeveloper.x.com
X API アクセスPay-Per-Useプラン推奨

Step 1: X Developer でアプリを作成

  1. X Developer Portal にアクセス
  2. Projects & Apps → プロジェクト作成
  3. App の User authentication settings を設定:
    • App permissions: Read and Write and Direct Messages
    • Type of App: Web App
    • Callback URL: https://your-domain.com/callback（後で変更可）
  4. 以下をメモ:
    • Consumer Key (API Key)
    • Consumer Secret (API Secret)
    • Access Token
    • Access Token Secret

📸 スクショ反映中: X Developer Portal のApp設定画面（permissions を Read+Write+DM に設定）

重要: 権限は必ず Read and Write and Direct Messages にしてください。Readのみだとゲート機能が動きません。

Step 2: リポジトリをクローン

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

Step 3: D1 データベースを作成

npx wrangler d1 create x-harness

apps/worker/wrangler.toml の database_id を更新。

スキーマを適用

npx wrangler d1 execute x-harness --remote --file=packages/db/schema.sql

Step 4: シークレットを設定

cd apps/worker
npx wrangler secret put API_KEY

API_KEY はダッシュボードのログインパスワードです。

注意: X API のトークンはここでは設定しません。ダッシュボードからアカウント登録時に入力します。

Step 5: Worker をデプロイ

npx wrangler deploy

Step 6: ダッシュボードをデプロイ

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

📸 スクショ反映中: デプロイ後のダッシュボードログイン画面

Step 7: X アカウントを登録

  1. ダッシュボードにAPI_KEYでログイン
  2. Settings → X Account → アカウント登録
  3. Step 1でメモしたOAuthトークンを入力
  4. Save で保存

📸 スクショ反映中: ダッシュボードのX Account 登録画面

Step 8: 最初のエンゲージメントゲートを作成

  1. ダッシュボードで Engagement Gates → New Gate
  2. 設定例:
    • Type: Reply Gate（リプライした人にDMでコンテンツ送信）
    • Conditions: Like + Follow（いいね＆フォローを条件に追加）
    • Reward: DM message（解放するコンテンツのテキスト）
  3. Create で保存
  4. 対象ツイートに紐付け

📸 スクショ反映中: エンゲージメントゲート作成画面

動作確認

  1. 別のXアカウントから対象ツイートにリプライ
  2. いいね＆フォローも実行
  3. 5分以内にDMでコンテンツが届く

コスト目安

利用規模月額コスト
ゲート1-2個、1日50リプライ$3-5
ゲート5個、1日200リプライ$10-15
大規模キャンペーン$30+

since_id アーキテクチャにより、APIコールは1日約50回に最適化されています。

よくあるトラブル

問題対処
DMが届かないX App の権限が Read+Write+DM になっているか確認
ゲートが反応しないCronが5分間隔で動いているか wrangler tail で確認
API コスト暴走D1にキャッシュが効いているか確認、ゲートのポーリング戦略を見直す
#setup#x#twitter#cloudflare#engagement-gate
この記事が役に立ったら投票してください

コメント (0)

コメントするにはログインしてください。

X Harnessを5分でセットアップする — Harness Wiki