gitroomhq/postiz-agent

Postiz Agents CLI - connect it to Claude / OpenClaw / etc, to schedule social media posts 🤖

무엇인가요

postiz-agent는 AI 에이전트(ChatGPT, Claude, Gemini 등)가 다양한 AI 에이전트 생태계(Claude Code, Cursor, Gemini, Grok Build, DeepSeek Harness 등) 내부에서 Postiz CLI를 호출할 수 있도록 하는 경량 래퍼입니다. 기반이 되는 Postiz CLI는 Postiz SaaS 플랫폼과 통신하며, 수십 개의 플랫폼(Twitter/X, LinkedIn, Reddit, TikTok, Instagram, YouTube, Facebook 등)에 소셜 미디어 게시물을 예약하고 게시하기 위한 통합 API를 제공합니다.

누가 사용하나요

AI 어시스턴트 도구를 구축하는 개발자: 콘텐츠를 자동으로 게시해야 하는 경우(예: 트윗 초안을 작성하고 예약하는 ChatGPT 플러그인).
제품 팀: Postiz를 자체 AI 에이전트 플랫폼(Claude Code, Cursor, Gemini 등) 내의 내장 "기술"로 노출하고 싶은 경우.
파워 유저: 이미 Postiz CLI를 사용 중이며, 사용자 지정 접착 코드 없이 대화형 AI에서 이를 트리거하고 싶은 경우.

핵심 구성 요소(README 설명 기준)

구성 요소	기능
기술/CLI 통합	호스트 에이전트 내에 `postiz` 기술을 등록합니다. 이 기술은 명령을 전역으로 설치된 `postiz` npm CLI(별도 설치 필요)로 전달합니다.
매니페스트 파일	각 호스트 플랫폼에 필요한 플러그인 매니페스트(`.grok-plugin`, `.cursor-plugin`, `gemini-extension.json`, DeepSeek Harness 번들 등)를 제공합니다.
MCP 서버 등록	MCP(Multi-Channel Publishing) 서버를 지원하는 플랫폼의 경우, 플러그인은 호스팅된 Postiz MCP 엔드포인트(`https://mcp.postiz.com/mcp-oauth-dynamic`)를 가리킵니다. 이는 에이전트의 OAuth 흐름과 토큰 저장을 처리합니다.
Postiz CLI	실제 작업을 수행하는 도구입니다. 인증(OAuth 장치 흐름 또는 API 키), 통합 목록 표시, 미디어 업로드, 게시물 생성/예약, 분석 데이터 가져오기, YouTube 클리핑 실행 등을 수행합니다. 모든 명령은 에이전트가 쉽게 파싱할 수 있도록 JSON을 출력합니다.

실제 작동 방식(예시 흐름)

기술 설치 – 예: npx skills add gitroomhq/postiz-agent 또는 Cursor 마켓플레이스를 통해 설치.
인증 – 에이전트가 처음 실행될 때 브라우저가 열리고 Postiz OAuth 장치 흐름을 통해 자격 증명을 저장합니다.
에이전트의 기술 호출 – 사용자가 AI에게 "내일 있을 새 기능에 대한 트윗을 예약해줘"라고 요청합니다. 에이전트는 postiz 기술을 사용하여 다음을 수행합니다:
- 사용 가능한 Twitter 통합 목록 표시 (postiz integrations:list).
- postiz integrations:trigger를 통해 동적 데이터(예: 트렌드 해시태그)를 가져올 수 있음.
- 미디어 업로드 (postiz upload image.png).
- 콘텐츠, 예약 시간, 통합 ID, 미디어 URL을 포함하여 postiz posts:create … 명령 실행.
Postiz API가 요청을 수신하고 게시물을 대기열에 추가한 뒤, 선택한 플랫폼에 게시합니다.

저장소 포함 내용

다양한 AI 에이전트 생태계를 위한 플러그인 매니페스트.
각 환경에 기술을 설치하는 방법에 대한 문서.
기반이 되는 postiz CLI 인증 및 사용 방법에 대한 설명.
DeepSeek Harness 번들을 위한 도우미 스크립트.

제한 사항 / 참고 사항

이 저장소는 AI 모델 자체를 구현하지 않으며, 기존 에이전트를 Postiz 서비스에 연결하기만 합니다.
postiz CLI는 전역으로 설치(npm i -g postiz)되어야 하며, 사용자는 Postiz 계정/API 키가 있어야 합니다.
일부 플랫폼(TikTok, Instagram)은 미디어를 먼저 Postiz에 업로드해야 합니다. README에서는 이를 필수 단계로 강조합니다.

요약

postiz-agent는 Postiz 소셜 미디어 자동화 CLI를 많은 인기 AI 에이전트 플랫폼의 기술로 노출하는 플러그인 매니페스트 모음으로, 에이전트가 28개 이상의 소셜 네트워크에서 프로그래밍 방식으로 게시물을 예약하고 관리할 수 있도록 합니다.