<div align="center"> <img src="assets/logo.png" alt="OpenCMO Logo" width="120" /> </div> <h1 align="center">OpenCMO</h1> <p align="center"> <strong>OpenCMO is an open-source growth system that unifies SEO, GEO, SERP, and community monitoring.</strong><br/> <sub>Built for open-source projects and developer products. See where your project is discovered, discussed, and compared — then turn those signals into reports, briefs, approvals, and actions.</sub> </p> <div align="center"> <a href="README.md">English</a> | <a href="README_zh.md">中文</a> | <a href="README_ja.md">日本語</a> | <a href="README_ko.md">한국어</a> | <a href="README_es.md">Español</a> </div> <p align="center"> <a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/python-3.10+-blue.svg?style=for-the-badge&logo=python" alt="Python 3.10+"></a> <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-green.svg?style=for-the-badge" alt="License"></a> <a href="https://github.com/study8677/OpenCMO/stargazers"><img src="https://img.shields.io/github/stars/study8677/OpenCMO?style=for-the-badge&color=yellow&logo=github" alt="Stars"></a> <img src="https://img.shields.io/badge/react-SPA-61DAFB.svg?style=for-the-badge&logo=react" alt="React SPA"> </p> <div align="center"> <h3> <a href="https://www.aidcmo.com/">Live Demo</a> · <a href="https://www.aidcmo.com/static/demo.mp4">Watch Video</a> </h3> </div> <div align="center"> <a href="https://www.aidcmo.com/"> <img src="assets/screenshots/demo-cover.png" alt="OpenCMO in action" width="850" /> </a> <p><i>Turn visibility signals into growth decisions from one open-source workspace.</i></p> </div>

Showcase: Real-World Example

See OpenCMO in action with a real scan of Cursor.com — 176 community discussions discovered across Reddit, Hacker News, Bilibili, Dev.to, and V2EX, with a 177-node knowledge graph.

View the Cursor showcase with full data

What Makes OpenCMO Different

It treats growth as a system, not a checklist: SEO, GEO, SERP, community discussion, competitors, reports, and approvals live in one loop.
It is built for open-source reality: before you have a marketing team, you still need discovery, discussion, and credibility.
It helps you act on signals: not just dashboards, but next actions, briefs, drafts, and human-in-the-loop approvals grounded in project context.

What OpenCMO Helps You Do

See where your project is visible: monitor search rankings, AI-search presence, community mentions, and crawler accessibility.
Understand who you are competing with: map competitors, keyword overlap, and community context in the knowledge graph.
Prioritize what to do next: identify the discussions to join, the keywords to push, and the content gaps worth closing.
Keep execution grounded: generate reports, agent briefs, and approval-ready drafts from the same project context.

The Growth Loop

Enter your URL on the homepage — AI scans your brand, category, keywords, and competitive context.
Monitor SEO, GEO, SERP, and community signals on a Daily / Weekly / Monthly schedule.
Turn raw signals into context with reports, graph exploration, and AI chat grounded in project data.
Move to execution with drafts, approvals, and prioritized next actions.

What Happens When You Hit "Start Monitoring"

One URL triggers a 6-stage AI pipeline that builds a complete growth picture:

| Stage | Name | What it does | |:-----:|------|-------------| | 1/6 | Context Build | Crawl your URL. Three AI specialists (Product Analyst, SEO Strategist, Community Strategist) run a 3-round debate to extract brand name, category, keywords, and competitors. | | 2/6 | Signal Collect | Run SEO audit, GEO visibility check, community search (Reddit, HN, Dev.to, ...), and SERP keyword tracking — all in parallel. | | 3/6 | Signal Normalize | Clean and standardize raw data: deduplicate discussions, normalize scores, align keyword and competitor records. | | 4/6 | Domain Review | Four AI analysts independently review the signals: SEO Analyst, GEO Analyst, Community Analyst, Competitor Analyst. | | 5/6 | Strategy Synthesis | An AI Strategy Director synthesizes all reviews into prioritized findings and actionable recommendations. | | 6/6 | Persist & Publish | Save results to DB, generate strategic report, surface insights on the dashboard. |

After the initial scan, schedule daily / weekly / monthly re-scans to track changes over time.

Core Capabilities

SEO Audit: Core Web Vitals, llms.txt, AI crawler detection, and technical site health.
GEO Visibility: monitor how your brand appears in AI-native search surfaces such as ChatGPT, Claude, Gemini, Perplexity, and You.com.
SERP Tracking: track keyword rankings over time with crawl-based or provider-based checks.
Community Monitoring: watch Reddit, Hacker News, Dev.to, YouTube, Bluesky, Twitter/X, plus Chinese platforms such as V2EX, Weibo, Bilibili, and XueQiu.
Knowledge Graph: explore competitors, keywords, and community connections in one visual map.
Reports: generate versioned strategic and weekly reports, with human readouts, agent briefs, PDF export, and email delivery.
Approvals and AI Chat: keep humans in the loop while using project-aware AI agents to reason, summarize, and draft.

Deep Reports

OpenCMO includes a report system inside each project workspace. Open the Reports tab or visit /projects/<id>/reports.

Strategic reports: full-scan analysis with positioning, competitor context, risks, and recommendations.
Weekly reports: 7-day monitoring summaries with trend changes, risks, wins, and next actions.
Dual outputs: every report is stored as both a Human Readout and an Agent Brief.
Multi-agent pipeline: human-facing reports use a 6-phase pipeline instead of a single prompt.
Graceful fallback: if the deep pipeline fails, OpenCMO falls back to simpler generation paths so reports stay available.

Quick Start

OpenCMO works with OpenAI-compatible APIs, including OpenAI, DeepSeek, NVIDIA NIM, Kimi-compatible gateways, and Ollama.

git clone https://github.com/study8677/OpenCMO.git
cd OpenCMO
pip install -e ".[all]"
crawl4ai-setup

cp .env.example .env
opencmo-web

Then open http://localhost:8080.

Enter your project URL on the homepage to run the first scan. If no LLM API key is configured yet, a red dot on the Settings icon will guide you to the setup panel.

Tip: you can also configure API keys from the web dashboard's Settings panel without touching .env.

<details> <summary>Frontend development (optional)</summary>

cd frontend
npm install
npm run dev
npm run build

The dev app runs at http://localhost:5173 and proxies API traffic to :8080.

</details>

Integrations

Roadmap

[x] AI CMO strategic scan
[x] SEO / GEO / SERP / community monitoring
[x] Versioned strategic and weekly reports
[x] Multi-agent deep report pipeline (6-phase)
[x] PDF export with branded header/footer
[x] 3D knowledge graph
[x] Approval queue and controlled publishing
[x] Chinese platform community monitoring (V2EX, Weibo, Bilibili, XueQiu)
[x] Full i18n (English, Chinese, Japanese, Korean, Spanish)
[x] Locale-aware AI responses (LLM follows UI language setting)
[x] LLM retry with exponential backoff for unreliable providers
[x] Simplified onboarding: enter URL on homepage, no configuration required to start
[ ] More publishing targets
[ ] Brand voice controls
[ ] Deeper enterprise SEO crawls

Contributors

study8677 - Creator and maintainer
ParakhJaggi - Tavily integration (#2, #3)
BBear0115 - Bug fixes for BYOK key isolation, base_url normalization, and reports (#9)
See CONTRIBUTORS.md for the full contributor list

Acknowledgments

geo-seo-claude by @zubair-trabzada
last30days-skill by @mvanhorn
Agent-Reach by @Panniantong — Chinese platform integration inspiration

OpenCMO

Install / Use

README