beydemirfurkan/tweetly

tweetly은(는) 무엇을 하나요?

AI 에이전트를 위한 멀티 테넌트 X(Twitter) 자동화 플랫폼 — 공개 API 대신 브라우저 기반 세션을 통해 MCP 또는 REST로 X를 제어합니다.

개요

tweetly는 여러 X 계정을 안전하게 관리할 수 있는 플랫폼으로, 각 계정의 브라우저 세션을 유지하여 Twitter의 공식 API 제한을 우회합니다. AI 에이전트는 MCP나 REST를 통해 이 플랫폼과 통신하여 트윗, 팔로우, 검색 등 일반적인 Twitter 작업을 수행할 수 있습니다.

기능

• 멀티 테넌시: 여러 X 계정을 동시에 관리하고 전환할 수 있습니다.
• 브라우저 세션: 각 계정의 로그인 상태를 브라우저 쿠키로 유지하여 안정적인 접근을 보장합니다.
• MCP 지원: AI 에이전트가 Model Context Protocol을 통해 직접 상호작용할 수 있습니다.
• REST API: HTTP 요청을 통해 모든 기능을 사용할 수 있습니다.
• 트윗 작업: 트윗 작성, 삭제, 좋아요, 리트윗, 답글 등.
• 프로필 관리: 팔로우, 언팔로우, 프로필 정보 보기.
• 검색: 키워드나 사용자 기반 트윗 검색.

시작하기

사전 요구 사항

• Node.js 18 이상
• npm 또는 yarn

설치

git clone https://github.com/beydemirfurkan/tweetly.git
cd tweetly
npm install

구성

config 디렉토리에 환경 변수 또는 구성 파일을 설정하세요:

PORT=3000
MCP_ENABLED=true
SESSION_DIR=./sessions

사용법

REST API

# 트윗 작성
curl -X POST http://localhost:3000/api/tweet \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello from tweetly!"}'

# 계정 전환
curl -X POST http://localhost:3000/api/switch-account \
  -H "Content-Type: application/json" \
  -d '{"accountId": "user2"}'

MCP

AI 에이전트에서 MCP 도구로 tweetly에 연결하세요. 예를 들어 Claude Code에서는:

{
  "mcpServers": {
    "tweetly": {
      "command": "node",
      "args": ["path/to/tweetly/mcp-server.js"],
      "env": {
        "TWEETLY_API_URL": "http://localhost:3000"
      }
    }
  }
}

세션 관리

각 X 계정의 브라우저 세션은 sessions 디렉토리에 저장됩니다. 세션을 추가하려면:

1. tweetly 서버를 시작합니다.
2. 브라우저로 http://localhost:3000/auth에 접속합니다.
3. 각 계정으로 로그인하여 세션을 저장합니다.

기여

버그 리포트, 기능 제안, 풀 리퀘스트를 환영합니다. GitHub 저장소를 방문해 주세요.

라이선스

MIT