무료GitHub에 공개한국어 소개

xurl

인증된 명령으로 X에 게시물을 올리고 답글 작성, 검색, 쪽지 송수신, 이미지·동영상 업로드를 수행합니다. 게시물, 팔로워와 인증 상태도 확인합니다.

원문원문 설명 보기

xurl CLI for authenticated X posts, replies, reads/search, DMs, media upload, followers, auth status, or raw v2 API calls.

openclaw/openclaw

연동 도구X (Twitter)

AI 평가80점/ 100 설치 방법 보기

이럴 때 유용합니다

이미지나 동영상이 포함된 게시물 작성
게시물 검색과 멘션 확인
쪽지 송수신
팔로워와 인증 상태 확인

한국어 소개

할 수 있는 일

명령줄 도구 xurl로 X에 글을 올리고 정보를 가져옵니다. 게시물 작성, 답글, 인용, 삭제와 함께 게시물 검색·열람, 타임라인, 멘션, 팔로워 확인을 지원합니다. 쪽지 송수신, 이미지·동영상 업로드, 좋아요, 북마크, 팔로우도 처리합니다. 전용 명령으로 처리할 수 없는 작업은 X v2 API를 직접 호출합니다.

이럴 때 유용합니다

에이전트에게 게시물이나 답글 작성을 맡기거나 검색 결과와 멘션을 가져올 때 사용합니다. 성공한 결과는 JSON으로 반환되므로 가져온 정보를 후속 처리에 전달할 수 있습니다. 요청마다 앱이나 인증 방식을 지정하는 예시도 있습니다.

사용 예시

“이 이미지를 업로드하고 설명을 붙여 X에 게시해 주세요.”
“지정한 키워드로 게시물 20개를 검색해 주세요.”
“최근 쪽지와 인증 상태를 확인해 주세요.”

주의 사항

xurl 설치와 X API 인증이 필요합니다. 비밀 정보는 명령에 직접 쓰지 않고 인증 입력창에 입력합니다. --verbose는 인증 헤더를 출력합니다. API 사용 제한에 도달하면 기다려야 합니다. 동영상은 게시 전에 처리 상태를 확인해야 할 수 있습니다.

이 소개문은 공개된 SKILL.md를 바탕으로 AI(OpenAI Codex)가 작성했습니다. 정확한 사양은 아래 원문을 확인하세요.

객관 평가

AI가 SKILL.md의 내용만을 근거로 4가지 관점에서 판정했습니다. 스타 수나 인기도는 판정에 넣지 않았습니다.

지시의 명확성언제 쓰고 무엇을 하는지 알 수 있는가: A양호X 게시물 작성, 검색, 쪽지 등의 용도와 해당 명령이 명시되어 있습니다.
절차의 구체성절차·입출력·예시가 구체적으로 적혀 있는가: A양호게시물과 미디어 명령 예시, JSON 출력, 오류 대응 방법을 제시합니다.
안전성전송·삭제·명령 실행 등을 명시하고 있는가: B일부 부족비밀 정보 취급 방법은 설명하지만 게시나 삭제 전 확인 절차는 없습니다.
도입의 용이성필요한 도구나 API 키가 적고 적혀 있는가: B일부 부족설치 방법은 제시하지만 X API 인증을 설정하는 상세 절차는 없습니다.

총점은 각 항목을 A=25점, B=15점, C=5점으로 더한 값입니다. 2026년 10월 19일 기준으로 AI(OpenAI Codex)가 판정했습니다. 참고용이므로 설치 전에 원문도 확인해 주세요.

평가가 다르다고 생각되면 재검토를 요청하기

포함된 파일(1)

SKILL.md2.6 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

xurl

Use xurl for X API work. Shortcut commands return JSON; raw mode works for any v2 endpoint.

Auth

~/.xurl holds tokens; check auth with xurl auth status instead of reading it.
Pass secrets to auth commands through the prompt, not inline, so they stay out of shell history.
--verbose prints auth headers into tool output.

Common shortcuts

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 can be a full https://x.com/<user>/status/<id> URL.

Media

xurl media upload image.jpg
xurl media upload clip.mp4
xurl media status MEDIA_ID
xurl post "caption" --media-id MEDIA_ID

Videos may need processing; poll media status.

Auth/app management

xurl auth status
xurl auth apps list
xurl auth default
xurl auth default APP_NAME USERNAME
xurl auth apps remove APP_NAME

Per request:

xurl --app APP_NAME /2/users/me
xurl --auth oauth2 /2/users/me

Raw API

xurl /2/users/me
xurl -X POST /2/tweets -d '{"text":"Hello world!"}'
xurl '/2/tweets/search/recent?query=openclaw&max_results=10'

Use raw mode when shortcuts do not cover the endpoint. Keep payloads in temp files for complex JSON.

Output and errors

JSON stdout on success.
Non-zero exit on API/auth/network errors.
401/403: auth, scope, or app mismatch; check xurl auth status.
429: rate limited; back off.
Media upload failures: check file type/size and media processing status.

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

같은 저장소의 스킬