Anomalia

Anomalia CLI — 社交媒体 AI 自动化 CLI、MCP 服务与 Agent 技能

在终端中自动化管理社交媒体。 Anomalia 是社交媒体 AI 自动驾驶平台，可自动规划、撰写、设计和发布帖子、博客文章，并执行 SEO/GEO 审核。本仓库包含它的命令行客户端、MCP 服务（模型上下文协议 — stdio + HTTP）和 Agent 技能：提供在终端或 AI Agent 中运行社交媒体自动化、内容生成和审批工作流所需的一切。

本仓库提供 三种方式 来使用同一款产品（相同的 OAuth、相同的 API、没有静态令牌）：

	功能	适用对象
CLI	anomalia 终端命令	用户和脚本
MCP	模型上下文协议服务（stdio + HTTP）	Cursor、Claude 及其他 MCP 宿主
Skill	Agent 技能（skills/anomalia/）	编码 Agent / skills.sh / npx skills

你需要一个 Anomalia 账户。 这是一个客户端，而非独立工具：每次调用都会通过 HTTPS 访问 Anomalia API。没有账户就无法使用。

使用 Anomalia CLI，你可以自动发布社交媒体帖子，一键批准 AI 生成的内容，逐页编辑轮播内容，将帖子转换为视频，运行 SEO 和 GEO 审核，以及管理博客——可以通过终端 或 Cursor、Claude 等 AI Agent 操作。

┌─────────────┐   ┌─────────────┐   ┌──────────────────┐
│  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	需要 Node.js ≥ 20
Homebrew	见下文	macOS / Linux，独立二进制文件
安装程序	见下文	curl 脚本 → PATH 中的二进制文件
从源代码安装	见下文	需要 Bun

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

每条命令都将品牌 slug 作为第一个参数。anomalia --help 会列出所有命令；anomalia <command> --help 会显示具体命令的详情。表格中的 ID 短前缀也可使用；如果前缀有歧义，系统会报错，而不会猜测。

类别	命令
帖子	content、approve、post <id> [show|edit|regenerate|slide|reorder|video|publish]
规划	plan、weekly-plan、calendar、gtm
品牌	studio、voice、people、products
Web	seo、geo、keywords、web
广告	ads — 广告活动、支出、推广提案、混剪、复制/删除（--sync、--propose、--remix、--create、--approve、--pause、--resume、--duplicate、--delete、--reject，按单个创意使用 --ad）
洞察	dashboard、status、analytics
AI	ai --message "..." — 自然语言，完整读写权限

完整命令列表：llms.txt · 更多文档：docs/

从源代码安装

需要 Bun。

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

---

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" }
  }
}

如果连接失败并显示 Not an https or loopback URI: cursor://…，说明你的 Cursor 版本仍在使用自定义 scheme OAuth 回调——请使用上文的 stdio，更新 Cursor（使用 loopback http://localhost:8787/callback），或参阅 docs/mcp.md。

• 本地 stdio：使用 login 工具或现有的 anomalia login → ~/.config/anomalia/session.json
• 远程 HTTP：Authorization: Bearer <access_token>（未提供令牌时返回 401 是预期行为）

---

3. Agent Skill 和插件

面向 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/）。

启用该 skill 后，如果已连接 MCP，Agent 会优先使用 MCP 工具；否则使用 CLI。

Claude Code / Codex 市场插件

相同的 skill + 远程 MCP，打包后可供安装插件和提交至目录：

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

# Codex
codex plugin marketplace add andreabuttarelli/anomalia-cli

提交检查清单（Claude 社区目录 + OpenAI 插件目录）：docs/plugins.md。

---

配置

默认无需配置 → https://anomalia.so；当本地应用有响应时，会自动回退到 http://localhost:5173。

变量	用途
PUBLIC_APP_URL	将 CLI/MCP 指向其他 Anomalia 实例
SENTRY_DSN	（MCP HTTP / Vercel）错误 → Sentry
SUPABASE_SERVICE_ROLE_KEY	（MCP HTTP / Vercel）mcp_logs 中的行
MCP_PUBLIC_URL	OAuth 元数据的 MCP 公共基础 URL

会话：~/.config/anomalia/session.json。anomalia logout 会清除会话。此仓库或二进制文件中均不包含密钥。

---

架构

轻量 HTTPS 客户端——不访问数据库，也不依赖 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，注册工具）
• Skill / 插件：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 进行类型检查和测试、交叉编译二进制文件，并在 GitHub Release 中提供 .tar.gz 和 SHA256SUMS.txt，更新 Formula/anomalia.rb，并在设置了 NPM_TOKEN 时将 anomalia-cli 发布到 npm。详情：docs/distribute.md。

---

许可证

版权所有 © 2026 Andrea Buttarelli。

依据 GNU Affero 通用公共许可证 v3.0 或更高版本授权。你可以使用、修改和再分发本软件，但衍生作品必须在相同许可证下保持开源、保留版权声明并注明所做的更改——包括通过网络向用户提供时。