OpenCMO

<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](https://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](docs/showcase/cursor/)**

---

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

1. **Enter your URL** on the homepage — AI scans your brand, category, keywords, and competitive context.
2. **Monitor SEO, GEO, SERP, and community signals** on a Daily / Weekly / Monthly schedule.
3. **Turn raw signals into context** with reports, graph exploration, and AI chat grounded in project data.
4. **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, ...), SERP keyword tracking, and **GitHub potential-user discovery** — 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

... (truncated)