nirholas/XActions

XActions — 인간과 AI 에이전트를 위한 X/Twitter 자동화 툴킷

정의: XActions는 X(구 Twitter)의 모든 작업(프로필 및 트윗 스크래핑, 검색, 팔로워 관리, DM 전송 등)을 자동화하기 위한 무료 오픈소스 툴킷입니다. 명령줄 도구, Node.js 라이브러리, 브라우저 콘솔 스크립트, 브라우저 확장 프로그램, 그리고 중요한 점으로 AI 에이전트(Claude, GPT, Cursor 등)가 X를 직접 제어할 수 있는 MCP 서버로도 작동합니다. 공식 API 키가 필요 없으며, X의 내부 웹 엔드포인트와 자신의 브라우저 세션을 사용합니다.

주요 기능(README에서):

• 스크래퍼 및 CLI: 프로필, 타임라인, 검색, 팔로워, 미디어 다운로드 등을 위한 56개의 명령. JSON, CSV, Markdown 또는 HTML로 출력.
• AI 에이전트용 MCP 서버: Model Context Protocol을 통해 152개의 도구를 노출하여 AI 어시스턴트가 X 계정을 읽고, 쓰고, 관리할 수 있게 합니다. 쓰기 작업에는 인간 승인 게이트와 계정별 일일 작업 상한선이 포함됩니다.
• 브라우저 스크립트 및 확장 프로그램: 설치 없이 자동화를 위한 95개의 복사-붙여넣기 콘솔 스크립트와 Chrome/Edge 확장 프로그램.
• Spaces의 AI 음성 에이전트: X Spaces에 참여하여 듣고 말할 수 있습니다.
• 계정 풀 및 재개 가능한 스크래핑: SQLite 기반 세션 관리, 프록시 순환, 속도 제한 처리, 긴 스크래핑을 위한 체크포인트 기반 재개 기능.
• 크로스 플랫폼: 단일 인터페이스로 Bluesky, Mastodon, Threads도 스크래핑.
• 이식성: 공식 X 아카이브를 가져와 Bluesky 또는 Mastodon으로 마이그레이션.
• 추가 기능: 감정 분석, 워크플로 엔진, 플러그인 시스템, 서명된 웹훅, 라이브 이벤트 스트리밍, 내장된 "Ask XActions" 어시스턴트.

작동 방식: XActions는 유료 X API를 우회하여 X 자체 내부 GraphQL 엔드포인트를 사용하고 실제 웹 클라이언트의 요청을 모방합니다. 설치된 브라우저(Chrome, Firefox 등)에서 쿠키를 읽어 인증할 수 있습니다. 모든 것이 로컬에서 실행되며 데이터가 기기를 떠나지 않습니다. MCP 서버는 stdio 또는 HTTP를 통해 AI 에이전트에 연결하여 명시적 승인을 받아 게시, 검색, 팔로워 관리 등의 작업을 수행할 수 있게 합니다.

사용 사례: 소셜 미디어 관리, 브랜드 모니터링, 콘텐츠 예약, 팔로워 분석, 데이터 내보내기, 그리고 API 액세스 비용을 지불하지 않고 AI 에이전트가 사용자를 대신하여 X와 상호작용하도록 하는 것.

차별점: API 키 없이 브라우저, 터미널, AI 에이전트를 동시에 지원하는 유일한 툴킷입니다. README에는 MCP 도구 수, 브라우저 스크립트, 승인 게이트 및 일일 상한과 같은 기능에서 리드하고 있음을 보여주는 경쟁 비교 표가 포함되어 있습니다.