convez.ai
AgenteAutomaçãoAvançado
ManabuAzai

X Engage Agent

ManabuAzai/x-engage-agent

Automatiza busca e priorização de engajamento no X, entrega leads no Chatwork

Ver no GitHub
InicialPluginScore · de 0 a 100

Agent 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-agent

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 2 dias
Versão
—
Issues abertas
1
Contribuidores
1

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 済み・コミットされません)。

必要なもの

セットアップ

トークン類はすべて 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

Ver o original no GitHub

Bom para

Relacionados