beydemirfurkan/tweetly

tweetly は何をしますか？

AIエージェント向けのマルチテナントX（Twitter）自動化プラットフォーム — 公開APIではなくブラウザバックアップセッションを介してMCPまたはREST経由でXを操作します。

概要

Tweetlyは、AIエージェントがXを自動化するための強力なプラットフォームです。従来の公開APIに依存せず、ブラウザベースのセッションを使用することで、より多くの操作と高い信頼性を実現します。

主な機能

• ツイートの投稿: テキスト、画像、リンクを含むツイートを投稿
• リツイート: 既存のツイートをリツイート
• いいね: ツイートにいいねを追加
• フォロー/アンフォロー: ユーザーをフォローまたはアンフォロー
• タイムラインの取得: ホームタイムラインやユーザータイムラインを取得
• 検索: キーワードやハッシュタグでツイートを検索
• マルチテナント: 複数のXアカウントを同時に管理

サポートされているプラットフォーム

• MCP (Model Context Protocol): Claude Code、Cursor、CodexなどのAIエージェントと統合
• REST API: 任意のHTTPクライアントから直接操作

はじめ方

前提条件

• Node.js 18以上
• npmまたはyarn
• Xアカウント（ログイン用）

インストール

npm install -g tweetly

設定

1. 環境変数を設定:

export TWEETLY_PORT=3000
export TWEETLY_SESSION_DIR=./sessions

2. サーバーを起動:

tweetly start

3. ブラウザで設定を開く:

http://localhost:3000/setup

MCP統合

MCPを使用してAIエージェントと統合するには、以下の設定を追加します:

{
  "mcpServers": {
    "tweetly": {
      "command": "npx",
      "args": ["-y", "@beydemirfurkan/tweetly-mcp"],
      "env": {
        "TWEETLY_API_URL": "http://localhost:3000"
      }
    }
  }
}

REST API

REST APIを使用して直接操作することもできます:

# ツイートを投稿
curl -X POST http://localhost:3000/api/tweet \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello from Tweetly!", "account": "main"}'

ライセンス

MIT

貢献

バグ報告や機能リクエストはGitHub Issuesへお願いします。プルリクエストも歓迎です。

リンク

• GitHub
• ドキュメント
• Discord