xurl

• AI 에이전트나 자동화 스크립트를 통해 X에 트윗, 답글, 또는 인용 게시물을 올려야 할 때.
• 최근 게시물 검색, 타임라인 읽기, 또는 멘션을 프로그래밍 방식으로 모니터링하고 싶을 때.
• 소셜 그래프 작업(팔로우, 언팔로우, 차단, 뮤트) 관리나 스크립트를 통한 다이렉트 메시지 전송이 필요할 때.
• 커스텀 API 클라이언트 코드 없이 미디어(이미지, 동영상)를 업로드하고 게시물에 첨부하고 싶을 때.

• 레거시 X API v1.1 엔드포인트와 상호작용해야 하는 경우 — xurl은 v2만 지원합니다.
• 자격 증명을 ~/.xurl에 저장하는 것이 안전하지 않거나 불가능한 샌드박스 또는 공유 환경에 있는 경우.
• X 계정 관리를 위한 그래픽 인터페이스나 노코드 인터페이스가 필요한 경우.

게시, 답글, 인용, 삭제, 검색, 좋아요, 리포스트, 북마크, 팔로우, 차단, 뮤트, DM 전송, 미디어 업로드를 위한 즉시 사용 가능한 원라이너 명령어를 제공합니다. 일상적인 작업을 위해 원시 API 페이로드를 직접 구성할 필요가 없습니다.

단축 명령어를 넘어, xurl은 범용 X API 클라이언트로도 활용됩니다. -X, -d, -H 플래그와 함께 xurl /2/some/endpoint를 사용하면 인증이 자동으로 처리되는 curl처럼 모든 v2 엔드포인트에 접근할 수 있습니다.

여러 X 앱을 등록하고 앱당 여러 OAuth 2.0 계정을 인증할 수 있습니다. xurl auth default 명령으로 전환하거나, --app 및 --username 플래그를 사용해 요청별로 재정의할 수 있습니다.

xurl media upload을 사용하여 이미지 또는 동영상을 업로드한 후, 반환된 media_id를 게시물이나 답글에 직접 첨부하세요. 동영상 처리 상태는 xurl media status --wait를 통해 폴링할 수 있습니다.

알려진 스트리밍 엔드포인트(예: /2/tweets/search/stream, /2/tweets/sample/stream)는 자동으로 감지되어 올바르게 처리됩니다. -s 플래그를 사용하면 모든 엔드포인트를 강제로 스트리밍 모드로 전환할 수 있습니다.

자격 증명은 ~/.xurl에 로컬로 저장되며, 인라인으로 전달할 필요가 없습니다. 이 도구는 엄격한 인라인 시크릿 금지 정책을 적용하므로, 프롬프트/컨텍스트 유출이 위험 요소로 작용하는 AI 에이전트 또는 LLM 워크플로우 내에서 더욱 안전하게 사용할 수 있습니다.

에이전트는 xurl search로 특정 주제의 게시물을 검색하고, xurl read로 맥락을 파악한 다음, 가장 관련성 높은 결과에 답글을 달거나 좋아요를 누를 수 있습니다 — 모든 단계에서 구조화된 JSON을 사용하는 단일 연결 워크플로우로 이 모든 작업이 이루어집니다.

xurl media upload로 준비된 이미지를 업로드하고, JSON 응답에서 media_id를 캡처한 다음, 즉시 새 게시물에 첨부하세요 — 완전히 자동화된 미디어 풍부 게시 파이프라인을 구현할 수 있습니다.

xurl mentions, xurl timeline, xurl followers, xurl dms를 사용하여 멘션, 홈 타임라인, 새 팔로워, DM을 주기적으로 확인함으로써 모니터링 대시보드나 알림 봇을 구동하세요.

별도의 개발 및 프로덕션 앱을 등록하고, 각각 독립적으로 인증한 후, xurl auth default 또는 요청별 --app 옵션을 사용하여 전환하세요 — 자격 증명이 혼합되는 일 없이.