Anomalia CLI — CLI de automatización de redes sociales con IA, MCP Server y Agent Skill

Automatiza tus redes sociales desde la terminal. Anomalia es el piloto automático de redes sociales con IA que planifica, escribe, diseña y publica publicaciones, artículos de blog y auditorías SEO/GEO en piloto automático. Este repositorio es su cliente de línea de comandos, servidor MCP (Model Context Protocol — stdio + HTTP) y habilidad de agente: todo lo que necesitas para ejecutar automatización de redes sociales, generación de contenido y flujos de aprobación desde una terminal o un agente de IA.

Este repositorio ofrece tres formas de usar el mismo producto (mismo OAuth, misma API, sin tokens estáticos):

Necesitas una cuenta de Anomalia. Este es un cliente, no una herramienta independiente: cada llamada se comunica con la API de Anomalia a través de HTTPS. Sin una cuenta no hay nada que manejar.

Con la CLI de Anomalia puedes automatizar la publicación en redes sociales, aprobar contenido generado por IA con un solo toque, editar un carrusel diapositiva a diapositiva, convertir una publicación en video, ejecutar auditorías SEO y GEO, y gestionar tu blog — desde la terminal o desde un agente de IA como Cursor o Claude.

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

1. CLI

Instalación

Elige uno:

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

Instalador (binario independiente) — macOS arm64/x64 y Linux arm64/x64, sin necesidad de Node/Bun:

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

Actualiza más tarde con anomalia update, o npm install -g anomalia-cli@latest / brew upgrade anomalia según cómo lo hayas instalado. Más detalles: docs/distribute.md.

Inicio rápido

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

Cada comando toma el slug de la marca como primer argumento. anomalia --help los lista todos; anomalia <comando> --help detalla uno. Se aceptan prefijos cortos de id de las tablas; los prefijos ambiguos dan error en lugar de adivinar.

Volcado completo de comandos: llms.txt · más documentación: docs/

Desde el código fuente

Requiere 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. Servidor MCP

Mismas herramientas y OAuth que la CLI. Documentación: docs/mcp.md.

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

Remoto: https://mcp.anomalia.so/mcp (se requiere Bearer JWT). Salud: 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" }
  }
}

Si Connect falla con Not an https or loopback URI: cursor://…, tu compilación de Cursor todavía está usando el callback OAuth de esquema personalizado — usa stdio arriba, actualiza Cursor (loopback http://localhost:8787/callback), o consulta docs/mcp.md.

• stdio local: herramienta login o anomalia login existente → ~/.config/anomalia/session.json

• HTTP remoto: Authorization: Bearer <access_token> (se espera 401 sin él)

3. Habilidad de agente y plugins

Habilidad de agente publicable Agent Skill para Cursor, Claude, skills.sh y amigos:

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

Paquete: skills/anomalia/ → plugins/anomalia/skills/anomalia/ (SKILL.md + references/ para configuración de MCP, mapa de herramientas, CLI).

Cuando la habilidad está activa, los agentes prefieren herramientas MCP si están conectadas, de lo contrario la CLI.

Plugin de marketplace Claude Code / Codex

Misma habilidad + MCP remoto, empaquetado para instalación de plugin y envío a directorio:

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

# Codex
codex plugin marketplace add andreabuttarelli/anomalia-cli

Lista de verificación de envío (directorio de comunidad de Claude + Directorio de Plugins de OpenAI): docs/plugins.md.

Configuración

Cero configuración por defecto → https://anomalia.so, con respaldo automático a http://localhost:5173 cuando una aplicación local está respondiendo.

Sesión: ~/.config/anomalia/session.json. anomalia logout la borra. No hay secretos incrustados en este repositorio ni en el binario.

Arquitectura

Cliente HTTPS ligero — sin acceso a BD, sin acoplamiento con el código del servidor de Anomalia:

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

• Comandos CLI: commands/ + cli.ts

• Cliente HTTP: solo lib/api.ts

• MCP: mcp/ (reutiliza lib/api.ts, registra herramientas)

• Habilidad / plugins: skills/anomalia/ → plugins/anomalia/ (manifiestos de marketplace de Claude + Codex)

Desarrollo

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/

Lanzamientos: empuja una etiqueta v* → CI verifica tipos, ejecuta pruebas, compila binarios + .tar.gz + SHA256SUMS.txt en el Release de GitHub, actualiza Formula/anomalia.rb y publica anomalia-cli en npm cuando NPM_TOKEN está configurado. Detalles: docs/distribute.md.

Licencia

Copyright © 2026 Andrea Buttarelli.

Licenciado bajo la GNU Affero General Public License v3.0 o posterior. Puedes usarlo, modificarlo y redistribuirlo, pero las obras derivadas deben permanecer de código abierto bajo la misma licencia, deben mantener el aviso de copyright y deben indicar sus cambios — incluso cuando se ofrezcan a usuarios a través de una red.