twitter-cli

twitter-cli 스킬 개요

twitter-cli 스킬이 하는 일

twitter-cli는 타임라인, 북마크, 검색 결과, 프로필, 트윗 상세를 읽는 데 초점을 둔 터미널 우선 Twitter/X 스킬이며, 인증이 되어 있으면 게시와 기타 쓰기 작업도 지원합니다. 웹앱 대신 CLI 워크플로를 원하는 사용자에게 가장 잘 맞고, 특히 Social Media 리서치, 계정 모니터링, 가벼운 퍼블리싱에 적합합니다.

누가 사용하면 좋은가

사용자가 명령줄에서 Twitter/X 데이터를 확인하고 싶거나, 반복적인 읽기 작업을 자동화하거나, 후속 처리용으로 구조화된 출력을 만들고 싶다면 twitter-cli 스킬을 사용하세요. 목표가 빠른 조회와 터미널 출력이라면 강점이 크지만, 완전한 소셜 미디어 대시보드를 대체하는 용도에는 맞지 않습니다.

이 스킬이 다른 이유

가장 중요한 도입 판단 기준은 인증입니다. twitter-cli는 API 키 없이도 동작할 수 있지만, 쓰기 작업은 유효한 브라우저 쿠키에 의존하며 환경 변수가 일부만 설정된 상태에서는 실패할 수 있습니다. 그래서 twitter-cli의 설치 결정은 결국 사용자가 인증을 깔끔하게 완료할 수 있는지, 그리고 읽기 전용인지 읽기/쓰기 모두 필요한지에 달려 있습니다.

twitter-cli 스킬 사용 방법

twitter-cli 설치하기

다음 명령으로 twitter-cli 스킬을 설치하세요:
npx skills add public-clis/twitter-cli --skill twitter-cli

설치 후에는 대상 환경에 Python 3.10+, uv, 또는 pipx가 있는지가 실제 twitter-cli install 판단의 핵심입니다. 이 저장소의 설정 방식은 브라우저 확장이나 호스팅 서비스가 아니라 Python 기반 CLI 설치를 전제로 합니다.

인증부터 시작하기

실제 twitter-cli usage를 하기 전에 먼저 상태를 확인하세요. 이 저장소의 워크플로는 분명합니다. 자격 증명이 있는지 확인한 다음 진행하면 됩니다.

보통 가장 먼저 확인할 명령:
twitter status --yaml

상태가 인증되지 않았다고 나오면, 게시, 답글, 좋아요를 시도하기 전에 브라우저 쿠키 추출이나 지원되는 다른 인증 경로를 안내하세요. 인증이 약할 때 가장 자주 막히는 지점이 바로 twitter-cli의 쓰기 작업이기 때문입니다.

작업을 좋은 프롬프트로 바꾸기

좋은 twitter-cli guide 프롬프트에는 다음이 분명히 들어가야 합니다:

• 대상 작업: 읽기, 검색, 게시, 답글, 인용, 좋아요, 리트윗, 팔로우, 조회
• 대상 객체: 사용자명, 트윗 ID, 키워드, 리스트, 타임라인 유형
• 출력 형식: 터미널 보기, --yaml, --json
• 제약 조건: 날짜 범위, 검색 탭, 전체 텍스트, 리트윗 제외 여부

요청 예시:
“twitter-cli로 Latest에서 open source LLM을 검색하고, --yaml로 반환한 뒤 작성자와 URL을 포함해 상위 5개 결과를 요약해줘.”

먼저 읽어야 할 파일

빠르게 저장소를 파악하려면 다음 순서를 우선하세요:

• SKILL.md — 명령과 인증 규칙
• README.md — 기능 범위와 예시
• SCHEMA.md — 구조화 출력 형식
• AGENTS.md — 개발 및 테스트 맥락
• twitter_cli/cli.py와 twitter_cli/auth.py — 명령 진입점과 로그인 동작

twitter-cli 스킬 FAQ

twitter-cli는 Twitter/X 읽기 전용인가요?

아니요. twitter-cli 스킬은 읽기와 쓰기 모두 지원하지만, 쓰기 작업은 인증 품질에 훨씬 민감하며 환경 변수만으로는 부족하고 브라우저 쿠키가 필요할 수 있습니다.

API 키가 꼭 필요한가요?

대체로 기본 twitter-cli 워크플로에는 API 키가 필요하지 않습니다. 이 저장소는 브라우저 쿠키 기반 인증과 CLI 중심 접근을 전제로 설계되어 있어, 개발자 앱 설정 없이 빠르게 Social Media 작업을 하고 싶은 사용자에게 유용합니다.

언제는 twitter-cli를 쓰지 말아야 하나요?

대량 자동화, 안정적으로 보장되는 API, 또는 터미널이 아닌 워크플로가 필요하다면 twitter-cli는 건너뛰는 것이 좋습니다. 또한 지원되는 브라우저에서 계정 인증이 불가능하거나, 비감독 상태의 쓰기 접근이 필요한 작업에도 적합하지 않습니다.

초보자도 쓰기 쉬운가요?

지원되는 브라우저에서 X에 로그인할 수 있고 작업이 단순하다면 그렇습니다. 가장 흔한 초보자 실수는 자격 증명을 확인하기 전에 명령이 바로 동작할 거라고 가정하는 것입니다. 먼저 인증을 확인하면 훨씬 수월합니다.

twitter-cli 스킬 개선 방법

가장 작은 완성형 대상을 주기

가장 좋은 twitter-cli 출력은 who, what, how many가 분명할 때 나옵니다. “@example의 AI agents 관련 최근 게시물을 찾아줘”는 “Twitter를 검색해줘”보다 훨씬 낫습니다. 이렇게 해야 스킬이 적절한 명령 경로를 고르고 잡음을 줄일 수 있습니다.

출력 제약을 처음부터 명시하기

더 나은 twitter-cli usage를 원한다면 전체 트윗 본문이 필요한지, 구조화 출력이 필요한지, 간단한 터미널 요약이면 충분한지 먼저 말하세요. 예를 들어 결과를 파싱할 계획이라면 --yaml이 더 적합하고, 대화형 검토라면 리치 테이블 출력이 더 보기 좋습니다.

인증과 환경 제한을 공유하기

현재 세션이 로그인되어 있는지, 브라우저 쿠키를 사용할 수 있는지, 지원되는 브라우저를 열 수 있는지 알려 주세요. 이런 제한은 트윗 내용 자체보다 twitter-cli install과 실행 경로를 더 크게 바꿉니다.

명령 형태보다 결과 품질을 기준으로 반복하기

첫 실행이 원하는 내용을 놓쳤다면 요청 전체를 다시 쓰기보다 검색어, 작성자 필터, 시간 범위, 출력 형식을 더 구체적으로 조정하세요. twitter-cli skill에서는 범위를 좁히고 원하는 데이터 형태를 분명히 할 때 가장 큰 개선이 나옵니다.