X(트위터) → 마크다운 변환기
X(트위터) 트윗·스레드·아티클을 YAML 프론트매터가 붙은 마크다운 파일로 저장해 주는 스킬입니다.
유틸리티중급★ 24,749⑂ 2,764AI 점수 6/10마지막 업데이트: 2026. 7. 4.
무엇을 해주나
- x.com / twitter.com의 트윗, 스레드, X 아티클 URL을 붙여넣으면 마크다운 파일로 변환해 저장합니다.
- 파일 상단에
url,author,tweetCount,coverImage같은 YAML 프론트매터를 자동으로 넣어 줍니다. --download-media옵션으로 이미지·동영상을imgs/,videos/폴더에 내려받고 마크다운 링크를 로컬 상대경로로 바꿔 줍니다.- 최초 실행 시 면책 동의 절차를 거치고,
EXTEND.md에 미디어 다운로드 방식·기본 저장 경로 같은 개인 설정을 저장합니다. - 저장 구조:
x-to-markdown/{사용자명}/{트윗ID}/{슬러그}.md
⚠️ 이 스킬은 비공식(리버스 엔지니어링) X API를 사용하며, 인증을 위해
X_AUTH_TOKEN/X_CT0환경변수 또는 Chrome 로그인 쿠키를 요구합니다. 계정 제한 가능성이 있으니 본인 책임하에 사용하세요.
이런 분께 추천
- 좋은 트윗·스레드를 옵시디언/노션 등 개인 지식베이스에 마크다운으로 아카이빙하고 싶은 분
- X 아티클을 블로그 초안이나 뉴스레터 소재로 재활용하려는 콘텐츠 제작자
- 인용·리서치 자료로 트윗 원문을 출처 메타데이터와 함께 보관해야 하는 연구자
활용 예시
- 스레드 아카이빙 — "이 스레드를 마크다운으로 저장해줘 https://x.com/user/status/123" →
x-to-markdown/user/123/....md생성, 이미지까지 로컬로 저장. - 아티클 재활용 — X 아티클 URL을 주고 "전체 본문을 추출해서 블로그 초안 폴더에 넣어줘"라고 요청 →
-o옵션으로 원하는 경로에 저장. - 자동화 파이프라인 —
--json옵션으로 구조화된 데이터를 뽑아 다른 스크립트(요약·번역)에 그대로 넘기기.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 JimLiu/baoyu-skills 의 skills/baoyu-danger-x-to-markdown 폴더를 내 ~/.claude/skills/baoyu-danger-x-to-markdown/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/JimLiu/baoyu-skills.git /tmp/baoyu-skills && mkdir -p ~/.claude/skills && cp -r /tmp/baoyu-skills/skills/baoyu-danger-x-to-markdown ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 사전 준비: 터미널에서
bun --version또는npx --version을 실행해 둘 중 하나가 설치돼 있는지 확인합니다. 없으면curl -fsSL https://bun.sh/install | bash로 bun을 설치하세요. - 저장소 클론:
git clone https://github.com/JimLiu/baoyu-skills.git /tmp/baoyu-skills - 스킬 폴더 복사:
mkdir -p ~/.claude/skills && cp -r /tmp/baoyu-skills/skills/baoyu-danger-x-to-markdown ~/.claude/skills/ - Claude Code 재시작 후
/skills또는 스킬 목록에서baoyu-danger-x-to-markdown이 보이는지 확인합니다. - 인증 준비(선택): 환경변수
X_AUTH_TOKEN,X_CT0를 설정하면 안정적입니다. 설정하지 않으면 Chrome 로그인 창이 열려 쿠키를 캐시합니다. - 첫 실행: "https://x.com/... 트윗을 마크다운으로 저장해줘"라고 요청하면 면책 동의 안내와 초기 설정(미디어 다운로드·저장 경로) 질문이 나옵니다. 내용을 읽고 선택하세요.
- 결과 파일이
./x-to-markdown/아래 생성됐는지 확인합니다.
GitHub에서 원본 보기 ↗라이선스: MIT