ai-native-camp Fetch Tweet
X/Twitter URL에서 트윗 원문, 작성자 정보, 인게이지먼트 데이터를 가져오는 스킬.
FxEmbed 오픈소스 프로젝트의 API (api.fxtwitter.com)를 활용하여 JavaScript 없이 트윗 데이터를 추출한다.
How It Works
X/Twitter URL의 도메인을 api.fxtwitter.com으로 변환하면 JSON으로 트윗 전체 데이터를 반환한다.
https://x.com/user/status/123456
→ https://api.fxtwitter.com/user/status/123456
Script
scripts/fetch_tweet.py - 표준 라이브러리만 사용, 외부 의존성 없음.
# 기본 사용 (포맷팅된 출력)
python scripts/fetch_tweet.py https://x.com/garrytan/status/2020072098635665909
# JSON 출력 (프로그래밍 활용)
python scripts/fetch_tweet.py https://x.com/garrytan/status/2020072098635665909 --json
지원 URL 형식: x.com, twitter.com, fxtwitter.com, fixupx.com
API Response Fields
| 필드 | 설명 |
|---|---|
tweet.text |
트윗 본문 (URL 확장됨) |
tweet.author |
작성자 (name, screen_name, bio, followers) |
tweet.likes/retweets/replies/bookmarks/views |
인게이지먼트 |
tweet.created_at |
작성 일시 |
tweet.media |
첨부 미디어 (photos, videos) |
tweet.quote |
인용 트윗 (동일 구조) |
tweet.lang |
언어 코드 |
Workflow
단일 트윗 가져오기
- URL에서 screen_name과 status_id를 추출
scripts/fetch_tweet.py <url>실행- 결과를 사용자에게 표시하거나 번역
번역 요청 시
- 스크립트로 원문 fetch
- 가져온 텍스트를 한국어로 번역하여 제공
- 인게이지먼트 수치도 함께 표시
다른 스킬과 연동
Contents Hub 등에서 수집한 X URL 목록을 일괄 처리할 때:
# JSON 출력으로 파이프라인 연동
python scripts/fetch_tweet.py <url> --json | python3 -c "import sys,json; print(json.load(sys.stdin)['tweet']['text'])"
WebFetch Fallback
스크립트 실행이 어려운 경우 WebFetch 도구로 직접 API 호출 가능:
URL: https://api.fxtwitter.com/{screen_name}/status/{status_id}
Prompt: "Extract the full tweet text and author name"
Limitations
- 비공개 계정 트윗은 조회 불가
- 삭제된 트윗은 조회 불가
- API rate limit은 FxEmbed 서버 정책에 따름 (일반 사용 수준에서는 문제 없음)