Skip to main content
Glama
omnipost-social-engine

omnipost-social-engine

by 1nc0gn30

Omnipost Social Engine

Zero-dependency Python 3.9+ multi-platform social copy formatter, sentence-aware thread splitter, copywriting hook generator, WCAG 2.2 alt-text accessibility auditor, UTM campaign URL builder/sanitizer, campaign exporter, and MCP server.


Overview

omnipost-social-engine formats and validates posts across X/Twitter (280 chars), Bluesky (300 chars), Threads (500 chars), Mastodon (500 chars), LinkedIn (3,000 chars), Facebook, and Instagram. It ships with a Google Material 3 dark loopback web workstation, deterministic Unicode typography styling (bold, italic, bold_italic, monospace, script, double_struck, sans, underline, strikethrough), sentence-preserving thread segmentation, engagement/readability scoring, ad-tracker parameter stripping (fbclid, gclid, msclkid, twclid), Buffer/Hootsuite/Typefully CSV export, and a 12-tool Model Context Protocol (MCP) server.


Related MCP server: PostMCP MCP Server

Architecture

src/omnipost_social_engine/
├── campaign_exporter.py          # Buffer, Hootsuite, Typefully CSV, JSON, and Markdown calendar exporters
├── hook_generator.py             # Deterministic hook templates across 9 copywriting frameworks
├── accessibility_synthesizer.py  # WCAG 2.2 image alt-text auditor and content-warning trigger scanner
├── utm_builder.py                # UTM parameter builder, click-ID URL sanitizer, and vanity HTML redirector
├── mcp_server.py                 # JSON-RPC 2.0 stdio MCP server exposing 12 social & UTM tools
├── ui_server.py                  # Loopback HTTP API + Google Material 3 Studio UI (127.0.0.1:8091)
└── cli.py                        # Unified CLI entrypoint (`omnipost`)

Quickstart

git clone https://github.com/1nc0gn30/omnipost-social-engine.git
cd omnipost-social-engine
python3 -m pip install -e ".[dev]"

# Launch the loopback web workstation on http://127.0.0.1:8091
omnipost serve --host 127.0.0.1 --port 8091

Run directly from a source checkout without installing:

PYTHONPATH=src python3 -m omnipost_social_engine.cli serve --host 127.0.0.1 --port 8091

CLI & MCP Usage

CLI Subcommands

# View CLI help
omnipost --help

# Format and style a post for X/Twitter, LinkedIn, Bluesky, Threads, or Mastodon
omnipost format "Shipping deterministic Python tools." --platform bluesky --style bold --tags python,mcp --json

# Split long-form copy into numbered thread segments
omnipost split examples/developer-thread/draft.txt --platform twitter --limit 280 --numbering-format fraction --json

# Generate copywriting hooks across 9 frameworks
omnipost hooks "local-first developer tools" --niche tech --framework contrarian --count 5 --json

# Score readability, structure, and engagement readiness (0-100)
omnipost analyze "Here is why zero-dependency CLIs start faster." --platform linkedin --json

# Export a campaign schedule to Buffer/Hootsuite/Typefully CSV, JSON, or Markdown
omnipost export examples/launch-campaign/campaign.json --format csv --preset buffer

# Audit image alt-text accessibility and content-warning triggers
omnipost accessibility --alt "Terminal screenshot showing JSON output" --platform mastodon --json

# Build UTM URLs, strip tracking IDs, or generate multi-platform campaign links
omnipost utm --url "https://nullai.tech" --platform twitter --campaign q4_launch --json
omnipost utm --url "https://example.com/?fbclid=abc123&utm_source=x" --sanitize --json

# Print platform character limits and runtime diagnostics
omnipost platform --json

# Launch stdio MCP server or print client configs
omnipost mcp
omnipost mcp-config --client claude

ZothOS v3.4.0 CLI Integration

On ZothOS v3.4.0 workstations, omnipost is available in /usr/local/bin/omnipost:

omnipost platform --json
omnipost web                 # Starts http://127.0.0.1:8091
omnipost desktop             # Launches the Electron workstation shell

Model Context Protocol (MCP) Tools

{
  "mcpServers": {
    "omnipost": {
      "command": "omnipost",
      "args": ["mcp"]
    }
  }
}

MCP Tool

Description

omni_format_post

Format and style social copy with platform character checks and Unicode typography

omni_split_thread

Split long-form text into numbered, sentence-bounded thread segments

omni_generate_hooks

Generate opening hooks across 9 copywriting frameworks (contrarian, curiosity_gap, etc.)

omni_analyze_engagement

Score readability, sentiment, structure, and engagement readiness (0-100)

omni_export_campaign

Export multi-post campaigns to Buffer/Hootsuite/Typefully CSV, JSON, or Markdown

omni_get_diagnostics

Return platform character budgets, Unicode support status, and engine diagnostics

omni_audit_accessibility

Audit image alt-text against WCAG 2.2 checks and scan for content-warning triggers

omni_build_utm_url

Construct clean UTM campaign tracking URLs

omni_sanitize_url

Strip surveillance click IDs (fbclid, gclid, msclkid, twclid) while optionally keeping UTM tags

omni_generate_campaign_links

Generate synchronized UTM tracking URLs across multiple social platforms

omni_tag_post_links

Detect bare URLs inside post copy and tag them with platform UTM parameters

omni_vanity_redirect

Generate a standalone HTML redirect page with Open Graph and Twitter Card metadata


HTTP API Reference

When running on http://127.0.0.1:8091:

Method

Endpoint

Description

GET

/health, /api/health

Service health status and Python runtime version

GET

/api/diagnostics

Platform character limits and engine diagnostics

GET

/api/mcp/config

Ready-to-paste MCP client configurations (claude_desktop, cursor, cline, zed)

POST

/api/format

Format and apply Unicode typography to post text

POST

/api/split

Split long text into numbered thread posts

GET/POST

/api/hooks

Generate hook candidates by topic, niche, and framework

POST

/api/analyze

Compute engagement readiness and readability metrics

POST

/api/export

Export campaign schedules (json, csv, markdown, txt)

GET/POST

/api/accessibility

Run WCAG 2.2 alt-text and content-warning checks

POST

/api/utm/build, /api/utm/sanitize, /api/utm/campaign-links, /api/utm/tag-post, /api/utm/vanity

UTM link construction, sanitization, and vanity redirect generation


Testing & Verification

# Run the pytest suite
python3 -m pytest -q

# Run CLI self-test
omnipost test

# Scan repository with gitleaks
gitleaks detect --source . --no-banner --redact

Support

Omnipost Social Engine is 100% free and open-access software with zero paywalls. Optional community support is available via:

  • Stripe: Buy Us a Coffee

  • Solana Tip: GG2eQbVh8ut1BK6j1A2tz7pSySdLpD38BgyEhGcxdXoK

License

MIT License — Engineered by Neal Frazier Tech (@1nc0gn30) • NullAI Platform. Copyright (c) 2026 Neal Frazier. See LICENSE for full text.

Available Tools

12 tools
omni_analyze_engagementB

Analyze text for engagement potential, viral readiness score (0-100), readability metrics, sentiment, structure, and actionable optimization tips.

Inputs: text (required), platform.

omni_audit_accessibilityB

Audit alt-text against WCAG 2.2 accessibility standards and detect content warning (CW) triggers for sensitive posts.

Inputs: alt_text, platform, post_text.

omni_build_utm_urlC

Build a clean campaign tracking URL with source, medium, campaign, term, and content parameters.

Inputs: medium (required), source (required), base_url (required), campaign (required), +2 more.

omni_export_campaignB

Export a multi-post social campaign into Buffer/Hootsuite CSV, JSON bundle, Markdown calendar, or plain text.

Inputs: campaign (required), format, preset.

omni_format_postB

Format, optimize and style social media posts for target platform (twitter, linkedin, bluesky, threads, mastodon) with character checks and Unicode typography styles.

Inputs: text (required), trim, style, hashtags, +1 more.

omni_generate_hooksB

Generate high-converting viral hooks, headlines, and opening lines based on proven copywriting frameworks.

Inputs: topic (required), count, niche, framework.

omni_get_diagnosticsA

Retrieve system diagnostics, platform character limits, Unicode font support status, and engine version info.

Inputs: platform.

omni_sanitize_urlA

Strip surveillance and ad network click IDs (fbclid, gclid, msclkid, twclid, etc.) from a URL.

Inputs: url (required), keep_utm.

omni_split_threadB

Split long-form copy into platform-optimized thread posts with character limit adherence, natural sentence/paragraph breaks, and numbering markers.

Inputs: text (required), limit, platform, numbering, +1 more.

omni_tag_post_linksC

Auto-detect URLs in social post body and replace them with platform-specific campaign UTM URLs.

Inputs: text (required), campaign (required), platform (required), content.

omni_vanity_redirectA

Generate a standalone zero-dependency HTML vanity redirect page with Open Graph and Twitter Card tags.

Inputs: title (required), target_url (required), delay_ms, og_image, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 12 tools

    Disambiguation4/5

    Most tools occupy clearly separate lanes: formatting, thread splitting, hooks, engagement analysis, export, accessibility audit, and diagnostics are all distinct operations. The only soft overlap is among the UTM tools (omni_build_utm_url, omni_generate_campaign_links, omni_tag_post_links), though descriptions distinguish single-URL construction, cross-platform link sets, and in-body auto-replacement. omni_vanity_redirect is also a different product surface (HTML page generation) from the rest of the copy/tracking workflow.

    Naming Consistency4/5

    All names follow a clean omni_ snake_case convention with a consistent prefix, making them easy to scan and group. The only deviation is verb style: omni_vanity_redirect uses a noun phrase rather than an action verb, while every other tool leads with generate/split/analyze/export/audit/build/sanitize/tag/get.

    Tool Count5/5

    Twelve tools sit squarely in the well-scoped 3-15 range, with each one covering a distinct step in the post-creation pipeline (hook generation, formatting, splitting, auditing, tracking, exporting). No tool appears redundant or filler.

    Completeness4/5

    The surface covers the copy lifecycle end-to-end: ideation (hooks), formatting and threading, quality checks (engagement, accessibility), tracking URL generation/sanitization, and campaign export. The main gap is that a "social engine" has no publish/schedule or media/alt-text generation step — only auditing of existing alt-text — so agents hit a dead end at delivery.

    Maintenance

    ActivityActive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to manage social media publishing across platforms like LinkedIn, Twitter, Facebook, Instagram, Threads, and Bluesky.
      7
      54 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Gives AI agents the ability to schedule and publish social media posts to Instagram, TikTok, YouTube, X, LinkedIn, Facebook, Pinterest, Threads, and Bluesky. Create, schedule, and bulk-plan posts with per-platform captions, then check per-platform results and retry failures.
      82
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to post, schedule, thread, delete, and analyze social media posts across platforms like X, Bluesky, LinkedIn, and Instagram through a single MCP interface.
      107 npm
      MIT