X Engage Agent
ManabuAzai/x-engage-agent
Automatiza busca e priorização de engajamento no X, entrega leads no Chatwork
Ver no GitHubAgent dirigido por Claude que automatiza a descoberta e priorização de leads, peers e candidatos no X (Twitter) através de busca, scoring e entrega de listas de engajamento no Chatwork. Pensado para profissionais de serviços (como contadores), gera candidatos a follow/like com contexto, deixando a execução manual nas mãos do usuário (APIs do X removeram automação de like/follow).
Instalação
npx convez-ai ManabuAzai/x-engage-agent1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Gerar leads segmentados (clientes, networking, recrutamento) para contadores e consultores
- Identificar candidatos a follow/like com scoring automático baseado em prompt customizável
- Automatizar busca no X por palavra-chave e entregar listagem priorizada diária via Chatwork
Veredito

Solução sofisticada para automação de prospecting em social media, bem estruturada com MCP e Claude Code. Requer setup técnico significativo (variáveis, Python, venv) e personalização de prompts, mas oferece workflow prático para quem quer lead generation semi-automática sem violar políticas de API.
README
A tradução para o português deste README ainda está na fila.
x-engage-agent
Claude Code が駆動する X(旧Twitter)エンゲージメント支援エージェント。 同梱テンプレートは税理士法人向けで、3つのターゲットセグメントを狙います — client(個人事業主・中小企業経営者などの顧問先候補)/ peer(同業者=ネットワーキング・採用パイプライン)/ recruit(転職候補者=採用)。関連投稿を検索・スコアリングしていいね/フォロー候補リストを生成し、セグメント別ラベル付きで Chatwork に配信します。配信メッセージには X アプリで直接開けるリンクが並ぶので、タップするだけで手動エンゲージできます。
なぜ「手動」なのか: X API のセルフサーブ全ティアで
likePost/followUserが廃止されたため、いいね・フォローの完全自動化はできません。本ツールは「誰に・なぜエンゲージすべきか」の判断(検索→スコアリング→除外)を自動化し、実行アクションだけ人間に渡します。
アーキテクチャ
improver/engage.sh … オーケストレーター
├─ xmcp/server.py … X API v2 を叩く MCP サーバ(OAuth1)
├─ scripts/engagement/fetch_following.py … フォロー/フォロワーのキャッシュ更新・アンフォロー候補生成
├─ prompts/engager.md … Claude Code に渡すエージェント指示(検索→採点→除外→記録→通知)
└─ scripts/notify.py … Chatwork へ候補リストを配信
候補・キャッシュは improver/data/engagement/ に保存されます(.gitignore 済み・コミットされません)。
必要なもの
- Claude Code CLI(
claudeコマンド) - Python 3.11+
- X API アプリ(OAuth1 Consumer Key/Secret、Bearer Token)— developer.x.com
- Chatwork アカウントと API トークン
セットアップ
トークン類はすべて fork した側の環境変数 / .env で設定します。リポジトリには一切コミットされません。
# 1. fork してクローン
git clone https://github.com/<your-account>/x-engage-agent.git
cd x-engage-agent
# 2. X API 認証情報(xmcp)
cp xmcp/env.example xmcp/.env
# xmcp/.env を編集: X_OAUTH_CONSUMER_KEY / X_OAUTH_CONSUMER_SECRET / X_BEARER_TOKEN ほか
# 3. Chatwork と対象アカウント(リポジトリルート)
cp .env.example .env
# .env を編集: CHATWORK_API_TOKEN / CHATWORK_ROOM_ID / X_USERNAME
# 4. xmcp の仮想環境(engage.sh が source します)
python3 -m venv xmcp/.venv
xmcp/.venv/bin/pip install -r xmcp/requirements.txt -r requirements.txt
xmcp/.env の各項目の意味は xmcp/README.md を参照してください。OAuth1 アクセストークンの取得は xmcp サーバの OAuth フローで行えます。
実行
# プレビュー(API を叩かず動作確認)
bash improver/engage.sh --dry-run
# 本実行(検索→採点→Chatwork 配信)
bash improver/engage.sh
cron などで毎日回す場合は improver/engage.sh をそのままスケジュールしてください。1 セッション 25 分以内、X API 検索は最大 12 回に制限されています(prompts/engager.md 参照)。
カスタマイズ
- ニッチの変更:
prompts/engager.mdの検索クエリ例とスコアリング基準を自分の領域に書き換えます。 - 除外リスト:
improver/data/engagement/internal_blocklist.json(身内)、churned_blocklist.json(churned)を置くと候補から除外されます。 - 通知先の差し替え: Chatwork 以外に流したい場合は
improver/scripts/notify.pyを差し替えてください(notify.py "<title>" "<body>"のインターフェースを保てば engage.sh / engager.md 側は変更不要)。
セキュリティ
.envとxmcp/.envはコミットされません(.gitignore済み)。improver/data/engagement/のフォロー状態・候補履歴もコミットされません。- トークンを誤って入れた場合は X / Chatwork 側で必ずローテートしてください。
ライセンス
MIT