Anomalia CLI — Social Media AI Automation CLI, MCP Server & Agent Skill

Automatisieren Sie Ihre Social Media vom Terminal aus. Anomalia ist der Social-Media-KI-Autopilot, der Beiträge, Blog-Artikel und SEO/GEO-Audits im Autopilot-Modus plant, schreibt, gestaltet und veröffentlicht. Dieses Repository ist sein Kommandozeilen-Client, MCP-Server (Model Context Protocol — stdio + HTTP) und Agenten-Skill: alles, was Sie benötigen, um Social-Media-Automatisierung, Content-Erstellung und Genehmigungsworkflows von einem Terminal oder einem KI-Agenten aus auszuführen.

Dieses Repository bietet drei Möglichkeiten, dasselbe Produkt zu steuern (gleiche OAuth, gleiche API, keine statischen Tokens):

Sie benötigen ein Anomalia-Konto. Dies ist ein Client, kein eigenständiges Tool: Jeder Aufruf kommuniziert über HTTPS mit der Anomalia-API. Ohne Konto gibt es nichts zu steuern.

Mit der Anomalia-CLI können Sie Social-Media-Posts automatisieren, KI-generierte Inhalte mit einem Klick genehmigen, ein Karussell Folie für Folie bearbeiten, einen Beitrag in ein Video verwandeln, SEO- und GEO-Audits durchführen und Ihren Blog verwalten — vom Terminal oder von einem KI-Agenten wie Cursor oder Claude.

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

1. CLI

Installation

Wählen Sie eine:

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

Installer (eigenständige Binärdatei) — macOS arm64/x64 und Linux arm64/x64, kein Node/Bun erforderlich:

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

Später aktualisieren mit anomalia update, oder npm install -g anomalia-cli@latest / brew upgrade anomalia je nach Installationsmethode. Weitere Details: docs/distribute.md.

Schnellstart

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

Jeder Befehl nimmt den Marken-Slug als erstes Argument. anomalia --help listet alle auf; anomalia <command> --help beschreibt einen. Kurze ID-Präfixe aus Tabellen werden akzeptiert; mehrdeutige Präfixe führen zu einem Fehler, anstatt zu raten.

Vollständiger Befehlsdump: llms.txt · weitere Dokumentation: docs/

Aus dem Quellcode

Erfordert 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-Server

Gleiche Tools und OAuth wie die CLI. Dokumentation: docs/mcp.md.

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

Remote: https://mcp.anomalia.so/mcp (Bearer-JWT erforderlich). Health: 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" }
  }
}

Wenn Connect mit Not an https or loopback URI: cursor://… fehlschlägt, verwendet Ihr Cursor-Build noch den OAuth-Callback mit benutzerdefiniertem Schema — verwenden Sie stdio oben, aktualisieren Sie Cursor (Loopback http://localhost:8787/callback) oder lesen Sie docs/mcp.md.

• Lokales stdio: login-Tool oder vorhandenes anomalia login → ~/.config/anomalia/session.json

• Remote-HTTP: Authorization: Bearer <access_token> (401 ohne dieses ist zu erwarten)

3. Agenten-Skill & Plugins

Veröffentlichbarer Agenten-Skill für Cursor, Claude, skills.sh und andere:

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

Paket: skills/anomalia/ → plugins/anomalia/skills/anomalia/ (SKILL.md + references/ für MCP-Einrichtung, Tool-Karte, CLI).

Wenn der Skill aktiv ist, bevorzugen Agenten MCP-Tools, falls verbunden, andernfalls die CLI.

Claude-Code-/Codex-Marketplace-Plugin

Gleicher Skill + Remote-MCP, verpackt für Plugin-Installation und Verzeichnis-Einreichung:

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

# Codex
codex plugin marketplace add andreabuttarelli/anomalia-cli

Einreichungs-Checkliste (Claude-Community-Verzeichnis + OpenAI-Plugins-Verzeichnis): docs/plugins.md.

Konfiguration

Standardmäßig keine Konfiguration → https://anomalia.so, mit automatischem Fallback auf http://localhost:5173, wenn eine lokale App antwortet.

Sitzung: ~/.config/anomalia/session.json. anomalia logout löscht sie. In diesem Repository oder der Binärdatei sind keine Geheimnisse eingebettet.

Architektur

Schlanker HTTPS-Client — kein DB-Zugriff, keine Kopplung an die Anomalia-Server-Codebasis:

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

• CLI-Befehle: commands/ + cli.ts

• HTTP-Client: nur lib/api.ts

• MCP: mcp/ (verwendet lib/api.ts wieder, registriert Tools)

• Skill / Plugins: skills/anomalia/ → plugins/anomalia/ (Claude- + Codex-Marketplace-Manifeste)

Entwicklung

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/

Releases: v*-Tag pushen → CI führt Typprüfung, Tests, Cross-Kompilierung von Binärdateien + .tar.gz + SHA256SUMS.txt auf der GitHub-Release durch, aktualisiert Formula/anomalia.rb und veröffentlicht anomalia-cli auf npm, wenn NPM_TOKEN gesetzt ist. Details: docs/distribute.md.

Lizenz

Copyright © 2026 Andrea Buttarelli.

Lizenziert unter der GNU Affero General Public License v3.0 oder später. Sie dürfen es verwenden, modifizieren und weiterverbreiten, aber abgeleitete Werke müssen unter derselben Lizenz Open Source bleiben, den Copyright-Hinweis beibehalten und ihre Änderungen angeben — auch wenn sie Benutzern über ein Netzwerk angeboten werden.