my-fetch-tweet

X/Twitter 트윗을 가져와서 요약·인사이트·전체 번역을 제공하는 스킬.

API 연동 방법

지원 URL 형식

입력 URL	변환 후
https://x.com/{screen_name}/status/{id}	https://api.fxtwitter.com/{screen_name}/status/{id}
https://twitter.com/{screen_name}/status/{id}	https://api.fxtwitter.com/{screen_name}/status/{id}
https://fxtwitter.com/{screen_name}/status/{id}	도메인만 api.fxtwitter.com으로 교체
https://fixupx.com/{screen_name}/status/{id}	도메인만 api.fxtwitter.com으로 교체

변환 규칙

1. URL에서 screen_name과 status_id 추출
2. 도메인을 api.fxtwitter.com으로 교체
3. WebFetch로 JSON 데이터 호출

변환 예시:
https://x.com/garrytan/status/1234567890
→ https://api.fxtwitter.com/garrytan/status/1234567890

응답 JSON 주요 필드

필드	설명
tweet.text	트윗 본문 전체
tweet.author.name	작성자 이름
tweet.author.screen_name	작성자 @핸들
tweet.likes	좋아요 수
tweet.retweets	리트윗 수
tweet.views	조회수
tweet.quote	인용 트윗 (있는 경우)

번역 파이프라인

트윗 데이터를 가져온 뒤 아래 3단계 순서로 제공한다. 전체 번역을 바로 보여주지 않고 단계적으로 제공하여 핵심 파악 → 의미 이해 → 전문 독해 순서를 따른다.

1단계: 요약 (3-5문장)

• 트윗의 핵심 주장을 한국어로 요약
• 작성자 정보(@핸들, 이름) 포함
• 인게이지먼트 수치 포함 (좋아요 N / 리트윗 N / 조회 N)
• 스레드 트윗이면 전체 흐름을 한 문단으로 압축

2단계: 인사이트 (3개)

• 핵심 메시지: 이 트윗이 정말 말하고 싶은 것
• 시사점: 업계/트렌드에서의 의미, 왜 지금 이 말을 하는지
• 적용점: 나(독자)에게 어떤 의미인지, 어떻게 활용할 수 있는지

3단계: 전체 번역

• 원문 전체를 자연스러운 한국어로 번역
• 인용 트윗이 있으면 함께 번역 (들여쓰기로 구분)
• 전문 용어는 원문 병기 (예: "에이전트(Agent)", "프롬프트(Prompt)")
• 줄바꿈·이모지·링크 등 원문 서식 유지

WebFetch Fallback

스크립트 실행이 어려울 때 WebFetch 도구로 직접 API를 호출한다.

사용 방법

1. 입력 URL에서 screen_name과 status_id 추출
2. 아래 형식으로 WebFetch 호출:

URL: https://api.fxtwitter.com/{screen_name}/status/{status_id}
Prompt: "Extract the full tweet text, author name, and engagement metrics"

예시

입력: https://x.com/garrytan/status/1234567890
WebFetch URL: https://api.fxtwitter.com/garrytan/status/1234567890

응답에서 tweet.text, tweet.author, tweet.likes, tweet.retweets, tweet.views 값을 추출하여 번역 파이프라인(요약 → 인사이트 → 전체 번역)에 사용한다.