EmDash to Buffer Plus
비공식, Buffer와 무관: 새 항목을 각 네트워크에 맞춰 Buffer로 공유하며, 전송 추적과 보고서를 제공합니다.
플러그인
EmDash to Buffer Plus
비공식, Buffer와 무관: 새 항목을 각 네트워크에 맞춰 Buffer로 공유하며, 전송 추적과 보고서를 제공합니다.
설명
비공식 플러그인입니다. Buffer와 제휴 관계가 없으며 Buffer의 승인이나 지원을 받지 않습니다.
새 항목을 각 네트워크에 맞게 조정해 Buffer 채널로 공유합니다. 전송 추적, 참여도 대시보드, 편집기 패널, MCP 도구를 제공합니다.
- Buffer API가 게시할 수 있는 모든 네트워크. 텍스트는 각 네트워크의 글자 수 제한에 맞게 조정되며 줄어드는 것은 설명뿐입니다. Buffer가 지원하는 경우 각 게시물에는 항목의 이미지나 링크 카드가 붙습니다.
- 추적되는 전송. 각 게시물은 사이트에서 실제 게시물까지 추적됩니다. 실패한 게시물에는 Buffer가 알려 준 이유가 표시되고 다시 시도할 수 있으며, 응답이 불확실하면 다시 보내기 전에 Buffer에서 먼저 확인하므로 중복 게시가 일어나지 않습니다.
- 보고서. 7일, 30일, 90일 동안의 전송됨, 대기 중, 실패한 게시물, 노출 수와 참여도, 인기 항목, 채널별 표를 사용자의 시간대 기준 날짜로 집계합니다. 없는 수치는 없다고 표시되며 0으로 표시되지 않습니다.
- 편집기 패널. 항목을 처음 보내기 전에 특정 채널을 제외하거나 해당 채널용 사용자 지정 텍스트를 작성할 수 있습니다. 보낸 뒤에는 각 채널의 상태와 실제 게시물 링크를 볼 수 있습니다.
- MCP 도구. 저장된 데이터를 바탕으로 답하는 읽기 전용 도구 4개.
플러그인을 설치한 뒤에 처음 게시된 항목만 공유되며, 다시 게시해도 다시 보내지 않습니다.
플러그인은 사용자의 개인 API 키로 Buffer API를 사용합니다.
설치
필요한 것: 샌드박스 러너가 있는 EmDash 1.1.0 이상, 채널이 연결된 Buffer 계정, Buffer 계정의 API 한도에 여유가 있을 것(모든 키와 연결된 어시스턴트가 함께 사용합니다. 무료 요금제는 하루 250회, 30일간 3,000회 요청이며, 채널이 10개이면 플러그인은 하루 약 40~50회를 사용합니다), 그리고 API 키를 암호화해 저장할 수 있도록 사이트에 설정한 EMDASH_ENCRYPTION_KEY(npx emdash secrets generate로 만들 수 있음).
- 레지스트리에서 플러그인을 설치하고 권한을 검토합니다. 콘텐츠 읽기, 스키마 읽기, 미디어 읽기, 그리고
api.buffer.com으로만 가는 네트워크 요청입니다. - Buffer에서 Settings > API(
https://publish.buffer.com/settings/api)를 열고 개인 API 키를 만듭니다. - EmDash에서 Plugins를 열고 이 플러그인의 설정에서 Buffer API key에 키를 붙여 넣습니다. Time zone을 IANA 시간대로 설정합니다(기본값 Australia/Sydney). 보고서는 해당 시간대의 날짜를 기준으로 각 게시물을 집계합니다. 저장합니다.
- Plugins > Buffer Plus를 열고 Setup을 선택합니다.
- Discover channels를 선택합니다.
- 게시하려는 각 채널을 켜고, 게시 시점(대기열, 다음에 공유, 지금 공유, Buffer 초안)과 첨부할 항목(이미지, 링크 카드, 없음)을 선택합니다. Pinterest는 보드도 필요합니다.
- Collections에서 공유할 컬렉션을 체크하고, 각 컬렉션이 이미지를 어디에서 가져올지 선택합니다.
- 항목을 게시합니다. 즉시 Buffer로 전송되며, 켜져 있는 채널이 많으면 1~2분 안에 전송됩니다.
각 컬렉션에는 항목에 공개 링크가 생기도록 URL Pattern(Content Types 아래)이 필요합니다. Cloudflare Workers에서는 동기화에 EmDash 배포 가이드의 Cron 트리거가 필요합니다.
MCP 도구를 사용하려면 Plugins에서 플러그인의 Agent 접근을 켜세요. 도구나 권한이 추가된 업데이트 후에는 다시 켜야 합니다.
자주 묻는 질문
기존 게시물도 공유하나요? 아니요. 관리자는 항목의 편집기 패널에서 Share now로 이전 항목을 수동으로 공유할 수 있습니다. 다시 게시해도 항목을 다시 보내지 않습니다.
채널이 건너뛰어진 이유는 무엇인가요? 편집기 패널과 Buffer Plus 페이지에 이유가 표시됩니다. 해당 네트워크가 항목에 없는 이미지를 요구하는 경우, Instagram이 이미지의 비율을 받아들일 수 없는 경우, 채널의 연결이 끊어졌거나 잠긴 경우, Pinterest 보드를 선택하지 않은 경우, 설명을 빼도 텍스트가 너무 긴 경우, 또는 Buffer의 API로는 그곳에 게시할 수 없는 경우(YouTube, WhatsApp, Start Page)입니다.
게시물 텍스트에서 어떤 태그를 쓸 수 있나요? , (항목의 Description 또는 SEO description, 로도 표기) 및 .
수치가 “None yet”으로 표시되는 이유는 무엇인가요? Buffer는 하루에 한 번 정도 수치를 보고하며, 네트워크가 제공하는 것만 보고합니다. 없다는 것이 0은 아닙니다.
노출 수에 다른 곳에서 올린 게시물도 포함되나요? 네. 공유한 채널의 모든 게시물을 포함하며, 네트워크에서 직접 올린 게시물과 이 플러그인을 포함해 Buffer를 통해 올린 게시물로 나뉩니다. 전송됨, 대기 중, 실패는 이 플러그인의 게시물만 집계합니다.
왜 31일치 수치만 있나요? Buffer는 요금제에 따라 수치를 거슬러 올라갈 수 있는 기간을 제한합니다. 무료 요금제는 31일입니다(Buffer 자체의 답변이며 문서에는 없습니다). 플러그인은 Buffer로부터 한도를 알아내 요금제가 허용하는 범위를 보여 줍니다.
게시물이 두 번 나갈 수 있나요? 아니요. 응답이 불확실했던 경우 다시 보내기 전에 Buffer에서 해당 게시물을 찾아봅니다.
Buffer에 몇 번이나 요청하나요? 채널 10개 기준으로 하루 약 40~50회이며, 다른 키와 어시스턴트가 함께 쓰는 Buffer의 계정별 한도에서 차감됩니다(무료 요금제: 하루 250회, 30일간 3,000회). 남은 양이 “Leave for other tools” 아래로 내려가면 보고서가 일시 중지됩니다.
Buffer의 한도에 도달하면 어떻게 되나요? 게시물은 사라지지 않습니다. 대기하다가 한도가 다시 채워지면 자동으로 나갑니다. Buffer에는 채널별로 별도의 게시 한도가 있어 게시물이 거부될 수 있으며, 이 경우 Retry the next day를 선택하세요.
모든 네트워크에서 작동하나요? Buffer가 문서화한 규칙을 따르지만 모든 네트워크에서 실제로 시험해 보지는 않았습니다. 발견한 내용이 있으면 알려 주세요.
보안
보안 문제는 저장소의 보안 권고 양식을 통해 비공개로 신고해 주세요: https://github.com/shanelord01/emdash-to-buffer-plus/security/advisories/new
플러그인이 할 수 있는 일
- 게시된 항목의 링크와 이미지를 찾기 위해 콘텐츠, 스키마, 미디어를 읽습니다. 콘텐츠를 변경하지 않습니다.
api.buffer.com으로만 요청을 보냅니다. 각 게시물의 텍스트, 링크, 이미지 주소, 대체 텍스트를 Buffer로 보냅니다.
Buffer 키를 다루는 방식
- 키는 암호화된 설정으로 저장됩니다(
EMDASH_ENCRYPTION_KEY를 사용한 AES-GCM). 이 키가 없으면 EmDash는 평문으로 저장하는 대신 저장을 거부합니다. - 키는 저장 후 관리자 화면에 표시되지 않으며 로그에도 기록되지 않습니다.
- Buffer 키는 Buffer 계정 전체를 대신해 작동합니다. 유출되었다고 생각되면 Buffer의 Settings > API에서 새 키를 만들어 플러그인 설정에 붙여 넣으세요.
이미지
이미지는 Buffer가 직접 가져옵니다. 플러그인은 이미지 주소가 https이면서 사이트 자체 호스트에 있는 경우, 또는 외부 미디어 제공업체의 절대 https 주소인 경우에만 주소를 전달합니다. IP 주소, localhost, 사설 이름은 거부됩니다.
누가 무엇을 할 수 있나
Buffer Plus 페이지, 대시보드 카드, 편집기 패널, MCP 도구를 보려면 편집자 역할이 필요합니다. 채널 찾기, 설정 저장, Retry, Send again에는 관리자 역할이 필요합니다.
변경 내역
0.1.6, 2026년 10월 9일
- Instagram은 4:5(세로)부터 1.91:1(가로)까지만 받아들이며 Buffer는 이미지를 자를 수 없습니다. 이 범위를 벗어나는 것으로 알려진 이미지는 이제 Buffer에서 실패하는 대신 이유와 함께 처음부터 Instagram을 건너뜁니다. 다른 네트워크는 영향을 받지 않으며, 크기를 알 수 없는 이미지는 이전처럼 전송됩니다.
- 편집기 패널이 처음 공유하기 전에 경고합니다. 비율이 다른 이미지를 게시한 뒤에는 Send again이 다시 확인하고 전송합니다.
- Send again은 Buffer가 게시물 처리를 마친 뒤에만 표시되며, 대기열에 있는 동안에는 표시되지 않습니다.
- 차트에 각 선과 색상 이름이 표시되며 모든 선이 서로 다르게 보입니다. 채널마다 색상이 있고, Direct는 실선, Buffer는 파선, Not split은 점선입니다. 이전에는 분리되지 않은 채널 4개가 분홍색과 주황색을 두 번씩 그렸습니다.
- 참여율은 소수점 한 자리로 표시되며, Setup 보기의 날짜가 관리자 화면의 나머지 부분과 일치합니다.
- 새로운 권한, 설정, MCP 도구 변경은 없습니다.
0.1.5, 2026년 10월 9일
- 이제 날짜가 사용자의 현지 날짜입니다. 0.1.4는 각 게시물을 UTC 날짜로 집계했기 때문에 시드니에서는 오전 10~11시 이전의 게시물이 하루 일찍 표시되었고, 범위도 UTC 자정에 바뀌었습니다. 새 설정 Time zone(기본값 Australia/Sydney)이 차트, 범위, 시각의 시간대를 정합니다.
- 업데이트 후 첫 동기화에서 UTC 날짜별로 저장된 일별 수치를 버리고, 요금제가 허용하는 시점까지(무료 요금제는 31일) Buffer에서 다시 읽어 옵니다. 그때까지는 수치 차트가 비어 있습니다.
- 레지스트리 목록에 배너를 추가했습니다.
- 새 권한은 없습니다. MCP 도구가 이제 날짜를 사용자의 시간대 기준으로 설명하므로, 업데이트 후 EmDash가 Agent 접근을 꺼 둡니다. Plugins에서 다시 켜세요.
전체 기록: CHANGELOG.md.