pi-x는 Pi 코딩 에이전트가 로그인된 브라우저 세션을 통해 X의 트렌드, 뉴스, 게시물, 프로필을 읽도록 하는 확장 기능이다. 개발자 계정이나 API 키 없이 쓸 수 있으며, 쿠키를 브라우저 밖으로 전송하지 않는다고 제작자는 설명한다.

pi-x GitHub 저장소에는 Pi 패키지 목록, 라이선스, 테스트, npm 패키지 링크가 있다. Pi는 pi.dev에서 확인할 수 있다.

무엇을 할 수 있나

x_trending은 지역별 트렌드와 X 뉴스 기사를 보여주며, drilldown을 설정하면 각 트렌드의 상위 게시물을 표본으로 살펴보고 관심이 커진 이유를 설명한다. x_search는 필터와 페이지네이션을 지원하고, 게시물과 사용자 정보도 조회할 수 있다. 검색·트렌드 결과에는 게시 속도, 중앙값, 인증된 계정 비율, 주요 계정·해시태그·사이트 등 에이전트가 활용할 수 있는 통계가 포함된다.

제작자 데모는 x_trending을 drilldown: 1로 한 번 호출해 전 세계 트렌드와 표본 게시물의 참여 수치를 보여준다. 예시에는 2026년 10월 2일의 트렌드와 게시물 통계가 담겼다. 이는 데모에 표시된 결과이며, 항상 같은 트렌드가 나온다는 뜻은 아니다.

확장 기능은 X의 내부 API 쿼리 ID를 실행 중에 찾아 사용하고, API 탐색이 실패하거나 페이지가 바뀌면 가능한 경우 페이지 내용을 읽는 방식으로 대체한다. 여러 계정을 등록하면 계정별 요청 제한에 대응해 순환하며, 기본 순환 방식은 마지막으로 사용한 시점이 가장 오래된 계정부터 선택하는 것이다. 계정을 지정해 고정할 수도 있다.

제작자는 pi-x가 무료로 작동하고 호출별 비용이 없다고 설명한다. 비교 자료에서는 공식 X API의 검색이 월 약 200달러부터라고 기재했으며, Scweet·twscrape·twikit·Agent-Reach 및 OpenCLI의 twitter 명령과 기능을 비교했다. 비교 항목은 API 키 필요 여부, 트렌드·뉴스, 트렌드 이유 설명, 통계 형식, 쿠키 처리, Pi 도구 통합 등이다. 자료는 각 프로젝트의 코드와 문서를 기준으로 2026년 10월 1일에 확인했다고 한다. 전체 비교는 저장소의 비교 안내와 docs/superpowers/specs/2026-10-01-pi-x-v1-design.md에 있다.

설치와 사용

필요 조건은 Pi ≥ 0.99, 개발 시 Node ≥ 22.18, 그리고 agent-browser CLI다. 브라우저 도구는 다음과 같이 설치한다.

npm i -g agent-browser && agent-browser install

Pi에서 패키지를 설치하거나, 한 번만 실행하거나, 최신 main 브랜치를 추적할 수 있다.

`pi install npm:@hett/pi-x

or try it once without installing:

pi -e npm:@hett/pi-x

or track the latest main branch:

pi install git:github.com/hett-patell/pi-x`

시작하려면 /x login을 실행한다. 브라우저 창에서 Google, Apple 또는 비밀번호와 2단계 인증으로 로그인하면 pi-x가 로그인을 확인하고 창을 닫는다. 이후 “What's trending on X right now, and why?”처럼 요청하면 된다. 설치 안내는 저장소의 설치 문서, 빠른 시작은 quick start에 있다.

주요 도구는 다음과 같다.

  • x_trending: 지역, 탭(trending/news/sports/entertainment), 뉴스 포함 여부, 결과 수, drilldown(0–5)을 설정해 트렌드와 뉴스 기사를 조회한다. 이전 확인 이후 새로 등장한 트렌드는 NEW로 표시한다.
  • x_search: 검색어, 최신순·인기순·미디어 유형, 최대 300개 결과, 계정·날짜·언어·참여도·인증 여부·지역 등의 조건을 지원한다. 통계와 페이지네이션도 제공한다.
  • x_tweet: 게시물 ID나 URL로 게시물을 읽는다. 답글을 요청하면 작성자의 스레드와 참여도가 높은 답글도 포함한다.
  • x_user: 프로필을 조회하고, 설정에 따라 최근 게시물과 통계를 확인한다.
  • x_doctor: 계정 로그인 상태와 API 탐색을 점검하고 해결 방법을 안내한다.
  • x_dm_inbox와 x_dm: /x write on을 켠 경우에만 쓸 수 있다. 받은 편지함을 읽거나 DM을 보낼 수 있으며, 전송 전 Pi 화면에서 받는 사람과 내용을 확인한다.

예시 요청과 전체 도구 설명은 도구 안내와 예시 프롬프트에 있다.

계정 관리와 개인정보

/x status는 계정과 로그인 상태, 순환 설정, 트렌드 지역을 표시한다. /x add <name>으로 계정 슬롯을 추가하고 /x use <account|auto>로 계정을 고정하거나 자동 순환을 설정할 수 있다. /x location [place|default]는 기본 트렌드 지역을 바꾼다. /x logout [account]는 계정을 연결 해제하고 브라우저 프로필을 삭제하지만, /x remove <account>는 계정을 제거해도 프로필 파일을 디스크에 남긴다. 나머지 명령은 명령어 안내에 정리돼 있다.

제작자 설명에 따르면 쿠키는 ~/.pi/agent/pi-x/profiles 아래의 브라우저 프로필에 보관되며, pi-x가 이를 추출하거나 외부로 보내지 않는다. X 요청을 승인하는 데 필요한 ct0 CSRF 토큰은 페이지 안에서만 읽는다. 설정 파일은 권한 0600으로 저장하고, 프록시 인증 정보는 메시지·로그·도구 출력에서 가린다.

기본 설정은 읽기 전용이다. 게시, 좋아요, 팔로우 기능은 없고 DM 접근도 꺼져 있다. /x write on을 켜면 받은 편지함 조회와 DM 전송이 가능해진다. 전송은 기본적으로 매번 사용자의 확인을 받으며, 한 계정에서 한 번만 시도하고 재시도하지 않는다. --no-confirm을 사용하면 확인 절차를 생략할 수 있다. 로그인 상태를 /x backup으로 저장하면 쿠키가 포함된 파일이 ~/.pi/agent/pi-x/state/<account>.json에 권한 0600으로 만들어진다. 이 파일을 가진 사람은 X 세션을 사용할 수 있으므로 안전하게 보관해야 한다.

같은 X 계정으로 여러 Pi 인스턴스를 동시에 실행하는 것은 지원하지 않는다. 잠금은 프로세스별로 관리되며, Pi 인스턴스 하나를 종료하면 다른 인스턴스가 사용하는 pi-x 브라우저 세션도 닫힐 수 있다. 제작자는 주 계정을 연결하는 것이 부담스러우면 보조 계정을 사용하고, X의 이용약관과 요청 제한을 지킬 책임은 사용자에게 있다고 안내한다. pi-x는 제한에 걸리면 자동으로 대기하지만 이를 우회하지 않는다고 한다.

버전 및 문제 해결

pi-x 1.0은 전체 재작성 버전이다. 첫 실행 때 ~/.pi/x-insights.json의 설정을 ~/.pi/agent/pi-x/config.json으로 자동 이전한다. 유료 키 기반 SocialData 연동은 제거됐으며, x_search와 x_user는 로그인된 브라우저 세션을 사용한다. x_scrape_topic은 필터를 사용하는 x_search로 통합됐고, /x setkey와 /x clearkey 명령도 없어졌다. 예전 확장 파일을 수동으로 복사했다면 ~/.pi/agent/extensions/x-insights.ts를 제거해야 새 패키지를 가리지 않는다. 자세한 내용은 0.x에서 업그레이드를 참고하면 된다.

browser_missing 오류에는 npm i -g agent-browser && agent-browser install, chrome_missing에는 agent-browser install을 실행한다. Linux에서는 agent-browser install --with-deps를 쓴다. profile_busy는 해당 프로필을 연 다른 Chrome 창을 닫고 다시 시도하며, not_logged_in은 /x login <account>으로 해결한다. rate_limited가 나타나면 잠시 기다리거나 결과 수를 줄이고 계정을 추가한다. api_changed나 dom_changed는 /x doctor로 점검하고, 필요하면 pi update를 실행하거나 이슈 페이지에 보고한다. 나머지 오류별 안내는 문제 해결 문서에 있다.

작동 방식과 개인정보·안전 관련 설명은 각각 작동 방식, 개인정보 및 안전에서 확인할 수 있다. pi-x는 사용자를 대신해 로그인된 브라우저에서 공개된 X 콘텐츠를 읽는 도구이며, X Corp.와 제휴하거나 승인을 받은 제품이 아니라고 밝힌다. 개발 절차는 개발 안내, 라이선스는 MIT 라이선스에서 확인할 수 있다.