Witty Write Mark: 10x faster SEO content production with AI and “Narrative Angles”
Witty Write Mark is an advanced CLI tool built with TypeScript and LLMs. It scales product marketing through intelligent content orchestration—turning one product set into dozens of unique SEO narratives matched to user intent.
📋 Project metrics
- Start: May 23, 2024 (Initial Repo)
- Go-live: June 2024
- Status: Completed / Production (Skład Muzyczny)
- Role: Lead Developer / Architect
- Goal: Scale unique multi-channel content without falling into a “content factory” pattern
🚀 Project evolution (AI content workflow)
- Mode analysis & detection (Ingestion & Detection) — ingest 1–5 URLs, auto-detect relationships: Comparison vs Bundle/Set.
- Angles & intent matrix (Content Matrix) — pick 1 of 10 narrative angles + 1 of 3 intents (informational / commercial / transactional), with smart defaults.
- Context & memory (Narrative Building) — read earlier articles and build a coherent series via contextual references.
- Multi-channel distribution — SEO formats (Schema) plus native posts for LinkedIn/Facebook/Instagram/X, with optional publishing via Ocoya API.
🎯 Business problem
Content scaling easily becomes a soulless “factory,” and manual tailoring to formats, intents, and platforms is costly and slow.
❌ Pain points
- Flat content: Generic rankings with no fresh angles (e.g., myth-busting, problem-solution).
- Low leverage: One research → one article; no tool to multiply formats.
- Ignoring intent: Same text for informational and transactional queries.
- No “soul” in AI: Standard LLMs sound artificial; brand needed a unique, slightly sarcastic Tone of Voice.
💡 Why it works (engineering approach)
- Narrative Angles architecture: Enforces clear logical structures (expert-review, top-ranking, budget-comparison, etc.).
- Smart defaults: Auto-picks mode/angle, e.g., for “Guitar + Amp” → Bundle + budget-comparison.
- Zero-Click & AEO optimization: Schema (FAQPage/ItemList/Review) and formats targeting Featured Snippets (PAA).
- Persona injection: Prompt engineering removes “AI-speak,” adding witty, self-aware humor.
📈 Impact (ROI)
The system enabled aggressive, multi-channel keyword coverage without proportional team growth.
| Metric | Effect | Business value |
|---|---|---|
| Production speed | 10x faster | Rapid coverage of new trends and deliveries |
| Content leverage | 1 URL package → many formats | Maximized ROI from a single product |
| SEO/AEO quality | Optimized for 3 intents | Higher conversion (meeting user intent) |
"Witty Write Mark turned tedious description writing into intelligent SEO content orchestration. We get endless variations of professional articles from a single data source."
🛠️ Architecture & tech stack
- Core: TypeScript, Node.js (high-performance CLI with strict typing)
- AI & orchestration: Claude (Anthropic) via LangChain — for language quality and persona
- Data processing: HTML parsing, metadata extraction, local state, product compatibility validation
- Output integrations: Structured JSON for social, Markdown with advanced formatting, Ocoya/AITable API support
🚀 Summary
Witty Write Mark shows that marketing automation is not “more text” but intelligent AEO/SEO systems that understand intent and offer many compelling perspectives on the same product. Like SupplyScribe, it’s a sketch of a tool reusable in other projects, yet highly helpful in daily work.