Skip to content

study8677/OpenCMO

Repository files navigation

OpenCMO Logo

OpenCMO

The Open-Source AI Chief Marketing Officer — Your Full Marketing Team in One Tool.
A powerful multi-agent system featuring 25+ specialized AI experts, real-time monitoring across SEO/GEO/SERP/Community, and a modern web dashboard with interactive 3D knowledge graph.

Python 3.10+ License Stars React SPA


What is OpenCMO?

OpenCMO is a multi-agent AI marketing ecosystem tailored for indie hackers, startups, and small teams. Simply provide your product's URL, and OpenCMO will:

  1. Analyze your website deeply to understand your product and audience.
  2. Orchestrate a multi-agent strategy debate to identify the best keywords, positioning, and target communities.
  3. Automate continuous monitoring across SEO, AI search visibility (GEO), SERP keyword rankings, and developer communities (Reddit, Hacker News, Dev.to).
  4. Generate platform-specific content for 20+ platforms and auto-publish to Reddit and Twitter.

Interface & Experience

A modern React SPA with glassmorphic design, built for maximum clarity and control.

OpenCMO Dashboard Overview

Real-time Project Dashboard — Track your SEO, GEO (AI Visibility), SERP rankings, and Community Engagement at a glance.


Interactive Knowledge Graph

The Knowledge Graph is the heart of your market intelligence — an interactive 3D force-directed network that visualizes your entire marketing ecosystem.

3D Knowledge Graph

A dynamic, 3D force-directed map of your brand, keywords, discussions, competitors, and SERP rankings.

Key capabilities:

  • Interactive exploration — Zoom, drag, and pan across your brand's digital universe.
  • 6 node dimensions — Brand (purple), Keywords (cyan), Community Discussions (amber), SERP Rankings (green), Competitors (red), Overlapping Keywords (orange).
  • Competitor intelligence — Add competitor URLs to visualize shared battlegrounds with red dashed connection lines.
  • Real-time sync — Graph re-balances every 30 seconds as new insights are discovered.
  • AI-powered competitor discovery — Automatically identify competitors and track overlapping keywords.

Feature Highlights

SEO Audit

Continuously audit performance scores, Core Web Vitals (LCP, CLS, TBT), Schema.org, robots.txt, and sitemaps via the Google PageSpeed Insights API.

SEO Audit Dashboard

Performance trend chart and Core Web Vitals detailed analysis.

GEO Detection (AI Search Visibility)

Monitor your brand's visibility across AI search engines: Perplexity, You.com, ChatGPT, Claude, and Gemini.

GEO Visibility Tracking

Brand visibility score trends across AI search platforms.

SERP Tracking

Continuously track your target keywords' search positions. Supports web crawling or the DataForSEO API.

SERP Keyword Rankings

Keyword position table and ranking history chart.

Community Monitoring

Automatically scan for brand mentions and relevant discussions across Reddit, Hacker News, and Dev.to.

Community Monitoring

Cross-platform scan history and tracked discussions.


Your AI Marketing Team

OpenCMO ships with 25+ specialized AI agents organized into three categories:

Market Intelligence Agents

Agent Responsibility
CMO Agent The orchestrator. Routes tasks to the right expert automatically.
SEO Auditor Audits Core Web Vitals, Schema.org, robots.txt, and sitemaps via Google PageSpeed API.
GEO Specialist Monitors your brand visibility across Perplexity, You.com, ChatGPT, Claude, and Gemini.
Community Radar Scans Reddit, Hacker News, and Dev.to for brand mentions and relevant discussions.

Content Creation Agents (Global)

Agent Platform
Twitter/X Expert Tweets, hooks, and viral threads
Reddit Strategist Authentic posts and smart replies to live subreddits
LinkedIn Pro Professional thought-leadership posts
Product Hunt Expert Taglines, descriptions, and maker comments
Hacker News Formatter Technical "Show HN" posts
Blog/SEO Writer Long-form SEO-optimized articles (2000+ words)
Dev.to Expert Developer community articles

Content Creation Agents (Chinese Platforms)

Agent Platform
Zhihu Expert Zhihu Q&A platform
Xiaohongshu Expert RED social commerce
V2EX Expert V2EX developer forum
Juejin Expert Juejin developer community
Jike Expert Jike social platform
WeChat Expert WeChat ecosystem
OSChina Expert OSChina open-source community
GitCode Expert GitCode open-source platform
SSPAI Expert SSPAI productivity
InfoQ Expert InfoQ China tech media
Ruanyifeng Expert Ruanyifeng Weekly submission formatting

Platform Integrations

All integrations are configurable via the built-in Settings panel in the web dashboard — no .env editing required.

Settings Panel

Unified Settings Panel — Configure all API keys and platform integrations from the web UI.

Monitoring & Analysis (automatic)

Capability Platforms How
Community Monitoring Reddit, Hacker News, Dev.to Public APIs (no auth required)
GEO Detection Perplexity, You.com Web crawling (no auth required)
GEO Detection ChatGPT, Claude, Gemini API calls (configure keys in Settings)
SEO Audit Google PageSpeed Insights HTTP API (optional key for higher limits)
SERP Tracking Google, DataForSEO Web crawling or DataForSEO API

Publishing (user-controlled)

Platform Method Setup
Reddit PRAW (post + reply) Configure Reddit app credentials in Settings
Twitter/X Tweepy (tweets) Configure Twitter API credentials in Settings

Reporting

Feature Method Setup
Email Reports SMTP Configure SMTP credentials in Settings

All other agents (LinkedIn, Product Hunt, Chinese platforms, etc.) generate ready-to-use content that you copy-paste to the target platform.


How It Works: Multi-Agent Debate

When you submit a URL, OpenCMO hosts a 3-round collaborative discussion among specialized agents:

sequenceDiagram
    participant PA as Product Analyst
    participant SEO as SEO Specialist
    participant CS as Community Strategist
    participant SD as Strategy Director

    Note over PA,CS: Round 1 — Independent Analysis
    PA->>PA: Identify product, features, audience
    SEO->>SEO: Suggest search keywords & competitor terms
    CS->>CS: Propose community topics & platforms

    Note over PA,CS: Round 2 — Collaborative Refinement
    PA->>SEO: Shares product insights
    SEO->>CS: Shares keyword strategy
    CS->>PA: Shares community pain points

    Note over SD: Round 3 — Executive Consensus
    SD->>SD: Synthesizes the discussion thread<br/>into a finalized Brand Strategy.
Loading

By allowing agents to read and react to each other, OpenCMO produces strategies that are fundamentally richer than single-pass AI responses.

Multi-Agent Discussion

Multi-Agent Analysis Discussion — Multiple specialized agents collaborating in real-time.


AI Chat Interface

Chat directly with 25+ specialized agents. The CMO agent auto-routes to the optimal expert. Real-time responses via SSE streaming.

AI Chat Interface

Expert selection grid and streaming chat — Instant access to marketing specialists.


Quick Start Guide

OpenCMO supports any OpenAI-compatible API (OpenAI, DeepSeek, NVIDIA NIM, Ollama, etc.).

1. Installation

git clone https://github.com/study8677/OpenCMO.git
cd OpenCMO

# Install all Python dependencies
pip install -e ".[all]"

# Initialize crawler playbooks
crawl4ai-setup

2. Configuration

cp .env.example .env

Edit .env with your provider credentials. Example for OpenAI:

OPENAI_API_KEY=sk-yourAPIKeyHere
OPENCMO_MODEL_DEFAULT=gpt-4o

Tip: You can also configure all API keys directly from the web dashboard's Settings panel — no .env editing needed after initial setup.

3. Launch the Dashboard

opencmo-web

Open http://localhost:8080/app in your browser.

Prefer the terminal? Run opencmo for an interactive CLI chatbot mode.

4. Frontend Development (optional)

cd frontend
npm install
npm run dev     # Dev server at localhost:5173 (proxies API to :8080)
npm run build   # Production build

Roadmap

  • 25+ AI Marketing Experts with chat and intelligent routing
  • Multi-agent URL analysis via collaborative debate
  • React SPA with multi-language support (EN/ZH)
  • API agnostic — OpenAI, Anthropic, DeepSeek, NVIDIA, Ollama
  • Interactive 3D Knowledge Graph with competitor intelligence
  • Community monitoring — Reddit, Hacker News, Dev.to
  • GEO detection — Perplexity, You.com, ChatGPT, Claude, Gemini
  • SEO audit — Core Web Vitals, Schema.org, robots.txt
  • SERP tracking — Keyword ranking monitoring
  • Auto-publishing — Reddit (post + reply) and Twitter
  • Email reports via SMTP
  • AI-powered competitor discovery and keyword overlap analysis
  • Unified Settings panel — configure all API keys from the web UI
  • Direct publishing to LinkedIn, Product Hunt, and more
  • Custom Brand Voice fine-tuning
  • Enterprise-grade full-site SEO crawls

Made with care by the Open Source Community.
If OpenCMO saves you time, please give it a star on GitHub!

About

OpenCMO: An open-source, multi-agent AI Chief Marketing Officer built with OpenAI Agents SDK & Crawl4AI. Your BYOK alternative to $99/mo AI marketing agencies.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors