Anomalia

Anomalia CLI — ソーシャルメディア AI 自動化 CLI、MCP サーバー、エージェントスキル

ターミナルからソーシャルメディアを自動化できます。 Anomalia は、ソーシャルメディアの AI オートパイロットです。投稿やブログ記事の計画、執筆、デザイン、公開に加え、SEO/GEO 監査も自動で行います。このリポジトリには、コマンドラインクライアント、MCP サーバー（Model Context Protocol — stdio + HTTP）、エージェントスキルが含まれています。ターミナルまたは AI エージェントから、ソーシャルメディアの自動化、コンテンツ生成、承認ワークフローを実行するために必要なものがすべて揃っています。

このリポジトリでは、同じ製品を操作する 3 つの方法 を提供しています（OAuth と API は共通で、静的トークンは不要です）。

	内容	対象
CLI	anomalia ターミナルコマンド	人間とスクリプト
MCP	Model Context Protocol サーバー（stdio + HTTP）	Cursor、Claude、その他の MCP ホスト
Skill	Agent Skill（skills/anomalia/）	コーディングエージェント / skills.sh / npx skills

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

すべてのコマンドでは、最初の引数としてブランドのスラッグを指定します。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 ビルドではカスタムスキームの 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 などで利用できる、公開可能なエージェントスキル：

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 にフォールバックします。

変数	用途
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 クライアントです。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 が型チェック、テスト、クロスコンパイルを実行し、GitHub Release にバイナリ、.tar.gz、SHA256SUMS.txt を追加して、Formula/anomalia.rb を更新します。また、NPM_TOKEN が設定されている場合は anomalia-cli を npm に公開します。詳細：docs/distribute.md。

---

ライセンス

Copyright © 2026 Andrea Buttarelli.

GNU Affero General Public License v3.0 or later の下でライセンスされています。使用、変更、再配布が可能ですが、派生物も同じライセンスの下でオープンソースとして公開し、著作権表示を保持し、変更内容を明記する必要があります。ネットワーク経由でユーザーに提供する場合も同様です。