Anomalia CLI — 소셜 미디어 AI 자동화 CLI, MCP 서버 및 에이전트 스킬

터미널에서 소셜 미디어를 자동화하세요. Anomalia는 게시물, 블로그 기사, SEO/GEO 감사를 계획하고 작성하며 디자인하고 게시하는 소셜 미디어 AI 오토파일럿입니다. 이 저장소는 그 명령줄 클라이언트, MCP 서버(Model Context Protocol — stdio + HTTP) 및 에이전트 스킬입니다: 터미널이나 AI 에이전트에서 소셜 미디어 자동화, 콘텐츠 생성 및 승인 워크플로를 실행하는 데 필요한 모든 것이 담겨 있습니다.

이 저장소는 동일한 제품을 구동하는 세 가지 방법을 제공합니다(동일한 OAuth, 동일한 API, 정적 토큰 없음):

Anomalia 계정이 필요합니다. 이 도구는 독립 실행형 도구가 아닌 클라이언트입니다: 모든 호출은 HTTPS를 통해 Anomalia API와 통신합니다. 계정이 없으면 구동할 대상이 없습니다.

Anomalia CLI를 사용하면 소셜 미디어 게시를 자동화하고, AI 생성 콘텐츠를 한 번의 탭으로 승인하고, 캐러셀 슬라이드를 슬라이드별로 편집하고, 게시물을 비디오로 변환하고, SEO 및 GEO 감사를 실행하고, 블로그를 관리할 수 있습니다 — 터미널 또는 Cursor나 Claude 같은 AI 에이전트에서 말이죠.

┌─────────────┐   ┌─────────────┐   ┌──────────────────┐
│  anomalia   │   │  MCP host   │   │  Agent + Skill   │
│    CLI      │   │ (Cursor…)   │   │  (npx skills)    │
└──────┬──────┘   └──────┬──────┘   └────────┬─────────┘
       │                 │                   │
       │    lib/api.ts + OAuth session       │
       └─────────────────┼───────────────────┘
                         ▼
                 Anomalia /api/v1/*

1. CLI

설치

하나를 선택하세요:

npm

npm install -g anomalia-cli
# or:  pnpm add -g anomalia-cli   /   bun add -g anomalia-cli
anomalia login

Homebrew

brew tap andreabuttarelli/anomalia-cli https://github.com/andreabuttarelli/anomalia-cli
brew install anomalia
anomalia login

설치 프로그램(독립 실행형 바이너리) — macOS arm64/x64 및 Linux arm64/x64, Node/Bun 불필요:

curl -sSL https://raw.githubusercontent.com/andreabuttarelli/anomalia-cli/main/scripts/install.sh | bash
anomalia login

이후 anomalia update로 업데이트하거나, 설치 방법에 따라 npm install -g anomalia-cli@latest / brew upgrade anomalia를 사용하세요. 자세한 내용: docs/distribute.md.

빠른 시작

anomalia brands
anomalia dashboard my-brand
anomalia content my-brand --status pending_user
anomalia approve my-brand --all
anomalia seo my-brand
anomalia web my-brand generate --topic "..."
anomalia ads my-brand --remix
anomalia ai my-brand --message "..." --pipe

모든 명령어는 첫 번째 인자로 브랜드 슬러그를 받습니다. anomalia --help는 모든 명령어를 나열하고, anomalia <command> --help는 하나의 명령어를 자세히 설명합니다. 표의 짧은 ID 접두사도 허용되며, 모호한 접두사는 추측하지 않고 오류를 반환합니다.

전체 명령어 덤프: llms.txt · 추가 문서: docs/

소스에서

Bun 필요.

git clone https://github.com/andreabuttarelli/anomalia-cli.git
cd anomalia-cli
bun install
bun run cli.ts --help

Related MCP server: automate-idea-to-social-mcp

2. MCP 서버

CLI와 동일한 도구 및 OAuth. 문서: docs/mcp.md.

bun run mcp          # stdio (local hosts)
bun run mcp:http     # http://localhost:8787/mcp

원격: https://mcp.anomalia.so/mcp(Bearer JWT 필요). 상태 확인: GET /health.

Cursor — stdio

{
  "mcpServers": {
    "anomalia": {
      "command": "bun",
      "args": ["run", "/ABS/PATH/to/anomalia-cli/mcp/stdio.ts"]
    }
  }
}

Cursor — HTTP

{
  "mcpServers": {
    "anomalia": { "url": "https://mcp.anomalia.so/mcp" }
  }
}

Connect가 Not an https or loopback URI: cursor://… 오류로 실패하면, Cursor 빌드가 여전히 사용자 지정 스킴 OAuth 콜백을 사용하는 것입니다 — 위의 stdio를 사용하거나, Cursor를 업데이트(루프백 http://localhost:8787/callback)하거나, docs/mcp.md를 참조하세요.

• 로컬 stdio: login 도구 또는 기존 anomalia login → ~/.config/anomalia/session.json

• 원격 HTTP: Authorization: Bearer <access_token>(없으면 401이 정상입니다)

3. 에이전트 스킬 및 플러그인

Cursor, Claude, skills.sh 등을 위한 게시 가능한 Agent Skill:

npx skills add andreabuttarelli/anomalia-cli --skill anomalia
# or
bash scripts/install-skill.sh --project

패키지: skills/anomalia/ → plugins/anomalia/skills/anomalia/ (SKILL.md + MCP 설정, 도구 맵, CLI용 references/).

스킬이 활성화되면 에이전트는 연결된 경우 MCP 도구를 우선 사용하고, 그렇지 않으면 CLI를 사용합니다.

Claude Code / Codex 마켓플레이스 플러그인

동일한 스킬 + 원격 MCP, 플러그인 설치 및 디렉토리 제출용으로 패키징:

# Claude Code
/plugin marketplace add andreabuttarelli/anomalia-cli
/plugin install anomalia@anomalia

# Codex
codex plugin marketplace add andreabuttarelli/anomalia-cli

제출 체크리스트(Claude 커뮤니티 디렉토리 + OpenAI Plugins Directory): docs/plugins.md.

구성

기본적으로 구성이 없으면 https://anomalia.so를 사용하며, 로컬 앱이 응답 중일 때 http://localhost:5173으로 자동 폴백합니다.

세션: ~/.config/anomalia/session.json. anomalia logout이 이를 삭제합니다. 이 저장소나 바이너리에는 비밀이 포함되어 있지 않습니다.

아키텍처

경량 HTTPS 클라이언트 — DB 액세스 없음, Anomalia 서버 코드베이스와의 결합 없음:

CLI  ──┐
MCP  ──┼── HTTPS ──►  /api/v1/*  ──►  Anomalia
Skill ─┘   (guides agents to CLI or MCP)

• CLI 명령어: commands/ + cli.ts

• HTTP 클라이언트: lib/api.ts만

• MCP: mcp/(lib/api.ts 재사용, 도구 등록)

• 스킬 / 플러그인: skills/anomalia/ → plugins/anomalia/(Claude + Codex 마켓플레이스 매니페스트)

개발

bun install
bun run cli.ts --help
bun run mcp
bun run mcp:http
bun run typecheck
bun test
bun run build             # binary → dist/
bun run build:all         # all four targets
bun run vercel-build      # MCP bundles under mcp/api/

릴리스: v* 태그를 푸시하면 CI가 타입체크, 테스트, 바이너리 + .tar.gz + SHA256SUMS.txt 크로스 컴파일을 GitHub Release에서 수행하고, Formula/anomalia.rb를 업데이트하며, NPM_TOKEN이 설정된 경우 anomalia-cli를 npm에 게시합니다. 자세한 내용: docs/distribute.md.

라이선스

Copyright © 2026 Andrea Buttarelli.

GNU Affero General Public License v3.0 이상에 따라 라이선스가 부여됩니다. 사용, 수정 및 재배포가 가능하지만, 파생 저작물은 동일한 라이선스로 오픈 소스를 유지해야 하며, 저작권 고지를 유지하고 변경 사항을 명시해야 합니다 — 네트워크를 통해 사용자에게 제공되는 경우를 포함합니다.