WilliamAlexYT/x-research-skill

x-research-skill은(는) 무엇을 하나요?

🔍 X(트위터) 리서치를 터미널 기반으로 빠르게 수행할 수 있도록 검색, 필터, 모니터링 및 비용 추적 기능을 제공하는 간단한 CLI 도구입니다.

개요

이 스킬은 x-research라는 명령줄 도구를 제공하여 X/Twitter 데이터를 효율적으로 탐색하고 수집할 수 있게 해줍니다. 주요 기능은 다음과 같습니다:

• 검색: 키워드, 해시태그, 사용자 멘션 기반 트윗 검색
• 필터: 날짜 범위, 언어, 트윗 유형(리트윗/댓글) 등 고급 필터링
• 모니터링: 특정 주제나 계정의 실시간 트윗 스트림 모니터링
• 비용 추적: API 사용량 및 예상 비용 실시간 확인

설치

# npm을 통한 전역 설치
npm install -g x-research-cli

# 또는 소스에서 직접 실행
npx x-research-cli

사용 방법

기본 검색

x-research search --query "AI agents"

필터 적용

x-research search --query "Claude" --from 2024-01-01 --to 2024-12-31 --lang en

실시간 모니터링

x-research monitor --keywords "OpenAI,GPT-5" --interval 30

비용 확인

x-research cost --session latest

환경 변수

TWITTER_BEARER_TOKEN 환경 변수가 필요합니다. Twitter API v2에 접근하기 위해 유효한 Bearer Token을 설정하세요.

export TWITTER_BEARER_TOKEN="your_token_here"

내보내기 형식

검색 결과는 다음 형식으로 내보낼 수 있습니다:

• json (기본값)
• csv
• markdown

예시:

x-research search --query "AI" --output csv --file results.csv

참고 사항

• Twitter API 사용량 제한에 주의하세요. 비용 추적 기능을 통해 사용량을 모니터링할 수 있습니다.
• 모든 데이터는 Twitter의 개발자 약관을 준수하여 사용해야 합니다.

라이선스

MIT