Skip to main content
xurl은 X API를 위한 curl과 유사한 커맨드라인 도구입니다. OAuth 인증을 자동으로 처리해 주므로 토큰을 수동으로 관리하거나 요청에 서명할 필요 없이 API 요청을 보낼 수 있습니다.

GitHub repository

소스 코드, 릴리스 및 문서.

​
설치

Go로 설치하거나 releases에서 미리 빌드된 바이너리를 다운로드하세요. 
go install github.com/xdevplatform/xurl@latest

​
설정

​
1. X 앱 만들기

xurl은 사용자 본인의 개발자 앱을 사용해 인증합니다. X 개발자 포털에서:
  1. OAuth 2.0이 활성화된 앱을 만들거나 엽니다.
  2. 리다이렉트 URI http://localhost:8080/callback을 앱에 등록합니다.
  3. “Keys and tokens” 페이지에서 앱의 Client ID와 Client Secret을 복사합니다.

​
2. 자격 증명 설정

xurl을 실행할 동일한 셸에서 자격 증명을 export 하세요: 
export CLIENT_ID="your-x-app-client-id"
export CLIENT_SECRET="your-x-app-client-secret"

​
3. 인증

xurl auth oauth2
이 명령은 브라우저 기반 OAuth 흐름을 엽니다. 인증이 완료되면 xurl이 토큰을 ~/.xurl에 로컬로 저장하므로 다시 인증할 필요가 없습니다.
브라우저에 **“Something went wrong — You weren’t able to give access to the App”**이 표시된다면, xurl이 유효한 자격 증명 없이 로그인을 시작한 것입니다. xurl auth oauth2를 실행한 셸에서 CLIENT_ID와 CLIENT_SECRET이 export되어 있는지, 그리고 http://localhost:8080/callback이 앱에 리다이렉트 URI로 등록되어 있는지 확인하세요.

​
사용법

​
원시 API 요청

xurl을 curl처럼 사용하면 됩니다 — 인증 헤더는 자동으로 처리됩니다: 
# Look up a user
xurl /2/users/by/username/xdevelopers

# Search recent posts
xurl "/2/tweets/search/recent?query=from:xdevelopers&max_results=10"

# Create a post
xurl -X POST /2/tweets -d '{"text": "Hello from xurl!"}'

​
단축 명령어

xurl에는 일반적인 작업을 위한 내장 단축 명령어가 포함되어 있습니다: 
# Look up a user by username
xurl user xdevelopers

# Search recent posts
xurl search "X API"

# Post a tweet
xurl post "Hello from xurl!"

​
왜 xurl을 사용해야 하나요?

기능curlxurl
인증수동 OAuth 헤더 설정자동 — xurl auth를 한 번만 실행
토큰 관리갱신/로테이션을 직접 처리내장 토큰 저장 및 갱신
API 단축 명령어전체 URL 필요일반 작업을 위한 단축 명령어
요청 서명수동 OAuth 1.0a 서명모든 요청에 대해 자동

​
AI 에이전트와 함께 xurl 사용하기

xurl에는 기능을 머신 판독 가능한 형식으로 기술한 SKILL.md 파일이 포함되어 있습니다. AI 에이전트는 이를 이용해 사용자 대신 xurl 명령어를 어떻게 호출해야 하는지 이해할 수 있습니다. 
npx skills add https://github.com/xdevplatform/xurl

​
관련 자료

첫 요청 보내기

cURL 또는 SDK를 사용해 X API로 시작하세요.

API Playground

모의 데이터로 로컬에서 엔드포인트를 테스트하세요 — API 크레딧이 필요 없습니다.