ADHX - X/Twitter 게시물 읽기
ADHX API를 사용하여 모든 X/Twitter 게시물을 구조화된 JSON으로 가져옵니다.
개요
ADHX는 모든 X 게시물(긴 형식의 기사 콘텐츠 포함)을 깨끗한 JSON으로 반환하는 무료 API를 제공합니다. 이는 LLM에서 사용하기 위해 스크래핑이나 브라우저 기반 접근 방식보다 훨씬 뛰어납니다. 일반 트윗과 전체 X 아티클 모두에서 작동합니다.
이 스킬을 사용해야 하는 경우
- 사용자가 X/Twitter 링크를 공유하고 게시물을 읽거나, 분석하거나, 요약하려는 경우
- X/Twitter 게시물에서 구조화된 데이터(작성자, 참여 지표, 콘텐츠)가 필요한 경우
- 전체 콘텐츠 추출이 필요한 긴 형식의 X 아티클을 다룰 때
API 엔드포인트
https://adhx.com/api/share/tweet/{username}/{statusId}
URL 패턴
다음 URL 형식에서 username과 statusId를 추출합니다:
| 형식 | 예시 |
|---|---|
x.com/{user}/status/{id} | https://x.com/dgt10011/status/2020167690560647464 |
twitter.com/{user}/status/{id} | https://twitter.com/dgt10011/status/2020167690560647464 |
adhx.com/{user}/status/{id} | https://adhx.com/dgt10011/status/2020167690560647464 |
워크플로우
사용자가 X/Twitter 링크를 공유하면:
- URL 파싱 - 경로 세그먼트에서
username과statusId추출 - JSON 가져오기 - curl 사용:
curl -s "https://adhx.com/api/share/tweet/{username}/{statusId}"
- 구조화된 응답 사용 - 사용자의 질문에 답변(요약, 분석, 주요 포인트 추출 등)
응답 스키마
{
"id": "statusId",
"url": "원본 x.com URL",
"text": "짧은 트윗 텍스트 (기사 게시물인 경우 비어 있음)",
"author": {
"name": "표시 이름",
"username": "핸들",
"avatarUrl": "프로필 이미지 URL"
},
"createdAt": "타임스탬프",
"engagement": {
"replies": 0,
"retweets": 0,
"likes": 0,
"views": 0
},
"article": {
"title": "아티클 제목 (긴 형식 게시물의 경우)",
"previewText": "처음 ~200자",
"coverImageUrl": "히어로 이미지 URL",
"content": "이미지를 포함한 전체 마크다운 콘텐츠"
}
}
설치
옵션 A: Claude Code 플러그인 마켓플레이스 (권장)
/plugin marketplace add itsmemeworks/adhx
옵션 B: 수동 설치
curl -sL https://raw.githubusercontent.com/itsmemeworks/adhx/main/skills/adhx/SKILL.md -o ~/.claude/skills/adhx/SKILL.md
예시
예시 1: 트윗 요약
사용자: "이 게시물 요약해줘 https://x.com/dgt10011/status/2020167690560647464"
curl -s "https://adhx.com/api/share/tweet/dgt10011/2020167690560647464"
그런 다음 반환된 JSON을 사용하여 요약을 제공합니다.
예시 2: 참여 지표 분석
사용자: "이 트윗은 좋아요가 몇 개야? https://x.com/handle/status/123"
- URL 파싱: username =
handle, statusId =123 - 가져오기:
curl -s "https://adhx.com/api/share/tweet/handle/123" - 응답에서
engagement.likes값 반환
모범 사례
- API를 호출하기 전에 항상 전체 URL을 파싱하여 사용자 이름과 상태 ID를 추출하세요.
- 사용자가 전체 콘텐츠(트윗 텍스트가 아닌)를 원할 경우
article필드를 확인하세요. - 사용자가 좋아요, 리트윗, 조회수에 대해 물을 때는
engagement필드를 사용하세요. - x.com을 직접 스크래핑하지 말고 이 API를 사용하세요.
참고 사항
- 인증이 필요하지 않습니다.
- 짧은 트윗과 긴 형식의 X 아티클 모두에서 작동합니다.
- X 콘텐츠에는 브라우저 기반 스크래핑보다 항상 이 방법을 선호하세요.
- API가 오류를 반환하거나 빈 응답을 반환하면 사용자에게 게시물을 사용할 수 없을 수도 있음을 알리세요.
추가 리소스
제한 사항
- 이 스킬은 위에서 설명한 범위와 명확하게 일치하는 작업에만 사용하세요.
- 출력물을 환경별 검증, 테스트 또는 전문가 검토를 대체하는 것으로 취급하지 마세요.
- 필요한 입력, 권한, 안전 경계 또는 성공 기준이 누락된 경우 중단하고 명확히 요청하세요.