X Signal — ChatGPT 및 Codex용 X(Twitter) 리서치

X Signal을 사용하면 ChatGPT 또는 Codex가 이미 사용 중인 계정을 통해 X를 리서치할 수 있습니다. 일반적인 질문을 하면 Top 및 Latest 검색, 스레드 추적, 피드 비교, 계정 찾기, 답변의 근거가 된 게시물 링크까지 제공합니다.

X Signal 서비스, 브라우저, 저장된 리서치 데이터는 Docker에서 사용자 컴퓨터에서 실행됩니다. X 세션은 영구 브라우저 프로필에 저장됩니다. X Signal은 읽기 전용입니다. 게시, 좋아요, 팔로우, 메시지 전송을 하지 않습니다. 로컬 사용에는 OpenAI 또는 X API 키가 필요 없습니다. ChatGPT 웹은 아래에 설명된 OpenAI의 선택적 Secure MCP Tunnel 전송을 사용합니다.

X Signal을 사용하여 개발자들이 이번 주 로컬 음성 에이전트에 대해 무엇을 말하고 있는지 리서치하세요. Top과 Latest를 확인하고, 유용한 스레드를 따라가며, 중요한 게시물을 링크하세요.

설치 · ChatGPT 또는 Codex 연결 · 작동 확인 · 작동 방식

리서치할 수 있는 항목

• 날짜, 언어, 계정, 참여도, 콘텐츠 필터와 함께 여러 Top, Latest 또는 Media 검색을 동시에 실행합니다.

• 정확한 Following, For You, 북마크, 사용자, 리스트, 커뮤니티 타임라인을 읽습니다.

• 게시물을 열고 작성자 스레드를 재구성하며 답글과 인용 게시물을 분리합니다.

• 사람과 조직을 찾은 다음 해당 타임라인을 읽습니다.

• 긴 검색을 계속 실행하고, 저장된 결과를 검토하며, 유용한 부분을 더 깊이 파고듭니다.

• 토픽이나 피드를 시간에 따라 모니터링하고 결과를 Markdown, CSV, JSON 또는 NDJSON으로 내보냅니다.

모델은 얼마나 광범위하게 검색할지 선택하며, 답변에 도움이 될 때 직접 참조를 사용합니다.

Related MCP server: TwitterAPI.io MCP Server

설치

필요한 것:

• Docker Compose 2.20.2 이상이 포함된 Docker Engine 25.0 이상. Windows와 macOS에서는 Docker Desktop이 일반적인 선택이며, Windows에서는 Linux 컨테이너를 사용합니다.

• X 계정.

• 전용 Chrome 프로필에서 자동 세션 동기화를 원하는 경우에만 Chrome.

• ChatGPT 터널 설정, 테스트, MCP Inspector, 백업/복원 또는 stdio에만 Node.js 24.19 이상.

저장소를 클론하고 폴더를 엽니다:

git clone https://github.com/anotb/x-signal.git
cd x-signal

최신 소스를 ZIP으로 다운로드할 수도 있습니다.

코딩 에이전트가 설정하도록 하기

Codex 또는 다른 코딩 에이전트가 터미널을 사용할 수 있다면 다음을 지시하세요:

이 저장소에서 내 컴퓨터에 X Signal을 설정하세요. 운영 체제를 감지하고 먼저 사전 요구 사항을 확인하세요. 모든 서비스를 기본 루프백 포트에 유지하세요. Docker Compose 스택을 시작하고, healthy 상태가 될 때까지 기다린 후 /healthz와 /readyz를 확인하세요. 내 로컬 Codex 클라이언트를 http://127.0.0.1:7345/mcp에 연결하세요. 채팅에 쿠키, 세션 토큰, API 키 또는 비밀번호를 붙여넣으라고 요청하지 마세요. X 로그인의 경우 전용 Chrome 프로필의 세션 컴패니언 또는 로컬 noVNC 브라우저를 통해 안내하세요. X 챌린지를 우회하지 마세요. ChatGPT 웹 지원을 요청하면 저장소의 chatgpt Secure MCP Tunnel 프로필을 사용하고 터널 ID와 제한된 런타임 키를 숨겨진 로컬 설정 프롬프트에 직접 입력하도록 하세요. 포트 7345를 노출하거나 셸 출력에 자격 증명을 넣지 마세요. 눈에 보이는 단계가 필요할 때 알려주세요.

저장소에는 코딩 에이전트용 지침도 포함되어 있습니다.

Windows

Copy-Item .env.example .env
docker compose up -d --build --wait
Invoke-RestMethod http://127.0.0.1:7345/readyz

macOS 또는 Linux

cp .env.example .env
docker compose up -d --build --wait
curl -fsS http://127.0.0.1:7345/readyz

두 서비스 모두 docker compose ps에서 healthy로 표시되어야 합니다.

X에 로그인

권장: 전용 Chrome 프로필 사용

이렇게 하면 리서치 계정을 매일 사용하는 X 계정과 분리할 수 있습니다.

1. Chrome 프로필을 만들고 X Signal이 사용할 X 계정에 로그인합니다.

2. chrome://extensions를 열고 개발자 모드를 켠 다음 압축 해제된 확장 프로그램 로드를 선택합니다.

3. 이 저장소에서 extensions/x-signal-session-companion을 선택합니다.

4. 확장 프로그램을 열고 프로필에 알아보기 쉬운 이름을 지정하고 자동 동기화를 켠 상태로 유지한 다음 이 프로필 사용을 한 번 클릭합니다.

해당 Chrome 프로필이 시작될 때, 열려 있는 동안 5분마다, 그리고 X 쿠키가 변경될 때 세션이 새로 고쳐집니다. Docker는 새로 고침 사이와 재시작 후에도 자체 서명된 복사본을 유지합니다. 다른 Chrome 프로필은 선택한 계정을 조용히 대체할 수 없습니다.

계정 전환 및 일회성 전송에 대해서는 세션 컴패니언 가이드를 참조하세요.

또는 Docker 내부에서 로그인

로컬 브라우저를 열고 X에 한 번 로그인합니다. 생성된 VNC 비밀번호를 클립보드에 복사합니다:

# Windows
docker compose exec -T browser sh -lc 'cat /data/.vnc/password.txt' | Set-Clipboard

# macOS
docker compose exec -T browser sh -lc 'cat /data/.vnc/password.txt' | pbcopy

Linux에서는 동일한 명령을 데스크톱 클립보드 도구에 파이프합니다: Wayland에서는 wl-copy, X11에서는 xclip -selection clipboard.

브라우저 프로필은 xsignal_browser Docker 볼륨에 유지됩니다.

ChatGPT 또는 Codex 연결

Codex

Codex 데스크톱 앱 또는 IDE 확장 프로그램에서 설정 → MCP 서버를 열고 Streamable HTTP 서버를 추가한 후 다음을 사용합니다:

http://127.0.0.1:7345/mcp

또는 ~/.codex/config.toml에 다음을 추가합니다:

[mcp_servers.x-signal]
url = "http://127.0.0.1:7345/mcp"
tool_timeout_sec = 900

저장 후 클라이언트를 다시 시작합니다. 더 긴 호스트 타임아웃은 깊은 피드 읽기를 위한 것이며, 광범위한 검색은 지속적인 작업을 사용하므로 처음부터 다시 시작하지 않고 폴링할 수 있습니다. Codex의 MCP 문서는 공유 데스크톱, CLI 및 IDE 구성을 다룹니다.

이 저장소는 또한 4개의 선택적 스킬이 있는 로컬 Codex 플러그인입니다. 플러그인은 동일한 MCP 연결을 번들로 제공하므로 서버를 두 번 추가하는 대신 플러그인을 설치하세요. 클라이언트 설정을 참조하세요.

ChatGPT 웹

ChatGPT는 localhost에 직접 연결할 수 없습니다. X Signal은 OpenAI의 Secure MCP Tunnel을 선택적이고 감독되는 Compose 서비스로 포함합니다. 이는 MCP 서버를 비공개로 유지하고, 연결에 안정적인 ID를 부여하며, Docker 또는 머신 재시작 후에 다시 연결합니다.

1. Platform 터널 설정에서 터널을 만들고 이를 사용할 ChatGPT 워크스페이스를 연결합니다.

2. 전용 런타임 API 키를 만듭니다. 제한됨 아래에서 터널 → 읽기, 사용에만 권한을 부여합니다.

3. 로컬 설정 명령을 실행하고 프롬프트가 표시되면 터널 ID와 키를 입력합니다. 키 입력은 숨겨지며, 두 값 모두 무시되는 로컬 파일에만 저장됩니다.

npm run tunnel:secure:configure
docker compose --profile chatgpt up -d --build --wait

4. ChatGPT에서 설정 → 보안 및 로그인을 열고 개발자 모드를 켭니다.

5. 플러그인을 열고 더하기 버튼을 선택한 다음 X Signal이라는 앱을 만듭니다.

6. 터널을 선택하고 터널을 선택한 다음 발견된 도구를 검토하고 앱을 만듭니다.

7. 새 채팅의 도구 메뉴에서 X Signal을 추가합니다.

런타임 키는 비공개 터널 전송만 인증합니다. X Signal은 이 키로 OpenAI 모델을 호출하지 않으며, 로컬 Codex 사용에도 여전히 OpenAI 키가 필요 없습니다. 터널은 Docker가 실행되는 동안 사용 가능합니다. docker compose --profile chatgpt ps 및 로컬 준비 상태 페이지에서 상태를 확인할 수 있습니다.

개발자 모드와 터널 액세스는 계정 및 워크스페이스 정책에 따라 다릅니다. OpenAI의 Secure MCP Tunnel 가이드와 자세한 클라이언트 설정을 참조하세요.

작동 확인

이것은 실제 X Signal 검색에서 나온 실제 ChatGPT 답변입니다. 요청은 의도적으로 단순했습니다. ChatGPT는 광범위한 Top + Latest 스캔을 선택하고, 약 100개의 최근 게시물을 종합했으며, 도움이 된 증거를 링크했습니다.

X Signal을 사용하여 지금 X에서 오픈소스 AI 에이전트에 대해 어떤 일이 일어나고 있는지 확인하세요.

캡처는 공개 검색 결과만 보여주며 계정, 세션 및 비공개 피드 데이터를 제외하도록 검토되었습니다. 두 번째로 다른 리서치 작업은 라이브 예시를 참조하세요.

시도해 볼 프롬프트

• "오늘 X에서 이 회사에 무슨 일이 일어나고 있나요? 여러 각도로 확인하고 무엇이 확인되었고, 논쟁 중이며, 단지 반복되고 있는지 알려주세요."

• "지난 7일 동안 개발자들이 이 두 제품에 대해 어떻게 논의하고 있는지 비교하세요. 자사 발표와 실제 사용 후기를 분리하세요."

• "이 토픽 주변의 중요한 계정을 찾은 다음, 그들이 의견이 다른 주장을 리서치하세요."

• "오늘 아침의 정확한 Following 피드를 읽고, 유용한 답글을 유지하며, 제 시간을 들일 가치가 있는 5개 항목 뒤의 스레드를 여세요."

• "이 게시물을 읽고 작성자의 스레드를 재구성하며 지지 답글과 인용 게시물 반박을 분리하세요."

• "이 토픽에 대한 일일 모니터를 만들고 최신 변경 사항을 Markdown으로 내보내세요."

작동 방식

flowchart LR
  C["ChatGPT or Codex"] -->|"MCP"| A["X Signal"]
  A --> B["persistent Chromium"]
  B -->|"read-only"| X["X"]
  A --> D["saved research"]
  B --> P["signed-in browser profile"]

기본 Compose 스택에는 두 개의 서비스가 있습니다: 작은 Node/SQLite 앱과 대화형 Chromium 사이드카입니다. 선택적 chatgpt 프로필은 OpenAI의 고정 터널 클라이언트를 추가합니다. 검색은 제한된 동시성, 요청 간격, 캐싱 및 적응형 백오프가 있는 하나의 영구 브라우저를 사용합니다. 저장된 작업, 증거 및 브라우저 프로필은 재시작 후에도 유지됩니다.

개인정보 보호 및 제한 사항

앱, 브라우저 디버거 및 noVNC는 기본적으로 localhost에 바인딩됩니다. 브라우저 볼륨과 백업에는 재사용 가능한 로그인 상태가 포함되어 있으므로 비밀번호처럼 취급하세요. 정규화된 결과는 도구를 호출할 때 선택한 ChatGPT, Codex 또는 MCP 클라이언트로 전송됩니다. X 챌린지는 로컬 브라우저를 통한 눈에 보이는 로그인이 필요하며, X Signal은 이를 우회하지 않습니다.

X Signal은 사용자가 제어하는 계정을 위한 독립적인 리서치 도구입니다. X 또는 OpenAI와 제휴하지 않으며 X의 API, 인증, 액세스 제어, 챌린지, 속도 제한 또는 기타 보호 장치를 우회하기 위한 것이 아닙니다. 계정이 액세스할 수 있는 콘텐츠에만 사용하고 X의 약관을 따르세요.

프로젝트 문서

• 클라이언트 설정

• 운영 및 백업

• 문제 해결

• 아키텍처

• 보안

• 기여

X Signal은 MIT 라이선스에 따라 제공됩니다.