Community라이팅 & 에디팅github.com

steipete/xurl

X API CLI: 설치, 인증, 앱 선택, 단축 명령어, 원시 엔드포인트 지원.

xurl란 무엇인가요?

xurl은 X (구 Twitter) API를 위한 공식 CLI 도구로, 개발자와 AI 에이전트가 X 플랫폼과 상호작용할 수 있도록 설계되었습니다. Homebrew, npm, Shell 스크립트, Go 등 다양한 패키지 관리자를 통해 쉽게 설치할 수 있습니다. 이 도구는 OAuth 1.0a, OAuth 2.0, 앱 전용 인증 등 여러 인증 방식을 지원하며, 여러 앱과 사용자 계정을 동시에 관리할 수 있습니다. 주요 기능으로는 트윗 게시/삭제/읽기, 검색, 사용자 정보 조회, 타임라인 읽기, 좋아요, 리포스트, 북마크, 팔로우/언팔로우, DM, 미디어 업로드 등 X API의 거의 모든 기능을 단축 명령어로 제공합니다. 또한 원시 엔드포인트 모드를 통해 HTTP 메서드와 JSON 페이로드를 직접 지정하여 모든 X API 엔드포인트에 접근할 수 있습니다. 보안이 매우 중요시되어, 인증 토큰이나 클라이언트 시크릿을 에이전트 컨텍스트에 노출하지 않도록 설계되었습니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, xurl은 에이전트가 실수로 민감 정보를 유출하지 않도록 --verbose 플래그 사용을 금지하고 인라인 시크릿 사용을 피하도록 권장합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/xurl

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

xurl은(는) 무엇을 하나요?

X API 공식 CLI.

공식 저장소: https://github.com/xdevplatform/xurl

설치

Homebrew:

brew install --cask xdevplatform/tap/xurl

npm:

npm install -g @xdevplatform/xurl

쉘 스크립트:

curl -fsSL https://raw.githubusercontent.com/xdevplatform/xurl/main/install.sh | bash

Go:

go install github.com/xdevplatform/xurl@latest

안전

  • ~/.xurl 파일을 LLM 컨텍스트에 읽거나, 출력, 요약, 업로드, 붙여넣기 하지 마십시오.
  • 사용자에게 클라이언트 시크릿, bearer 토큰, OAuth 토큰을 채팅에 붙여넣도록 요청하지 마십시오.
  • 에이전트 실행 시 --verbose를 사용하지 마십시오. 인증 헤더가 노출될 수 있습니다.
  • 에이전트 세션에서 인라인 시크릿 플래그를 사용하여 인증 명령을 실행하지 마십시오.
  • 사용자는 에이전트 세션 밖에서 자신의 기기에서 수동으로 앱 자격 증명을 등록해야 합니다.

인증

현재 상태 확인:

xurl auth status

앱이 이미 등록되어 있으면 OAuth 2.0 완료:

xurl auth oauth2

멀티 앱:

xurl auth apps list
xurl auth default my-app
xurl auth default my-app alice
xurl --app dev-app /2/users/me

참고:

  • xurl은 앱 설정과 토큰을 ~/.xurl에 저장합니다.
  • X 개발자 포털에서 OAuth 2.0 리디렉션 URI는 http://localhost:8080/callback으로 설정해야 합니다.
  • 인라인 시크릿을 포함한 앱 등록 예시는 의도적으로 생략되었습니다. 에이전트 세션 밖에서 수행하십시오.

일반 단축 명령어

xurl post "Hello world!"
xurl reply 1234567890 "멋진 글이네요"
xurl quote 1234567890 "내 생각"
xurl delete 1234567890

xurl read 1234567890
xurl search "from:elonmusk" -n 10
xurl whoami
xurl user @XDevelopers
xurl timeline -n 20
xurl mentions -n 10

xurl like 1234567890
xurl unlike 1234567890
xurl repost 1234567890
xurl unrepost 1234567890

xurl bookmark 1234567890
xurl unbookmark 1234567890
xurl bookmarks -n 10
xurl likes -n 10

xurl follow @handle
xurl unfollow @handle
xurl following -n 20
xurl followers -n 20

xurl dm @handle "메시지"
xurl dms -n 10

xurl media upload path/to/file.mp4
xurl media status MEDIA_ID

POST_ID는 전체 X 상태 URL도 가능합니다.

원시 엔드포인트 모드

GET:

xurl /2/users/me

POST JSON:

xurl -X POST /2/tweets -d '{"text":"Hello world!"}'

헤더:

xurl -H "Content-Type: application/json" /2/tweets

인증 유형 선택:

xurl --auth oauth2 /2/users/me
xurl --auth oauth1 /2/tweets
xurl --auth app /2/users/me

OAuth2 계정 선택:

xurl --username alice /2/users/me

스트리밍:

xurl /2/tweets/search/stream
xurl -s /2/users/me

빠른 확인

설치 확인:

xurl version

인증 상태:

xurl auth status

인증 후 라이브 요청:

xurl whoami

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

관련 스킬