원문 GeekNews — CogSend · 저장소 deepakness/cogsend (MIT, 2026-09-22 생성, 수집 시점 Stars 175) · 문서 cogsend.com/docs

한 줄 요약

Buffer 같은 호스팅형 예약 발행 서비스를 자기 Cloudflare 계정 안의 Worker 하나로 대체한다. 글·토큰은 내 D1과 R2에 남고, 발행은 내 API 자격 증명으로 나가며, 구독료가 없다. 1인 관리자 인스턴스는 보통 Cloudflare 무료 플랜 안에서 돈다.

무엇을 하나

  • 대상 플랫폼: Mastodon, Bluesky, LinkedIn, Threads, X. Mastodon·Bluesky는 바로 연결된다. LinkedIn·Threads·X는 직접 OAuth 앱을 등록하거나 후원사 Zernio를 거쳐 연결한다.
  • 작성기: 공통 초안 하나에 플랫폼별 탭을 두어 X용·LinkedIn용 문구를 따로 쓴다. 긴 글을 붙여 넣으면 선택한 플랫폼들의 글자 수 제한에 맞춰 스레드로 자동 분할한다. 게시물당 이미지 4장과 대체 텍스트, 링크 미리보기를 지원한다.
  • 발행·관리: 즉시 게시 또는 예약. 초안·예약·완료·실패를 한곳에서 보고, 계정별 결과 확인, 예약 변경·취소·재시도가 된다. 일시적 오류는 간격을 늘리며 자동 재시도하고, 최대 5회 시도한 뒤 실패로 남긴다.
  • 통계: 최근 7·30·90일의 성공·실패 건수와 실패 원인.
  • 보안: 플랫폼 자격 증명은 AES-256-GCM으로 암호화하고, 관리자 로그인에 인증 앱 2단계 인증을 건다.
  • 스택: SvelteKit 2·Svelte 5, Cloudflare Workers(Static Assets), D1(SQLite, Drizzle), R2(미디어).

에이전트 연동 (API·MCP)

개인 API 키는 읽기 전용과 읽기+쓰기 두 등급이다. 인스턴스의 /api/mcp가 상태 없는 Streamable HTTP MCP 서버라서 Claude Code나 Codex에 .mcp.json 한 줄로 붙는다. 인증은 Authorization: Bearer 개인 키만 받는다.

키 등급노출 도구
읽기 전용list_connections, list_drafts, get_draft, list_queue, validate_post
읽기+쓰기create_draft, update_draft, duplicate_draft, delete_draft, set_draft_variant, delete_draft_variant, schedule_draft, reschedule_delivery, cancel_delivery, publish_draft, retry_delivery

미디어·설정·통계·계정 관리는 MCP로 노출하지 않는다. 문서는 publish_draft·retry_delivery가 실제 계정에 글을 올리므로 클라이언트 쪽에서 실행 전 확인을 켜라고 권한다. CogSend가 쓰기 도구에 표시를 달지만 멈춰 묻는 것은 클라이언트만 할 수 있다는 이유다. 에이전트에 초안 작성·예약까지만 맡기려면 읽기+쓰기 키를 주되 발행 도구만 승인 대상으로 두는 식이 된다.

무료 플랜에서의 실제 제약

GeekNews 요약은 “보통 무료 플랜 범위”와 R2 결제 수단 정도만 짚는다. 문서에는 운영에 영향을 주는 조건이 더 있다.

  • R2는 결제 수단 등록이 필요하다. 무료 한도를 넘거나 X API를 쓰면 비용이 생길 수 있다.
  • 크론 트리거는 계정당 5개이고 계정의 모든 Worker가 나눠 쓴다. 남은 슬롯이 없으면 배포는 트리거 없이 진행되고, 예약 글은 외부 호출(cron-job.org, UptimeRobot, 동봉된 GitHub Actions 워크플로 등)이 /api/internal/tick을 POST할 때까지 대기한다.
  • 틱 한 번에 쓸 수 있는 Cloudflare 호출 예산이 50(무료 플랜 subrequest 한도)이다. 틱은 가장 오래된 예약 글 하나는 항상 보내고, 나머지는 예상 호출 수가 예산에 들어갈 때만 시작한다. 그래서 무료 플랜에서는 밀린 글이 분당 한두 건씩 빠진다. 유료 플랜에서 SUBREQUEST_LIMIT를 올리면 한 번에 다 보낸다.

이 보수적인 설계는 이중 게시를 막으려는 것이다. 플랫폼이 이미 받아들인 글을 처리하던 도중 요청 예산이 바닥나면 같은 글이 두 번 나갈 수 있기 때문이다.

이중 게시 방지

재시도 안전성은 플랫폼마다 다르게 처리된다.

  • Mastodon·Bluesky: 재시도한 세그먼트가 첫 시도와 같은 플랫폼 측 ID를 쓴다. 스레드가 중간에 실패해도 이미 올라간 부분이 다시 올라가지 않는다(Mastodon은 1시간 동안 ID를 기억하고, Bluesky는 레코드 덮어쓰기를 거부한다).
  • X·LinkedIn·Threads: 이런 ID를 받지 않는다. 생성 요청을 보냈는데 응답이 없으면 “게시됐을 수 있음” 오류로 실패 처리하고 자동 재시도하지 않는다. 사용자가 플랫폼을 확인한 뒤 수동으로 재시도해야 한다.
  • 같은 초안을 같은 계정에 두 번 발행하면 기존 행을 재사용하고, 이미 게시된 계정은 skipped: true로 돌아온다. 이미 게시됐거나 게시 중인 계정에 예약을 걸면 409를 돌려준다.

위키 맥락

  • Cloudflare 무료 플랜 위에 1인용 앱을 올리는 서드파티 사례라는 점에서 moc-cloudflare-open-source의 INKWAVE와 같은 줄에 놓인다. INKWAVE가 Durable Object를 실시간 relay로 썼다면, CogSend는 크론 트리거와 D1 큐로 예약 작업을 돌리면서 subrequest 한도를 스케줄러 설계에 직접 반영했다.
  • 에이전트 쪽에서는 Social Media Skills가 “무엇을 쓸지”(목소리·콘텐츠 제작)를 다룬다면, CogSend의 MCP 서버는 “어디에 언제 올릴지”를 맡는 발행 계층이다. 읽기/쓰기 키 분리와 발행 도구 승인 권고는 moc-mcp에서 다루는 쓰기 도구 권한 문제의 구체적인 예다.

한계

  • README·문서와 GeekNews 요약 기준이며, 직접 배포·발행해 보지는 않았다.
  • 2026-09-22에 만든 저장소이고 수집 시점 Stars는 175다. 운영 이력이 짧다.
  • LinkedIn·Threads·X는 플랫폼별 개발자 앱 정책을 따른다. Zernio 경유 연결은 후원사 서비스에 의존한다.