xurl은(는) 무엇을 하나요?
X API 작업에는 xurl을 사용하세요. 단축 명령어는 JSON을 반환하며, 원시 모드는 모든 v2 엔드포인트에서 작동합니다.
인증
~/.xurl파일에 토큰이 저장됩니다. 파일을 직접 읽지 말고xurl auth status로 인증 상태를 확인하세요.- 인증 명령어에 시크릿을 전달할 때는 프롬프트를 통해 전달하고, 인라인으로 전달하지 마십시오. 셸 히스토리에 남지 않도록 하기 위함입니다.
--verbose플래그를 사용하면 인증 헤더가 도구 출력에 포함됩니다.
일반 단축 명령어
xurl post "Hello world!"
xurl reply POST_ID "Nice."
xurl quote POST_ID "My take"
xurl delete POST_ID
xurl read POST_ID
xurl search "query" -n 20
xurl whoami
xurl user @handle
xurl timeline -n 20
xurl mentions -n 10
xurl like POST_ID
xurl unlike POST_ID
xurl repost POST_ID
xurl unrepost POST_ID
xurl bookmark POST_ID
xurl unbookmark POST_ID
xurl followers -n 20
xurl following -n 20
xurl follow @handle
xurl unfollow @handle
xurl block @handle
xurl unblock @handle
xurl mute @handle
xurl unmute @handle
xurl dm @handle "message"
xurl dms -n 10
POST_ID는 전체 https://x.com/<user>/status/<id> URL일 수 있습니다.
미디어
xurl media upload image.jpg
xurl media upload clip.mp4
xurl media status MEDIA_ID
xurl post "caption" --media-id MEDIA_ID
비디오는 처리 시간이 필요할 수 있습니다. media status로 상태를 확인하세요.
인증/앱 관리
xurl auth status
xurl auth apps list
xurl auth default
xurl auth default APP_NAME USERNAME
xurl auth apps remove APP_NAME
요청별:
xurl --app APP_NAME /2/users/me
xurl --auth oauth2 /2/users/me
원시 API
xurl /2/users/me
xurl -X POST /2/tweets -d '{"text":"Hello world!"}'
xurl '/2/tweets/search/recent?query=openclaw&max_results=10'
단축 명령어가 해당 엔드포인트를 지원하지 않을 때는 원시 모드를 사용하세요. 복잡한 JSON의 경우 페이로드를 임시 파일에 저장하세요.
출력 및 오류
- 성공 시 JSON이 표준 출력(stdout)으로 출력됩니다.
- API/인증/네트워크 오류 시 0이 아닌 종료 코드가 반환됩니다.
- 401/403: 인증, 범위(scope) 또는 앱 불일치.
xurl auth status로 확인하세요. - 429: 속도 제한 초과. 잠시 대기하세요.
- 미디어 업로드 실패: 파일 유형/크기와 미디어 처리 상태를 확인하세요.