# AICMOHQ

> AI marketing copilot that helps bootstrapped SaaS founders find their first 10 paid users. It surfaces high-intent Reddit, SEO, and GEO opportunities, drafts non-spam helpful replies and articles, and requires founder approval before anything is published.

AICMOHQ is built for solo and indie SaaS founders who have no time or budget for marketing. A founder enters their product URL; the system analyzes the product, finds acquisition opportunities, drafts content in the founder's voice, and tracks a repeatable weekly acquisition loop. Nothing is posted publicly without explicit founder approval.

## Core capabilities
- Site intake: analyze a product URL into a Brand Voice Guide and Product Positioning Brief.
- Reddit opportunity scanner: find high-intent posts and score them by relevance, recency, buyer intent, subreddit fit, and spam risk.
- SEO/GEO engine: low-competition long-tail keyword ideas, article briefs, and AI-search (GEO) queries people ask ChatGPT and Perplexity.
- Content drafts for X, LinkedIn, and Hacker News in the founder's brand voice.
- Approval system: nothing public ships without founder approval.
- Autonomous refresh every 6 hours.

## The 6 AI agents
- [Agents overview](https://aicmohq.com/agents): the six AI marketing agents that run your acquisition loop.
- [Scout Agent](https://aicmohq.com/agents/scout): finds high-intent communities, trending conversations, and competitor launches, ranked by buyer intent.
- [Writer Agent](https://aicmohq.com/agents/writer): drafts X threads, LinkedIn posts, and Reddit-native content in your brand voice.
- [Publisher Agent](https://aicmohq.com/agents/publisher): schedules and cross-posts approved content at the optimal time per platform.
- [Engage Agent](https://aicmohq.com/agents/engage): drafts genuine replies and nurtures relationships across channels (approval required).
- [Analyst Agent](https://aicmohq.com/agents/analyst): turns marketing data into weekly insights and concrete next steps.
- [ICP Validator Agent](https://aicmohq.com/agents/icp): validates ideal-customer fit and sharpens positioning before campaigns are drafted.

## Channels
- [Channels overview](https://aicmohq.com/channels): every platform AICMOHQ connects to.
- [X (Twitter)](https://aicmohq.com/channels/x): draft, schedule, and engage on X in your voice.
- [Reddit](https://aicmohq.com/channels/reddit): find high-intent threads and draft non-spam helpful replies.
- [LinkedIn](https://aicmohq.com/channels/linkedin): thought-leadership posts scheduled for peak reach.
- [Email / Newsletter](https://aicmohq.com/channels/email): repurpose top content into newsletter issues and launch emails.
- [Hacker News](https://aicmohq.com/channels/hacker-news): time and frame Show HN launches that resonate.

## Comparisons
- [Compare](https://aicmohq.com/compare): AICMOHQ vs Buffer, Hootsuite, Typefully, and Hypefury.
- [Alternatives](https://aicmohq.com/alternatives): the best marketing-tool alternative for solo founders.

## Public pages
- [Developer documentation](https://aicmohq.com/developers): API overview, device-flow authentication, scopes, and approval requirements.
- [OpenAPI document](https://aicmohq.com/openapi.json): machine-readable documentation for the implemented public API surface.
- [Tools](https://aicmohq.com/tools): free marketing utilities for founders.
- [UTM Builder](https://aicmohq.com/tools/utm-builder): build clean tagged links for campaigns.
- [Schema Generator](https://aicmohq.com/tools/schema-generator): generate JSON-LD for FAQ, SoftwareApplication, and Organization pages.
- [SERP & Social Preview](https://aicmohq.com/tools/serp-preview): preview titles, descriptions, and social cards before publishing.
- [Daily Trends](https://aicmohq.com/trends): live trending posts across Hacker News, GitHub, and Reddit for indie founders.
- [Tech Rankings](https://aicmohq.com/rankings): daily leaderboards of trending GitHub repos, Hacker News stories, and Reddit posts.
- [Top GitHub Repositories](https://aicmohq.com/rankings/github): ranked by stars, updated daily.
- [Top Hacker News Stories](https://aicmohq.com/rankings/hackernews): ranked by points, updated daily.
- [Top Indie Hacker Reddit Posts](https://aicmohq.com/rankings/reddit): ranked by upvotes across founder subreddits.

## About
- Audience: bootstrapped and solo SaaS founders, indie hackers.
- Positioning: the "first 10 paid users" engine, not a generic AI CMO.
- Principles: founder approval required, no auto-posting, no fake engagement, no private-data scraping.

## API notes
- The public marketing site exposes only `GET https://aicmohq.com/api/health`; authenticated API operations are served from `https://app.aicmohq.com/api/v1`.
- Device authorization start/poll endpoints on the app API do not require a bearer token. Other `/api/v1` operations require a bearer token and the documented scope.
- Device authorization approval happens in the browser and requires an active subscription. Publishing remains approval-first; an API token does not bypass human approval.
- Error responses are JSON: `{ "error": { "code", "message", "retryable" } }`. Unknown API paths return HTTP 404 with that envelope.

## MCP server
- [MCP manifest](https://aicmohq.com/mcp.json): machine-readable manifest — transport, auth env vars, tool list, and error envelope.
- [MCP documentation](https://aicmohq.com/mcp): setup for Claude, Cursor, Codex, and other MCP-capable clients.
- Transport: stdio. Command: `aicmo mcp`. Auth: bearer token via `AICMOHQ_API_KEY`.
- Tools cover site intake, opportunity scanning, drafting, queue management, approval, publishing, and credit/capability lookup.

## CLI
- `aicmo` — the AICMOHQ CLI (Bun binary, `@aicmohq/cli` in this monorepo). Authenticate with `aicmo login` (RFC 8628 device flow) or set `AICMOHQ_API_KEY`.
- [CLI guide](https://aicmohq.com/agent): authentication, scopes, and command reference.
- Tokens are scoped (`queue:read`, `queue:write`, `publish`, `connections:read`, `strategy:run`) and never bypass founder approval.

## Machine-readable index
- [llms.txt](https://aicmohq.com/llms.txt) · [sitemap.xml](https://aicmohq.com/sitemap.xml) · [openapi.json](https://aicmohq.com/openapi.json) · [mcp.json](https://aicmohq.com/mcp.json) · [robots.txt](https://aicmohq.com/robots.txt)