FeaturesPricingBlogResourcesAboutContact
Sign inGet Started Free

X(구 트위터) 타임라인을 홈페이지에 삽입하는 피드 위젯, 글만 있는 게시물도 전문 그대로

계정을 연결하고, 공개할 게시물을 고르고, 코드 하나를 홈페이지에 붙여넣으면 됩니다. 게시물은 전문 그대로 페이지 안에 표시되므로, 읽는 사람을 X로 내보내지 않고 그 자리에서 읽게 할 수 있습니다. 사진이 있으면 크게 싣지만, 사진이 없어도 제대로 보이도록 만들었습니다.

7일 무료 체험에서 X도 쓸 수 있습니다. 신용카드 등록은 필요 없습니다.

클럽 공식 계정 소식
Lampblack Runners3시간 전

오늘 밤 클럽 1500m 기록이 바뀌었습니다. 4분 11초 6, 두 번째 도전에서, 다들 말도 꺼내기 싫어하는 맞바람을 뚫고 세운 기록이에요. 내일 아침 기록판에 새 줄이 하나 생깁니다.

4026348
Lampblack Runners11시간 전

젖은 아스팔트, 잿빛 강. 수다 떨 수 있는 페이스로 10km. 한 해 최고의 달리기는 늘 한 해 최악의 날씨에 찾아옵니다.

비에 젖은 강변 산책로를 달리는 사람. 난간을 따라 빈 벤치가 늘어서 있고, 뒤로는 연무에 흐려진 현수교와 도시 스카이라인이 보인다.
143917

Lampblack Runners는 저희가 만든 가상의 러닝 클럽이고 주소도 가상이며, 사진은 CC0 대체 이미지입니다. 열의 폭, 사진을 자르는 방식, 반응 수 표시는 실제 위젯의 것입니다.

1
제품에서 요금이 드는 소스는 X 하나뿐입니다
12시간
유료 요금제의 갱신 간격, 어느 요금제든 같습니다
40
디자인 스튜디오 레이아웃
16
모든 요금제에서 무료인 테마

X(트위터) 타임라인 임베드가 안 보일 때, 공식 도구를 직접 검증해 보니

2026년 8월, X 공식 임베드 도구(publish.x.com)에 입력할 수 있는 네 가지(게시물 URL, 프로필 URL, @핸들, 해시태그)를 모두 시험해 봤습니다. 타임라인이 안 보이는 원인이 붙여넣은 코드가 아니라 도구 자체에 있는 경우가 있습니다. 결과는 다음과 같습니다.

단일 게시물 URL: 정상 표시

본문과 이미지, 반응 수가 담긴 카드가 미리보기로 나타났고, 페이지에 붙여넣어도 그대로 표시됐습니다. 글 안에서 게시물 하나를 인용하는 용도라면 공식 도구로 충분합니다.

프로필 URL: 텍스트 링크뿐

“Embedded Timeline”을 골라도 미리보기에 나온 것은 피드가 아니라 “Posts by (계정 이름)”이라는 텍스트뿐이었습니다. 게다가 생성된 링크는 x.com이 아니라 존재하지 않는 s.com 주소를 가리킵니다. 붙여넣어도 타임라인은 표시되지 않습니다.

@핸들: 같은 증상

X가 입력 예시로 직접 제시하는 @XDevelopers로도 똑같은 텍스트 링크와 깨진 s.com 링크만 생성됐습니다.

해시태그: 임베드 선택지 자체가 없음

타임라인 선택지가 아예 나타나지 않고, 생성되는 것은 글쓰기 버튼뿐입니다. 공식 도구로 해시태그 피드를 임베드하는 방법은 없습니다.

이 위젯이 같은 이유로 사라지지 않는 까닭

CollectSocials 위젯은 X 공식 임베드 스크립트(widgets.js)를 내 페이지에서 불러오지 않습니다. 게시물은 X 공식 API v2에서 가져와 저희 쪽에 저장하고, 거기서 내보냅니다. 페이지가 열릴 때마다 X에 물어보는 방식이 아니므로, 방문자가 X에 로그인했는지와 상관없이 표시됩니다. 계정 타임라인도 해시태그도 붙여넣은 그 자리에 피드로 나타납니다.

옛 twitter.com 주소가 남은 코드, 비공개 계정, 스퀘어스페이스와 웹플로우의 편집 화면에서만 생기는 제한 같은 다른 원인을 가려내는 방법은 X 임베드가 표시되지 않는 7가지 원인에서 검증 화면과 함께 설명합니다.

X 게시물은 대부분 문장이고, 문장 하나에도 한 줄을 통째로 내줄 가치가 있습니다

연습 취소, 대회 결과, 집합 장소 변경. 먼저 게시물마다 한 줄을 쓰는 List로 보고, 거기서 레이아웃과 테마를 바꾸며 본문, 날짜, 프로필 사진, 배지를 켜고 꺼 보세요. 가입도 연결도 필요 없습니다. 아래 게시물은 러닝 클럽이 실제로 쓸 법한 내용으로 채웠습니다.

레이아웃
테마
표시 항목
지금 보는 조합 List Minimal
붉은 육상 트랙에 칠해진 1500m 출발 표시를 바닥 높이에서 찍은 사진. 뒤편 경기장은 흐릿하게 처리되어 있다.

오늘 밤 클럽 1500m 기록이 바뀌었습니다. 4분 11초 6, 두 번째 도전에서, 다들 말도 꺼내기 싫어하는 맞바람을 뚫고 세운 기록이에요. 내일 아침 기록판에 새 줄이 하나 생깁니다.

비에 젖은 강변 산책로를 달리는 사람. 난간을 따라 빈 벤치가 늘어서 있고, 뒤로는 연무에 흐려진 현수교와 도시 스카이라인이 보인다.

젖은 아스팔트, 잿빛 강. 수다 떨 수 있는 페이스로 10km. 한 해 최고의 달리기는 늘 한 해 최악의 날씨에 찾아옵니다.

젖은 아스팔트 위 물웅덩이에 건물과 잎 없는 나뭇가지가 거꾸로 비친 모습.

화요일 인터벌은 취소합니다. 트랙이 통째로 빙판이라 괜찮은 척하지 않겠습니다. 대신 같은 시간, 같은 장소에서 도로 8km를 가볍게 뜁니다.

안개가 나무 사이에 내려앉은 공원. 잎이 진 나무와 적갈색으로 물든 나무가 서 있고, 잔디 위에 낙엽이 깔려 있다.

아침 6시, 안개 낀 공원 순환 코스, 기온 4도. 뒤처진 사람은 한 명도 없었습니다. 목요일에는 같은 코스를 반대 방향으로 돕니다.

List. 한 줄에 게시물 하나, 본문이 사진 옆에 붙습니다. 계정을 직접 읽는 느낌에 가장 가깝고, 글이 대부분인 피드라면 여기서 시작하는 것이 좋습니다.

내 피드로 만들어 보기

실제 렌더러가 아니라 미리보기입니다. 테마 색은 제품이 쓰는 테마 정의에서 그대로 읽어 오고 레이아웃 이름도 실제 이름이지만, 여기 그려진 모양은 이 페이지를 위해 그린 것입니다. 위젯 렌더러는 Deno 엣지 함수로 돌아가서 이 사이트의 Next 앱에서는 불러올 수 없기 때문입니다. 그린 모양이 제대로 보이도록 미리보기 게시물에는 모두 사진을 붙였지만, 실제 X 피드는 대부분 글이고 위젯은 그런 게시물도 전문 그대로 보여줍니다. 실제 디자인 스튜디오에는 레이아웃 40종과 테마 16종, 모든 요금제에서 쓸 수 있는 테마 빌더가 있고, 편집하는 동안 진짜 위젯이 그려집니다. Lampblack Runners는 저희가 만든 가상의 클럽이고 주소도 가상이며, 사진은 CC0 대체 이미지입니다.

카드 한 장에 담기는 것, 항목별로

여기 적은 것은 서버가 위젯에 게시물을 보낼 때 담기는 항목 그대로이고, 그 밖의 정보는 카드에 표시되지 않습니다. 항목이 정해져 있기 때문에 아래 상자에서 카드에 나오지 않는 것도 분명하게 말할 수 있습니다.

게시물 본문, 전문 그대로

다른 곳으로 보내기 위한 미리보기가 아니라 게시물 전체를 카드에 담습니다. 기본으로 다섯 줄 정도를 보여주고 나머지는 “더보기”로 펼치며, 레이아웃에서 보여줄 줄 수를 정하거나 줄 수 제한을 끌 수도 있습니다.

표시 이름과 프로필 사진

X가 돌려주는 계정 이름과 프로필 사진입니다. 프로필 사진 없이 도착한 게시물은 그 자리를 비워 두지 않고 이름의 첫 글자를 대신 그립니다.

이미지는 한 장, 있을 때만

게시물에 첨부된 첫 번째 사진입니다. 글만 있는 게시물은 이미지가 없을 뿐이고, 그것은 오류가 아니라 지극히 평범한 경우입니다.

경과 시간(내림)

위젯에는 “3 hours ago”처럼 게시 후 지난 시간이 표시됩니다. 반올림이 아니라 내림으로 계산하기 때문에, 대시보드와 홈페이지에 삽입한 위젯이 같은 게시물의 경과 시간을 서로 다르게 보여주는 일이 없습니다.

좋아요, 답글, 재게시

세 가지 수치를 보여주고, 플랫폼에 해당 수치가 없으면 그 항목만 따로 숨깁니다. 재게시(리트윗)와 인용 게시물은 따로 집계되어 들어오는데, 이 둘을 더해 하나의 재게시 수로 보여줍니다.

원래 게시물로 가는 링크

모든 게시물은 x.com에 자기 주소를 그대로 갖고 있습니다. 기본 설정에서는 카드를 누르면 게시물 전문과 “Twitter에서 보기” 버튼이 있는 창이 열리고, 원래 게시물로 바로 이동하게 하거나 카드를 누를 수 없게 설정할 수도 있습니다.

카드에 없는 것, 그리고 그 이유

이름 아래에 @핸들이 없습니다. 서버가 위젯에 보내는 항목은 정해져 있고, 계정 핸들은 거기에 들어 있지 않기 때문입니다. 게시물을 알아보는 단서는 이름과 경과 시간, 그리고 원래 게시물로 가는 링크입니다.

팔로워 수나 인증 배지도 없습니다. 보여주는 것은 게시물이 가진 정보이지, 계정의 초상이 아닙니다.

사진은 섬네일이 아니라 폭 전체로

게시물에 첨부된 첫 번째 이미지는 본문 위에 열 폭 전체로 표시됩니다. 글이 대부분인 피드에서 사진은 예외이기 때문에, 배경처럼 묻히지 않고 나타나는 순간 눈길을 끕니다.

붉은 우레탄 트랙에 칠해진 레인 번호를 레인 선을 따라 낮은 각도에서 찍은 사진. 빛은 부드럽고 고르다.
Lampblack Runners5일 전

1레인 도색이 끝났고, 클럽 핸디캡 레이스가 24일에 다시 열립니다. 참가 신청은 화이트보드가 꽉 차면 마감합니다.

128159

Lampblack Runners는 저희가 만든 가상의 러닝 클럽이고 주소도 가상이며, 사진은 CC0 대체 이미지입니다. 열의 폭, 사진을 자르는 방식, 반응 수 표시는 실제 위젯의 것입니다.

요금제로 고르는 것은 X 소스 수, 모든 소스는 12시간마다 갱신

X API는 돌려준 게시물 수만큼 요금이 붙습니다. X가 이 제품에서 유일한 유료 소스인 이유는 그것 하나이고, 같은 사정 때문에 어떤 임베드 서비스든 X 연동은 상위 요금제 기능이 되기 쉽습니다. 알아 둘 숫자는 소스 수와 갱신 간격 두 가지이고, 둘 다 이 페이지에 적혀 있습니다.

Pro 요금제의 첫 가져오기
요청한 게시물 수50
X가 돌려준 게시물 수34
Collect에 들어온 게시물34
이후 12시간마다새 게시물만

숫자는 예시지만 흐름은 실제와 같습니다. 첫 가져오기의 양을 직접 정하면 X는 계정에 실제로 있는 만큼만 돌려주고, 이후의 동기화는 그보다 새로운 게시물만 요청합니다.

모든 유료 요금제에서 12시간마다

X는 API가 돌려준 게시물 수만큼 요금을 받기 때문에, 모든 유료 요금제에서 12시간마다 갱신됩니다. 요금제마다 숫자가 셋인 것이 아니라 하나뿐이고, 저희가 지원하는 다른 어떤 SNS보다 일부러 느리게 두었으며, Pro에서도 Scale에서도 같습니다. 무료 체험 중 X 소스는 하루 한 번 갱신됩니다. 피드에 함께 넣은 다른 플랫폼은 X의 이 간격에 묶이지 않습니다.

새 게시물이 없으면 아무것도 가져오지 않습니다

동기화할 때마다 X에 요청하는 것은 이미 저장된 가장 최신 게시물보다 새로운 것뿐입니다. 조용한 한 주라면 빈 응답이 돌아올 뿐 아무것도 바뀌지 않습니다. 이 기준점은 소스를 지웠다가 다시 추가해도 남아 있습니다. 소스를 지우면 가져온 게시물도 함께 지워지고, 같은 계정이나 해시태그로 다시 추가한 소스는 그 뒤에 올라온 새 게시물부터 가져옵니다. 그러니 연결에 문제가 생긴 계정은 소스를 지우지 말고 같은 X 계정으로 다시 연결하세요.

스크래핑이 아니라 공식 API

모든 게시물은 X가 공개하고 문서화한 API v2를 거쳐 들어옵니다(계정 게시물은 사용자가 승인한 토큰으로, 해시태그는 저희 애플리케이션 인증으로 읽습니다). 이 API는 읽은 만큼 요금을 받기 때문에 소스 수에 상한이 있고, 공식 API이기 때문에 스크래퍼처럼 x.com 페이지 구조가 바뀌지 않기만을 바랄 필요도 없습니다.

Pro: X 소스 1개 · 12시간마다 갱신

소스마다 프로필 타임라인이나 공개 해시태그 검색 중 하나로 정할 수 있습니다. 첫 가져오기는 기본 50개이고 확정하기 전에 바꿀 수 있습니다. 그 뒤로는 새 게시물만 가져옵니다.

Business: X 소스 2개 · 12시간마다 갱신

소스마다 프로필 타임라인이나 공개 해시태그 검색 중 하나로 정할 수 있습니다. 첫 가져오기는 기본 100개이고 확정하기 전에 바꿀 수 있습니다. 그 뒤로는 새 게시물만 가져옵니다.

Scale: X 소스 5개 · 12시간마다 갱신

소스마다 프로필 타임라인이나 공개 해시태그 검색 중 하나로 정할 수 있습니다. 첫 가져오기는 기본 100개이고 확정하기 전에 바꿀 수 있습니다. 그 뒤로는 새 게시물만 가져옵니다.

새 게시물은 자동으로 반영, 유료 요금제에서는 12시간마다

방식은 두 가지입니다. X 소스는 피드의 다른 소스와 별도의 주기로 갱신되고, 그 주기를 기다리지 않고 바로 가져오는 버튼은 유료 기능입니다.

자동 갱신

X 피드는 12시간마다 갱신

자동으로 갱신되지만 요금제의 일반 갱신 주기와는 따로 움직입니다. X는 API가 돌려준 게시물 수만큼 요금을 받기 때문에 모든 유료 요금제에서 12시간마다, 무료 체험 중에는 하루 한 번 갱신됩니다. 그래서 새 게시물이 페이지에 나타나기까지 최대 한 주기가 걸릴 수 있습니다.

모든 유료 요금제 12시간 · 무료 체험 하루 1회

수동 가져오기

“Pull now”를 누르면 기다리지 않고 바로

유료 요금제에서는 정기 동기화 사이에 직접 가져올 수 있습니다. 한 번에 최대 100개, 1시간에 한 번까지입니다. 오늘 아침에 올린 게시물을 다음 주기까지 기다리지 않고 페이지에 올릴 수 있습니다.

1회 100개까지 · 1시간에 1회 · 유료 요금제

X 소스가 다른 SNS보다 느린 이유

요금제에는 기본 갱신 주기가 있고(무료 요금제의 하루 한 번부터 상위 요금제의 몇 분 간격까지), 인스타그램, 페이스북, 틱톡 같은 소스는 그 주기에 맞춰 자동으로 동기화됩니다. X 소스는 그 설정을 그대로 쓰지 않고, 그것과 X 자체의 최소 간격 중 더 느린 쪽으로 움직입니다. 종량제 API에서 주기를 짧게 잡으면, 새 게시물을 싣는 데가 아니라 새 게시물이 있는지 확인하는 데 비용을 쓰게 되기 때문입니다. 이벤트 월은 자동으로 동기화하는 다른 플랫폼을 2분 간격 갱신으로 끌어올리지만, 같은 이유로 X만은 그대로 둡니다.

사진이 없어도 무너지지 않는, 글을 위한 레이아웃

사진용으로 만든 그리드에 글 피드를 넣으면 회색 사각형만 늘어섭니다. 여기 소개하는 세 가지는 글에 맞춰 모양을 잡은 레이아웃입니다. 레이아웃 40종과 테마 16종은 모두 X 피드에 쓸 수 있고, 무료 요금제에는 40종 가운데 7종의 레이아웃과 모든 테마, 테마 빌더가 들어 있습니다.

Lampblack Runners1일 전

화요일 인터벌은 취소합니다. 트랙이 통째로 빙판이라 괜찮은 척하지 않겠습니다. 대신 같은 시간, 같은 장소에서 도로 8km를 가볍게 뜁니다.

Lampblack Runners4일 전

처음이신가요? 화요일이나 목요일 저녁 6시 반에 오시면 됩니다. 가입 신청서도 회비도 없고, 혼자 뛰게 두는 일은 절대 없습니다.

Lampblack Runners3시간 전

오늘 밤 클럽 1500m 기록이 바뀌었습니다. 4분 11초 6, 두 번째 도전에서, 다들 말도 꺼내기 싫어하는 맞바람을 뚫고 세운 기록이에요. 내일 아침 기록판에 새 줄이 하나 생깁니다.

List 무료 요금제

한 줄에 게시물 하나, 전문 그대로, 잘리는 것 없이. 계정을 직접 읽는 느낌에 가장 가깝고, 대부분의 페이지는 여기서 시작하는 것이 좋습니다.

Lampblack Runners3시간 전

오늘 밤 클럽 1500m 기록이 바뀌었습니다. 4분 11초 6, 두 번째 도전에서, 다들 말도 꺼내기 싫어하는 맞바람을 뚫고 세운 기록이에요. 내일 아침 기록판에 새 줄이 하나 생깁니다.

Quote wall

게시물을 하나씩 크게 보여주고 나머지는 그 뒤에서 기다립니다. 페이지의 3분의 1이 아니라 폭 전체를 쓸 만한 한 문장을 위한 레이아웃입니다.

Lampblack Runners6일 전

3월까지는 헤드랜턴의 계절입니다. 반사 용품이 하나뿐이라면 흔드는 쪽 팔에 차세요.

비 오는 밤거리에서 검은 우산을 쓰고 걷는 사람의 뒷모습. 자동차와 가게 불빛이 젖은 도로 위에 길고 알록달록한 반사를 드리운다.
Lampblack Runners4일 전

처음이신가요? 화요일이나 목요일 저녁 6시 반에 오시면 됩니다. 가입 신청서도 회비도 없고, 혼자 뛰게 두는 일은 절대 없습니다.

Social news

이미지가 있는 대표 게시물 아래로 제목들이 이어지므로, 글과 사진이 섞인 한 주도 하나의 열로 읽힙니다.

계정 타임라인도, 해시태그도, 공식 API로

Pro는 X 소스 1개, Business는 2개, Scale은 5개입니다. 소스마다 두 종류 중 하나로 정할 수 있고, 모두 12시간마다 갱신됩니다.

내 계정

프로필 타임라인

계정을 연결하면 위젯이 그 계정이 직접 쓴 게시물을 읽어 옵니다. 가져오는 것은 원본 게시물뿐이고 재게시(리트윗)와 답글은 요청 단계에서 제외하므로, 홈페이지에 올라가는 것은 그 계정이 퍼 나른 글이 아니라 직접 쓴 글입니다.

해시태그

공개 해시태그 검색

계정 대신 해시태그를 지정하면 공개된 최근 검색 엔드포인트를 읽어 옵니다. 계정 연결은 필요 없고, 여기서도 재게시와 답글은 걸러냅니다. 모든 유료 요금제에서 쓸 수 있고 무료 체험 중에도 써 볼 수 있습니다.

스크래핑 없음

공식 API로만 가져옵니다

모든 게시물은 X의 공식 API v2에서 가져옵니다. 계정 게시물은 사용자가 승인한 토큰으로, 해시태그는 저희 애플리케이션 인증으로 읽습니다. 제한을 피하려고 x.com 페이지를 긁어 오지 않기 때문에, 홈페이지의 피드가 스크래퍼가 기대는 x.com 페이지 구조에 좌우되지 않습니다.

홈페이지에 연동하기까지 네 단계, 단계별 화면과 함께

두 번째 단계는 다른 플랫폼에는 없는 단계입니다. 첫 가져오기에서 계정의 지난 게시물을 어디까지 거슬러 올라갈지 직접 정합니다. 그 뒤로는 새 게시물만 가져옵니다.

1단계

계정 연결하기

소스 목록에서 “X / Twitter”를 고르고, X의 화면에서 읽기 권한을 승인합니다. 해시태그 소스는 공개 검색 엔드포인트를 읽기 때문에 연결 자체가 필요 없습니다.

소스 추가
X / Twitter트윗과 해시태그연결

이것을 고르면 X의 로그인 화면으로 넘어가 읽기 권한을 승인합니다. 그 화면은 X가 직접 보여 주는 화면이고, 저희가 비밀번호를 묻는 일은 없습니다.

2단계

가져올 과거 게시물 양 정하기

지난 게시물까지 거슬러 올라가는 것은 첫 가져오기뿐이라, 정해진 개수를 그대로 받는 대신 직접 정합니다. 그 뒤로는 새 게시물만 가져옵니다.

첫 가져오기

첫 가져오기가 어디까지 거슬러 올라갈지 정합니다. 기본값과 상한은 모두 요금제에서 정해지고, 둘 다 확정하기 전에 소스 생성 화면에 표시됩니다.

3단계

공개할 게시물 고르기

가져온 게시물은 Collect 페이지에 모이고, 기본 설정에서는 가져오는 대로 홈페이지에 표시됩니다. 보여주고 싶지 않은 게시물은 하나씩 제외하고, 피드 설정의 사전 승인(Pre-approve posts)을 켜 두면 승인한 게시물만 홈페이지에 나갑니다. 키워드 규칙을 설정하면 규칙에 걸린 게시물은 들어오는 즉시 홈페이지에서 빠집니다. 승인, 제외, 키워드 규칙은 무료 요금제를 포함한 모든 요금제에서 쓸 수 있고, 맨 앞에 고정하는 기능은 유료 요금제와 7일 체험 기간에 쓸 수 있습니다.

Collect

오늘 밤 클럽 1500m 기록이 바뀌었습니다. 4분 11초 6, 두 번째 도전에서, 다들 말도 꺼내기 싫어하는 맞바람을 뚫고 세운 기록이에요. 내일 아침 기록판에 새 줄이 하나 생깁니다.

화요일 인터벌은 취소합니다. 트랙이 통째로 빙판이라 괜찮은 척하지 않겠습니다. 대신 같은 시간, 같은 장소에서 도로 8km를 가볍게 뜁니다.

승인, 맨 앞에 고정(유료 요금제와 체험 기간), 또는 제외. 키워드 규칙에 걸린 게시물은 들어오는 즉시 홈페이지에서 빠집니다.

4단계

코드 하나 붙여넣기

삽입 화면에서 설치할 곳을 고르면 그 환경에 맞는 코드가 나옵니다. 빌더별 자세한 순서는 설치 가이드에 정리해 두었습니다.

임베드 코드
<!-- CollectSocials -->
<div id="cs-feed"></div>
<script src=".../widget.js"
  data-feed-id="..."
  data-container="cs-feed"
  defer></script>

줄여서 보여준 것입니다. 실제 코드에는 진짜 속성 이름이 쓰이고 ID는 자동으로 채워집니다. 스크립트를 제한하는 빌더에는 iframe 방식, 스크립트를 전혀 실행할 수 없는 곳에는 주소 방식의 코드가 나갑니다.

워드프레스, 쇼피파이, 윅스, 스퀘어스페이스, 웹플로우에서 코드를 어디에 붙여넣는지는 설치 가이드의 플랫폼별 임베드 방법에 정리해 두었습니다. 이 페이지는 판단의 근거이고, 가이드는 따라 하는 순서입니다.

워드프레스, 윅스, 노션까지 어떤 홈페이지에나 삽입하는 코드

스크립트 태그가 어디서나 그대로 붙는 것은 아닙니다. 어떤 빌더는 외부 코드를 샌드박스에 가두고, 어떤 빌더는 아예 지워 버립니다. 그래서 삽입 화면이 먼저 어디에 설치할지 묻고, 그 환경에 맞는 코드를 내줍니다.

스크립트 삽입

HTML, 워드프레스, 웹플로우, React

스크립트 태그 하나와 컨테이너 div 하나입니다. 위젯은 Shadow DOM 안에서 그려지므로 위젯 CSS와 홈페이지 CSS가 서로 간섭하지 않습니다.

래퍼로 감싼 스크립트

쇼피파이

같은 스크립트를 페이지 폭 래퍼로 감싼 코드입니다. 쇼피파이 테마는 섹션을 flexbox로 배치하기 때문에, 그대로 두면 컨테이너가 눌려 버립니다.

iframe 삽입

윅스(Wix), 스퀘어스페이스

두 곳 모두 외부 스크립트를 샌드박스에 가두거나 지워 버리기 때문에 iframe 방식의 코드를 내줍니다. 코드 안의 작은 스크립트가 실행되는 곳에서는 iframe 높이가 콘텐츠에 맞춰 조정됩니다.

주소만 붙여넣기

노션, 구글 사이트 도구

스크립트를 전혀 실행할 수 없는 도구에는 고정 높이 프레임의 주소를 내줍니다. 내용은 프레임 안에서 스크롤됩니다.

노션, 윅스, 국내 빌더에서 쓸 때

노션에서는 페이지에 “/embed”를 입력해 임베드 블록을 만들고, 삽입 화면에서 노션을 골랐을 때 나오는 주소를 붙여넣습니다. 높이는 블록 아래쪽 가장자리를 끌거나 주소 안의 “h=600” 값을 바꿔서 조정합니다.

윅스에서는 편집기의 추가 메뉴에서 HTML 임베드 요소를 놓고, 발급된 iframe 방식 코드를 붙여넣은 뒤 게시합니다. 코드 안의 작은 스크립트가 실행되면 높이가 콘텐츠에 맞춰 조정되고, 스크립트가 막힌 곳에서는 정해진 높이의 창 안에서 스크롤됩니다.

카페24나 아임웹에서도 HTML 블록(코드 삽입 기능)을 쓸 수 있다면, 삽입 화면에서 “Plain HTML”을 골랐을 때 나오는 코드를 붙여넣어 시험해 볼 수 있습니다. 위 네 가지 중 첫 번째와 같은 코드입니다. 빌더에 따라서는 편집 화면에서 스크립트가 돌지 않고 게시한 페이지에서 비로소 표시되기도 합니다(스퀘어스페이스와 웹플로우가 그런 예입니다). 표시 확인은 게시한 페이지에서 하시기 바랍니다.

워드프레스라면 전용 플러그인(영어)을 쓰면 코드를 붙여넣을 필요조차 없습니다.

X 게시물은 다른 SNS와 나란히 있을 때 더 잘 읽힙니다

피드 하나에 10개 플랫폼을 섞을 수 있어서, X 게시물을 인스타그램 사진, 페이스북 게시물, 구글 리뷰와 같은 영역에 놓을 수 있습니다. X 외의 플랫폼은 무료 요금제에서도 연결할 수 있지만, 무료 요금제의 소스는 1개이므로 여러 플랫폼을 한 벽에 담으려면 7일 체험이나 유료 요금제가 필요합니다.

박지연2주 전Google

사진만 보고 일출 코스를 예약했는데 사진보다 나았습니다. 가이드분들이 어디서 언제 멈춰야 하는지 정확히 알고 계셨어요.

바다 위 폭풍 구름 아래로 햇빛이 새어 나오는 가운데, 검은 화산 능선 위에 서 있는 사람.YouTube

능선 종주 3일, 처음부터 끝까지

맑고 파란 하늘을 향해 크게 날아오른 색칠된 회전그네 탑승객들을 아래에서 올려다본 모습.TikTok

그네가 물 위까지 쭉 날아갑니다

Atlas & Pine@atlasandpine · 3일 전Twitter/X

일출 팀이 폭풍 오기 전에 능선까지 올라갔습니다. 사진은 전부 홈페이지에 올려 뒀어요.

Atlas & Pine5주 전Facebook

석호에서 하루. 배 여섯 척 나갔고 아무도 안 뒤집혔고, 물빛이 오후 내내 저 색 그대로였습니다.

석회암 절벽 사이의 청록색 석호를 빨간색과 노란색 카약을 타고 지나가는 사람들.
김태훈한 달 전Google

올해만 두 번째입니다. 일정이 전부 제시간에 돌아갔고, 인원을 적게 받는 게 이 팀의 핵심이라고 봅니다.

선명한 노란 벽 앞에서 춤추는 사람. 머리카락이 얼굴 위로 흩날린다.Instagram

노란 벽을 찾았습니다. 당연히 그 앞에서 춤췄죠.

넓게 퍼지는 햇살을 등지고 모래언덕 능선에 선 두 사람의 실루엣. 아래 모래에는 바람 자국이 물결처럼 나 있다.Instagram

해가 뜨기 직전에 능선에 올랐습니다.

새벽녘 옅은 색 바위 지형 위를 떠가는 열기구들.Instagram

기구가 뜨기 전에 먼저 올라와 있었습니다.

Atlas & Pine7주 전Facebook

축제 마지막 날, 풍선을 한꺼번에 전부 날려 보냈습니다. 10초쯤은 아무도 말이 없었어요.

맑고 파란 하늘로 한꺼번에 떠오르는 수백 개의 색색 풍선.

가상의 브랜드로 만든 데모 피드이며, 연결할 수 있는 소스 10종 가운데 인스타그램, 구글 리뷰, 유튜브, X, 틱톡, 페이스북을 한 벽에 담았습니다. 게시물과 리뷰 작성자, 반응 수치는 예시일 뿐 제품 지표가 아닙니다. 카드에 있는 항목은 전부 실제 위젯이 그리는 것이지만, 이 벽 자체는 위젯이 그린 것이 아니라 이 페이지를 위해 따로 그린 것입니다.

요금이 드는 소스는 X 하나, 그 이유

읽을 때마다 저희에게 요금을 청구하는 플랫폼은 X뿐이라, 유료 요금제에서만 쓸 수 있는 플랫폼도 X뿐입니다. 결제하는 대상은 운영할 수 있는 X 소스 수와 각 소스의 갱신 빈도입니다.

무료(7일 체험 포함)
  • X / Twitter: 7일 무료 체험
  • 체험 중 X 소스 최대 3개, 하루 1회 갱신, 카드 등록 없음
  • 레이아웃 40종 중 7종, 테마 16종 전부
  • 승인과 제외, 키워드 규칙으로 걸러내기

체험이 끝나면 X는 유료 소스가 되고, X 외의 플랫폼은 계속 무료로 쓸 수 있습니다. 무료 요금제에서 연결할 수 있는 소스는 1개입니다. 무료 요금제 위젯에는 작은 CollectSocials 표기 링크가 붙습니다.

유료, 월 $29부터
  • Pro: X 소스 1개 · 12시간마다 갱신
  • Business: X 소스 2개 · 12시간마다 갱신
  • Scale: X 소스 5개 · 12시간마다 갱신
  • “Pull now”로 수동 가져오기, 1회 최대 100개(1시간에 1회)

레이아웃 40종 전부, 해시태그 소스, 게시물을 맨 앞에 고정하는 기능, 표기 링크 제거. 연간 결제는 두 달이 무료라 Pro는 연 $290, Business는 $590, Scale은 $1,190입니다. 전체 요금제 보기(영어)

X(트위터) 피드 위젯, 자주 묻는 질문

X(트위터) 타임라인 임베드가 안 보이는 이유는 무엇인가요?

가장 먼저 확인할 것은 공식 도구(publish.x.com)의 타임라인 임베드 자체가, 2026년 8월 검증 당시 피드가 아니라 “Posts by (계정 이름)”이라는 텍스트 링크만 생성했다는 점입니다. 이 경우에는 코드를 다시 붙여넣어도 해결되지 않습니다. 그 밖에도 옛 twitter.com 주소가 남은 코드, X 공식 임베드 스크립트(widgets.js)의 로드 실패, 로그인하지 않은 방문자에 대한 표시 제한, 비공개 계정 전환, 편집 화면에서만 생기는 제한 같은 원인이 있고, 원인을 가려내는 방법은 설치 가이드에서 화면과 함께 설명합니다. 이 위젯은 X의 임베드 스크립트를 쓰지 않고 이미 가져온 게시물을 저희 쪽에서 내보내기 때문에, 방문자가 X에 로그인했는지와 상관없이 표시됩니다.

X 피드 위젯(트위터 위젯)이란 무엇인가요?

X 게시물을 내 홈페이지(웹사이트)의 한 영역에 모아 보여주는 삽입형 위젯입니다. 한 번 붙여넣으면 알아서 갱신됩니다. X 공식 임베드 도구로 확실하게 표시되는 것은 게시물 하나뿐이어서, 계정 타임라인이나 해시태그를 모아 보여주려면 피드 위젯이 필요합니다.

X(트위터) 피드 위젯은 무료로 쓸 수 있나요?

아니요. 이 제품에서 무료 요금제에 들어 있지 않은 소스는 X 하나뿐입니다. X는 API가 돌려준 게시물 수만큼 저희에게 요금을 청구하기 때문에, X 피드는 갱신할 때마다 비용이 들고 그 비용을 요금제가 감당해야 합니다. X를 뺀 나머지 플랫폼은 모두 무료 요금제에서 연결할 수 있습니다(무료 요금제에서 연결할 수 있는 소스는 1개입니다). 새 계정은 7일 체험 기간 동안 카드 등록 없이 X를 쓸 수 있고, 체험 중 X 소스는 최대 3개까지, 하루 한 번 갱신됩니다. 유료 요금제는 월 $29부터이고, 연간 결제는 두 달이 무료라 연 $290입니다. 자세한 내용은 요금제 페이지(영어)에 있습니다.

위젯에 X 게시물을 몇 개까지 보여줄 수 있나요?

남겨 둔 X 게시물은 피드에서 사라지지 않고 계속 표시됩니다. 게시물을 페이지가 열릴 때마다 가져오는 것이 아니라 저희 쪽에 저장해 두기 때문입니다. 한도라고 할 만한 것은 요금제 전체의 저장 게시물 수뿐이고, 이것은 X만의 숫자가 아니라 모든 플랫폼이 함께 쓰는 한도입니다. 요금제가 X에 대해 정하는 것은 연결할 수 있는 소스 수와 갱신 주기입니다. Pro는 1개, Business는 2개, Scale은 5개이고, 모든 소스가 12시간마다 갱신됩니다.

홈페이지에 삽입한 X 타임라인은 새 게시물로 자동 갱신되나요?

네, 자동으로 갱신됩니다. 다른 플랫폼은 대부분 요금제의 갱신 주기에 맞춰 동기화되지만, X 소스에는 따로 정한 최소 간격이 있습니다. X는 API가 돌려준 게시물 수만큼 요금을 받기 때문에 모든 유료 요금제에서 12시간마다 갱신됩니다. 7일 체험 기간에는 X 소스가 하루 한 번 갱신됩니다. 유료 요금제에서는 “Pull now”를 눌러 바로 가져올 수도 있습니다(1시간에 한 번).

X(트위터) 개발자 계정이나 API 키가 필요한가요?

필요 없습니다. API 접근 권한은 저희가 갖고 있고, X 로그인 화면에서 내 계정의 읽기 권한을 승인하기만 하면 됩니다. 요청하는 권한은 게시물 읽기, 프로필 읽기, 그리고 몇 시간마다 다시 연결하지 않아도 피드가 계속 갱신되도록 로그인 상태를 유지하는 것, 이렇게 세 가지뿐입니다. 게시, 팔로우, 메시지 전송, 삭제는 어느 것도 할 수 없습니다.

리트윗이나 답글도 표시되나요?

표시되지 않습니다. 프로필 소스는 X에 원본 게시물만 요청하기 때문에 리트윗(재게시)과 답글은 처음부터 들어오지 않습니다. 해시태그 소스도 같은 방식으로 걸러냅니다. 답글 스레드를 홈페이지에서 보여주고 싶다면, 원래 게시물을 공개해 두고 읽는 사람이 카드에서 X를 열어 대화를 이어 읽게 하는 편이 확실합니다.

내 계정 대신 해시태그 피드를 홈페이지에 삽입할 수 있나요?

가능합니다. 모든 유료 요금제에서 쓸 수 있고, 체험 기간에도 써 볼 수 있습니다. 해시태그 소스는 저희 애플리케이션 인증으로 공개 최근 검색 엔드포인트를 읽기 때문에 계정 연결이 필요 없습니다. 한 가지 알아 둘 점은 이 엔드포인트에는 한 번에 10개보다 적은 게시물을 요청할 수 없다는 것입니다. 그래서 해시태그 소스는 한 번에 적어도 10개씩 요청합니다. 설정 방법은 설치 가이드에서 설명합니다.

X가 API를 바꾸면 임베드한 피드는 어떻게 되나요?

X는 API를 버전별로 관리하고 문서로 공개하며, 피드의 게시물은 모두 그 API를 거쳐 들어온 것입니다. 그래서 스크래핑으로 만든 피드처럼 x.com 페이지 구조에 의존하지 않습니다. 이미 가져온 게시물은 저희 쪽에 저장되어 소스 연결이 끊긴 동안에도 계속 표시되므로, 계정을 다시 연결하는 사이에 홈페이지의 그 영역이 비는 일은 없습니다.

홈페이지에 보여줄 게시물을 고를 수 있나요?

네, 모든 요금제에서 고를 수 있습니다. 가져온 게시물은 Collect 페이지에 모이고, 거기서 하나씩 승인하거나 제외할 수 있습니다. 키워드 규칙을 설정하면 규칙에 걸린 게시물은 들어오는 즉시 홈페이지에서 빠집니다. 기본 설정에서는 새 게시물이 가져오는 대로 홈페이지에 표시되고, 피드 설정에서 사전 승인(Pre-approve posts)을 켜 두면 새 게시물은 승인하기 전까지 홈페이지에 나가지 않습니다. 이 기능은 X에서 특히 중요합니다. 타임라인에서는 자연스럽게 읽히는 게시물도 홈페이지의 고정된 영역에 놓이면 어색하게 보일 수 있기 때문입니다. 승인, 제외, 키워드 규칙은 무료 요금제를 포함한 모든 요금제에서 쓸 수 있고, 고른 게시물을 맨 앞에 고정하는 기능은 유료 요금제와 7일 체험 기간에 쓸 수 있습니다. 테마 16종과 테마 빌더도 모두 무료 요금제에 들어 있습니다.

X(트위터) 타임라인을 홈페이지나 웹사이트에 삽입하는 HTML 코드는 어디서 받나요?

디자인 스튜디오 오른쪽 위의 “Get Code”를 누르면 열리는 삽입 화면에서, 설치할 곳으로 “Plain HTML”을 고르면 발급됩니다. 스크립트 태그 하나와 컨테이너 div 하나로 되어 있고, 피드 ID 같은 값은 미리 채워져 있습니다. 홈페이지 HTML에서 피드를 보여줄 자리에 붙여넣고 저장한 뒤 게시하면 됩니다. 서비스별로 붙여넣는 위치는 설치 가이드에 정리해 두었습니다.

워드프레스나 윅스(Wix)에도 트위터 타임라인을 넣을 수 있나요?

넣을 수 있습니다. 워드프레스, 쇼피파이, 윅스, 스퀘어스페이스, 웹플로우, 노션, 구글 사이트 도구, 일반 HTML, React를 지원합니다. 외부 스크립트를 샌드박스에 가두는 빌더도 있고 아예 지우는 빌더도 있어서, 삽입 화면에서 설치할 곳을 고르면 그 환경에 맞는 코드를 내줍니다. 윅스에는 iframe 방식의 코드가 나가고, 워드프레스는 워드프레스 플러그인(영어)을 쓰면 코드를 붙여넣을 필요도 없습니다.

카페24나 아임웹 홈페이지에도 X 피드를 연동할 수 있나요?

카페24나 아임웹에서도 HTML 블록(코드 삽입 기능)을 쓸 수 있다면, 삽입 화면에서 “Plain HTML”을 골랐을 때 나오는 코드를 붙여넣어 시험해 볼 수 있습니다. 두 빌더만을 위한 별도 코드가 있는 것은 아니고, 일반 HTML 사이트에 쓰는 것과 같은 코드입니다. 빌더에 따라서는 편집 화면에서 스크립트가 돌지 않고 게시한 페이지에서 비로소 표시되기도 하니, 표시 확인은 게시한 페이지에서 하시기 바랍니다.

블로그 글에 트윗 하나만 넣을 때도 이 위젯이 필요한가요?

필요하지 않습니다. 글 안에서 트윗 하나를 인용하는 정도라면 X 공식 도구의 단일 게시물 임베드로 충분하고, 저희 검증에서도 정상적으로 표시됐습니다. 계정 타임라인이나 해시태그 게시물을 한데 모아 자동으로 갱신되게 보여주고 싶다면 이 위젯이 필요합니다. 스크립트가 들어간 HTML을 붙여넣을 수 있는 블로그라면 “Plain HTML” 코드를 그대로 쓸 수 있고, 워드프레스 블로그는 사용자 정의 HTML 블록에 붙여넣거나 플러그인을 쓰면 됩니다.

트위터인가요, X인가요?

두 이름 모두 쓰이고, 이 제품에서는 어느 쪽으로 불러도 통합니다. 대시보드의 소스 이름은 “X / Twitter”이고, 게시물 링크는 x.com으로 연결되며, 카드의 마크는 X 로고이고, 원래 게시물을 여는 버튼에는 지금도 “Twitter에서 보기”라고 적혀 있습니다. 임베드와 관련해 실제로 바뀐 것은 로고만이 아니며, 그 부분은 설치 가이드에서 다룹니다.

X 게시물을 다른 SNS와 함께 보여줄 수 있나요?

가능합니다. 피드 하나에 10개 플랫폼을 섞을 수 있어서, X 게시물을 인스타그램 사진, 페이스북 게시물, 구글 리뷰와 같은 영역에 나란히 놓을 수 있습니다. 위젯 네 개를 쌓아 올리는 것이 아니라 하나의 벽으로 디자인됩니다. 대부분의 사이트가 원하는 것도 바로 그것입니다. 사진은 어떤 곳인지를 보여주고, 게시물은 무슨 일이 있었는지를 알려 줍니다. 다만 플랫폼마다 소스가 하나 이상 필요하므로, 한 벽에 섞을 수 있는 플랫폼 수는 요금제의 소스 수를 넘지 않습니다. 소스는 무료 요금제 1개(7일 체험 중에는 3개), Pro 5개, Business 15개, Scale 30개이고, X 소스도 이 수에 포함됩니다.

X 타임라인을 오늘 저녁 홈페이지에 올려 보세요

X를 연결하고, 공개할 게시물을 고르고, 레이아웃을 정한 다음 코드 하나를 붙여넣으면 됩니다. 7일 체험에서는 X도 쓸 수 있고 카드 등록은 필요 없습니다.

워드프레스, 쇼피파이, 윅스, 스퀘어스페이스, 웹플로우, 노션, 구글 사이트 도구, React, 일반 HTML에서 사용할 수 있습니다.