Fetch Tweet
Pull full text, author metadata, and engagement stats from an X/Twitter URL so your agent can summarize, translate, or wire tweets into other workflows.
Overview
Fetch Tweet is an agent skill most often used in Build integrations (also Idea research and Grow content) that retrieves tweet text, author info, and engagement from X/Twitter URLs via FxEmbed’s API and a stdlib Python s
Install
npx skills add https://github.com/ai-native-camp/camp-2 --skill fetch-tweetWhat is this skill?
- Maps x.com/twitter.com URLs to api.fxtwitter.com for JSON without browser JavaScript
- Bundled scripts/fetch_tweet.py using only the Python standard library—no pip dependencies
- Human-readable output or --json mode for downstream agent pipelines
- Surfaces text, author bio/followers, likes/retweets/replies/bookmarks/views, media, quotes, and lang
- Supports x.com, twitter.com, fxtwitter.com, and fixupx.com URL shapes
- stdlib-only Python script with no external pip dependencies
- supports four URL host patterns including x.com and twitter.com
Adoption & trust: 1.1k installs on skills.sh; 17 GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You have an X/Twitter link in chat but need reliable tweet text and stats without logging into the API or scraping in a browser.
Who is it for?
Builders automating tweet ingestion in Claude Code or Cursor, especially when mixing Korean trigger phrases with English URLs.
Skip if: Bulk historical analytics, posting tweets, or compliance-sensitive monitoring that requires official X API contracts and auth.
When should I use this skill?
User asks to fetch, read, or translate tweets; provides x.com or twitter.com URLs; or another skill needs programmatic tweet text.
What do I get? / Deliverables
You get formatted or JSON tweet payloads ready to display, translate, or pass into analysis and content workflows without extra dependencies.
- Formatted tweet summary for chat display
- Optional JSON payload for downstream skills
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Fetching tweet JSON via a script is agent-side integration work—the canonical home is Build/integrations even when the output supports research or growth tasks. Integrations fits because the skill wraps FxEmbed’s HTTP API and a stdlib Python script other skills can call programmatically.
Where it fits
Pull founder or competitor tweets verbatim while mapping positioning narratives.
Call fetch_tweet.py --json from a larger agent workflow that summarizes threads.
Capture engagement metrics and quote tweets before drafting a response or newsletter cite.
How it compares
A lightweight URL-to-JSON bridge—not a full social listening platform or browser automation skill.
Common Questions / FAQ
Who is fetch-tweet for?
Solo builders and agent authors who frequently reference X posts for research, translation, or chaining into other skills.
When should I use fetch-tweet?
In Idea/discover when capturing competitor or audience posts; in Build/integrations when scripting agent pipelines; in Grow/content when you need exact wording and engagement on a shared launch thread.
Is fetch-tweet safe to install?
Check the Security Audits panel on this Prism page for ai-native-camp/camp-2; the skill only calls a public embed API and runs local Python—review network behavior before use in sensitive environments.
SKILL.md
READMESKILL.md - Fetch Tweet
# 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` - 표준 라이브러리만 사용, 외부 의존성 없음. ```bash # 기본 사용 (포맷팅된 출력) 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 ### 단일 트윗 가져오기 1. URL에서 screen_name과 status_id를 추출 2. `scripts/fetch_tweet.py <url>` 실행 3. 결과를 사용자에게 표시하거나 번역 ### 번역 요청 시 1. 스크립트로 원문 fetch 2. 가져온 텍스트를 한국어로 번역하여 제공 3. 인게이지먼트 수치도 함께 표시 ### 다른 스킬과 연동 Contents Hub 등에서 수집한 X URL 목록을 일괄 처리할 때: ```bash # 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 서버 정책에 따름 (일반 사용 수준에서는 문제 없음)