# ChimpanSEO - Full Context for LLMs

> AI-powered SEO & AEO article generator with automatic WordPress publishing.

## What is ChimpanSEO?

ChimpanSEO is a SaaS platform that helps businesses and content creators generate high-quality, SEO-optimized articles using AI and publish them directly to their WordPress sites. The platform combines content generation with technical SEO analysis, structured data generation, and performance tracking.

## Target Audience

- Small and medium businesses looking to scale content production
- SEO professionals and agencies
- Content marketers and bloggers
- WordPress site owners who want automated content publishing

## Core Features

### AI Article Generation
- AI-generated articles, written to be read by people and extracted by AI engines
- Generates articles optimized for GEO (Generative Engine Optimization), AEO (Answer Engine Optimization) and traditional SEO
- Applies the 9 GEO methods from Aggarwal et al., "GEO: Generative Engine Optimization" (KDD 2024), plus the Capsule Method: every section opens with a self-contained, extractable answer passage
- Supports multiple writing tones: professional, friendly, technical, narrative, authoritative, casual
- Automatic FAQ section generation for featured snippets and AI extraction
- Built-in GEO Score + AEO scoring system, evaluated per factor (direct answer, FAQ, citations, AI-fingerprint cleanliness) before publishing
- AI-fingerprint cleaner: flags and removes phrasing patterns that betray AI-generated origin
- Multi-language generation: Italian, English, Spanish, French, German, Portuguese, Dutch

### WordPress Integration
- Direct publishing to WordPress via REST API
- Supports publish, draft, and scheduled publishing
- Automatic SEO metadata injection (meta title, meta description)
- Schema.org JSON-LD structured data injection
- Category management
- WordPress credentials encrypted with AES-256-GCM

### Editorial Calendar
- Schedule articles for automatic AI generation and publishing
- Visual monthly calendar view
- Status tracking: scheduled, processing, published, failed
- Retry mechanism for failed generations
- Available on Pro and Business plans

### Google Search Console Integration
- OAuth-based connection to GSC
- Per-article performance metrics (clicks, impressions, CTR, position)
- Site-level aggregate statistics
- Available on Business plan

### SEO Analysis
- Topic suggestion engine with adjustable creativity levels
- Keyword integration from site SEO tags
- Geographic targeting for local SEO
- Article refresh/update to keep content current
- Schema.org structured data generation (Article, FAQPage, HowTo, BreadcrumbList)

### MCP Server (AI agents)

- Remote MCP server at `https://chimpanseo.app/api/mcp` (Streamable HTTP, stateless), listed in the official MCP Registry as `app.chimpanseo/chimpanseo`
- Auth: `Authorization: Bearer <API key>` (or `x-api-key`), keys created in Settings > API/MCP, full access or read-only; handshake and tools/list are public, tool calls need a key
- 13 tools: list_sites, get_usage, list_articles, get_article, suggest_topics, list_scheduled_articles, audit_site, get_generation_status, generate_article (asynchronous, returns a jobId), refresh_article, publish_article, schedule_article, cancel_scheduled_article
- Included in every plan, same monthly quota as the dashboard; setup guide for Claude Code, Cursor and Claude Desktop at https://chimpanseo.app/mcp

## Pricing Plans

| Plan | Price | Articles/month | Batch | Key Features |
|------|-------|----------------|-------|--------------|
| Free trial | €0 for 15 days | 30 | up to 5 | Full Starter feature set, no credit card required |
| Starter | €19/mo | 30 | up to 5 | WordPress publishing, GEO Score + Capsule Method |
| Pro | €59/mo | 100 | up to 10 | GEO Profiles + target-engine tuning, auto Schema.org, freshness monitor, editorial calendar |
| Business | €149/mo | 400 | up to 20 | Everything in Pro, AI-fingerprint cleaner, Google Search Console integration, priority support |

All plans are billed monthly; there is no annual plan. You can cancel at any time from the Stripe portal.

## Technical Stack

- Next.js 16 (App Router)
- TypeScript
- Supabase (PostgreSQL + Auth)
- Vercel (hosting)
- Stripe (payments)
- Resend (transactional email)

## Blog languages

The public blog is bilingual: English is the default and largest set of articles;
an Italian translation exists for any post that has one. Use `?lang=it` on `/blog`
to list only the Italian articles, or follow the `hreflang`/"Read in Italian" link
on an individual post if a translation exists. Not every English post has an
Italian translation yet - the blog listing only shows posts that exist in the
requested language.

## Pages

- **/** - Landing page with feature overview, pricing, and social proof
- **/blog** - SEO/AEO articles written and published with ChimpanSEO (dogfooding), English by default, `?lang=it` for Italian
- **/blog/[slug]** - Individual blog post
- **/mcp** - MCP server documentation: endpoint, API keys, client setup, the 13 tools, pricing
- **/about** - Who builds ChimpanSEO, what it does, how we use it ourselves
- **/contact** - How to reach us: support, privacy requests, developer questions, press
- **/signup** - Account registration
- **/login** - User login
- **/dashboard** - Main dashboard with stats and quick actions
- **/dashboard/articles/new** - AI article generation wizard
- **/dashboard/articles** - Article history
- **/dashboard/calendar** - Editorial calendar (Pro+ plans)
- **/dashboard/sites** - WordPress site management
- **/dashboard/settings** - Account settings, GSC integration
- **/dashboard/billing** - Subscription management
- **/legal/privacy** - Privacy Policy (GDPR compliant)
- **/legal/termini** - Terms of Service
- **/legal/cookie** - Cookie Policy

## Contact

- Email: hello@chimpanseo.app
- Website: https://chimpanseo.app