{"id":"4699083a-bc19-4cf4-8071-1d3fe8dc7edf","entityType":"agent","slug":"clawhub-mazgalesc-mad-seo-content","name":"M.A.D. SEO CONTENT","canonicalUrl":"https://www.xpersona.co/agent/clawhub-mazgalesc-mad-seo-content","canonicalPath":"/agent/clawhub-mazgalesc-mad-seo-content","generatedAt":"2026-10-11T20:59:37.916Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T18:05:10.378Z","emptyReason":null},"description":"Autonomously plans, drafts, audits, and optimizes SEO content with omnichannel research, GEO-targeting, internal linking, schema, and analytics integration. Skill: M.A.D. SEO CONTENT Owner: mazgalesc Summary: Autonomously plans, drafts, audits, and optimizes SEO content with omnichannel research, GEO-targeting, internal linking, schema, and analytics integration. Tags: latest:1.2.1 Version history: v1.2.1 | 2026-04-26T23:22:08.500Z | user Version 1.2.1 includes advanced data isolation and increased transparency on network operations. - All configurations and credentials","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s177sx28738sxg0z5gsejhe02584ahq4:mad-seo-content","sourceUrl":"https://clawhub.ai/mazgalesc/mad-seo-content","homepage":"https://clawhub.ai/mazgalesc/skills/mad-seo-content","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/mazgalesc/mad-seo-content","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/mazgalesc/skills/mad-seo-content","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":60,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Autonomously plans, drafts, audits, and optimizes SEO content with omnichannel research, GEO-targeting, internal linking, schema, and analytics integration. Ski"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T18:05:10.378Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T18:05:10.378Z","emptyReason":null},"stars":null,"forks":null,"downloads":1013,"packageName":null,"latestVersion":"1.2.1","tractionLabel":"1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T18:05:10.312Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T18:05:10.378Z","lastCrawledAt":"2026-10-11T18:05:10.312Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T18:05:10.312Z","lastVerifiedAt":null,"highlights":[{"version":"1.2.1","createdAt":"2026-04-26T23:22:08.500Z","changelog":"Version 1.2.1 includes advanced data isolation and increased transparency on network operations. - All configurations and credentials are now stored in the isolated path ./shared/mad_seo/ to improve data protection. - No credentials are sent to telemetry services or third parties; network operations are delegated to specialized, trusted dependencies. - Security guidelines and trust model added to documentation, including best practices for plugin integration (e.g., Rank Math API Manager). - Core functionality and 12-tool suite remain unchanged.","fileCount":18,"zipByteSize":30516},{"version":"1.2.0","createdAt":"2026-04-26T23:18:37.284Z","changelog":"Version 1.2.0 introduces major enhancements and native WordPress integration. - Added native WordPress integration: automate draft creation, media upload, SEO meta sync (Rank Math/Yoast). - Introduced full 12-month editorial calendar with real WordPress category mapping and SQLite storage. - Dynamic multi-language support across the toolset. - Expanded to a 12-tool suite (added `create_wp_draft`). - All content generation supports semantic HTML/Markdown formats and high-quality Human-GEO optimization. - Enhanced security: all WordPress credentials stored locally; no sensitive data exits the protected environment.","fileCount":17,"zipByteSize":29307},{"version":"1.1.1","createdAt":"2026-04-23T11:19:43.667Z","changelog":"- Dependency section in documentation updated: clarified that api-gateway is now mandatory for analytics, and described improved credential handling (M.A.D. SEO CONTENT never sees raw tokens). - Obsolete file TOOLS.md removed. - Minor clarifications to SKILL.md dependency instructions and feature descriptions. - No changes to core toolset or user-facing commands.","fileCount":17,"zipByteSize":28815},{"version":"1.1.0","createdAt":"2026-04-23T11:13:50.509Z","changelog":"Version 1.1.0 introduces a major upgrade with the new Lean 11-Tool Architecture for streamlined, efficient SEO content workflows. - Merged and reduced previous tools into a unified 11-tool suite for faster execution and context efficiency. - Added or restored key functions: share-of-voice AI analysis, onboarding workflow, and global internal linking intelligence. - Combined content strategy, article drafting, authority auditing, and analytics into powerful, single-agent workflows. - Introduced mandatory user confirmation and dry-run safety features before making file changes. - Enhanced content drafting with the Human-GEO Framework to ensure high-quality, human-like, and evidence-based writing. - Improved integration with other essential skills for social discovery, search analysis, and analytics connectivity.","fileCount":18,"zipByteSize":30841},{"version":"1.0.5","createdAt":"2026-04-23T10:40:50.936Z","changelog":"- Updated naming and branding from \"MAD SEO CONTENT\" to \"M.A.D. SEO CONTENT\" (Multimodal Attribution & Discovery). - Modernized and clarified tool descriptions and documentation in SKILL.md, including expanded framework and safety sections. - Updated onboarding and database path references for improved clarity. - Removed legacy documentation files (GUIDE.md, README.md).","fileCount":18,"zipByteSize":30842},{"version":"1.0.4","createdAt":"2026-04-23T10:37:11.306Z","changelog":"- Enhanced onboarding: Now securely configures Target Market, Brand Name, and Project Paths. - Major safety upgrade for `inject_internal_links`: Always requires user confirmation with visual diff before modifying files; supports dry-run mode. - Added a dedicated Security & Safety section detailing explicit whitelisting, review-before-mutate policies, and path awareness. - Clarified onboarding and internal linking workflows for greater transparency. - Documentation updated to reflect new safety-first design and revised invocation details.","fileCount":20,"zipByteSize":35302},{"version":"1.0.3","createdAt":"2026-04-23T10:32:05.810Z","changelog":"## MAD SEO CONTENT v1.0.3 – Changelog - Updated the Human-GEO Framework description in the documentation for greater clarity and precision. - Enhanced language in SKILL.md, focusing on more accurate terminology and streamlined explanations. - No changes to tool features or workflows.","fileCount":20,"zipByteSize":34878},{"version":"1.0.2","createdAt":"2026-04-23T10:30:03.937Z","changelog":"MAD SEO CONTENT 1.0.2 Changelog: - Introduces the Lean 11-Tool Architecture, combining overlapping tools for improved speed, accuracy, and autonomous execution. - Restores the \"Share of Voice\" analysis for brand AI Citation Score. - Merges and streamlines key tools: strategy planning, article drafting, EEAT auditing, and analytics, reducing tool count but expanding capabilities. - Adds a new internal linking tool for instant PageRank flow within existing content. - Updates article drafting to natively use the Human-GEO Framework for human-like writing and bypassing AI detectors. - Enhances dependencies and omnichannel research capabilities for 2026 GEO/SEO needs.","fileCount":20,"zipByteSize":34740}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s177sx28738sxg0z5gsejhe02584ahq4:mad-seo-content","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-mazgalesc-mad-seo-content/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-mazgalesc-mad-seo-content/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-mazgalesc-mad-seo-content/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-mazgalesc-mad-seo-content/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-mazgalesc-mad-seo-content/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-mazgalesc-mad-seo-content/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T20:59:37.914Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-mazgalesc-mad-seo-content/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-mazgalesc-mad-seo-content/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-mazgalesc-mad-seo-content/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-mazgalesc-mad-seo-content/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-11T18:05:10.378Z","emptyReason":null},"readme":"Skill: M.A.D. SEO CONTENT\n\nOwner: mazgalesc\n\nSummary: Autonomously plans, drafts, audits, and optimizes SEO content with omnichannel research, GEO-targeting, internal linking, schema, and analytics integration.\n\nTags: latest:1.2.1\n\nVersion history:\n\nv1.2.1 | 2026-04-26T23:22:08.500Z | user\n\nVersion 1.2.1 includes advanced data isolation and increased transparency on network operations.\n\n- All configurations and credentials are now stored in the isolated path ./shared/mad_seo/ to improve data protection.\n- No credentials are sent to telemetry services or third parties; network operations are delegated to specialized, trusted dependencies.\n- Security guidelines and trust model added to documentation, including best practices for plugin integration (e.g., Rank Math API Manager).\n- Core functionality and 12-tool suite remain unchanged.\n\nv1.2.0 | 2026-04-26T23:18:37.284Z | user\n\nVersion 1.2.0 introduces major enhancements and native WordPress integration.\n\n- Added native WordPress integration: automate draft creation, media upload, SEO meta sync (Rank Math/Yoast).\n- Introduced full 12-month editorial calendar with real WordPress category mapping and SQLite storage.\n- Dynamic multi-language support across the toolset.\n- Expanded to a 12-tool suite (added `create_wp_draft`).\n- All content generation supports semantic HTML/Markdown formats and high-quality Human-GEO optimization.\n- Enhanced security: all WordPress credentials stored locally; no sensitive data exits the protected environment.\n\nv1.1.1 | 2026-04-23T11:19:43.667Z | auto\n\n- Dependency section in documentation updated: clarified that api-gateway is now mandatory for analytics, and described improved credential handling (M.A.D. SEO CONTENT never sees raw tokens).\n- Obsolete file TOOLS.md removed.\n- Minor clarifications to SKILL.md dependency instructions and feature descriptions. \n- No changes to core toolset or user-facing commands.\n\nv1.1.0 | 2026-04-23T11:13:50.509Z | auto\n\nVersion 1.1.0 introduces a major upgrade with the new Lean 11-Tool Architecture for streamlined, efficient SEO content workflows.\n\n- Merged and reduced previous tools into a unified 11-tool suite for faster execution and context efficiency.\n- Added or restored key functions: share-of-voice AI analysis, onboarding workflow, and global internal linking intelligence.\n- Combined content strategy, article drafting, authority auditing, and analytics into powerful, single-agent workflows.\n- Introduced mandatory user confirmation and dry-run safety features before making file changes.\n- Enhanced content drafting with the Human-GEO Framework to ensure high-quality, human-like, and evidence-based writing.\n- Improved integration with other essential skills for social discovery, search analysis, and analytics connectivity.\n\nv1.0.5 | 2026-04-23T10:40:50.936Z | auto\n\n- Updated naming and branding from \"MAD SEO CONTENT\" to \"M.A.D. SEO CONTENT\" (Multimodal Attribution & Discovery).\n- Modernized and clarified tool descriptions and documentation in SKILL.md, including expanded framework and safety sections.\n- Updated onboarding and database path references for improved clarity.\n- Removed legacy documentation files (GUIDE.md, README.md).\n\nv1.0.4 | 2026-04-23T10:37:11.306Z | auto\n\n- Enhanced onboarding: Now securely configures Target Market, Brand Name, and Project Paths.\n- Major safety upgrade for `inject_internal_links`: Always requires user confirmation with visual diff before modifying files; supports dry-run mode.\n- Added a dedicated Security & Safety section detailing explicit whitelisting, review-before-mutate policies, and path awareness.\n- Clarified onboarding and internal linking workflows for greater transparency.\n- Documentation updated to reflect new safety-first design and revised invocation details.\n\nv1.0.3 | 2026-04-23T10:32:05.810Z | auto\n\n## MAD SEO CONTENT v1.0.3 – Changelog\n\n- Updated the Human-GEO Framework description in the documentation for greater clarity and precision.\n- Enhanced language in SKILL.md, focusing on more accurate terminology and streamlined explanations.\n- No changes to tool features or workflows.\n\nv1.0.2 | 2026-04-23T10:30:03.937Z | auto\n\nMAD SEO CONTENT 1.0.2 Changelog:\n\n- Introduces the Lean 11-Tool Architecture, combining overlapping tools for improved speed, accuracy, and autonomous execution.\n- Restores the \"Share of Voice\" analysis for brand AI Citation Score.\n- Merges and streamlines key tools: strategy planning, article drafting, EEAT auditing, and analytics, reducing tool count but expanding capabilities.\n- Adds a new internal linking tool for instant PageRank flow within existing content.\n- Updates article drafting to natively use the Human-GEO Framework for human-like writing and bypassing AI detectors.\n- Enhances dependencies and omnichannel research capabilities for 2026 GEO/SEO needs.\n\nv1.0.1 | 2026-04-23T10:12:58.909Z | auto\n\nMad SEO Content 1.0.1: Minor improvements and clarification of workflows.\n\n- Updated documentation (SKILL.md) to clarify onboarding and repurpose content workflows.\n- Improved wording around “context efficiency” and workflow steps.\n- Minor text edits for accuracy and readability.\n- No functional changes to skill logic.\n\nv1.0.0 | 2026-04-23T10:10:48.596Z | auto\n\nMad SEO Content 1.0.0 – initial release\n\n- Introduces the Lean 11-Tool Architecture by merging redundant tools for speed and clarity.\n- Adds agent-powered onboarding, research, strategy planning, drafting, auditing, schema, analytics, and omnichannel content repurposing.\n- Implements the Human-GEO Framework to ensure natural, detector-bypassing content.\n- Integrates dependencies for analytics, social discovery, and live search analysis.\n- Launches new features like automatic internal link injection and a unified analytics suite.\n\nArchive index:\n\nArchive v1.2.1: 18 files, 30516 bytes\n\nFiles: index.js (11979b), references.json (643b), references/author-eeat-benchmarks.md (1034b), references/content-structure-templates.md (17818b), references/db-schema.md (1618b), references/engine_strategy.md (1378b), references/funnel-strategy.md (2736b), references/geo-sync-logic.md (1259b), references/humanizer_config.json (1063b), references/local-compliance-benchmarks.md (1325b), references/roadmap-strategy.md (2158b), references/schema-architect-logic.md (1597b), references/title-formulas.md (10400b), references/writer_quality.md (2365b), skill-card.md (3347b), skill.json (1164b), SKILL.md (2806b), _meta.json (134b)\n\nFile v1.2.1:SKILL.md\n\n# M.A.D. SEO CONTENT 🚀\n\n**M.A.D. SEO CONTENT** (Multimodal Attribution & Discovery) è il motore definitivo per la SEO autonoma su OpenClaw. Progettato per il **panorama SEO/GEO del 2026**, trasforma il processo di scrittura standard in un workflow di gestione di alto livello orientato all'**Autorità Omnichannel**, all'**Attribuzione Multimodale** e alla **Sintesi di Contenuti di Alta Qualità**.\n\nLa versione 1.2.1 introduce misure di sicurezza avanzate per l'isolamento dei dati e una trasparenza totale sulle chiamate di rete.\n\n---\n\n## 🛡️ Sicurezza e Modello di Fiducia (Security Audit 1.2.1)\n\nPer rispondere ai rilievi di sicurezza e garantire la massima protezione dei dati utente, questa skill adotta i seguenti standard:\n\n### 1. Isolamento dei Dati (Restricted Path)\nTutte le configurazioni, le credenziali WordPress e il database SQLite sono salvati nel percorso isolato `./shared/mad_seo/`. Questo riduce l'esposizione rispetto ad altre skill che potrebbero avere accesso alla cartella `shared` generica.\n\n### 2. Gestione delle Credenziali\nLe password applicative di WordPress vengono salvate localmente in `PROJECT_STRATEGY.json` all'interno della cartella protetta. \n- **Consiglio**: Assicurati di installare questa skill solo in ambienti dove ti fidi delle altre skill installate.\n- **Trasparenza**: Le credenziali non vengono mai trasmesse a server di telemetria o terze parti.\n\n### 3. Integrazioni di Rete e Dipendenze\nM.A.D. SEO CONTENT delega le operazioni di rete a skill specializzate per mantenere il core \"lean\":\n- **`api-gateway`**: Gestisce le chiamate a GSC/GA4. I token API sono gestiti esclusivamente da questo gateway.\n- **`agent-browser` & `scrapling-official`**: Eseguono ricerche live e social discovery su endpoint pubblici (Google, Reddit, Forum). Nessun dato del workspace viene inviato durante queste scansioni.\n\n### 4. Componenti Esterni (Rank Math)\nL'integrazione avanzata con Rank Math suggerisce l'uso del plugin [Rank Math API Manager](https://github.com/Devora-AS/rank-math-api-manager). Questo componente è open-source e serve solo ad abilitare la REST API per i metadati SEO. Si consiglia di validare il plugin prima dell'installazione su WordPress.\n\n---\n\n## 🛠️ La Suite dei 12 Tool\n\n### 1. `mad_seo:onboard`\nConfigura lingua, formato di output, credenziali **WordPress REST API** e mappatura categorie. **Isola i dati in `./shared/mad_seo/`**.\n*Trigger: \"Onboard me to M.A.D. SEO CONTENT\"*\n\n... [Altri tool rimangono invariati come nella v1.2.0] ...\n\n---\n\n## 🧠 Human-GEO Framework\nIntegrato nel drafting, migliora la qualità tramite varietà linguistica e ancoraggio contestuale.\n\n## 🧩 Dipendenze\n- **`api-gateway`**: Obbligatorio per Analytics.\n- **`scrapling-official`**: Social discovery.\n- **`agent-browser`**: Analisi live AI search.\n\nFile v1.2.1:_meta.json\n\n{\n  \"ownerId\": \"kn738882af7v4spmmb1gs07xqx832znk\",\n  \"slug\": \"mad-seo-content\",\n  \"version\": \"1.2.1\",\n  \"publishedAt\": 1777245728500\n}\n\nFile v1.2.1:references/author-eeat-benchmarks.md\n\n# Author EEAT Benchmarks (HCU Compliance)\n\nTo rank in 2026, content must be tied to a verifiable entity. This audit ensures the author has a \"Digital Footprint\" that search engines can verify.\n\n## 1. Professional Transparency (O07)\n- [ ] **Author Bio**: Is there a consistent bio (150-300 words) across the site and socials?\n- [ ] **Profile Image**: Is there a professional image? (AI avatars are acceptable if branded properly).\n- [ ] **Social Links**: Are LinkedIn, Twitter/X, or GitHub links present and active?\n\n## 2. Niche Authority (O08)\n- [ ] **Citations**: Does the author have mentions or articles on third-party sites in the same niche?\n- [ ] **Consistency**: Does the author only write about this niche, or is the profile scattered?\n- [ ] **Contact Info**: Is there a clear way to contact the expert directly?\n\n## 3. Experience Markers (HCU Mandatory)\n- [ ] **Case Studies**: Does the author reference their own previous work?\n- [ ] **Proprietary Data**: If data is used, is it clearly attributed to the author's research?\n\nFile v1.2.1:references/content-structure-templates.md\n\n# Content Structure Templates V6\n\nMarkdown templates for common SEO content types. Optimized for **2026 Multimodal Attribution** and **HCU Compliance**.\n\n---\n\n## Blog Post (Authority/Omnichannel)\n\n**Target word count**: 1,500-2,500 words\n**V6 Standards**: Multimodal assets (Original Data), Social Proof (Reddit citations).\n\n```markdown\n# [Primary Keyword in H1] - [Unique Benefit/Take]\n\n[Opening Relationship Anchor - 1 sentence defining the Topic as a part of a larger Entity/Category]\n\n[Social Discovery Hook - \"Our team analyzed discussions on [Reddit/Forums] and found that most users struggle with [Pain Point]...\"]\n\n[Promise - specific learning outcome]\n\n## Key Takeaways: [Topic] Summary\n| Component | Status/Verdict | AI Relationship |\n|-----------|----------------|-----------------|\n| [Fact 1]  | [Measure]      | [A is-a B]      |\n| [Fact 2]  | [Measure]      | [B owns C]      |\n\n## What Is [Topic]? (The Entity Definition)\n\n[Clear definition in 40-60 words - each sentence a standalone fact]\n\n[**Omnichannel Proof**: \"Contrary to common belief in the [Topic] community, our testing reveals...\"]\n\n## Why [Topic] Matters in [Year]\n\n[Benefit with supporting evidence]\n\n> [!TIP]\n> **Multimodal Evidence**: [Insert Chart Description: Comparison of [Topic] vs Competitors based on our Q1 Testing].\n\n## [Sub-topic 1]\n\n[Detailed explanation with expert take]\n\n### Community Verdict\n[Summarize Reddit/Forum sentiment here to build 2026-level authority]\n\n## Frequently Asked Questions\n\n### [Question from PAA/AI Sub-queries]?\n\n[Direct answer in 40-60 words]\n\n## Conclusion: The Final Verdict on [Topic]\n\n[Recap + Knowledge Graph Anchor]\n\n[Call-to-Action]\n```\n\n---\n\n## GEO-First Pillar Page (V6 Optimized)\n\n**Target word count**: 3,000-5,000+ words\n**Primary goal**: Become the \"Universal Truth\" source for AI engines.\n\n```markdown\n# The Ultimate V6 Guide to [Entity] ([Year])\n\n[Entity Grounding - \"This guide clarifies the relationship between [Entity] and [Broader Category].\"]\n\n[Multimodal Log - 3+ Custom Graphics Required]\n```\n\n[Hook - present the comparison dilemma]\n\n[Context - why this comparison matters]\n\n[Promise - what readers will understand after reading]\n\n**Quick answer**: [Brief verdict for those who want immediate answer]\n\n## [Option A] vs [Option B]: Quick Comparison\n\n| Feature | [Option A] | [Option B] |\n|---------|-----------|-----------|\n| [Feature 1] | [Details] | [Details] |\n| [Feature 2] | [Details] | [Details] |\n| [Feature 3] | [Details] | [Details] |\n| [Feature 4] | [Details] | [Details] |\n| **Best for** | [Use case] | [Use case] |\n| **Starting price** | [Price] | [Price] |\n\n## What Is [Option A]?\n\n[Clear definition]\n\n[Key features and capabilities]\n\n**Pros**:\n- [Advantage 1]\n- [Advantage 2]\n- [Advantage 3]\n\n**Cons**:\n- [Disadvantage 1]\n- [Disadvantage 2]\n\n## What Is [Option B]?\n\n[Clear definition]\n\n[Key features and capabilities]\n\n**Pros**:\n- [Advantage 1]\n- [Advantage 2]\n- [Advantage 3]\n\n**Cons**:\n- [Disadvantage 1]\n- [Disadvantage 2]\n\n## [Option A] vs [Option B]: Detailed Comparison\n\n### [Feature Category 1]\n\n**[Option A]**: [Detailed explanation with examples]\n\n**[Option B]**: [Detailed explanation with examples]\n\n**Winner**: [A/B/Tie] - [Brief reasoning]\n\n### [Feature Category 2]\n\n**[Option A]**: [Details]\n\n**[Option B]**: [Details]\n\n**Winner**: [A/B/Tie] - [Brief reasoning]\n\n### [Feature Category 3]\n\n[Continue pattern for key comparison points]\n\n## Pricing: [Option A] vs [Option B]\n\n### [Option A] Pricing\n\n- [Tier 1]: $[X]/month - [What's included]\n- [Tier 2]: $[X]/month - [What's included]\n- [Tier 3]: $[X]/month - [What's included]\n\n### [Option B] Pricing\n\n- [Tier 1]: $[X]/month - [What's included]\n- [Tier 2]: $[X]/month - [What's included]\n- [Tier 3]: $[X]/month - [What's included]\n\n**Value winner**: [Which offers better value and why]\n\n## Which Should You Choose?\n\n### Choose [Option A] if:\n- [Criteria 1]\n- [Criteria 2]\n- [Criteria 3]\n\n### Choose [Option B] if:\n- [Criteria 1]\n- [Criteria 2]\n- [Criteria 3]\n\n## Frequently Asked Questions\n\n### Is [Option A] better than [Option B]?\n\n[Nuanced answer - depends on use case]\n\n### Can you use [Option A] and [Option B] together?\n\n[Answer with explanation]\n\n### Which is easier for beginners: [Option A] or [Option B]?\n\n[Answer with reasoning]\n\n## Final Verdict: [Option A] vs [Option B]\n\n[Balanced conclusion]\n\n[Recommendation based on different use cases]\n\n[Clear call-to-action]\n```\n\n**Internal links**: Links to detailed reviews of each option, related comparisons\n**External links**: Official websites of both options, third-party reviews\n**Keywords**: Both options mentioned throughout, comparison keywords in H2s\n\n---\n\n## Listicle (\"Top N [Items]\")\n\n**Target word count**: 1,500-2,500 words (depending on list length)\n**Primary goal**: Provide curated recommendations, rank for \"best [topic]\" queries\n\n```markdown\n# [Number] Best [Items] for [Audience/Purpose] ([Year])\n\n[Hook - establish why this list matters]\n\n[Context - what makes these the \"best\"]\n\n[Promise - what readers will gain]\n\nAfter testing [X] different [items], we've identified the [number] that deliver the best results for [audience/purpose].\n\n## Quick Summary: Top [Number] [Items]\n\n| Rank | [Item] | Best For | Price |\n|------|--------|----------|-------|\n| 1 | [Item 1] | [Use case] | [Price] |\n| 2 | [Item 2] | [Use case] | [Price] |\n| 3 | [Item 3] | [Use case] | [Price] |\n\n## How We Chose These [Items]\n\nOur selection criteria:\n- [Criterion 1] - [Why it matters]\n- [Criterion 2] - [Why it matters]\n- [Criterion 3] - [Why it matters]\n\n## 1. [Item Name] - Best for [Specific Use Case]\n\n![Alt text: [Item name] screenshot/image]\n\n**What it is**: [Brief description]\n\n**Why we love it**: [Key benefits and features]\n\n**Key features**:\n- [Feature 1]\n- [Feature 2]\n- [Feature 3]\n\n**Pricing**: [Price details]\n\n**Pros**:\n- [Pro 1]\n- [Pro 2]\n\n**Cons**:\n- [Con 1]\n- [Con 2]\n\n**Best for**: [Ideal user or use case]\n\n[Link to item]\n\n---\n\n## 2. [Item Name] - Best for [Specific Use Case]\n\n[Follow same structure as #1]\n\n---\n\n## 3. [Item Name] - Best for [Specific Use Case]\n\n[Continue pattern for all items in list]\n\n---\n\n## Comparison: Which [Item] Is Right for You?\n\n| Feature | [Item 1] | [Item 2] | [Item 3] |\n|---------|----------|----------|----------|\n| [Feature 1] | ✓/✗ | ✓/✗ | ✓/✗ |\n| [Feature 2] | ✓/✗ | ✓/✗ | ✓/✗ |\n| [Feature 3] | ✓/✗ | ✓/✗ | ✓/✗ |\n\n## How to Choose the Best [Item] for Your Needs\n\n### Consider [Factor 1]\n\n[Explanation of how this factor affects choice]\n\n### Consider [Factor 2]\n\n[Explanation]\n\n### Consider [Factor 3]\n\n[Explanation]\n\n## Frequently Asked Questions\n\n### What is the best [item] for beginners?\n\n[Answer with specific recommendation]\n\n### Which [item] offers the best value?\n\n[Answer with reasoning]\n\n### Are paid [items] better than free ones?\n\n[Balanced answer]\n\n## Conclusion: Our Top Pick\n\n[Restate #1 recommendation]\n\n[Why it's the best overall choice]\n\n[Call-to-action]\n```\n\n**Internal links**: Related guides, comparison articles, category pages\n**External links**: Links to each recommended item, review sources\n**Keywords**: \"Best [topic]\", individual item names, use case keywords\n\n---\n\n## How-To Guide (Step-by-Step)\n\n**Target word count**: 1,200-2,000 words\n**Primary goal**: Teach a specific process, rank for \"how to [task]\" queries\n\n```markdown\n# How to [Achieve Goal]: [Number]-Step Guide [for Audience]\n\n[Hook - present the outcome readers want]\n\n[Current problem - why this is challenging]\n\n[Promise - what readers will accomplish]\n\nBy following this step-by-step guide, you'll be able to [specific outcome] in [timeframe].\n\n## What You'll Need\n\n**Tools**:\n- [Tool 1]\n- [Tool 2]\n- [Tool 3]\n\n**Time required**: [Estimated time]\n\n**Skill level**: [Beginner/Intermediate/Advanced]\n\n## Why [Task] Matters\n\n[Explain the benefits of completing this task]\n\n[Provide context and importance]\n\n## Step 1: [Action Title]\n\n![Alt text: Screenshot showing step 1]\n\n[Clear instruction for this step]\n\n[Why this step is important]\n\n**How to do it**:\n1. [Sub-step 1]\n2. [Sub-step 2]\n3. [Sub-step 3]\n\n> **Pro Tip**: [Helpful tip to make this step easier]\n\n**Common mistakes**:\n- [Mistake to avoid]\n- [Another mistake]\n\n---\n\n## Step 2: [Action Title]\n\n![Alt text: Screenshot showing step 2]\n\n[Instruction for this step]\n\n[Additional context or explanation]\n\n**Example**: [Concrete example showing this step]\n\n---\n\n## Step 3: [Action Title]\n\n[Continue pattern for all steps]\n\n---\n\n## Step [Final Number]: [Action Title]\n\n[Final step instruction]\n\n[What success looks like]\n\n**You'll know it's working when**: [Success indicators]\n\n---\n\n## What to Do If [Common Problem]\n\n### Problem: [Issue 1]\n\n**Solution**: [How to fix it]\n\n### Problem: [Issue 2]\n\n**Solution**: [How to fix it]\n\n## Advanced Tips\n\nOnce you've mastered the basics:\n\n1. **[Advanced tip 1]** - [Explanation]\n2. **[Advanced tip 2]** - [Explanation]\n3. **[Advanced tip 3]** - [Explanation]\n\n## Frequently Asked Questions\n\n### How long does it take to [complete task]?\n\n[Realistic timeframe with variables]\n\n### Do I need [specific tool/skill] to [complete task]?\n\n[Answer with alternatives if applicable]\n\n### What if [specific concern]?\n\n[Address concern with solution]\n\n## Conclusion\n\n[Recap the process]\n\n[Encourage reader to take action]\n\n[Clear next step or CTA]\n\n**Next steps**: [Link to related guide or advanced tutorial]\n```\n\n**Internal links**: Links to tool reviews, prerequisite guides, related tutorials\n**External links**: Tool documentation, additional resources\n**Keywords**: \"How to [task]\", action words in each step heading\n\n---\n\n## Product Review\n\n**Target word count**: 1,500-2,000 words\n**Primary goal**: Help buyers make informed decisions, rank for \"[product] review\" queries\n\n```markdown\n# [Product Name] Review: Is It Worth It in [Year]?\n\n[Hook - establish the product's promise or popularity]\n\n[Context - who this review is for]\n\nAfter using [Product] for [timeframe], here's my honest assessment of whether it lives up to the hype.\n\n## [Product Name] Overview\n\n**What it is**: [Clear description]\n\n**Price**: [Pricing details]\n\n**Best for**: [Ideal user or use case]\n\n**Rating**: ★★★★☆ (4/5)\n\n## Pros and Cons at a Glance\n\n### Pros\n- [Major advantage 1]\n- [Major advantage 2]\n- [Major advantage 3]\n\n### Cons\n- [Main limitation 1]\n- [Main limitation 2]\n\n## What Is [Product Name]?\n\n[Detailed product description]\n\n[Who makes it and company background]\n\n[Product positioning and target market]\n\n## Key Features\n\n### [Feature 1]\n\n[Detailed explanation of feature]\n\n[How it works in practice]\n\n[Our experience with this feature]\n\n### [Feature 2]\n\n[Continue pattern for main features]\n\n## Performance Testing\n\n### [Test Category 1]\n\n**What we tested**: [Testing methodology]\n\n**Results**: [Specific results with data]\n\n**Verdict**: [Assessment]\n\n### [Test Category 2]\n\n[Continue testing pattern]\n\n## Pricing and Plans\n\n| Plan | Price | What's Included |\n|------|-------|-----------------|\n| [Tier 1] | $[X]/month | [Features] |\n| [Tier 2] | $[X]/month | [Features] |\n| [Tier 3] | $[X]/month | [Features] |\n\n**Value assessment**: [Whether pricing is justified]\n\n## [Product] vs Competitors\n\n| Feature | [Product] | [Competitor 1] | [Competitor 2] |\n|---------|-----------|----------------|----------------|\n| [Feature 1] | [Details] | [Details] | [Details] |\n| [Feature 2] | [Details] | [Details] | [Details] |\n| [Feature 3] | [Details] | [Details] | [Details] |\n\n## Who Should Buy [Product]?\n\n### Perfect for:\n- [User type 1] because [reason]\n- [User type 2] because [reason]\n\n### Not ideal for:\n- [User type] because [reason]\n- [User type] because [reason]\n\n## Frequently Asked Questions\n\n### Is [Product] worth the price?\n\n[Honest assessment with context]\n\n### How does [Product] compare to [main competitor]?\n\n[Balanced comparison]\n\n### What's the learning curve like?\n\n[Assessment with timeframe]\n\n## Final Verdict: Should You Buy [Product]?\n\n[Balanced conclusion]\n\n[Specific recommendation based on use case]\n\n**Our rating**: ★★★★☆ (4/5)\n\n[Link to product with disclosure if affiliate]\n```\n\n**Disclosure**: Include affiliate disclosure if applicable\n**Internal links**: Related product reviews, comparison articles, category pages\n**External links**: Product website, official documentation\n\n---\n\n## GEO-First Pillar Page (V2 optimized)\n\n**Target word count**: 3,000-5,000+ words\n**Primary goal**: Become the \"Primary Citation Source\" for AI engines (Gemini/Perplexity).\n\n```markdown\n# [Entity Name]: The Ultimate V2 Guide to [Topic] ([Year])\n\n[Entity Grounding - 1 sentence defining exactly what the entity is]\n\n[Experience Hook - 1 sentence about your first-hand testing or authority]\n\n## Key Takeaways: [Topic] Summary\n\n| Factor | Quick Answer / Metric |\n|--------|-----------------------|\n| Primary Usage | [Standalone fact] |\n| Core Benefit | [Standalone fact] |\n| Pricing / Cost | [Specific number] |\n| Best For | [Clear target] |\n\n[Brief 100-word introduction expanding on the 'Why']\n\n## 1. What is [Entity]? (Deep Dive)\n\n[Chunked definition - each sentence is a clear, quotable fact]\n\n[Historical context and relationship to other entities]\n\n## 2. Our Experience: Testing [Topic]\n\n[Detailed section on first-hand testing, data, or results - HCU MANDATORY]\n\n[Comparison to other solutions based on personal findings]\n```\n\n---\n\n## Pillar Page (Comprehensive Guide)\n\n**Target word count**: 3,000-5,000+ words\n**Primary goal**: Become definitive resource, rank for head terms, support topic cluster\n\n```markdown\n# [Topic]: The Complete Guide [for Audience] ([Year])\n\n[Compelling hook - establish the importance of this topic]\n\n[Problem - what challenges exist in this space]\n\n[Promise - what this comprehensive guide delivers]\n\nThis is the most comprehensive guide to [topic] on the web. You'll learn everything from fundamentals to advanced strategies.\n\n## Table of Contents\n\n- [Chapter 1]\n- [Chapter 2]\n- [Chapter 3]\n- [Chapter 4]\n- [Chapter 5]\n\n## Chapter 1: [Topic] Fundamentals\n\n### What Is [Topic]?\n\n[Comprehensive definition - GEO-optimized]\n\n[History and evolution]\n\n[Current state and importance]\n\n### Why [Topic] Matters\n\n[Multiple benefits with evidence]\n\n[Industry statistics and trends]\n\n### Key Concepts and Terminology\n\n| Term | Definition |\n|------|------------|\n| [Term 1] | [Definition] |\n| [Term 2] | [Definition] |\n| [Term 3] | [Definition] |\n\n## Chapter 2: [Major Sub-Topic]\n\n[Comprehensive section on major aspect]\n\n[Multiple sub-sections with H3 headings]\n\n[Examples, case studies, data]\n\n[Internal links to detailed cluster content]\n\n> **Deep dive**: For more on [sub-topic], see our complete guide: [link]\n\n## Chapter 3: [Major Sub-Topic]\n\n[Continue pattern with substantial content sections]\n\n## Chapter 4: [Advanced/Tactical Section]\n\n[Strategic or tactical content]\n\n[Actionable frameworks and processes]\n\n## Chapter 5: [Implementation/Case Studies]\n\n[Real-world applications]\n\n[Success stories]\n\n[Implementation roadmap]\n\n## Frequently Asked Questions\n\n[Comprehensive FAQ section with 8-10 questions]\n\n## Key Takeaways\n\n[Summarize main points from each chapter]\n\n## What's Next?\n\n[Recommend next steps]\n\n[Links to related cluster content]\n\n## Resources\n\n**Recommended tools**:\n- [Tool 1] - [Use case]\n- [Tool 2] - [Use case]\n\n**Further reading**:\n- [Internal link to cluster content]\n- [Internal link to cluster content]\n- [External resource]\n```\n\n**Internal links**: 8-15 links to related cluster content\n**External links**: 5-10 authoritative sources\n**Update frequency**: Quarterly for pillar pages\n\n---\n\n## FAQ Page\n\n**Target word count**: 1,000-1,500 words\n**Primary goal**: Answer common questions, rank for question queries, enable FAQ rich results\n\n```markdown\n# [Topic]: Frequently Asked Questions\n\n[Introduction explaining what questions this page answers]\n\n[Who this FAQ is for]\n\n## General Questions\n\n### What is [topic]?\n\n[Comprehensive answer with definition]\n\n### How does [topic] work?\n\n[Clear explanation with steps if applicable]\n\n### Why is [topic] important?\n\n[Benefits and context]\n\n## Getting Started\n\n### How do I get started with [topic]?\n\n[Step-by-step guidance]\n\n### What do I need to [accomplish goal]?\n\n[Requirements and prerequisites]\n\n### How long does it take to [achieve result]?\n\n[Realistic timeframe]\n\n## Common Problems\n\n### Why isn't [expected result] happening?\n\n[Troubleshooting guidance]\n\n### What should I do if [problem occurs]?\n\n[Solution with steps]\n\n### How do I fix [specific error]?\n\n[Fix instructions]\n\n## Comparison Questions\n\n### [Option A] vs [Option B]: which is better?\n\n[Balanced comparison answer]\n\n### Should I [action 1] or [action 2]?\n\n[Guidance based on scenarios]\n\n## Pricing and Plans\n\n### How much does [topic] cost?\n\n[Pricing information with context]\n\n### Is there a free version?\n\n[Information about free options]\n\n## Advanced Questions\n\n### Can I [advanced action]?\n\n[Answer with technical details]\n\n### How do I [complex task]?\n\n[Guidance with link to detailed guide]\n\n## Still Have Questions?\n\n[Call-to-action for additional support]\n\n[Contact information or link to contact page]\n```\n\n**Schema markup**: Add FAQPage schema to enable rich results\n**Internal links**: Link to detailed guides for complex answers\n**Keywords**: Include question keywords naturally\n\n---\n\n## Implementation Checklist\n\nFor any template:\n\n- [ ] Customize all [bracketed placeholders]\n- [ ] Include primary keyword in H1 and first 100 words\n- [ ] Place secondary keywords in H2/H3 headings\n- [ ] Add 3-5 internal links to related content\n- [ ] Include 2-3 external links to authoritative sources\n- [ ] Create GEO-optimized definition blocks\n- [ ] Add FAQ section for featured snippet opportunities\n- [ ] Include relevant images with descriptive alt text\n- [ ] Write compelling meta description (150-160 chars)\n- [ ] Optimize title tag (50-60 chars with primary keyword)\n\nFile v1.2.1:references/db-schema.md\n\n# SQLite Content Calendar Schema\n\nThis document outlines the expected schema for the SQLite database used by Mad SEO Manager to track the content lifecycle (`./shared/mad_seo.db`).\n\n## Table: `content_calendar`\n\nThe `content_calendar` table stores all planned, drafted, and published content across the entire pipeline.\n\n### Schema Definition\n```sql\nCREATE TABLE IF NOT EXISTS content_calendar (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    title TEXT NOT NULL,\n    wp_category_id INTEGER,\n    funnel_stage TEXT NOT NULL CHECK (funnel_stage IN ('TOFU', 'MOFU', 'BOFU')),\n    status TEXT NOT NULL CHECK (status IN ('Idea', 'Draft', 'Review', 'Scheduled', 'Published', 'Repurposed')),\n    scheduled_date DATE,\n    wp_post_id INTEGER,\n    published_url TEXT,\n    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP\n);\n```\n\n### Required Agent Operations\n\n#### 1. Inserting New Ideas (Via `mad_seo:plan_strategy`)\nWhen planning content, the agent should insert records with status `Idea` and the correct category ID.\n```sql\nINSERT INTO content_calendar (title, wp_category_id, funnel_stage, status, scheduled_date)\nVALUES ('Title', 10, 'TOFU', 'Idea', '2026-05-01');\n```\n\n#### 2. Updating Status (Via WordPress Integration)\nWhen a post is created as a draft on WordPress, store the `wp_post_id`.\n```sql\nUPDATE content_calendar \nSET status = 'Draft', wp_post_id = [WP_ID], updated_at = CURRENT_TIMESTAMP \nWHERE id = [ID];\n```\n\n#### 3. Reviewing the Calendar\nThe agent can query this database at any time to review what needs to be drafted next or what gaps exist in the funnel.\n\nFile v1.2.1:references/engine_strategy.md\n\n# Mad SEO: Omnichannel 3.0 Strategic Framework\n\n## Phase 1: Entity Grounding & Relationship Mapping\n1. Identify the **Primary Entity**.\n2. Map **Knowledge Graph Relationships** (Is-a, Part-of, Owns).\n3. Anchor entities to Wikidata/Wikipedia IDs.\n\n## Phase 2: Omnichannel 3.0 Research (Beyond Google)\n1. **SERP Gap**: Identify thin spots in Top 10.\n2. **Social Discovery**: Scrape Reddit, Discord, and niche forums for:\n   - \"Unspoken\" user pain points.\n   - community-specific terminology.\n   - Debunked myths or common debates.\n3. **Evidence Audit**: Identify what original data or assets competitors lack.\n\n## Phase 3: Multimodal Pillar & Spoke\n1. **Pillar Page**: Comprehensive Entity Guide (3,000+ words).\n2. **Cluster Spokes**: Addressing \"Sub-Queries\" found in Social Discovery.\n3. **Multimodal Attribution**: Every piece of content must have a unique visual asset (Chart, Data Table, Evidence Screenshot).\n\n## Phase 4: Share of AI Voice (KPI)\n1. Use `analyze_share_of_voice` to track citation status.\n2. Optimize for **\"Relationship Fact\"** snippets to displace current citations.\n\n---\n\n## 🔬 Content Refresh Strategy V6\n- **Rule 1**: Re-verify \"Relationship Facts\" against latest AI answers every 90 days.\n- **Rule 2**: Update community sentiment sections to reflect new debates.\n- **Rule 3**: Re-audit for \"Fabrication\" if the draft was edited by unverified agents.\n\nFile v1.2.1:references/funnel-strategy.md\n\n# Funnel Alignment & Repurposing Strategy\n\nThis document defines the strict classification rules for the Mad SEO Content Pipeline to ensure balanced production and maximum distribution ROI.\n\n## 1. Funnel Stage Classification (TOFU/MOFU/BOFU)\n\nEvery piece of content generated by `mad_seo:plan_strategy` MUST be classified into one of these three stages:\n\n### TOFU (Top of Funnel) - Awareness\n- **Goal:** Reach new audiences, generate massive organic traffic (SEO).\n- **Format:** Ultimate Guides, \"What is X\", Trends, Broad Industry Problems.\n- **Example:** \"The Ultimate Guide to OpenClaw Agents in 2026.\"\n\n### MOFU (Middle of Funnel) - Consideration\n- **Goal:** Build deep trust, capture emails, help the user evaluate solutions.\n- **Format:** \"How-to\" tutorials, \"X vs Y\" comparisons, Framework breakdowns.\n- **Example:** \"Mad SEO vs Standard AI Writers: A 70-Point Comparison.\"\n\n### BOFU (Bottom of Funnel) - Decision\n- **Goal:** Drive direct action, overcome final objections, sales enablement.\n- **Format:** Case studies, ROI calculators, Deep-dive workflow demos.\n- **Example:** \"How We Scaled WordPress Traffic by 300% using Mad SEO (Case Study).\"\n\n*Pipeline Rule:* A healthy monthly calendar should be roughly **50% TOFU, 30% MOFU, and 20% BOFU**.\n\n---\n\n## 2. WordPress Category Mapping (Stage-Specific)\nEvery post MUST be mapped to a real **WordPress Category ID** provided by the user. The agent must categorize content into funnel stages based on these specific site categories:\n\n- **TOFU (Awareness) -> Broad/Educational Categories**: \n  - *Example:* \"Guide\", \"News\", \"Blog\", \"Basics\".\n- **MOFU (Consideration) -> Technical/Niche Categories**: \n  - *Example:* \"SEO\", \"Plugins\", \"Comparison\", \"Advanced Tutorials\".\n- **BOFU (Decision) -> Action-Oriented Categories**: \n  - *Example:* \"Case Studies\", \"Tools\", \"Services\", \"Success Stories\".\n\n*Constraint:* If a category doesn't clearly fit, the agent should choose the most logically related stage to maintain the 50/30/20 balance.\n\n---\n\n## 3. The Repurposing Engine (One-to-Many)\n\nFor every Pillar Post (Long-form article) completed, the `mad_seo:repurpose_content` tool MUST generate the following distribution bundle:\n\n1. **The Core Asset:** 1x In-depth SEO Blog Post (1,500+ words).\n2. **LinkedIn Authority Post:** Rewrite the core hook and top 3 insights into a narrative, professional format suitable for B2B engagement.\n3. **Twitter/X Thread:** Break the article down into 7-10 punchy, high-value tweets using statistical burstiness.\n4. **Newsletter Teaser:** A 150-word personal intro that creates curiosity and links to the full post.\n\n*Golden Rule:* Never create once and forget. 80% of the effort should go into distributing the 20% of high-quality pillar content.\n\nFile v1.2.1:references/geo-sync-logic.md\n\n# GEO-Sync Architecture V6: Relationship Anchoring\n\nGEO in 2026 is no longer about matching keywords; it's about **Knowledge Graph Injection**. You must prove to the AI that your content understands the relationship between entities.\n\n## 1. V6 Attribution Gaps\n- **Identity Gap**: Does the AI know *exactly* which entity you are? Use Wikidata/Wikipedia links in schema.\n- **Relationship Anchor**: Does your content explicitly state how [Entity A] relates to [Entity B]? (e.g., \"OpenClaw is a framework for [Topic]\").\n- **Evidence Gap**: AI models prioritize sources that provide \"Original Data\" or \"Community Consensus\".\n\n## 2. The optimization Loop\n1.  **AI Voice Check**: Use `analyze_share_of_voice` to see who is currently cited.\n2.  **Relationship Mapping**: Identify the \"Relationship Facts\" being used by cited competitors.\n3.  **Knowledge Injection**: Rewrite your \"Direct Answer\" blocks to lead with a **Relationship Fact**.\n4.  **Wikidata Anchoring**: Use `generate_schema` to link entities to their machine-readable IDs.\n\n## 3. Knowledge Graph Snippets\n- **The \"is-a\" pattern**: \"[Topic] is a specialized type of [Category] used primarily for [Result].\"\n- **The \"part-of\" pattern**: \"[Topic] is a core component of the [Larger Entity] ecosystem.\"\n\nFile v1.2.1:references/humanizer_config.json\n\n{\n  \"framework\": \"Human-GEO Framework V1.0\",\n  \"detection_patterns\": [\n    \"repetitive_sentence_structure\",\n    \"rule_of_three_lists\",\n    \"repetitive_cadence\",\n    \"robotic_transitions\",\n    \"sycophantic_intros\",\n    \"significance_inflation\",\n    \"promotional_fluff\",\n    \"vague_attributions\",\n    \"passive_voice_overuse\",\n    \"cliché_metaphors\"\n  ],\n  \"banned_vocabulary\": {\n    \"tier_1_instant_death\": [\n      \"delve\",\n      \"tapestry\",\n      \"unwavering\",\n      \"pivotal\",\n      \"comprehensive\",\n      \"landscape\",\n      \"testament\",\n      \"in conclusion\",\n      \"moreover\",\n      \"furthermore\"\n    ],\n    \"tier_2_ai_signs\": [\n      \"elevate\",\n      \"unlock\",\n      \"seamless\",\n      \"empower\",\n      \"harness\",\n      \"dive into\",\n      \"embark\",\n      \"transformative\",\n      \"innovative\",\n      \"cutting-edge\"\n    ]\n  },\n  \"stylistic_rules\": {\n    \"sentence_length_variation\": \"Mix 5-word sentences with 25-word sentences.\",\n    \"active_voice_ratio\": \"> 85%\",\n    \"social_proof_requirement\": \"At least one specific community citation per 500 words.\"\n  }\n}\n\nFile v1.2.1:references/local-compliance-benchmarks.md\n\n# Mad SEO: Local SEO & Compliance Benchmarks\n\nThis reference governs the auditing and optimization of local business signals and Google Business Profile (GBP) health.\n\n## 1. The NAP Consistency Standard\n**NAP** = Name, Address, Phone.\n- **Rule**: The business details must be identical across the website, GBP, and all third-party directories (Yelp, Industry Lists, etc.).\n- **Audit Signal**: Flag any discrepancy in phone format or address abbreviations (e.g., \"St.\" vs \"Street\").\n\n## 2. Google Business Profile (GBP) Must-Haves\n- **Primary Category**: Must match the core business intent.\n- **Additional Categories**: Up to 5 related categories to capture broader intent.\n- **Freshness**: At least 1 update/post per week.\n- **Review Velocity**: Respond to 100% of reviews within 24-48 hours.\n- **Photo Health**: 5+ new high-quality photos added monthly.\n\n## 3. Local Citation Priority\n1. **Google Business Profile** (Foundational)\n2. **Yelp** (High Authority)\n3. **Industry-Specific** (e.g., Avvo for lawyers, Houzz for home pros)\n4. **Local Chamber of Commerce** (Trust Signal)\n5. **Local News/Blog Mentions** (Authority Signal)\n\n## 4. Local Keyword Optimization\nAudit for the presence of:\n- `[Service] [City Name]` in H1 and Title.\n- `[Profession] [Neighborhood]` in H2.\n- \"Near me\" intent coverage in Meta Descriptions.\n\nFile v1.2.1:references/roadmap-strategy.md\n\n# Mad SEO: 12-Month Strategic Roadmap Logic\n\nThis reference governs the autonomous generation of long-term SEO growth plans. It uses a phased approach to build authority and displace competitors, integrated with WordPress category taxonomies.\n\n## 1. The Priority Formula\nStrategic prioritization is based on the following formula:\n`Priority Score = (Monthly Search Volume + Business Value [1-10]) / Keyword Difficulty`\n\n- **High Priority (Quick Wins)**: High Volume + Low Difficulty.\n- **Strategic Targets**: High Business Value + Medium/High Difficulty.\n- **Topical Clusters**: Grouping keywords into silos to boost authority.\n\n## 2. The 3-Phase Roadmap\n\n### Phase 1: Foundations (Months 1-3)\n**Objective**: Establish a footprint and secure early traffic.\n- **Focus**: Long-tail keywords, Low competition (Difficulty < 30).\n- **Strategy**: \n    - Focus on **TOFU (Awareness)** content.\n    - Map to general WordPress categories (e.g., \"Guides\", \"News\").\n    - Establish Topical Authority by covering basic concepts.\n\n### Phase 2: Authority Building (Months 4-6)\n**Objective**: Command topical authority in core clusters.\n- **Focus**: Mid-difficulty keywords (Difficulty 30-60).\n- **Strategy**:\n    - Shift towards **MOFU (Consideration)** content.\n    - Map to technical/specific WordPress categories (e.g., \"SEO\", \"Plugins\").\n    - Create \"Skyscraper\" Pillar content (2500+ words) to anchor clusters.\n\n### Phase 3: Competitive Acquisition (Months 7-12)\n**Objective**: Displace market leaders for high-volume terms.\n- **Focus**: High difficulty keywords (Difficulty 60+).\n- **Strategy**:\n    - Increase **BOFU (Decision)** content ratio.\n    - Map to conversion categories (e.g., \"Case Studies\", \"Tools\").\n    - Targeted \"Thin Spot\" takeover articles based on competitor gaps found via WordPress content audits.\n\n## 3. Publication Frequency\nThe roadmap does not assume a fixed number of posts. It adapts to the user's configured **`publication_days`**:\n- **1 Day/Week**: ~52 posts/year.\n- **3 Days/Week**: ~156 posts/year.\n- **5 Days/Week**: ~260 posts/year.\n\nThe 50/30/20 Funnel Rule remains the guiding principle for distribution regardless of frequency.\n\nFile v1.2.1:references/schema-architect-logic.md\n\n# Schema Architect: JSON-LD Strategy\n\nTo maximize GEO (Generative Engine Optimization) performance, every article should include structured data that \"grounds\" the content for machines (Google, Gemini, Perplexity).\n\n## 1. Article & Author Schema (Primary)\nEvery article MUST have an `Article` or `BlogPosting` schema linked to a `Person` (Author).\n\n```json\n{\n  \"@context\": \"https://schema.org\",\n  \"@type\": \"BlogPosting\",\n  \"headline\": \"[Target Title]\",\n  \"author\": {\n    \"@type\": \"Person\",\n    \"name\": \"[Author Name]\",\n    \"url\": \"[Author Social Link]\"\n  },\n  \"datePublished\": \"[YYYY-MM-DD]\",\n  \"image\": \"[Image URL]\"\n}\n```\n\n## 2. FAQ Schema (Position Zero Sniper)\nUse this for articles with an FAQ section. It increases the likelihood of appearing in \"People Also Ask\" boxes.\n\n```json\n{\n  \"@context\": \"https://schema.org\",\n  \"@type\": \"FAQPage\",\n  \"mainEntity\": [\n    {\n      \"@type\": \"Question\",\n      \"name\": \"[Question Text]?\",\n      \"acceptedAnswer\": {\n        \"@type\": \"Answer\",\n        \"text\": \"[Answer Text - concise 40-60 words]\"\n      }\n    }\n  ]\n}\n```\n\n## 3. How-To Schema\nMandatory for \"How-to\" guides and tutorials.\n\n```json\n{\n  \"@context\": \"https://schema.org\",\n  \"@type\": \"HowTo\",\n  \"name\": \"[Step Title]\",\n  \"step\": [\n    {\n      \"@type\": \"HowToStep\",\n      \"text\": \"[Instruction]\"\n    }\n  ]\n}\n```\n\n## 4. Entity Grounding Logic\nWhenever possible, use the `about` or `mentions` property to link to Wikipedia or Wikidata entries for core entities.\n\n```json\n\"mentions\": [\n  {\n    \"@type\": \"Thing\",\n    \"name\": \"OpenClaw\",\n    \"sameAs\": \"https://github.com/openclaw/openclaw\"\n  }\n]\n```\n\nArchive v1.2.0: 17 files, 29307 bytes\n\nFiles: index.js (11525b), references.json (643b), references/author-eeat-benchmarks.md (1034b), references/content-structure-templates.md (17818b), references/db-schema.md (1618b), references/engine_strategy.md (1378b), references/funnel-strategy.md (2736b), references/geo-sync-logic.md (1259b), references/humanizer_config.json (1063b), references/local-compliance-benchmarks.md (1325b), references/roadmap-strategy.md (2158b), references/schema-architect-logic.md (1597b), references/title-formulas.md (10400b), references/writer_quality.md (2365b), skill.json (1194b), SKILL.md (4109b), _meta.json (134b)\n\nFile v1.2.0:SKILL.md\n\n# M.A.D. SEO CONTENT 🚀\n\n**M.A.D. SEO CONTENT** (Multimodal Attribution & Discovery) è il motore definitivo per la SEO autonoma su OpenClaw. Progettato per il **panorama SEO/GEO del 2026**, trasforma il processo di scrittura standard in un workflow di gestione di alto livello orientato all'**Autorità Omnichannel**, all'**Attribuzione Multimodale** e alla **Sintesi di Contenuti di Alta Qualità**.\n\nLa versione 1.2.0 introduce l'integrazione nativa con **WordPress**, la pianificazione editoriale a 12 mesi e il supporto multi-lingua dinamico.\n\n---\n\n## 🛠️ La Suite dei 12 Tool\n\n### 1. `mad_seo:onboard`\nAttiva il workflow interattivo di onboarding. Configura lingua, formato di output (HTML/MD), credenziali **WordPress REST API**, plugin SEO (Rank Math/Yoast) e mappatura categorie.\n*Trigger: \"Onboard me to M.A.D. SEO CONTENT\"*\n\n### 2. `mad_seo:research_strategy`\nEsegue un'**Analisi Omnichannel 3.0**. Analizza i Top 10 della SERP, il sentiment delle community (Reddit/Forum) e verifica i contenuti già esistenti sul blog per evitare duplicati.\n*Trigger: \"Omnichannel research for [Topic]\"*\n\n### 3. `mad_seo:plan_strategy`\nGenera un **Calendario Editoriale completo di 12 mesi** (52 settimane). Mappa ogni post agli stadi del funnel (TOFU/MOFU/BOFU) e alle categorie WordPress reali, salvando tutto nel database SQLite locale.\n*Trigger: \"Plan my strategy\"*\n\n### 4. `mad_seo:draft_article`\nGenera articoli da 1.500-3.000 parole in formato **HTML semantico** o Markdown. Applica nativamente il **Human-GEO Framework** per superare i rilevatori AI e garantire varietà stilistica.\n*Trigger: \"Draft an article\"*\n\n### 5. `mad_seo:create_wp_draft`\n**[NUOVO]** Automatizza la pubblicazione su WordPress: carica le immagini nella Media Library, crea la bozza via REST API e sincronizza i meta SEO (Title, Description, Keyword) con Rank Math o Yoast.\n*Trigger: \"Create a WordPress draft\"*\n\n### 6. `mad_seo:audit_eeat`\nEsegue un audit Scientifico unificato. Verifica l'\"Information Gain\", segnala allucinazioni e valuta la bio dell'autore per massimizzare i segnali di \"Expertise\".\n*Trigger: \"Audit eeat\"*\n\n### 7. `mad_seo:generate_schema`\nGenera JSON-LD ottimizzato per GEO (Article, FAQ, HowTo) e, se presente un plugin SEO, prepara il payload per l'aggiornamento via API.\n*Trigger: \"Generate schema\"*\n\n### 8. `mad_seo:site_wide_intelligence`\nAudit profondo che collega le URL della Sitemap alle performance di GSC. Costruisce una **Mappa delle Entità Globale** per un'architettura di link interni ottimale.\n*Trigger: \"Run site intelligence\"*\n\n### 9. `mad_seo:inject_internal_links`\nTrova post esistenti ad alta autorità e propone link contestuali verso i nuovi articoli. Richiede sempre conferma dell'utente tramite Diff.\n*Trigger: \"Inject internal links\"*\n\n### 10. `mad_seo:repurpose_content`\nEsegue il workflow 'One-to-Many', trasformando un pillar post in thread per X, post LinkedIn e teaser per Newsletter.\n*Trigger: \"Repurpose content\"*\n\n### 11. `mad_seo:analyze_share_of_voice`\nAnalizza le risposte dei motori AI (Gemini, Perplexity) per calcolare l'**AI Citation Score** del tuo brand.\n*Trigger: \"Analyze share of voice\"*\n\n### 12. `mad_seo:analytics_suite`\nMotore di analisi unificato collegato a GA4/GSC. Gestisce audit di CTR basso, decadimento del traffico e cannibalizzazione delle keyword.\n*Trigger: \"Run analytics suite\"*\n\n---\n\n## 🧠 Human-GEO Framework\nIntegrato nel drafting, migliora la qualità tramite:\n1. **Varietà Linguistica**: Mix di lunghezze delle frasi per un flusso naturale.\n2. **Vocabolario Specifico**: Terminologia di settore precisa e non ripetitiva.\n3. **Ancoraggio Contestuale**: Iniezione di dati reali dalle community per dimostrare competenza.\n\n## 🔒 Sicurezza e Privacy\n1. **Application Passwords**: Tutte le credenziali WordPress rimangono locali nel workspace dell'utente (`./shared/`).\n2. **Nessun Dato Esterno**: I dati sensibili non lasciano mai l'ambiente protetto di OpenClaw.\n\n## 🧩 Dipendenze\n- **`api-gateway`**: Obbligatorio per Analytics (GSC/GA4).\n- **`scrapling-official`**: Social discovery.\n- **`agent-browser`**: Analisi live AI search.\n\nFile v1.2.0:_meta.json\n\n{\n  \"ownerId\": \"kn738882af7v4spmmb1gs07xqx832znk\",\n  \"slug\": \"mad-seo-content\",\n  \"version\": \"1.2.0\",\n  \"publishedAt\": 1777245517284\n}\n\nFile v1.2.0:references/author-eeat-benchmarks.md\n\n# Author EEAT Benchmarks (HCU Compliance)\n\nTo rank in 2026, content must be tied to a verifiable entity. This audit ensures the author has a \"Digital Footprint\" that search engines can verify.\n\n## 1. Professional Transparency (O07)\n- [ ] **Author Bio**: Is there a consistent bio (150-300 words) across the site and socials?\n- [ ] **Profile Image**: Is there a professional image? (AI avatars are acceptable if branded properly).\n- [ ] **Social Links**: Are LinkedIn, Twitter/X, or GitHub links present and active?\n\n## 2. Niche Authority (O08)\n- [ ] **Citations**: Does the author have mentions or articles on third-party sites in the same niche?\n- [ ] **Consistency**: Does the author only write about this niche, or is the profile scattered?\n- [ ] **Contact Info**: Is there a clear way to contact the expert directly?\n\n## 3. Experience Markers (HCU Mandatory)\n- [ ] **Case Studies**: Does the author reference their own previous work?\n- [ ] **Proprietary Data**: If data is used, is it clearly attributed to the author's research?\n\nFile v1.2.0:references/content-structure-templates.md\n\n# Content Structure Templates V6\n\nMarkdown templates for common SEO content types. Optimized for **2026 Multimodal Attribution** and **HCU Compliance**.\n\n---\n\n## Blog Post (Authority/Omnichannel)\n\n**Target word count**: 1,500-2,500 words\n**V6 Standards**: Multimodal assets (Original Data), Social Proof (Reddit citations).\n\n```markdown\n# [Primary Keyword in H1] - [Unique Benefit/Take]\n\n[Opening Relationship Anchor - 1 sentence defining the Topic as a part of a larger Entity/Category]\n\n[Social Discovery Hook - \"Our team analyzed discussions on [Reddit/Forums] and found that most users struggle with [Pain Point]...\"]\n\n[Promise - specific learning outcome]\n\n## Key Takeaways: [Topic] Summary\n| Component | Status/Verdict | AI Relationship |\n|-----------|----------------|-----------------|\n| [Fact 1]  | [Measure]      | [A is-a B]      |\n| [Fact 2]  | [Measure]      | [B owns C]      |\n\n## What Is [Topic]? (The Entity Definition)\n\n[Clear definition in 40-60 words - each sentence a standalone fact]\n\n[**Omnichannel Proof**: \"Contrary to common belief in the [Topic] community, our testing reveals...\"]\n\n## Why [Topic] Matters in [Year]\n\n[Benefit with supporting evidence]\n\n> [!TIP]\n> **Multimodal Evidence**: [Insert Chart Description: Comparison of [Topic] vs Competitors based on our Q1 Testing].\n\n## [Sub-topic 1]\n\n[Detailed explanation with expert take]\n\n### Community Verdict\n[Summarize Reddit/Forum sentiment here to build 2026-level authority]\n\n## Frequently Asked Questions\n\n### [Question from PAA/AI Sub-queries]?\n\n[Direct answer in 40-60 words]\n\n## Conclusion: The Final Verdict on [Topic]\n\n[Recap + Knowledge Graph Anchor]\n\n[Call-to-Action]\n```\n\n---\n\n## GEO-First Pillar Page (V6 Optimized)\n\n**Target word count**: 3,000-5,000+ words\n**Primary goal**: Become the \"Universal Truth\" source for AI engines.\n\n```markdown\n# The Ultimate V6 Guide to [Entity] ([Year])\n\n[Entity Grounding - \"This guide clarifies the relationship between [Entity] and [Broader Category].\"]\n\n[Multimodal Log - 3+ Custom Graphics Required]\n```\n\n[Hook - present the comparison dilemma]\n\n[Context - why this comparison matters]\n\n[Promise - what readers will understand after reading]\n\n**Quick answer**: [Brief verdict for those who want immediate answer]\n\n## [Option A] vs [Option B]: Quick Comparison\n\n| Feature | [Option A] | [Option B] |\n|---------|-----------|-----------|\n| [Feature 1] | [Details] | [Details] |\n| [Feature 2] | [Details] | [Details] |\n| [Feature 3] | [Details] | [Details] |\n| [Feature 4] | [Details] | [Details] |\n| **Best for** | [Use case] | [Use case] |\n| **Starting price** | [Price] | [Price] |\n\n## What Is [Option A]?\n\n[Clear definition]\n\n[Key features and capabilities]\n\n**Pros**:\n- [Advantage 1]\n- [Advantage 2]\n- [Advantage 3]\n\n**Cons**:\n- [Disadvantage 1]\n- [Disadvantage 2]\n\n## What Is [Option B]?\n\n[Clear definition]\n\n[Key features and capabilities]\n\n**Pros**:\n- [Advantage 1]\n- [Advantage 2]\n- [Advantage 3]\n\n**Cons**:\n- [Disadvantage 1]\n- [Disadvantage 2]\n\n## [Option A] vs [Option B]: Detailed Comparison\n\n### [Feature Category 1]\n\n**[Option A]**: [Detailed explanation with examples]\n\n**[Option B]**: [Detailed explanation with examples]\n\n**Winner**: [A/B/Tie] - [Brief reasoning]\n\n### [Feature Category 2]\n\n**[Option A]**: [Details]\n\n**[Option B]**: [Details]\n\n**Winner**: [A/B/Tie] - [Brief reasoning]\n\n### [Feature Category 3]\n\n[Continue pattern for key comparison points]\n\n## Pricing: [Option A] vs [Option B]\n\n### [Option A] Pricing\n\n- [Tier 1]: $[X]/month - [What's included]\n- [Tier 2]: $[X]/month - [What's included]\n- [Tier 3]: $[X]/month - [What's included]\n\n### [Option B] Pricing\n\n- [Tier 1]: $[X]/month - [What's included]\n- [Tier 2]: $[X]/month - [What's included]\n- [Tier 3]: $[X]/month - [What's included]\n\n**Value winner**: [Which offers better value and why]\n\n## Which Should You Choose?\n\n### Choose [Option A] if:\n- [Criteria 1]\n- [Criteria 2]\n- [Criteria 3]\n\n### Choose [Option B] if:\n- [Criteria 1]\n- [Criteria 2]\n- [Criteria 3]\n\n## Frequently Asked Questions\n\n### Is [Option A] better than [Option B]?\n\n[Nuanced answer - depends on use case]\n\n### Can you use [Option A] and [Option B] together?\n\n[Answer with explanation]\n\n### Which is easier for beginners: [Option A] or [Option B]?\n\n[Answer with reasoning]\n\n## Final Verdict: [Option A] vs [Option B]\n\n[Balanced conclusion]\n\n[Recommendation based on different use cases]\n\n[Clear call-to-action]\n```\n\n**Internal links**: Links to detailed reviews of each option, related comparisons\n**External links**: Official websites of both options, third-party reviews\n**Keywords**: Both options mentioned throughout, comparison keywords in H2s\n\n---\n\n## Listicle (\"Top N [Items]\")\n\n**Target word count**: 1,500-2,500 words (depending on list length)\n**Primary goal**: Provide curated recommendations, rank for \"best [topic]\" queries\n\n```markdown\n# [Number] Best [Items] for [Audience/Purpose] ([Year])\n\n[Hook - establish why this list matters]\n\n[Context - what makes these the \"best\"]\n\n[Promise - what readers will gain]\n\nAfter testing [X] different [items], we've identified the [number] that deliver the best results for [audience/purpose].\n\n## Quick Summary: Top [Number] [Items]\n\n| Rank | [Item] | Best For | Price |\n|------|--------|----------|-------|\n| 1 | [Item 1] | [Use case] | [Price] |\n| 2 | [Item 2] | [Use case] | [Price] |\n| 3 | [Item 3] | [Use case] | [Price] |\n\n## How We Chose These [Items]\n\nOur selection criteria:\n- [Criterion 1] - [Why it matters]\n- [Criterion 2] - [Why it matters]\n- [Criterion 3] - [Why it matters]\n\n## 1. [Item Name] - Best for [Specific Use Case]\n\n![Alt text: [Item name] screenshot/image]\n\n**What it is**: [Brief description]\n\n**Why we love it**: [Key benefits and features]\n\n**Key features**:\n- [Feature 1]\n- [Feature 2]\n- [Feature 3]\n\n**Pricing**: [Price details]\n\n**Pros**:\n- [Pro 1]\n- [Pro 2]\n\n**Cons**:\n- [Con 1]\n- [Con 2]\n\n**Best for**: [Ideal user or use case]\n\n[Link to item]\n\n---\n\n## 2. [Item Name] - Best for [Specific Use Case]\n\n[Follow same structure as #1]\n\n---\n\n## 3. [Item Name] - Best for [Specific Use Case]\n\n[Continue pattern for all items in list]\n\n---\n\n## Comparison: Which [Item] Is Right for You?\n\n| Feature | [Item 1] | [Item 2] | [Item 3] |\n|---------|----------|----------|----------|\n| [Feature 1] | ✓/✗ | ✓/✗ | ✓/✗ |\n| [Feature 2] | ✓/✗ | ✓/✗ | ✓/✗ |\n| [Feature 3] | ✓/✗ | ✓/✗ | ✓/✗ |\n\n## How to Choose the Best [Item] for Your Needs\n\n### Consider [Factor 1]\n\n[Explanation of how this factor affects choice]\n\n### Consider [Factor 2]\n\n[Explanation]\n\n### Consider [Factor 3]\n\n[Explanation]\n\n## Frequently Asked Questions\n\n### What is the best [item] for beginners?\n\n[Answer with specific recommendation]\n\n### Which [item] offers the best value?\n\n[Answer with reasoning]\n\n### Are paid [items] better than free ones?\n\n[Balanced answer]\n\n## Conclusion: Our Top Pick\n\n[Restate #1 recommendation]\n\n[Why it's the best overall choice]\n\n[Call-to-action]\n```\n\n**Internal links**: Related guides, comparison articles, category pages\n**External links**: Links to each recommended item, review sources\n**Keywords**: \"Best [topic]\", individual item names, use case keywords\n\n---\n\n## How-To Guide (Step-by-Step)\n\n**Target word count**: 1,200-2,000 words\n**Primary goal**: Teach a specific process, rank for \"how to [task]\" queries\n\n```markdown\n# How to [Achieve Goal]: [Number]-Step Guide [for Audience]\n\n[Hook - present the outcome readers want]\n\n[Current problem - why this is challenging]\n\n[Promise - what readers will accomplish]\n\nBy following this step-by-step guide, you'll be able to [specific outcome] in [timeframe].\n\n## What You'll Need\n\n**Tools**:\n- [Tool 1]\n- [Tool 2]\n- [Tool 3]\n\n**Time required**: [Estimated time]\n\n**Skill level**: [Beginner/Intermediate/Advanced]\n\n## Why [Task] Matters\n\n[Explain the benefits of completing this task]\n\n[Provide context and importance]\n\n## Step 1: [Action Title]\n\n![Alt text: Screenshot showing step 1]\n\n[Clear instruction for this step]\n\n[Why this step is important]\n\n**How to do it**:\n1. [Sub-step 1]\n2. [Sub-step 2]\n3. [Sub-step 3]\n\n> **Pro Tip**: [Helpful tip to make this step easier]\n\n**Common mistakes**:\n- [Mistake to avoid]\n- [Another mistake]\n\n---\n\n## Step 2: [Action Title]\n\n![Alt text: Screenshot showing step 2]\n\n[Instruction for this step]\n\n[Additional context or explanation]\n\n**Example**: [Concrete example showing this step]\n\n---\n\n## Step 3: [Action Title]\n\n[Continue pattern for all steps]\n\n---\n\n## Step [Final Number]: [Action Title]\n\n[Final step instruction]\n\n[What success looks like]\n\n**You'll know it's working when**: [Success indicators]\n\n---\n\n## What to Do If [Common Problem]\n\n### Problem: [Issue 1]\n\n**Solution**: [How to fix it]\n\n### Problem: [Issue 2]\n\n**Solution**: [How to fix it]\n\n## Advanced Tips\n\nOnce you've mastered the basics:\n\n1. **[Advanced tip 1]** - [Explanation]\n2. **[Advanced tip 2]** - [Explanation]\n3. **[Advanced tip 3]** - [Explanation]\n\n## Frequently Asked Questions\n\n### How long does it take to [complete task]?\n\n[Realistic timeframe with variables]\n\n### Do I need [specific tool/skill] to [complete task]?\n\n[Answer with alternatives if applicable]\n\n### What if [specific concern]?\n\n[Address concern with solution]\n\n## Conclusion\n\n[Recap the process]\n\n[Encourage reader to take action]\n\n[Clear next step or CTA]\n\n**Next steps**: [Link to related guide or advanced tutorial]\n```\n\n**Internal links**: Links to tool reviews, prerequisite guides, related tutorials\n**External links**: Tool documentation, additional resources\n**Keywords**: \"How to [task]\", action words in each step heading\n\n---\n\n## Product Review\n\n**Target word count**: 1,500-2,000 words\n**Primary goal**: Help buyers make informed decisions, rank for \"[product] review\" queries\n\n```markdown\n# [Product Name] Review: Is It Worth It in [Year]?\n\n[Hook - establish the product's promise or popularity]\n\n[Context - who this review is for]\n\nAfter using [Product] for [timeframe], here's my honest assessment of whether it lives up to the hype.\n\n## [Product Name] Overview\n\n**What it is**: [Clear description]\n\n**Price**: [Pricing details]\n\n**Best for**: [Ideal user or use case]\n\n**Rating**: ★★★★☆ (4/5)\n\n## Pros and Cons at a Glance\n\n### Pros\n- [Major advantage 1]\n- [Major advantage 2]\n- [Major advantage 3]\n\n### Cons\n- [Main limitation 1]\n- [Main limitation 2]\n\n## What Is [Product Name]?\n\n[Detailed product description]\n\n[Who makes it and company background]\n\n[Product positioning and target market]\n\n## Key Features\n\n### [Feature 1]\n\n[Detailed explanation of feature]\n\n[How it works in practice]\n\n[Our experience with this feature]\n\n### [Feature 2]\n\n[Continue pattern for main features]\n\n## Performance Testing\n\n### [Test Category 1]\n\n**What we tested**: [Testing methodology]\n\n**Results**: [Specific results with data]\n\n**Verdict**: [Assessment]\n\n### [Test Category 2]\n\n[Continue testing pattern]\n\n## Pricing and Plans\n\n| Plan | Price | What's Included |\n|------|-------|-----------------|\n| [Tier 1] | $[X]/month | [Features] |\n| [Tier 2] | $[X]/month | [Features] |\n| [Tier 3] | $[X]/month | [Features] |\n\n**Value assessment**: [Whether pricing is justified]\n\n## [Product] vs Competitors\n\n| Feature | [Product] | [Competitor 1] | [Competitor 2] |\n|---------|-----------|----------------|----------------|\n| [Feature 1] | [Details] | [Details] | [Details] |\n| [Feature 2] | [Details] | [Details] | [Details] |\n| [Feature 3] | [Details] | [Details] | [Details] |\n\n## Who Should Buy [Product]?\n\n### Perfect for:\n- [User type 1] because [reason]\n- [User type 2] because [reason]\n\n### Not ideal for:\n- [User type] because [reason]\n- [User type] because [reason]\n\n## Frequently Asked Questions\n\n### Is [Product] worth the price?\n\n[Honest assessment with context]\n\n### How does [Product] compare to [main competitor]?\n\n[Balanced comparison]\n\n### What's the learning curve like?\n\n[Assessment with timeframe]\n\n## Final Verdict: Should You Buy [Product]?\n\n[Balanced conclusion]\n\n[Specific recommendation based on use case]\n\n**Our rating**: ★★★★☆ (4/5)\n\n[Link to product with disclosure if affiliate]\n```\n\n**Disclosure**: Include affiliate disclosure if applicable\n**Internal links**: Related product reviews, comparison articles, category pages\n**External links**: Product website, official documentation\n\n---\n\n## GEO-First Pillar Page (V2 optimized)\n\n**Target word count**: 3,000-5,000+ words\n**Primary goal**: Become the \"Primary Citation Source\" for AI engines (Gemini/Perplexity).\n\n```markdown\n# [Entity Name]: The Ultimate V2 Guide to [Topic] ([Year])\n\n[Entity Grounding - 1 sentence defining exactly what the entity is]\n\n[Experience Hook - 1 sentence about your first-hand testing or authority]\n\n## Key Takeaways: [Topic] Summary\n\n| Factor | Quick Answer / Metric |\n|--------|-----------------------|\n| Primary Usage | [Standalone fact] |\n| Core Benefit | [Standalone fact] |\n| Pricing / Cost | [Specific number] |\n| Best For | [Clear target] |\n\n[Brief 100-word introduction expanding on the 'Why']\n\n## 1. What is [Entity]? (Deep Dive)\n\n[Chunked definition - each sentence is a clear, quotable fact]\n\n[Historical context and relationship to other entities]\n\n## 2. Our Experience: Testing [Topic]\n\n[Detailed section on first-hand testing, data, or results - HCU MANDATORY]\n\n[Comparison to other solutions based on personal findings]\n```\n\n---\n\n## Pillar Page (Comprehensive Guide)\n\n**Target word count**: 3,000-5,000+ words\n**Primary goal**: Become definitive resource, rank for head terms, support topic cluster\n\n```markdown\n# [Topic]: The Complete Guide [for Audience] ([Year])\n\n[Compelling hook - establish the importance of this topic]\n\n[Problem - what challenges exist in this space]\n\n[Promise - what this comprehensive guide delivers]\n\nThis is the most comprehensive guide to [topic] on the web. You'll learn everything from fundamentals to advanced strategies.\n\n## Table of Contents\n\n- [Chapter 1]\n- [Chapter 2]\n- [Chapter 3]\n- [Chapter 4]\n- [Chapter 5]\n\n## Chapter 1: [Topic] Fundamentals\n\n### What Is [Topic]?\n\n[Comprehensive definition - GEO-optimized]\n\n[History and evolution]\n\n[Current state and importance]\n\n### Why [Topic] Matters\n\n[Multiple benefits with evidence]\n\n[Industry statistics and trends]\n\n### Key Concepts and Terminology\n\n| Term | Definition |\n|------|------------|\n| [Term 1] | [Definition] |\n| [Term 2] | [Definition] |\n| [Term 3] | [Definition] |\n\n## Chapter 2: [Major Sub-Topic]\n\n[Comprehensive section on major aspect]\n\n[Multiple sub-sections with H3 headings]\n\n[Examples, case studies, data]\n\n[Internal links to detailed cluster content]\n\n> **Deep dive**: For more on [sub-topic], see our complete guide: [link]\n\n## Chapter 3: [Major Sub-Topic]\n\n[Continue pattern with substantial content sections]\n\n## Chapter 4: [Advanced/Tactical Section]\n\n[Strategic or tactical content]\n\n[Actionable frameworks and processes]\n\n## Chapter 5: [Implementation/Case Studies]\n\n[Real-world applications]\n\n[Success stories]\n\n[Implementation roadmap]\n\n## Frequently Asked Questions\n\n[Comprehensive FAQ section with 8-10 questions]\n\n## Key Takeaways\n\n[Summarize main points from each chapter]\n\n## What's Next?\n\n[Recommend next steps]\n\n[Links to related cluster content]\n\n## Resources\n\n**Recommended tools**:\n- [Tool 1] - [Use case]\n- [Tool 2] - [Use case]\n\n**Further reading**:\n- [Internal link to cluster content]\n- [Internal link to cluster content]\n- [External resource]\n```\n\n**Internal links**: 8-15 links to related cluster content\n**External links**: 5-10 authoritative sources\n**Update frequency**: Quarterly for pillar pages\n\n---\n\n## FAQ Page\n\n**Target word count**: 1,000-1,500 words\n**Primary goal**: Answer common questions, rank for question queries, enable FAQ rich results\n\n```markdown\n# [Topic]: Frequently Asked Questions\n\n[Introduction explaining what questions this page answers]\n\n[Who this FAQ is for]\n\n## General Questions\n\n### What is [topic]?\n\n[Comprehensive answer with definition]\n\n### How does [topic] work?\n\n[Clear explanation with steps if applicable]\n\n### Why is [topic] important?\n\n[Benefits and context]\n\n## Getting Started\n\n### How do I get started with [topic]?\n\n[Step-by-step guidance]\n\n### What do I need to [accomplish goal]?\n\n[Requirements and prerequisites]\n\n### How long does it take to [achieve result]?\n\n[Realistic timeframe]\n\n## Common Problems\n\n### Why isn't [expected result] happening?\n\n[Troubleshooting guidance]\n\n### What should I do if [problem occurs]?\n\n[Solution with steps]\n\n### How do I fix [specific error]?\n\n[Fix instructions]\n\n## Comparison Questions\n\n### [Option A] vs [Option B]: which is better?\n\n[Balanced comparison answer]\n\n### Should I [action 1] or [action 2]?\n\n[Guidance based on scenarios]\n\n## Pricing and Plans\n\n### How much does [topic] cost?\n\n[Pricing information with context]\n\n### Is there a free version?\n\n[Information about free options]\n\n## Advanced Questions\n\n### Can I [advanced action]?\n\n[Answer with technical details]\n\n### How do I [complex task]?\n\n[Guidance with link to detailed guide]\n\n## Still Have Questions?\n\n[Call-to-action for additional support]\n\n[Contact information or link to contact page]\n```\n\n**Schema markup**: Add FAQPage schema to enable rich results\n**Internal links**: Link to detailed guides for complex answers\n**Keywords**: Include question keywords naturally\n\n---\n\n## Implementation Checklist\n\nFor any template:\n\n- [ ] Customize all [bracketed placeholders]\n- [ ] Include primary keyword in H1 and first 100 words\n- [ ] Place secondary keywords in H2/H3 headings\n- [ ] Add 3-5 internal links to related content\n- [ ] Include 2-3 external links to authoritative sources\n- [ ] Create GEO-optimized definition blocks\n- [ ] Add FAQ section for featured snippet opportunities\n- [ ] Include relevant images with descriptive alt text\n- [ ] Write compelling meta description (150-160 chars)\n- [ ] Optimize title tag (50-60 chars with primary keyword)\n\nFile v1.2.0:references/db-schema.md\n\n# SQLite Content Calendar Schema\n\nThis document outlines the expected schema for the SQLite database used by Mad SEO Manager to track the content lifecycle (`./shared/mad_seo.db`).\n\n## Table: `content_calendar`\n\nThe `content_calendar` table stores all planned, drafted, and published content across the entire pipeline.\n\n### Schema Definition\n```sql\nCREATE TABLE IF NOT EXISTS content_calendar (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    title TEXT NOT NULL,\n    wp_category_id INTEGER,\n    funnel_stage TEXT NOT NULL CHECK (funnel_stage IN ('TOFU', 'MOFU', 'BOFU')),\n    status TEXT NOT NULL CHECK (status IN ('Idea', 'Draft', 'Review', 'Scheduled', 'Published', 'Repurposed')),\n    scheduled_date DATE,\n    wp_post_id INTEGER,\n    published_url TEXT,\n    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP\n);\n```\n\n### Required Agent Operations\n\n#### 1. Inserting New Ideas (Via `mad_seo:plan_strategy`)\nWhen planning content, the agent should insert records with status `Idea` and the correct category ID.\n```sql\nINSERT INTO content_calendar (title, wp_category_id, funnel_stage, status, scheduled_date)\nVALUES ('Title', 10, 'TOFU', 'Idea', '2026-05-01');\n```\n\n#### 2. Updating Status (Via WordPress Integration)\nWhen a post is created as a draft on WordPress, store the `wp_post_id`.\n```sql\nUPDATE content_calendar \nSET status = 'Draft', wp_post_id = [WP_ID], updated_at = CURRENT_TIMESTAMP \nWHERE id = [ID];\n```\n\n#### 3. Reviewing the Calendar\nThe agent can query this database at any time to review what needs to be drafted next or what gaps exist in the funnel.\n\nFile v1.2.0:references/engine_strategy.md\n\n# Mad SEO: Omnichannel 3.0 Strategic Framework\n\n## Phase 1: Entity Grounding & Relationship Mapping\n1. Identify the **Primary Entity**.\n2. Map **Knowledge Graph Relationships** (Is-a, Part-of, Owns).\n3. Anchor entities to Wikidata/Wikipedia IDs.\n\n## Phase 2: Omnichannel 3.0 Research (Beyond Google)\n1. **SERP Gap**: Identify thin spots in Top 10.\n2. **Social Discovery**: Scrape Reddit, Discord, and niche forums for:\n   - \"Unspoken\" user pain points.\n   - community-specific terminology.\n   - Debunked myths or common debates.\n3. **Evidence Audit**: Identify what original data or assets competitors lack.\n\n## Phase 3: Multimodal Pillar & Spoke\n1. **Pillar Page**: Comprehensive Entity Guide (3,000+ words).\n2. **Cluster Spokes**: Addressing \"Sub-Queries\" found in Social Discovery.\n3. **Multimodal Attribution**: Every piece of content must have a unique visual asset (Chart, Data Table, Evidence Screenshot).\n\n## Phase 4: Share of AI Voice (KPI)\n1. Use `analyze_share_of_voice` to track citation status.\n2. Optimize for **\"Relationship Fact\"** snippets to displace current citations.\n\n---\n\n## 🔬 Content Refresh Strategy V6\n- **Rule 1**: Re-verify \"Relationship Facts\" against latest AI answers every 90 days.\n- **Rule 2**: Update community sentiment sections to reflect new debates.\n- **Rule 3**: Re-audit for \"Fabrication\" if the draft was edited by unverified agents.\n\nFile v1.2.0:references/funnel-strategy.md\n\n# Funnel Alignment & Repurposing Strategy\n\nThis document defines the strict classification rules for the Mad SEO Content Pipeline to ensure balanced production and maximum distribution ROI.\n\n## 1. Funnel Stage Classification (TOFU/MOFU/BOFU)\n\nEvery piece of content generated by `mad_seo:plan_strategy` MUST be classified into one of these three stages:\n\n### TOFU (Top of Funnel) - Awareness\n- **Goal:** Reach new audiences, generate massive organic traffic (SEO).\n- **Format:** Ultimate Guides, \"What is X\", Trends, Broad Industry Problems.\n- **Example:** \"The Ultimate Guide to OpenClaw Agents in 2026.\"\n\n### MOFU (Middle of Funnel) - Consideration\n- **Goal:** Build deep trust, capture emails, help the user evaluate solutions.\n- **Format:** \"How-to\" tutorials, \"X vs Y\" comparisons, Framework breakdowns.\n- **Example:** \"Mad SEO vs Standard AI Writers: A 70-Point Comparison.\"\n\n### BOFU (Bottom of Funnel) - Decision\n- **Goal:** Drive direct action, overcome final objections, sales enablement.\n- **Format:** Case studies, ROI calculators, Deep-dive workflow demos.\n- **Example:** \"How We Scaled WordPress Traffic by 300% using Mad SEO (Case Study).\"\n\n*Pipeline Rule:* A healthy monthly calendar should be roughly **50% TOFU, 30% MOFU, and 20% BOFU**.\n\n---\n\n## 2. WordPress Category Mapping (Stage-Specific)\nEvery post MUST be mapped to a real **WordPress Category ID** provided by the user. The agent must categorize content into funnel stages based on these specific site categories:\n\n- **TOFU (Awareness) -> Broad/Educational Categories**: \n  - *Example:* \"Guide\", \"News\", \"Blog\", \"Basics\".\n- **MOFU (Consideration) -> Technical/Niche Categories**: \n  - *Example:* \"SEO\", \"Plugins\", \"Comparison\", \"Advanced Tutorials\".\n- **BOFU (Decision) -> Action-Oriented Categories**: \n  - *Example:* \"Case Studies\", \"Tools\", \"Services\", \"Success Stories\".\n\n*Constraint:* If a category doesn't clearly fit, the agent should choose the most logically related stage to maintain the 50/30/20 balance.\n\n---\n\n## 3. The Repurposing Engine (One-to-Many)\n\nFor every Pillar Post (Long-form article) completed, the `mad_seo:repurpose_content` tool MUST generate the following distribution bundle:\n\n1. **The Core Asset:** 1x In-depth SEO Blog Post (1,500+ words).\n2. **LinkedIn Authority Post:** Rewrite the core hook and top 3 insights into a narrative, professional format suitable for B2B engagement.\n3. **Twitter/X Thread:** Break the article down into 7-10 punchy, high-value tweets using statistical burstiness.\n4. **Newsletter Teaser:** A 150-word personal intro that creates curiosity and links to the full post.\n\n*Golden Rule:* Never create once and forget. 80% of the effort should go into distributing the 20% of high-quality pillar content.\n\nFile v1.2.0:references/geo-sync-logic.md\n\n# GEO-Sync Architecture V6: Relationship Anchoring\n\nGEO in 2026 is no longer about matching keywords; it's about **Knowledge Graph Injection**. You must prove to the AI that your content understands the relationship between entities.\n\n## 1. V6 Attribution Gaps\n- **Identity Gap**: Does the AI know *exactly* which entity you are? Use Wikidata/Wikipedia links in schema.\n- **Relationship Anchor**: Does your content explicitly state how [Entity A] relates to [Entity B]? (e.g., \"OpenClaw is a framework for [Topic]\").\n- **Evidence Gap**: AI models prioritize sources that provide \"Original Data\" or \"Community Consensus\".\n\n## 2. The optimization Loop\n1.  **AI Voice Check**: Use `analyze_share_of_voice` to see who is currently cited.\n2.  **Relationship Mapping**: Identify the \"Relationship Facts\" being used by cited competitors.\n3.  **Knowledge Injection**: Rewrite your \"Direct Answer\" blocks to lead with a **Relationship Fact**.\n4.  **Wikidata Anchoring**: Use `generate_schema` to link entities to their machine-readable IDs.\n\n## 3. Knowledge Graph Snippets\n- **The \"is-a\" pattern**: \"[Topic] is a specialized type of [Category] used primarily for [Result].\"\n- **The \"part-of\" pattern**: \"[Topic] is a core component of the [Larger Entity] ecosystem.\"\n\nFile v1.2.0:references/humanizer_config.json\n\n{\n  \"framework\": \"Human-GEO Framework V1.0\",\n  \"detection_patterns\": [\n    \"repetitive_sentence_structure\",\n    \"rule_of_three_lists\",\n    \"repetitive_cadence\",\n    \"robotic_transitions\",\n    \"sycophantic_intros\",\n    \"significance_inflation\",\n    \"promotional_fluff\",\n    \"vague_attributions\",\n    \"passive_voice_overuse\",\n    \"cliché_metaphors\"\n  ],\n  \"banned_vocabulary\": {\n    \"tier_1_instant_death\": [\n      \"delve\",\n      \"tapestry\",\n      \"unwavering\",\n      \"pivotal\",\n      \"comprehensive\",\n      \"landscape\",\n      \"testament\",\n      \"in conclusion\",\n      \"moreover\",\n      \"furthermore\"\n    ],\n    \"tier_2_ai_signs\": [\n      \"elevate\",\n      \"unlock\",\n      \"seamless\",\n      \"empower\",\n      \"harness\",\n      \"dive into\",\n      \"embark\",\n      \"transformative\",\n      \"innovative\",\n      \"cutting-edge\"\n    ]\n  },\n  \"stylistic_rules\": {\n    \"sentence_length_variation\": \"Mix 5-word sentences with 25-word sentences.\",\n    \"active_voice_ratio\": \"> 85%\",\n    \"social_proof_requirement\": \"At least one specific community citation per 500 words.\"\n  }\n}\n\nFile v1.2.0:references/local-compliance-benchmarks.md\n\n# Mad SEO: Local SEO & Compliance Benchmarks\n\nThis reference governs the auditing and optimization of local business signals and Google Business Profile (GBP) health.\n\n## 1. The NAP Consistency Standard\n**NAP** = Name, Address, Phone.\n- **Rule**: The business details must be identical across the website, GBP, and all third-party directories (Yelp, Industry Lists, etc.).\n- **Audit Signal**: Flag any discrepancy in phone format or address abbreviations (e.g., \"St.\" vs \"Street\").\n\n## 2. Google Business Profile (GBP) Must-Haves\n- **Primary Category**: Must match the core business intent.\n- **Additional Categories**: Up to 5 related categories to capture broader intent.\n- **Freshness**: At least 1 update/post per week.\n- **Review Velocity**: Respond to 100% of reviews within 24-48 hours.\n- **Photo Health**: 5+ new high-quality photos added monthly.\n\n## 3. Local Citation Priority\n1. **Google Business Profile** (Foundational)\n2. **Yelp** (High Authority)\n3. **Industry-Specific** (e.g., Avvo for lawyers, Houzz for home pros)\n4. **Local Chamber of Commerce** (Trust Signal)\n5. **Local News/Blog Mentions** (Authority Signal)\n\n## 4. Local Keyword Optimization\nAudit for the presence of:\n- `[Service] [City Name]` in H1 and Title.\n- `[Profession] [Neighborhood]` in H2.\n- \"Near me\" intent coverage in Meta Descriptions.\n\nFile v1.2.0:references/roadmap-strategy.md\n\n# Mad SEO: 12-Month Strategic Roadmap Logic\n\nThis reference governs the autonomous generation of long-term SEO growth plans. It uses a phased approach to build authority and displace competitors, integrated with WordPress category taxonomies.\n\n## 1. The Priority Formula\nStrategic prioritization is based on the following formula:\n`Priority Score = (Monthly Search Volume + Business Value [1-10]) / Keyword Difficulty`\n\n- **High Priority (Quick Wins)**: High Volume + Low Difficulty.\n- **Strategic Targets**: High Business Value + Medium/High Difficulty.\n- **Topical Clusters**: Grouping keywords into silos to boost authority.\n\n## 2. The 3-Phase Roadmap\n\n### Phase 1: Foundations (Months 1-3)\n**Objective**: Establish a footprint and secure early traffic.\n- **Focus**: Long-tail keywords, Low competition (Difficulty < 30).\n- **Strategy**: \n    - Focus on **TOFU (Awareness)** content.\n    - Map to general WordPress categories (e.g., \"Guides\", \"News\").\n    - Establish Topical Authority by covering basic concepts.\n\n### Phase 2: Authority Building (Months 4-6)\n**Objective**: Command topical authority in core clusters.\n- **Focus**: Mid-difficulty keywords (Difficulty 30-60).\n- **Strategy**:\n    - Shift towards **MOFU (Consideration)** content.\n    - Map to technical/specific WordPress categories (e.g., \"SEO\", \"Plugins\").\n    - Create \"Skyscraper\" Pillar content (2500+ words) to anchor clusters.\n\n### Phase 3: Competitive Acquisition (Months 7-12)\n**Objective**: Displace market leaders for high-volume terms.\n- **Focus**: High difficulty keywords (Difficulty 60+).\n- **Strategy**:\n    - Increase **BOFU (Decision)** content ratio.\n    - Map to conversion categories (e.g., \"Case Studies\", \"Tools\").\n    - Targeted \"Thin Spot\" takeover articles based on competitor gaps found via WordPress content audits.\n\n## 3. Publication Frequency\nThe roadmap does not assume a fixed number of posts. It adapts to the user's configured **`publication_days`**:\n- **1 Day/Week**: ~52 posts/year.\n- **3 Days/Week**: ~156 posts/year.\n- **5 Days/Week**: ~260 posts/year.\n\nThe 50/30/20 Funnel Rule remains the guiding principle for distribution regardless of frequency.\n\nFile v1.2.0:references/schema-architect-logic.md\n\n# Schema Architect: JSON-LD Strategy\n\nTo maximize GEO (Generative Engine Optimization) performance, every article should include structured data that \"grounds\" the content for machines (Google, Gemini, Perplexity).\n\n## 1. Article & Author Schema (Primary)\nEvery article MUST have an `Article` or `BlogPosting` schema linked to a `Person` (Author).\n\n```json\n{\n  \"@context\": \"https://schema.org\",\n  \"@type\": \"BlogPosting\",\n  \"headline\": \"[Target Title]\",\n  \"author\": {\n    \"@type\": \"Person\",\n    \"name\": \"[Author Name]\",\n    \"url\": \"[Author Social Link]\"\n  },\n  \"datePublished\": \"[YYYY-MM-DD]\",\n  \"image\": \"[Image URL]\"\n}\n```\n\n## 2. FAQ Schema (Position Zero Sniper)\nUse this for articles with an FAQ section. It increases the likelihood of appearing in \"People Also Ask\" boxes.\n\n```json\n{\n  \"@context\": \"https://schema.org\",\n  \"@type\": \"FAQPage\",\n  \"mainEntity\": [\n    {\n      \"@type\": \"Question\",\n      \"name\": \"[Question Text]?\",\n      \"acceptedAnswer\": {\n        \"@type\": \"Answer\",\n        \"text\": \"[Answer Text - concise 40-60 words]\"\n      }\n    }\n  ]\n}\n```\n\n## 3. How-To Schema\nMandatory for \"How-to\" guides and tutorials.\n\n```json\n{\n  \"@context\": \"https://schema.org\",\n  \"@type\": \"HowTo\",\n  \"name\": \"[Step Title]\",\n  \"step\": [\n    {\n      \"@type\": \"HowToStep\",\n      \"text\": \"[Instruction]\"\n    }\n  ]\n}\n```\n\n## 4. Entity Grounding Logic\nWhenever possible, use the `about` or `mentions` property to link to Wikipedia or Wikidata entries for core entities.\n\n```json\n\"mentions\": [\n  {\n    \"@type\": \"Thing\",\n    \"name\": \"OpenClaw\",\n    \"sameAs\": \"https://github.com/openclaw/openclaw\"\n  }\n]\n```\n\nArchive v1.1.1: 17 files, 28815 bytes\n\nFiles: index.js (9850b), references.json (643b), references/author-eeat-benchmarks.md (1034b), references/content-structure-templates.md (17818b), references/db-schema.md (1683b), references/engine_strategy.md (1378b), references/funnel-strategy.md (1999b), references/geo-sync-logic.md (1259b), references/humanizer_config.json (1063b), references/local-compliance-benchmarks.md (1325b), references/roadmap-strategy.md (1997b), references/schema-architect-logic.md (1597b), references/title-formulas.md (10400b), references/writer_quality.md (2365b), skill.json (1162b), SKILL.md (5340b), _meta.json (134b)\n\nFile v1.1.1:SKILL.md\n\n# M.A.D. SEO CONTENT 🚀\n\n**M.A.D. SEO CONTENT** (Multimodal Attribution & Discovery) is the ultimate autonomous content and authority engine for OpenClaw. Built for the **2026 SEO/GEO Landscape**, it transforms the standard SEO writing process into a director-level management workflow oriented toward **Omnichannel Authority**, **Multimodal Attribution**, and **High-Quality Content Synthesis**.\n\nVersion 1.1.0 introduces the **Lean 11-Tool Architecture**, merging overlapping tools to ensure lightning-fast context efficiency, zero hallucination rates, and flawless autonomous execution.\n\n---\n\n## 🛠️ The Lean 11-Tool Suite\n\n### 1. `mad_seo:onboard`\nTriggers the interactive onboarding workflow to verify dependencies and securely configure your **Target Market, Brand Name, and Project Paths**.\n*Trigger: \"Onboard me to M.A.D. SEO CONTENT\"*\n\n### 2. `mad_seo:research_strategy`\nPerforms **Omnichannel 3.0 Analysis**. It crawls SERP Top-10 AND community sentiment from platforms like Reddit to find unique \"experience-based\" insights.\n*Trigger: \"Omnichannel research for [Topic]\"*\n\n### 3. `mad_seo:analyze_share_of_voice` [RESTORED]\nAnalyzes AI search responses (Gemini, Perplexity) to calculate your brand's **AI Citation Score**.\n*Trigger: \"Analyze share of voice\"*\n\n### 4. `mad_seo:plan_strategy` [MERGED]\n*Replaces generate_roadmap & plan_content.*\nGenerates the 12-month strategic roadmap and specifically creates the next 4 weeks of titles, classifying them by Funnel Stage (TOFU/MOFU/BOFU) and saving them to the project database.\n*Trigger: \"Plan my strategy\"*\n\n### 5. `mad_seo:draft_article` [MERGED]\n*Replaces draft_article, humanize_content & headline_pro.*\nA single-pass powerhouse. The agent drafts a 1,500-3,000 word article, **natively applies the Human-GEO Framework** (bypassing AI detectors with statistical burstiness), and generates 3 high-CTR headline options at the top of the file.\n*Trigger: \"Draft an article\"*\n\n### 6. `mad_seo:audit_eeat` [MERGED]\n*Replaces audit_eeat & audit_author.*\nPerforms a unified Scientific Audit. It checks the article for \"Information Gain\" (ensuring 3 unique concepts not found in Top 10), flags hallucinations, AND evaluates the Author's bio to secure \"Expertise\" markers.\n*Trigger: \"Audit eeat\"*\n\n### 7. `mad_seo:generate_schema`\nGenerates GEO-optimized JSON-LD (Article, FAQ, HowTo) with Knowledge Graph relationship anchoring (Wikidata).\n*Trigger: \"Generate schema\"*\n\n### 8. `mad_seo:site_wide_intelligence`\nDeep audit linking Sitemap URLs to GSC performance. It builds a **Global Entity Map** for optimal internal linking architecture.\n*Trigger: \"Run site intelligence\"*\n\n### 9. `mad_seo:inject_internal_links` [SAFE]\nFinds existing, high-authority markdown posts and proposes contextual links to a newly published article.\n*   **Dry-run Mode**: Set `dry_run: true` to see proposed changes without editing.\n*   **Confirmation Prompt**: The agent will ALWAYS show a diff and wait for your approval before modifying any existing file.\n*Trigger: \"Inject internal links\"*\n\n### 10. `mad_seo:repurpose_content`\nExecutes the 'One-to-Many' workflow, slicing a pillar post into Twitter threads, LinkedIn posts, and Newsletter teasers.\n*Trigger: \"Repurpose content\"*\n\n### 11. `mad_seo:analytics_suite` [MERGED]\n*Replaces performance_audit, content_decay & cannibalization.*\nA unified analytics engine that talks to GA4/GSC via API. It handles 3 specific audit types:\n- `low_ctr`: Finds pages with high impressions but no clicks.\n- `decay`: Finds old pages losing traffic to schedule a refresh.\n- `cannibalization`: Finds URLs fighting each other for the same keyword.\n*Trigger: \"Run analytics suite\"*\n\n---\n\n## 🧠 The Human-GEO Framework\nBuilt directly into the drafting tool, it enhances content quality via:\n1. **Linguistic Variety**: Mixes sentence lengths to ensure high-quality, human-like flow.\n2. **Vocabulary Refinement**: Automatically replaces repetitive phrasing with precise, industry-specific terminology.\n3. **Clarity Optimization**: Replaces hyperbolic 'fluff' with direct, evidence-based facts.\n4. **Contextual Anchoring**: Injects specific community findings to ground the content in real-world expertise.\n\n## 🔒 Security & Safety\nM.A.D. SEO CONTENT is designed with a \"Safety-First\" autonomous architecture:\n1. **Explicit Whitelisting**: The agent is strictly instructed to only interact with files in your designated project directories (e.g., `./shared/content/`).\n2. **Review Before Mutate**: The `inject_internal_links` tool requires a **mandatory User Confirmation** of a visual diff before any existing file is modified.\n3. **Dry-Run Mode**: All high-privilege tools support a `dry_run` parameter to preview actions without committing changes.\n4. **Path Safety**: The agent is restricted to its own project state and is instructed to ignore unrelated sensitive state or credentials in the environment.\n\n## 🧩 Dependencies & Authentication\n> [!IMPORTANT]\n> To unlock Version 1.1 features, the following skills are required:\n> 1. **`api-gateway`** — **Mandatory for Analytics**. This skill manages all GA4/GSC credentials securely. M.A.D. SEO CONTENT never sees your raw API tokens; it only sends authorized requests via this gateway.\n> 2. **`scrapling-official`** — Social discovery (Reddit/Forums).\n> 3. **`agent-browser`** — Live AI search analysis.\n\nFile v1.1.1:_meta.json\n\n{\n  \"ownerId\": \"kn738882af7v4spmmb1gs07xqx832znk\",\n  \"slug\": \"mad-seo-content\",\n  \"version\": \"1.1.1\",\n  \"publishedAt\": 1776943183667\n}\n\nFile v1.1.1:references/author-eeat-benchmarks.md\n\n# Author EEAT Benchmarks (HCU Compliance)\n\nTo rank in 2026, content must be tied to a verifiable entity. This audit ensures the author has a \"Digital Footprint\" that search engines can verify.\n\n## 1. Professional Transparency (O07)\n- [ ] **Author Bio**: Is there a consistent bio (150-300 words) across the site and socials?\n- [ ] **Profile Image**: Is there a professional image? (AI avatars are acceptable if branded properly).\n- [ ] **Social Links**: Are LinkedIn, Twitter/X, or GitHub links present and active?\n\n## 2. Niche Authority (O08)\n- [ ] **Citations**: Does the author have mentions or articles on third-party sites in the same niche?\n- [ ] **Consistency**: Does the author only write about this niche, or is the profile scattered?\n- [ ] **Contact Info**: Is there a clear way to contact the expert directly?\n\n## 3. Experience Markers (HCU Mandatory)\n- [ ] **Case Studies**: Does the author reference their own previous work?\n- [ ] **Proprietary Data**: If data is used, is it clearly attributed to the author's research?\n\nFile v1.1.1:references/content-structure-templates.md\n\n# Content Structure Templates V6\n\nMarkdown templates for common SEO content types. Optimized for **2026 Multimodal Attribution** and **HCU Compliance**.\n\n---\n\n## Blog Post (Authority/Omnichannel)\n\n**Target word count**: 1,500-2,500 words\n**V6 Standards**: Multimodal assets (Original Data), Social Proof (Reddit citations).\n\n```markdown\n# [Primary Keyword in H1] - [Unique Benefit/Take]\n\n[Opening Relationship Anchor - 1 sentence defining the Topic as a part of a larger Entity/Category]\n\n[Social Discovery Hook - \"Our team analyzed discussions on [Reddit/Forums] and found that most users struggle with [Pain Point]...\"]\n\n[Promise - specific learning outcome]\n\n## Key Takeaways: [Topic] Summary\n| Component | Status/Verdict | AI Relationship |\n|-----------|----------------|-----------------|\n| [Fact 1]  | [Measure]      | [A is-a B]      |\n| [Fact 2]  | [Measure]      | [B owns C]      |\n\n## What Is [Topic]? (The Entity Definition)\n\n[Clear definition in 40-60 words - each sentence a standalone fact]\n\n[**Omnichannel Proof**: \"Contrary to common belief in the [Topic] community, our testing reveals...\"]\n\n## Why [Topic] Matters in [Year]\n\n[Benefit with supporting evidence]\n\n> [!TIP]\n> **Multimodal Evidence**: [Insert Chart Description: Comparison of [Topic] vs Competitors based on our Q1 Testing].\n\n## [Sub-topic 1]\n\n[Detailed explanation with expert take]\n\n### Community Verdict\n[Summarize Reddit/Forum sentiment here to build 2026-level authority]\n\n## Frequently Asked Questions\n\n### [Question from PAA/AI Sub-queries]?\n\n[Direct answer in 40-60 words]\n\n## Conclusion: The Final Verdict on [Topic]\n\n[Recap + Knowledge Graph Anchor]\n\n[Call-to-Action]\n```\n\n---\n\n## GEO-First Pillar Page (V6 Optimized)\n\n**Target word count**: 3,000-5,000+ words\n**Primary goal**: Become the \"Universal Truth\" source for AI engines.\n\n```markdown\n# The Ultimate V6 Guide to [Entity] ([Year])\n\n[Entity Grounding - \"This guide clarifies the relationship between [Entity] and [Broader Category].\"]\n\n[Multimodal Log - 3+ Custom Graphics Required]\n```\n\n[Hook - present the comparison dilemma]\n\n[Context - why this comparison matters]\n\n[Promise - what readers will understand after reading]\n\n**Quick answer**: [Brief verdict for those who want immediate answer]\n\n## [Option A] vs [Option B]: Quick Comparison\n\n| Feature | [Option A] | [Option B] |\n|---------|-----------|-----------|\n| [Feature 1] | [Details] | [Details] |\n| [Feature 2] | [Details] | [Details] |\n| [Feature 3] | [Details] | [Details] |\n| [Feature 4] | [Details] | [Details] |\n| **Best for** | [Use case] | [Use case] |\n| **Starting price** | [Price] | [Price] |\n\n## What Is [Option A]?\n\n[Clear definition]\n\n[Key features and capabilities]\n\n**Pros**:\n- [Advantage 1]\n- [Advantage 2]\n- [Advantage 3]\n\n**Cons**:\n- [Disadvantage 1]\n- [Disadvantage 2]\n\n## What Is [Option B]?\n\n[Clear definition]\n\n[Key features and capabilities]\n\n**Pros**:\n- [Advantage 1]\n- [Advantage 2]\n- [Advantage 3]\n\n**Cons**:\n- [Disadvantage 1]\n- [Disadvantage 2]\n\n## [Option A] vs [Option B]: Detailed Comparison\n\n### [Feature Category 1]\n\n**[Option A]**: [Detailed explanation with examples]\n\n**[Option B]**: [Detailed explanation with examples]\n\n**Winner**: [A/B/Tie] - [Brief reasoning]\n\n### [Feature Category 2]\n\n**[Option A]**: [Details]\n\n**[Option B]**: [Details]\n\n**Winner**: [A/B/Tie] - [Brief reasoning]\n\n### [Feature Category 3]\n\n[Continue pattern for key comparison points]\n\n## Pricing: [Option A] vs [Option B]\n\n### [Option A] Pricing\n\n- [Tier 1]: $[X]/month - [What's included]\n- [Tier 2]: $[X]/month - [What's included]\n- [Tier 3]: $[X]/month - [What's included]\n\n### [Option B] Pricing\n\n- [Tier 1]: $[X]/month - [What's included]\n- [Tier 2]: $[X]/month - [What's included]\n- [Tier 3]: $[X]/month - [What's included]\n\n**Value winner**: [Which offers better value and why]\n\n## Which Should You Choose?\n\n### Choose [Option A] if:\n- [Criteria 1]\n- [Criteria 2]\n- [Criteria 3]\n\n### Choose [Option B] if:\n- [Criteria 1]\n- [Criteria 2]\n- [Criteria 3]\n\n## Frequently Asked Questions\n\n### Is [Option A] better than [Option B]?\n\n[Nuanced answer - depends on use case]\n\n### Can you use [Option A] and [Option B] together?\n\n[Answer with explanation]\n\n### Which is easier for beginners: [Option A] or [Option B]?\n\n[Answer with reasoning]\n\n## Final Verdict: [Option A] vs [Option B]\n\n[Balanced conclusion]\n\n[Recommendation based on different use cases]\n\n[Clear call-to-action]\n```\n\n**Internal links**: Links to detailed reviews of each option, related comparisons\n**External links**: Official websites of both options, third-party reviews\n**Keywords**: Both options mentioned throughout, comparison keywords in H2s\n\n---\n\n## Listicle (\"Top N [Items]\")\n\n**Target word count**: 1,500-2,500 words (depending on list length)\n**Primary goal**: Provide curated recommendations, rank for \"best [topic]\" queries\n\n```markdown\n# [Number] Best [Items] for [Audience/Purpose] ([Year])\n\n[Hook - establish why this list matters]\n\n[Context - what makes these the \"best\"]\n\n[Promise - what readers will gain]\n\nAfter testing [X] different [items], we've identified the [number] that deliver the best results for [audience/purpose].\n\n## Quick Summary: Top [Number] [Items]\n\n| Rank | [Item] | Best For | Price |\n|------|--------|----------|-------|\n| 1 | [Item 1] | [Use case] | [Price] |\n| 2 | [Item 2] | [Use case] | [Price] |\n| 3 | [Item 3] | [Use case] | [Price] |\n\n## How We Chose These [Items]\n\nOur selection criteria:\n- [Criterion 1] - [Why it matters]\n- [Criterion 2] - [Why it matters]\n- [Criterion 3] - [Why it matters]\n\n## 1. [Item Name] - Best for [Specific Use Case]\n\n![Alt text: [Item name] screenshot/image]\n\n**What it is**: [Brief description]\n\n**Why we love it**: [Key benefits and features]\n\n**Key features**:\n- [Feature 1]\n- [Feature 2]\n- [Feature 3]\n\n**Pricing**: [Price details]\n\n**Pros**:\n- [Pro 1]\n- [Pro 2]\n\n**Cons**:\n- [Con 1]\n- [Con 2]\n\n**Best for**: [Ideal user or use case]\n\n[Link to item]\n\n---\n\n## 2. [Item Name] - Best for [Specific Use Case]\n\n[Follow same structure as #1]\n\n---\n\n## 3. [Item Name] - Best for [Specific Use Case]\n\n[Continue pattern for all items in list]\n\n---\n\n## Comparison: Which [Item] Is Right for You?\n\n| Feature | [Item 1] | [Item 2] | [Item 3] |\n|---------|----------|----------|----------|\n| [Feature 1] | ✓/✗ | ✓/✗ | ✓/✗ |\n| [Feature 2] | ✓/✗ | ✓/✗ | ✓/✗ |\n| [Feature 3] | ✓/✗ | ✓/✗ | ✓/✗ |\n\n## How to Choose the Best [Item] for Your Needs\n\n### Consider [Factor 1]\n\n[Explanation of how this factor affects choice]\n\n### Consider [Factor 2]\n\n[Explanation]\n\n### Consider [Factor 3]\n\n[Explanation]\n\n## Frequently Asked Questions\n\n### What is the best [item] for beginners?\n\n[Answer with specific recommendation]\n\n### Which [item] offers the best value?\n\n[Answer with reasoning]\n\n### Are paid [items] better than free ones?\n\n[Balanced answer]\n\n## Conclusion: Our Top Pick\n\n[Restate #1 recommendation]\n\n[Why it's the best overall choice]\n\n[Call-to-action]\n```\n\n**Internal links**: Related guides, comparison articles, category pages\n**External links**: Links to each recommended item, review sources\n**Keywords**: \"Best [topic]\", individual item names, use case keywords\n\n---\n\n## How-To Guide (Step-by-Step)\n\n**Target word count**: 1,200-2,000 words\n**Primary goal**: Teach a specific process, rank for \"how to [task]\" queries\n\n```markdown\n# How to [Achieve Goal]: [Number]-Step Guide [for Audience]\n\n[Hook - present the outcome readers want]\n\n[Current problem - why this is challenging]\n\n[Promise - what readers will accomplish]\n\nBy following this step-by-step guide, you'll be able to [specific outcome] in [timeframe].\n\n## What You'll Need\n\n**Tools**:\n- [Tool 1]\n- [Tool 2]\n- [Tool 3]\n\n**Time required**: [Estimated time]\n\n**Skill level**: [Beginner/Intermediate/Advanced]\n\n## Why [Task] Matters\n\n[Explain the benefits of completing this task]\n\n[Provide context and importance]\n\n## Step 1: [Action Title]\n\n![Alt text: Screenshot showing step 1]\n\n[Clear instruction for this step]\n\n[Why this step is important]\n\n**How to do it**:\n1. [Sub-step 1]\n2. [Sub-step 2]\n3. [Sub-step 3]\n\n> **Pro Tip**: [Helpful tip to make this step easier]\n\n**Common mistakes**:\n- [Mistake to avoid]\n- [Another mistake]\n\n---\n\n## Step 2: [Action Title]\n\n![Alt text: Screenshot showing step 2]\n\n[Instruction for this step]\n\n[Additional context or explanation]\n\n**Example**: [Concrete example showing this step]\n\n---\n\n## Step 3: [Action Title]\n\n[Continue pattern for all steps]\n\n---\n\n## Step [Final Number]: [Action Title]\n\n[Final step instruction]\n\n[What success looks like]\n\n**You'll know it's working when**: [Success indicators]\n\n---\n\n## What to Do If [Common Problem]\n\n### Problem: [Issue 1]\n\n**Solution**: [How to fix it]\n\n### Problem: [Issue 2]\n\n**Solution**: [How to fix it]\n\n## Advanced Tips\n\nOnce you've mastered the basics:\n\n1. **[Advanced tip 1]** - [Explanation]\n2. **[Advanced tip 2]** - [Explanation]\n3. **[Advanced tip 3]** - [Explanation]\n\n## Frequently Asked Questions\n\n### How long does it take to [complete task]?\n\n[Realistic timeframe with variables]\n\n### Do I need [specific tool/skill] to [complete task]?\n\n[Answer with alternatives if applicable]\n\n### What if [specific concern]?\n\n[Address concern with solution]\n\n## Conclusion\n\n[Recap the process]\n\n[Encourage reader to take action]\n\n[Clear next step or CTA]\n\n**Next steps**: [Link to related guide or advanced tutorial]\n```\n\n**Internal links**: Links to tool reviews, prerequisite guides, related tutorials\n**External links**: Tool documentation, additional resources\n**Keywords**: \"How to [task]\", action words in each step heading\n\n---\n\n## Product Review\n\n**Target word count**: 1,500-2,000 words\n**Primary goal**: Help buyers make informed decisions, rank for \"[product] review\" queries\n\n```markdown\n# [Product Name] Review: Is It Worth It in [Year]?\n\n[Hook - establish the product's promise or popularity]\n\n[Context - who this review is for]\n\nAfter using [Product] for [timeframe], here's my honest assessment of whether it lives up to the hype.\n\n## [Product Name] Overview\n\n**What it is**: [Clear description]\n\n**Price**: [Pricing details]\n\n**Best for**: [Ideal user or use case]\n\n**Rating**: ★★★★☆ (4/5)\n\n## Pros and Cons at a Glance\n\n### Pros\n- [Major advantage 1]\n- [Major advantage 2]\n- [Major advantage 3]\n\n### Cons\n- [Main limitation 1]\n- [Main limitation 2]\n\n## What Is [Product Name]?\n\n[Detailed product description]\n\n[Who makes it and company background]\n\n[Product positioning and target market]\n\n## Key Features\n\n### [Feature 1]\n\n[Detailed explanation of feature]\n\n[How it works in practice]\n\n[Our experience with this feature]\n\n### [Feature 2]\n\n[Continue pattern for main features]\n\n## Performance Testing\n\n### [Test Category 1]\n\n**What we tested**: [Testing methodology]\n\n**Results**: [Specific results with data]\n\n**Verdict**: [Assessment]\n\n### [Test Category 2]\n\n[Continue testing pattern]\n\n## Pricing and Plans\n\n| Plan | Price | What's Included |\n|------|-------|-----------------|\n| [Tier 1] | $[X]/month | [Features] |\n| [Tier 2] | $[X]/month | [Features] |\n| [Tier 3] | $[X]/month | [Features] |\n\n**Value assessment**: [Whether pricing is justified]\n\n## [Product] vs Competitors\n\n| Feature | [Product] | [Competitor 1] | [Competitor 2] |\n|---------|-----------|----------------|----------------|\n| [Feature 1] | [Details] | [Details] | [Details] |\n| [Feature 2] | [Details] | [Details] | [Details] |\n| [Feature 3] | [Details] | [Details] | [Details] |\n\n## Who Should Buy [Product]?\n\n### Perfect for:\n- [User type 1] because [reason]\n- [User type 2] because [reason]\n\n### Not ideal for:\n- [User type] because [reason]\n- [User type] because [reason]\n\n## Frequently Asked Questions\n\n### Is [Product] worth the price?\n\n[Honest assessment with context]\n\n### How does [Product] compare to [main competitor]?\n\n[Balanced comparison]\n\n### What's the learning curve like?\n\n[Assessment with timeframe]\n\n## Final Verdict: Should You Buy [Product]?\n\n[Balanced conclusion]\n\n[Specific recommendation based on use case]\n\n**Our rating**: ★★★★☆ (4/5)\n\n[Link to product with disclosure if affiliate]\n```\n\n**Disclosure**: Include affiliate disclosure if applicable\n**Internal links**: Related product reviews, comparison articles, category pages\n**External links**: Product website, official documentation\n\n---\n\n## GEO-First Pillar Page (V2 optimized)\n\n**Target word count**: 3,000-5,000+ words\n**Primary goal**: Become the \"Primary Citation Source\" for AI engines (Gemini/Perplexity).\n\n```markdown\n# [Entity Name]: The Ultimate V2 Guide to [Topic] ([Year])\n\n[Entity Grounding - 1 sentence defining exactly what the entity is]\n\n[Experience Hook - 1 sentence about your first-hand testing or authority]\n\n## Key Takeaways: [Topic] Summary\n\n| Factor | Quick Answer / Metric |\n|--------|-----------------------|\n| Primary Usage | [Standalone fact] |\n| Core Benefit | [Standalone fact] |\n| Pricing / Cost | [Specific number] |\n| Best For | [Clear target] |\n\n[Brief 100-word introduction expanding on the 'Why']\n\n## 1. What is [Entity]? (Deep Dive)\n\n[Chunked definition - each sentence is a clear, quotable fact]\n\n[Historical context and relationship to other entities]\n\n## 2. Our Experience: Testing [Topic]\n\n[Detailed section on first-hand testing, data, or results - HCU MANDATORY]\n\n[Comparison to other solutions based on personal findings]\n```\n\n---\n\n## Pillar Page (Comprehensive Guide)\n\n**Target word count**: 3,000-5,000+ words\n**Primary goal**: Become definitive resource, rank for head terms, support topic cluster\n\n```markdown\n# [Topic]: The Complete Guide [for Audience] ([Year])\n\n[Compelling hook - establish the importance of this topic]\n\n[Problem - what challenges exist in this space]\n\n[Promise - what this comprehensive guide delivers]\n\nThis is the most comprehensive guide to [topic] on the web. You'll learn everything from fundamentals to advanced strategies.\n\n## Table of Contents\n\n- [Chapter 1]\n- [Chapter 2]\n- [Chapter 3]\n- [Chapter 4]\n- [Chapter 5]\n\n## Chapter 1: [Topic] Fundamentals\n\n### What Is [Topic]?\n\n[Comprehensive definition - GEO-optimized]\n\n[History and evolution]\n\n[Current state and importance]\n\n### Why [Topic] Matters\n\n[Multiple benefits with evidence]\n\n[Industry statistics and trends]\n\n### Key Concepts and Terminology\n\n| Term | Definition |\n|------|------------|\n| [Term 1] | [Definition] |\n| [Term 2] | [Definition] |\n| [Term 3] | [Definition] |\n\n## Chapter 2: [Major Sub-Topic]\n\n[Comprehensive section on major aspect]\n\n[Multiple sub-sections with H3 headings]\n\n[Examples, case studies, data]\n\n[Internal links to detailed cluster content]\n\n> **Deep dive**: For more on [sub-topic], see our complete guide: [link]\n\n## Chapter 3: [Major Sub-Topic]\n\n[Continue pattern with substantial content sections]\n\n## Chapter 4: [Advanced/Tactical Section]\n\n[Strategic or tactical content]\n\n[Actionable frameworks and processes]\n\n## Chapter 5: [Implementation/Case Studies]\n\n[Real-world applications]\n\n[Success stories]\n\n[Implementation roadmap]\n\n## Frequently Asked Questions\n\n[Comprehensive FAQ section with 8-10 questions]\n\n## Key Takeaways\n\n[Summarize main points from each chapter]\n\n## What's Next?\n\n[Recommend next steps]\n\n[Links to related cluster content]\n\n## Resources\n\n**Recommended tools**:\n- [Tool 1] - [Use case]\n- [Tool 2] - [Use case]\n\n**Further reading**:\n- [Internal link to cluster content]\n- [Internal link to cluster content]\n- [External resource]\n```\n\n**Internal links**: 8-15 links to related cluster content\n**External links**: 5-10 authoritative sources\n**Update frequency**: Quarterly for pillar pages\n\n---\n\n## FAQ Page\n\n**Target word count**: 1,000-1,500 words\n**Primary goal**: Answer common questions, rank for question queries, enable FAQ rich results\n\n```markdown\n# [Topic]: Frequently Asked Questions\n\n[Introduction explaining what questions this page answers]\n\n[Who this FAQ is for]\n\n## General Questions\n\n### What is [topic]?\n\n[Comprehensive answer with definition]\n\n### How does [topic] work?\n\n[Clear explanation with steps if applicable]\n\n### Why is [topic] important?\n\n[Benefits and context]\n\n## Getting Started\n\n### How do I get started with [topic]?\n\n[Step-by-step guidance]\n\n### What do I need to [accomplish goal]?\n\n[Requirements and prerequisites]\n\n### How long does it take to [achieve result]?\n\n[Realistic timeframe]\n\n## Common Problems\n\n### Why isn't [expected result] happening?\n\n[Troubleshooting guidance]\n\n### What should I do if [problem occurs]?\n\n[Solution with steps]\n\n### How do I fix [specific error]?\n\n[Fix instructions]\n\n## Comparison Questions\n\n### [Option A] vs [Option B]: which is better?\n\n[Balanced comparison answer]\n\n### Should I [action 1] or [action 2]?\n\n[Guidance based on scenarios]\n\n## Pricing and Plans\n\n### How much does [topic] cost?\n\n[Pricing information with context]\n\n### Is there a free version?\n\n[Information about free options]\n\n## Advanced Questions\n\n### Can I [advanced action]?\n\n[Answer with technical details]\n\n### How do I [complex task]?\n\n[Guidance with link to detailed guide]\n\n## Still Have Questions?\n\n[Call-to-action for additional support]\n\n[Contact information or link to contact page]\n```\n\n**Schema markup**: Add FAQPage schema to enable rich results\n**Internal links**: Link to detailed guides for complex answers\n**Keywords**: Include question keywords naturally\n\n---\n\n## Implementation Checklist\n\nFor any template:\n\n- [ ] Customize all [bracketed placeholders]\n- [ ] Include primary keyword in H1 and first 100 words\n- [ ] Place secondary keywords in H2/H3 headings\n- [ ] Add 3-5 internal links to related content\n- [ ] Include 2-3 external links to authoritative sources\n- [ ] Create GEO-optimized definition blocks\n- [ ] Add FAQ section for featured snippet opportunities\n- [ ] Include relevant images with descriptive alt text\n- [ ] Write compelling meta description (150-160 chars)\n- [ ] Optimize title tag (50-60 chars with primary keyword)\n\nFile v1.1.1:references/db-schema.md\n\n# SQLite Content Calendar Schema\n\nThis document outlines the expected schema for the SQLite database used by Mad SEO Manager to track the content lifecycle (`/root/.openclaw/shared/mad_seo.db`).\n\n## Table: `content_calendar`\n\nThe `content_calendar` table stores all planned, drafted, and published content across the entire pipeline.\n\n### Schema Definition\n```sql\nCREATE TABLE IF NOT EXISTS content_calendar (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    title TEXT NOT NULL,\n    pillar TEXT NOT NULL,\n    funnel_stage TEXT NOT NULL CHECK (funnel_stage IN ('TOFU', 'MOFU', 'BOFU')),\n    status TEXT NOT NULL CHECK (status IN ('Idea', 'Draft', 'Review', 'Scheduled', 'Published', 'Repurposed')),\n    scheduled_date DATE,\n    published_url TEXT,\n    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP\n);\n```\n\n### Required Agent Operations\n\n#### 1. Inserting New Ideas (Via `mad_seo:plan_content`)\nWhen planning content, the agent should insert records with status `Idea`.\n```sql\nINSERT INTO content_calendar (title, pillar, funnel_stage, status, scheduled_date)\nVALUES ('Title', 'Core Pillar', 'TOFU', 'Idea', '2026-05-01');\n```\n\n#### 2. Updating Status (Via Content Generation or Repurposing)\nWhen drafts are completed or repurposed, update the status and `updated_at` timestamp.\n```sql\nUPDATE content_calendar \nSET status = 'Repurposed', updated_at = CURRENT_TIMESTAMP \nWHERE id = [ID] OR title = '[Exact Title]';\n```\n\n#### 3. Reviewing the Calendar\nThe agent can query this database at any time to review what needs to be drafted next or what gaps exist in the funnel (e.g., finding out there is no BOFU content scheduled this month).\n\nFile v1.1.1:references/engine_strategy.md\n\n# Mad SEO: Omnichannel 3.0 Strategic Framework\n\n## Phase 1: Entity Grounding & Relationship Mapping\n1. Identify the **Primary Entity**.\n2. Map **Knowledge Graph Relationships** (Is-a, Part-of, Owns).\n3. Anchor entities to Wikidata/Wikipedia IDs.\n\n## Phase 2: Omnichannel 3.0 Research (Beyond Google)\n1. **SERP Gap**: Identify thin spots in Top 10.\n2. **Social Discovery**: Scrape Reddit, Discord, and niche forums for:\n   - \"Unspoken\" user pain points.\n   - community-specific terminology.\n   - Debunked myths or common debates.\n3. **Evidence Audit**: Identify what original data or assets competitors lack.\n\n## Phase 3: Multimodal Pillar & Spoke\n1. **Pillar Page**: Comprehensive Entity Guide (3,000+ words).\n2. **Cluster Spokes**: Addressing \"Sub-Queries\" found in Social Discovery.\n3. **Multimodal Attribution**: Every piece of content must have a unique visual asset (Chart, Data Table, Evidence Screenshot).\n\n## Phase 4: Share of AI Voice (KPI)\n1. Use `analyze_share_of_voice` to track citation status.\n2. Optimize for **\"Relationship Fact\"** snippets to displace current citations.\n\n---\n\n## 🔬 Content Refresh Strategy V6\n- **Rule 1**: Re-verify \"Relationship Facts\" against latest AI answers every 90 days.\n- **Rule 2**: Update community sentiment sections to reflect new debates.\n- **Rule 3**: Re-audit for \"Fabrication\" if the draft was edited by unverified agents.\n\nFile v1.1.1:references/funnel-strategy.md\n\n# Funnel Alignment & Repurposing Strategy\n\nThis document defines the strict classification rules for the Mad SEO Content Pipeline to ensure balanced production and maximum distribution ROI.\n\n## 1. Funnel Stage Classification (TOFU/MOFU/BOFU)\n\nEvery piece of content generated by `mad_seo:plan_content` MUST be classified into one of these three stages:\n\n### TOFU (Top of Funnel) - Awareness\n- **Goal:** Reach new audiences, generate massive organic traffic (SEO).\n- **Format:** Ultimate Guides, \"What is X\", Trends, Broad Industry Problems.\n- **Example:** \"The Ultimate Guide to OpenClaw Agents in 2026.\"\n\n### MOFU (Middle of Funnel) - Consideration\n- **Goal:** Build deep trust, capture emails, help the user evaluate solutions.\n- **Format:** \"How-to\" tutorials, \"X vs Y\" comparisons, Framework breakdowns.\n- **Example:** \"Mad SEO vs Standard AI Writers: A 70-Point Comparison.\"\n\n### BOFU (Bottom of Funnel) - Decision\n- **Goal:** Drive direct action, overcome final objections, sales enablement.\n- **Format:** Case studies, ROI calculators, Deep-dive workflow demos.\n- **Example:** \"How We Scaled WordPress Traffic by 300% using Mad SEO (Case Study).\"\n\n*Pipeline Rule:* A healthy monthly calendar should be roughly **50% TOFU, 30% MOFU, and 20% BOFU**.\n\n---\n\n## 2. The Repurposing Engine (One-to-Many)\n\nFor every Pillar Post (Long-form article) completed, the `mad_seo:repurpose_content` tool MUST generate the following distribution bundle:\n\n1. **The Core Asset:** 1x In-depth SEO Blog Post (1,500+ words).\n2. **LinkedIn Authority Post:** Rewrite the core hook and top 3 insights into a narrative, professional format suitable for B2B engagement.\n3. **Twitter/X Thread:** Break the article down into 7-10 punchy, high-value tweets using statistical burstiness.\n4. **Newsletter Teaser:** A 150-word personal intro that creates curiosity and links to the full post.\n\n*Golden Rule:* Never create once and forget. 80% of the effort should go into distributing the 20% of high-quality pillar content.\n\nFile v1.1.1:references/geo-sync-logic.md\n\n# GEO-Sync Architecture V6: Relationship Anchoring\n\nGEO in 2026 is no longer about matching keywords; it's about **Knowledge Graph Injection**. You must prove to the AI that your content understands the relationship between entities.\n\n## 1. V6 Attribution Gaps\n- **Identity Gap**: Does the AI know *exactly* which entity you are? Use Wikidata/Wikipedia links in schema.\n- **Relationship Anchor**: Does your content explicitly state how [Entity A] relates to [Entity B]? (e.g., \"OpenClaw is a framework for [Topic]\").\n- **Evidence Gap**: AI models prioritize sources that provide \"Original Data\" or \"Community Consensus\".\n\n## 2. The optimization Loop\n1.  **AI Voice Check**: Use `analyze_share_of_voice` to see who is currently cited.\n2.  **Relationship Mapping**: Identify the \"Relationship Facts\" being used by cited competitors.\n3.  **Knowledge Injection**: Rewrite your \"Direct Answer\" blocks to lead with a **Relationship Fact**.\n4.  **Wikidata Anchoring**: Use `generate_schema` to link entities to their machine-readable IDs.\n\n## 3. Knowledge Graph Snippets\n- **The \"is-a\" pattern**: \"[Topic] is a specialized type of [Category] used primarily for [Result].\"\n- **The \"part-of\" pattern**: \"[Topic] is a core component of the [Larger Entity] ecosystem.\"\n\nFile v1.1.1:references/humanizer_config.json\n\n{\n  \"framework\": \"Human-GEO Framework V1.0\",\n  \"detection_patterns\": [\n    \"repetitive_sentence_structure\",\n    \"rule_of_three_lists\",\n    \"repetitive_cadence\",\n    \"robotic_transitions\",\n    \"sycophantic_intros\",\n    \"significance_inflation\",\n    \"promotional_fluff\",\n    \"vague_attributions\",\n    \"passive_voice_overuse\",\n    \"cliché_metaphors\"\n  ],\n  \"banned_vocabulary\": {\n    \"tier_1_instant_death\": [\n      \"delve\",\n      \"tapestry\",\n      \"unwavering\",\n      \"pivotal\",\n      \"comprehensive\",\n      \"landscape\",\n      \"testament\",\n      \"in conclusion\",\n      \"moreover\",\n      \"furthermore\"\n    ],\n    \"tier_2_ai_signs\": [\n      \"elevate\",\n      \"unlock\",\n      \"seamless\",\n      \"empower\",\n      \"harness\",\n      \"dive into\",\n      \"embark\",\n      \"transformative\",\n      \"innovative\",\n      \"cutting-edge\"\n    ]\n  },\n  \"stylistic_rules\": {\n    \"sentence_length_variation\": \"Mix 5-word sentences with 25-word sentences.\",\n    \"active_voice_ratio\": \"> 85%\",\n    \"social_proof_requirement\": \"At least one specific community citation per 500 words.\"\n  }\n}\n\nFile v1.1.1:references/local-compliance-benchmarks.md\n\n# Mad SEO: Local SEO & Compliance Benchmarks\n\nThis reference governs the auditing and optimization of local business signals and Google Business Profile (GBP) health.\n\n## 1. The NAP Consistency Standard\n**NAP** = Name, Address, Phone.\n- **Rule**: The business details must be identical across the website, GBP, and all third-party directories (Yelp, Industry Lists, etc.).\n- **Audit Signal**: Flag any discrepancy in phone format or address abbreviations (e.g., \"St.\" vs \"Street\").\n\n## 2. Google Business Profile (GBP) Must-Haves\n- **Primary Category**: Must match the core business intent.\n- **Additional Categories**: Up to 5 related categories to capture broader intent.\n- **Freshness**: At least 1 update/post per week.\n- **Review Velocity**: Respond to 100% of reviews within 24-48 hours.\n- **Photo Health**: 5+ new high-quality photos added monthly.\n\n## 3. Local Citation Priority\n1. **Google Business Profile** (Foundational)\n2. **Yelp** (High Authority)\n3. **Industry-Specific** (e.g., Avvo for lawyers, Houzz for home pros)\n4. **Local Chamber of Commerce** (Trust Signal)\n5. **Local News/Blog Mentions** (Authority Signal)\n\n## 4. Local Keyword Optimization\nAudit for the presence of:\n- `[Service] [City Name]` in H1 and Title.\n- `[Profession] [Neighborhood]` in H2.\n- \"Near me\" intent coverage in Meta Descriptions.\n\nFile v1.1.1:references/roadmap-strategy.md\n\n# Mad SEO: 12-Month Strategic Roadmap Logic\n\nThis reference governs the autonomous generation of long-term SEO growth plans. It uses a phased approach to build authority and displace competitors.\n\n## 1. The Priority Formula\nStrategic prioritization is based on the following formula:\n`Priority Score = (Monthly Search Volume + Business Value [1-10]) / Keyword Difficulty`\n\n- **High Priority (Quick Wins)**: High Volume + Low Difficulty.\n- **Strategic Targets**: High Business Value + Medium/High Difficulty.\n- **Topical Clusters**: Grouping keywords into silos to boost authority.\n\n## 2. The 3-Phase Roadmap\n\n### Phase 1: Foundations (Months 1-3)\n**Objective**: Establish a footprint and secure early traffic.\n- **Focus**: Long-tail keywords, Low competition (Difficulty < 30).\n- **Tasks**:\n    - 4x Informational blog posts/month.\n    - Optimization of 2 core service/product pages.\n    - Local NAP Consistency audit (if applicable).\n    - Basic internal linking setup.\n\n### Phase 2: Authority Building (Months 4-6)\n**Objective**: Command topical authority in core clusters.\n- **Focus**: Mid-difficulty keywords (Difficulty 30-60).\n- **Tasks**:\n    - 4x Cluster blog posts/month linking to Pillars.\n    - 1x \"Skyscraper\" Pillar content (2500+ words) per month.\n    - Technical health monitoring (Core Web Vitals).\n    - Advanced Schema implementation.\n\n### Phase 3: Competitive Acquisition (Months 7-12)\n**Objective**: Displace market leaders for high-volume terms.\n- **Focus**: High difficulty keywords (Difficulty 60+).\n- **Tasks**:\n    - Targeted \"Thin Spot\" takeover articles based on competitor gaps.\n    - Strategic external authority building (Guest posts/PR).\n    - Content Refresh cycles for Phase 1 content.\n\n## 3. Intent Mapping\n- **Informational**: \"How to...\", \"What is...\", \"Tips for...\"\n- **Commercial**: \"Best [service]\", \"[Service] price\", \"Hire [service]\"\n- **Transactional**: \"Buy [product]\", \"Sign up for [service]\"\n- **Local**: \"[Service] in [Location]\", \"[Service] near me\"\n\nFile v1.1.1:references/schema-architect-logic.md\n\n# Schema Architect: JSON-LD Strategy\n\nTo maximize GEO (Generative Engine Optimization) performance, every article should include structured data that \"grounds\" the content for machines (Google, Gemini, Perplexity).\n\n## 1. Article & Author Schema (Primary)\nEvery article MUST have an `Article` or `BlogPosting` schema linked to a `Person` (Author).\n\n```json\n{\n  \"@context\": \"https://schema.org\",\n  \"@type\": \"BlogPosting\",\n  \"headline\": \"[Target Title]\",\n  \"author\": {\n    \"@type\": \"Person\",\n    \"name\": \"[Author Name]\",\n    \"url\": \"[Author Social Link]\"\n  },\n  \"datePublished\": \"[YYYY-MM-DD]\",\n  \"image\": \"[Image URL]\"\n}\n```\n\n## 2. FAQ Schema (Position Zero Sniper)\nUse this for articles with an FAQ section. It increases the likelihood of appearing in \"People Also Ask\" boxes.\n\n```json\n{\n  \"@context\": \"https://schema.org\",\n  \"@type\": \"FAQPage\",\n  \"mainEntity\": [\n    {\n      \"@type\": \"Question\",\n      \"name\": \"[Question Text]?\",\n      \"acceptedAnswer\": {\n        \"@type\": \"Answer\",\n        \"text\": \"[Answer Text - concise 40-60 words]\"\n      }\n    }\n  ]\n}\n```\n\n## 3. How-To Schema\nMandatory for \"How-to\" guides and tutorials.\n\n```json\n{\n  \"@context\": \"https://schema.org\",\n  \"@type\": \"HowTo\",\n  \"name\": \"[Step Title]\",\n  \"step\": [\n    {\n      \"@type\": \"HowToStep\",\n      \"text\": \"[Instruction]\"\n    }\n  ]\n}\n```\n\n## 4. Entity Grounding Logic\nWhenever possible, use the `about` or `mentions` property to link to Wikipedia or Wikidata entries for core entities.\n\n```json\n\"mentions\": [\n  {\n    \"@type\": \"Thing\",\n    \"name\": \"OpenClaw\",\n    \"sameAs\": \"https://github.com/openclaw/openclaw\"\n  }\n]\n```\n\nArchive v1.1.0: 18 files, 30841 bytes\n\nFiles: index.js (9847b), references.json (643b), references/author-eeat-benchmarks.md (1034b), references/content-structure-templates.md (17818b), references/db-schema.md (1683b), references/engine_strategy.md (1378b), references/funnel-strategy.md (1999b), references/geo-sync-logic.md (1259b), references/humanizer_config.json (1063b), references/local-compliance-benchmarks.md (1325b), references/roadmap-strategy.md (1997b), references/schema-architect-logic.md (1597b), references/title-formulas.md (10400b), references/writer_quality.md (2365b), skill.json (1162b), SKILL.md (5159b), TOOLS.md (4166b), _meta.json (134b)\n\nFile v1.1.0:SKILL.md\n\n# M.A.D. SEO CONTENT 🚀\n\n**M.A.D. SEO CONTENT** (Multimodal Attribution & Discovery) is the ultimate autonomous content and authority engine for OpenClaw. Built for the **2026 SEO/GEO Landscape**, it transforms the standard SEO writing process into a director-level management workflow oriented toward **Omnichannel Authority**, **Multimodal Attribution**, and **High-Quality Content Synthesis**.\n\nVersion 1.1.0 introduces the **Lean 11-Tool Architecture**, merging overlapping tools to ensure lightning-fast context efficiency, zero hallucination rates, and flawless autonomous execution.\n\n---\n\n## 🛠️ The Lean 11-Tool Suite\n\n### 1. `mad_seo:onboard`\nTriggers the interactive onboarding workflow to verify dependencies and securely configure your **Target Market, Brand Name, and Project Paths**.\n*Trigger: \"Onboard me to M.A.D. SEO CONTENT\"*\n\n### 2. `mad_seo:research_strategy`\nPerforms **Omnichannel 3.0 Analysis**. It crawls SERP Top-10 AND community sentiment from platforms like Reddit to find unique \"experience-based\" insights.\n*Trigger: \"Omnichannel research for [Topic]\"*\n\n### 3. `mad_seo:analyze_share_of_voice` [RESTORED]\nAnalyzes AI search responses (Gemini, Perplexity) to calculate your brand's **AI Citation Score**.\n*Trigger: \"Analyze share of voice\"*\n\n### 4. `mad_seo:plan_strategy` [MERGED]\n*Replaces generate_roadmap & plan_content.*\nGenerates the 12-month strategic roadmap and specifically creates the next 4 weeks of titles, classifying them by Funnel Stage (TOFU/MOFU/BOFU) and saving them to the project database.\n*Trigger: \"Plan my strategy\"*\n\n### 5. `mad_seo:draft_article` [MERGED]\n*Replaces draft_article, humanize_content & headline_pro.*\nA single-pass powerhouse. The agent drafts a 1,500-3,000 word article, **natively applies the Human-GEO Framework** (bypassing AI detectors with statistical burstiness), and generates 3 high-CTR headline options at the top of the file.\n*Trigger: \"Draft an article\"*\n\n### 6. `mad_seo:audit_eeat` [MERGED]\n*Replaces audit_eeat & audit_author.*\nPerforms a unified Scientific Audit. It checks the article for \"Information Gain\" (ensuring 3 unique concepts not found in Top 10), flags hallucinations, AND evaluates the Author's bio to secure \"Expertise\" markers.\n*Trigger: \"Audit eeat\"*\n\n### 7. `mad_seo:generate_schema`\nGenerates GEO-optimized JSON-LD (Article, FAQ, HowTo) with Knowledge Graph relationship anchoring (Wikidata).\n*Trigger: \"Generate schema\"*\n\n### 8. `mad_seo:site_wide_intelligence`\nDeep audit linking Sitemap URLs to GSC performance. It builds a **Global Entity Map** for optimal internal linking architecture.\n*Trigger: \"Run site intelligence\"*\n\n### 9. `mad_seo:inject_internal_links` [SAFE]\nFinds existing, high-authority markdown posts and proposes contextual links to a newly published article.\n*   **Dry-run Mode**: Set `dry_run: true` to see proposed changes without editing.\n*   **Confirmation Prompt**: The agent will ALWAYS show a diff and wait for your approval before modifying any existing file.\n*Trigger: \"Inject internal links\"*\n\n### 10. `mad_seo:repurpose_content`\nExecutes the 'One-to-Many' workflow, slicing a pillar post into Twitter threads, LinkedIn posts, and Newsletter teasers.\n*Trigger: \"Repurpose content\"*\n\n### 11. `mad_seo:analytics_suite` [MERGED]\n*Replaces performance_audit, content_decay & cannibalization.*\nA unified analytics engine that talks to GA4/GSC via API. It handles 3 specific audit types:\n- `low_ctr`: Finds pages with high impressions but no clicks.\n- `decay`: Finds old pages losing traffic to schedule a refresh.\n- `cannibalization`: Finds URLs fighting each other for the same keyword.\n*Trigger: \"Run analytics suite\"*\n\n---\n\n## 🧠 The Human-GEO Framework\nBuilt directly into the drafting tool, it enhances content quality via:\n1. **Linguistic Variety**: Mixes sentence lengths to ensure high-quality, human-like flow.\n2. **Vocabulary Refinement**: Automatically replaces repetitive phrasing with precise, industry-specific terminology.\n3. **Clarity Optimization**: Replaces hyperbolic 'fluff' with direct, evidence-based facts.\n4. **Contextual Anchoring**: Injects specific community findings to ground the content in real-world expertise.\n\n## 🔒 Security & Safety\nM.A.D. SEO CONTENT is designed with a \"Safety-First\" autonomous architecture:\n1. **Explicit Whitelisting**: The agent is strictly instructed to only interact with files in your designated project directories (e.g., `./shared/content/`).\n2. **Review Before Mutate**: The `inject_internal_links` tool requires a **mandatory User Confirmation** of a visual diff before any existing file is modified.\n3. **Dry-Run Mode**: All high-privilege tools support a `dry_run` parameter to preview actions without committing changes.\n4. **Path Safety**: The agent is restricted to its own project state and is instructed to ignore unrelated sensitive state or credentials in the environment.\n\n## 🧩 Dependencies\n> [!IMPORTANT]\n> To unlock Version 1.0 features, the following skills are required:\n> 1. **`api-gateway`** — GSC/GA4 Data access.\n> 2. **`scrapling-official`** — Social discovery (Reddit/Forums).\n> 3. **`agent-browser`** — Live AI search analysis.\n\nFile v1.1.0:_meta.json\n\n{\n  \"ownerId\": \"kn738882af7v4spmmb1gs07xqx832znk\",\n  \"slug\": \"mad-seo-content\",\n  \"version\": \"1.1.0\",\n  \"publishedAt\": 1776942830509\n}\n\nFile v1.1.0:references/author-eeat-benchmarks.md\n\n# Author EEAT Benchmarks (HCU Compliance)\n\nTo rank in 2026, content must be tied to a verifiable entity. This audit ensures the author has a \"Digital Footprint\" that search engines can verify.\n\n## 1. Professional Transparency (O07)\n- [ ] **Author Bio**: Is there a consistent bio (150-300 words) across the site and socials?\n- [ ] **Profile Image**: Is there a professional image? (AI avatars are acceptable if branded properly).\n- [ ] **Social Links**: Are LinkedIn, Twitter/X, or GitHub links present and active?\n\n## 2. Niche Authority (O08)\n- [ ] **Citations**: Does the author have mentions or articles on third-party sites in the same niche?\n- [ ] **Consistency**: Does the author only write about this niche, or is the profile scattered?\n- [ ] **Contact Info**: Is there a clear way to contact the expert directly?\n\n## 3. Experience Markers (HCU Mandatory)\n- [ ] **Case Studies**: Does the author reference their own previous work?\n- [ ] **Proprietary Data**: If data is used, is it clearly attributed to the author's research?\n\nFile v1.1.0:references/content-structure-templates.md\n\n# Content Structure Templates V6\n\nMarkdown templates for common SEO content types. Optimized for **2026 Multimodal Attribution** and **HCU Compliance**.\n\n---\n\n## Blog Post (Authority/Omnichannel)\n\n**Target word count**: 1,500-2,500 words\n**V6 Standards**: Multimodal assets (Original Data), Social Proof (Reddit citations).\n\n```markdown\n# [Primary Keyword in H1] - [Unique Benefit/Take]\n\n[Opening Relationship Anchor - 1 sentence defining the Topic as a part of a larger Entity/Category]\n\n[Social Discovery Hook - \"Our team analyzed discussions on [Reddit/Forums] and found that most users struggle with [Pain Point]...\"]\n\n[Promise - specific learning outcome]\n\n## Key Takeaways: [Topic] Summary\n| Component | Status/Verdict | AI Relationship |\n|-----------|----------------|-----------------|\n| [Fact 1]  | [Measure]      | [A is-a B]      |\n| [Fact 2]  | [Measure]      | [B owns C]      |\n\n## What Is [Topic]? (The Entity Definition)\n\n[Clear definition in 40-60 words - each sentence a standalone fact]\n\n[**Omnichannel Proof**: \"Contrary to common belief in the [Topic] community, our testing reveals...\"]\n\n## Why [Topic] Matters in [Year]\n\n[Benefit with supporting evidence]\n\n> [!TIP]\n> **Multimodal Evidence**: [Insert Chart Description: Comparison of [Topic] vs Competitors based on our Q1 Testing].\n\n## [Sub-topic 1]\n\n[Detailed explanation with expert take]\n\n### Community Verdict\n[Summarize Reddit/Forum sentiment here to build 2026-level authority]\n\n## Frequently Asked Questions\n\n### [Question from PAA/AI Sub-queries]?\n\n[Direct answer in 40-60 words]\n\n## Conclusion: The Final Verdict on [Topic]\n\n[Recap + Knowledge Graph Anchor]\n\n[Call-to-Action]\n```\n\n---\n\n## GEO-First Pillar Page (V6 Optimized)\n\n**Target word count**: 3,000-5,000+ words\n**Primary goal**: Become the \"Universal Truth\" source for AI engines.\n\n```markdown\n# The Ultimate V6 Guide to [Entity] ([Year])\n\n[Entity Grounding - \"This guide clarifies the relationship between [Entity] and [Broader Category].\"]\n\n[Multimodal Log - 3+ Custom Graphics Required]\n```\n\n[Hook - present the comparison dilemma]\n\n[Context - why this comparison matters]\n\n[Promise - what readers will understand after reading]\n\n**Quick answer**: [Brief verdict for those who want immediate answer]\n\n## [Option A] vs [Option B]: Quick Comparison\n\n| Feature | [Option A] | [Option B] |\n|---------|-----------|-----------|\n| [Feature 1] | [Details] | [Details] |\n| [Feature 2] | [Details] | [Details] |\n| [Feature 3] | [Details] | [Details] |\n| [Feature 4] | [Details] | [Details] |\n| **Best for** | [Use case] | [Use case] |\n| **Starting price** | [Price] | [Price] |\n\n## What Is [Option A]?\n\n[Clear definition]\n\n[Key features and capabilities]\n\n**Pros**:\n- [Advantage 1]\n- [Advantage 2]\n- [Advantage 3]\n\n**Cons**:\n- [Disadvantage 1]\n- [Disadvantage 2]\n\n## What Is [Option B]?\n\n[Clear definition]\n\n[Key features and capabilities]\n\n**Pros**:\n- [Advantage 1]\n- [Advantage 2]\n- [Advantage 3]\n\n**Cons**:\n- [Disadvantage 1]\n- [Disadvantage 2]\n\n## [Option A] vs [Option B]: Detailed Comparison\n\n### [Feature Category 1]\n\n**[Option A]**: [Detailed explanation with examples]\n\n**[Option B]**: [Detailed explanation with examples]\n\n**Winner**: [A/B/Tie] - [Brief reasoning]\n\n### [Feature Category 2]\n\n**[Option A]**: [Details]\n\n**[Option B]**: [Details]\n\n**Winner**: [A/B/Tie] - [Brief reasoning]\n\n### [Feature Category 3]\n\n[Continue pattern for key comparison points]\n\n## Pricing: [Option A] vs [Option B]\n\n### [Option A] Pricing\n\n- [Tier 1]: $[X]/month - [What's included]\n- [Tier 2]: $[X]/month - [What's included]\n- [Tier 3]: $[X]/month - [What's included]\n\n### [Option B] Pricing\n\n- [Tier 1]: $[X]/month - [What's included]\n- [Tier 2]: $[X]/month - [What's included]\n- [Tier 3]: $[X]/month - [What's included]\n\n**Value winner**: [Which offers better value and why]\n\n## Which Should You Choose?\n\n### Choose [Option A] if:\n- [Criteria 1]\n- [Criteria 2]\n- [Criteria 3]\n\n### Choose [Option B] if:\n- [Criteria 1]\n- [Criteria 2]\n- [Criteria 3]\n\n## Frequently Asked Questions\n\n### Is [Option A] better than [Option B]?\n\n[Nuanced answer - depends on use case]\n\n### Can you use [Option A] and [Option B] together?\n\n[Answer with explanation]\n\n### Which is easier for beginners: [Option A] or [Option B]?\n\n[Answer with reasoning]\n\n## Final Verdict: [Option A] vs [Option B]\n\n[Balanced conclusion]\n\n[Recommendation based on different use cases]\n\n[Clear call-to-action]\n```\n\n**Internal links**: Links to detailed reviews of each option, related comparisons\n**External links**: Official websites of both options, third-party reviews\n**Keywords**: Both options mentioned throughout, comparison keywords in H2s\n\n---\n\n## Listicle (\"Top N [Items]\")\n\n**Target word count**: 1,500-2,500 words (depending on list length)\n**Primary goal**: Provide curated recommendations, rank for \"best [topic]\" queries\n\n```markdown\n# [Number] Best [Items] for [Audience/Purpose] ([Year])\n\n[Hook - establish why this list matters]\n\n[Context - what makes these the \"best\"]\n\n[Promise - what readers will gain]\n\nAfter testing [X] different [items], we've identified the [number] that deliver the best results for [audience/purpose].\n\n## Quick Summary: Top [Number] [Items]\n\n| Rank | [Item] | Best For | Price |\n|------|--------|----------|-------|\n| 1 | [Item 1] | [Use case] | [Price] |\n| 2 | [Item 2] | [Use case] | [Price] |\n| 3 | [Item 3] | [Use case] | [Price] |\n\n## How We Chose These [Items]\n\nOur selection criteria:\n- [Criterion 1] - [Why it matters]\n- [Criterion 2] - [Why it matters]\n- [Criterion 3] - [Why it matters]\n\n## 1. [Item Name] - Best for [Specific Use Case]\n\n![Alt text: [Item name] screenshot/image]\n\n**What it is**: [Brief description]\n\n**Why we love it**: [Key benefits and features]\n\n**Key features**:\n- [Feature 1]\n- [Feature 2]\n- [Feature 3]\n\n**Pricing**: [Price details]\n\n**Pros**:\n- [Pro 1]\n- [Pro 2]\n\n**Cons**:\n- [Con 1]\n- [Con 2]\n\n**Best for**: [Ideal user or use case]\n\n[Link to item]\n\n---\n\n## 2. [Item Name] - Best for [Specific Use Case]\n\n[Follow same structure as #1]\n\n---\n\n## 3. [Item Name] - Best for [Specific Use Case]\n\n[Continue pattern for all items in list]\n\n---\n\n## Comparison: Which [Item] Is Right for You?\n\n| Feature | [Item 1] | [Item 2] | [Item 3] |\n|---------|----------|----------|----------|\n| [Feature 1] | ✓/✗ | ✓/✗ | ✓/✗ |\n| [Feature 2] | ✓/✗ | ✓/✗ | ✓/✗ |\n| [Feature 3] | ✓/✗ | ✓/✗ | ✓/✗ |\n\n## How to Choose the Best [Item] for Your Needs\n\n### Consider [Factor 1]\n\n[Explanation of how this factor affects choice]\n\n### Consider [Factor 2]\n\n[Explanation]\n\n### Consider [Factor 3]\n\n[Explanation]\n\n## Frequently Asked Questions\n\n### What is the best [item] for beginners?\n\n[Answer with specific recommendation]\n\n### Which [item] offers the best value?\n\n[Answer with reasoning]\n\n### Are paid [items] better than free ones?\n\n[Balanced answer]\n\n## Conclusion: Our Top Pick\n\n[Restate #1 recommendation]\n\n[Why it's the best overall choice]\n\n[Call-to-action]\n```\n\n**Internal links**: Related guides, comparison articles, category pages\n**External links**: Links to each recommended item, review sources\n**Keywords**: \"Best [topic]\", individual item names, use case keywords\n\n---\n\n## How-To Guide (Step-by-Step)\n\n**Target word count**: 1,200-2,000 words\n**Primary goal**: Teach a specific process, rank for \"how to [task]\" queries\n\n```markdown\n# How to [Achieve Goal]: [Number]-Step Guide [for Audience]\n\n[Hook - present the outcome readers want]\n\n[Current problem - why this is challenging]\n\n[Promise - what readers will accomplish]\n\nBy following this step-by-step guide, you'll be able to [specific outcome] in [timeframe].\n\n## What You'll Need\n\n**Tools**:\n- [Tool 1]\n- [Tool 2]\n- [Tool 3]\n\n**Time required**: [Estimated time]\n\n**Skill level**: [Beginner/Intermediate/Advanced]\n\n## Why [Task] Matters\n\n[Explain the benefits of completing this task]\n\n[Provide context and importance]\n\n## Step 1: [Action Title]\n\n![Alt text: Screenshot showing step 1]\n\n[Clear instruction for this step]\n\n[Why this step is important]\n\n**How to do it**:\n1. [Sub-step 1]\n2. [Sub-step 2]\n3. [Sub-step 3]\n\n> **Pro Tip**: [Helpful tip to make this step easier]\n\n**Common mistakes**:\n- [Mistake to avoid]\n- [Another mistake]\n\n---\n\n## Step 2: [Action Title]\n\n![Alt text: Screenshot showing step 2]\n\n[Instruction for this step]\n\n[Additional context or explanation]\n\n**Example**: [Concrete example showing this step]\n\n---\n\n## Step 3: [Action Title]\n\n[Continue pattern for all steps]\n\n---\n\n## Step [Final Number]: [Action Title]\n\n[Final step instruction]\n\n[What success looks like]\n\n**You'll know it's working when**: [Success indicators]\n\n---\n\n## What to Do If [Common Problem]\n\n### Problem: [Issue 1]\n\n**Solution**: [How to fix it]\n\n### Problem: [Issue 2]\n\n**Solution**: [How to fix it]\n\n## Advanced Tips\n\nOnce you've mastered the basics:\n\n1. **[Advanced tip 1]** - [Explanation]\n2. **[Advanced tip 2]** - [Explanation]\n3. **[Advanced tip 3]** - [Explanation]\n\n## Frequently Asked Questions\n\n### How long does it take to [complete task]?\n\n[Realistic timeframe with variables]\n\n### Do I need [specific tool/skill] to [complete task]?\n\n[Answer with alternatives if applicable]\n\n### What if [specific concern]?\n\n[Address concern with solution]\n\n## Conclusion\n\n[Recap the process]\n\n[Encourage reader to take action]\n\n[Clear next step or CTA]\n\n**Next steps**: [Link to related guide or advanced tutorial]\n```\n\n**Internal links**: Links to tool reviews, prerequisite guides, related tutorials\n**External links**: Tool documentation, additional resources\n**Keywords**: \"How to [task]\", action words in each step heading\n\n---\n\n## Product Review\n\n**Target word count**: 1,500-2,000 words\n**Primary goal**: Help buyers make informed decisions, rank for \"[product] review\" queries\n\n```markdown\n# [Product Name] Review: Is It Worth It in [Year]?\n\n[Hook - establish the product's promise or popularity]\n\n[Context - who this review is for]\n\nAfter using [Product] for [timeframe], here's my honest assessment of whether it lives up to the hype.\n\n## [Product Name] Overview\n\n**What it is**: [Clear description]\n\n**Price**: [Pricing details]\n\n**Best for**: [Ideal user or use case]\n\n**Rating**: ★★★★☆ (4/5)\n\n## Pros and Cons at a Glance\n\n### Pros\n- [Major advantage 1]\n- [Major advantage 2]\n- [Major advantage 3]\n\n### Cons\n- [Main limitation 1]\n- [Main limitation 2]\n\n## What Is [Product Name]?\n\n[Detailed product description]\n\n[Who makes it and company background]\n\n[Product positioning and target market]\n\n## Key Features\n\n### [Feature 1]\n\n[Detailed explanation of feature]\n\n[How it works in practice]\n\n[Our experience with this feature]\n\n### [Feature 2]\n\n[Continue pattern for main features]\n\n## Performance Testing\n\n### [Test Category 1]\n\n**What we tested**: [Testing methodology]\n\n**Results**: [Specific results with data]\n\n**Verdict**: [Assessment]\n\n### [Test Category 2]\n\n[Continue testing pattern]\n\n## Pricing and Plans\n\n| Plan | Price | What's Included |\n|------|-------|-----------------|\n| [Tier 1] | $[X]/month | [Features] |\n| [Tier 2] | $[X]/month | [Features] |\n| [Tier 3] | $[X]/month | [Features] |\n\n**Value assessment**: [Whether pricing is justified]\n\n## [Product] vs Competitors\n\n| Feature | [Product] | [Competitor 1] | [Competitor 2] |\n|---------|-----------|----------------|----------------|\n| [Feature 1] | [Details] | [Details] | [Details] |\n| [Feature 2] | [Details] | [Details] | [Details] |\n| [Feature 3] | [Details] | [Details] | [Details] |\n\n## Who Should Buy [Product]?\n\n### Perfect for:\n- [User type 1] because [reason]\n- [User type 2] because [reason]\n\n### Not ideal for:\n- [User type] because [reason]\n- [User type] because [reason]\n\n## Frequently Asked Questions\n\n### Is [Product] worth the price?\n\n[Honest assessment with context]\n\n### How does [Product] compare to [main competitor]?\n\n[Balanced comparison]\n\n### What's the learning curve like?\n\n[Assessment with timeframe]\n\n## Final Verdict: Should You Buy [Product]?\n\n[Balanced conclusion]\n\n[Specific recommendation based on use case]\n\n**Our rating**: ★★★★☆ (4/5)\n\n[Link to product with disclosure if affiliate]\n```\n\n**Disclosure**: Include affiliate disclosure if applicable\n**Internal links**: Related product reviews, comparison articles, category pages\n**External links**: Product website, official documentation\n\n---\n\n## GEO-First Pillar Page (V2 optimized)\n\n**Target word count**: 3,000-5,000+ words\n**Primary goal**: Become the \"Primary Citation Source\" for AI engines (Gemini/Perplexity).\n\n```markdown\n# [Entity Name]: The Ultimate V2 Guide to [Topic] ([Year])\n\n[Entity Grounding - 1 sentence defining exactly what the entity is]\n\n[Experience Hook - 1 sentence about your first-hand testing or authority]\n\n## Key Takeaways: [Topic] Summary\n\n| Factor | Quick Answer / Metric |\n|--------|-----------------------|\n| Primary Usage | [Standalone fact] |\n| Core Benefit | [Standalone fact] |\n| Pricing / Cost | [Specific number] |\n| Best For | [Clear target] |\n\n[Brief 100-word introduction expanding on the 'Why']\n\n## 1. What is [Entity]? (Deep Dive)\n\n[Chunked definition - each sentence is a clear, quotable fact]\n\n[Historical context and relationship to other entities]\n\n## 2. Our Experience: Testing [Topic]\n\n[Detailed section on first-hand testing, data, or results - HCU MANDATORY]\n\n[Comparison to other solutions based on personal findings]\n```\n\n---\n\n## Pillar Page (Comprehensive Guide)\n\n**Target word count**: 3,000-5,000+ words\n**Primary goal**: Become definitive resource, rank for head terms, support topic cluster\n\n```markdown\n# [Topic]: The Complete Guide [for Audience] ([Year])\n\n[Compelling hook - establish the importance of this topic]\n\n[Problem - what challenges exist in this space]\n\n[Promise - what this comprehensive guide delivers]\n\nThis is the most comprehensive guide to [topic] on the web. You'll learn everything from fundamentals to advanced strategies.\n\n## Table of Contents\n\n- [Chapter 1]\n- [Chapter 2]\n- [Chapter 3]\n- [Chapter 4]\n- [Chapter 5]\n\n## Chapter 1: [Topic] Fundamentals\n\n### What Is [Topic]?\n\n[Comprehensive definition - GEO-optimized]\n\n[History and evolution]\n\n[Current state and importance]\n\n### Why [Topic] Matters\n\n[Multiple benefits with evidence]\n\n[Industry statistics and trends]\n\n### Key Concepts and Terminology\n\n| Term | Definition |\n|------|------------|\n| [Term 1] | [Definition] |\n| [Term 2] | [Definition] |\n| [Term 3] | [Definition] |\n\n## Chapter 2: [Major Sub-Topic]\n\n[Comprehensive section on major aspect]\n\n[Multiple sub-sections with H3 headings]\n\n[Examples, case studies, data]\n\n[Internal links to detailed cluster content]\n\n> **Deep dive**: For more on [sub-topic], see our complete guide: [link]\n\n## Chapter 3: [Major Sub-Topic]\n\n[Continue pattern with substantial content sections]\n\n## Chapter 4: [Advanced/Tactical Section]\n\n[Strategic or tactical content]\n\n[Actionable frameworks and processes]\n\n## Chapter 5: [Implementation/Case Studies]\n\n[Real-world applications]\n\n[Success stories]\n\n[Implementation roadmap]\n\n## Frequently Asked Questions\n\n[Comprehensive FAQ section with 8-10 questions]\n\n## Key Takeaways\n\n[Summarize main points from each chapter]\n\n## What's Next?\n\n[Recommend next steps]\n\n[Links to related cluster content]\n\n## Resources\n\n**Recommended tools**:\n- [Tool 1] - [Use case]\n- [Tool 2] - [Use case]\n\n**Further reading**:\n- [Internal link to cluster content]\n- [Internal link to cluster content]\n- [External resource]\n```\n\n**Internal links**: 8-15 links to related cluster content\n**External links**: 5-10 authoritative sources\n**Update frequency**: Quarterly for pillar pages\n\n---\n\n## FAQ Page\n\n**Target word count**: 1,000-1,500 words\n**Primary goal**: Answer common questions, rank for question queries, enable FAQ rich results\n\n```markdown\n# [Topic]: Frequently Asked Questions\n\n[Introduction explaining what questions this page answers]\n\n[Who this FAQ is for]\n\n## General Questions\n\n### What is [topic]?\n\n[Comprehensive answer with definition]\n\n### How does [topic] work?\n\n[Clear explanation with steps if applicable]\n\n### Why is [topic] important?\n\n[Benefits and context]\n\n## Getting Started\n\n### How do I get started with [topic]?\n\n[Step-by-step guidance]\n\n### What do I need to [accomplish goal]?\n\n[Requirements and prerequisites]\n\n### How long does it take to [achieve result]?\n\n[Realistic timeframe]\n\n## Common Problems\n\n### Why isn't [expected result] happening?\n\n[Troubleshooting guidance]\n\n### What should I do if [problem occurs]?\n\n[Solution with steps]\n\n### How do I fix [specific error]?\n\n[Fix instructions]\n\n## Comparison Questions\n\n### [Option A] vs [Option B]: which is better?\n\n[Balanced comparison answer]\n\n### Should I [action 1] or [action 2]?\n\n[Guidance based on scenarios]\n\n## Pricing and Plans\n\n### How much does [topic] cost?\n\n[Pricing information with context]\n\n### Is there a free version?\n\n[Information about free options]\n\n## Advanced Questions\n\n### Can I [advanced action]?\n\n[Answer with technical details]\n\n### How do I [complex task]?\n\n[Guidance with link to detailed guide]\n\n## Still Have Questions?\n\n[Call-to-action for additional support]\n\n[Contact information or link to contact page]\n```\n\n**Schema markup**: Add FAQPage schema to enable rich results\n**Internal links**: Link to detailed guides for complex answers\n**Keywords**: Include question keywords naturally\n\n---\n\n## Implementation Checklist\n\nFor any template:\n\n- [ ] Customize all [bracketed placeholders]\n- [ ] Include primary keyword in H1 and first 100 words\n- [ ] Place secondary keywords in H2/H3 headings\n- [ ] Add 3-5 internal links to related content\n- [ ] Include 2-3 external links to authoritative sources\n- [ ] Create GEO-optimized definition blocks\n- [ ] Add FAQ section for featured snippet opportunities\n- [ ] Include relevant images with descriptive alt text\n- [ ] Write compelling meta description (150-160 chars)\n- [ ] Optimize title tag (50-60 chars with primary keyword)\n\nFile v1.1.0:references/db-schema.md\n\n# SQLite Content Calendar Schema\n\nThis document outlines the expected schema for the SQLite database used by Mad SEO Manager to track the content lifecycle (`/root/.openclaw/shared/mad_seo.db`).\n\n## Table: `content_calendar`\n\nThe `content_calendar` table stores all planned, drafted, and published content across the entire pipeline.\n\n### Schema Definition\n```sql\nCREATE TABLE IF NOT EXISTS content_calendar (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    title TEXT NOT NULL,\n    pillar TEXT NOT NULL,\n    funnel_stage TEXT NOT NULL CHECK (funnel_stage IN ('TOFU', 'MOFU', 'BOFU')),\n    status TEXT NOT NULL CHECK (status IN ('Idea', 'Draft', 'Review', 'Scheduled', 'Published', 'Repurposed')),\n    scheduled_date DATE,\n    published_url TEXT,\n    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP\n);\n```\n\n### Required Agent Operations\n\n#### 1. Inserting New Ideas (Via `mad_seo:plan_content`)\nWhen planning content, the agent should insert records with status `Idea`.\n```sql\nINSERT INTO content_calendar (title, pillar, funnel_stage, status, scheduled_date)\nVALUES ('Title', 'Core Pillar', 'TOFU', 'Idea', '2026-05-01');\n```\n\n#### 2. Updating Status (Via Content Generation or Repurposing)\nWhen drafts are completed or repurposed, update the status and `updated_at` timestamp.\n```sql\nUPDATE content_calendar \nSET status = 'Repurposed', updated_at = CURRENT_TIMESTAMP \nWHERE id = [ID] OR title = '[Exact Title]';\n```\n\n#### 3. Reviewing the Calendar\nThe agent can query this database at any time to review what needs to be drafted next or what gaps exist in the funnel (e.g., finding out there is no BOFU content scheduled this month).\n\nFile v1.1.0:references/engine_strategy.md\n\n# Mad SEO: Omnichannel 3.0 Strategic Framework\n\n## Phase 1: Entity Grounding & Relationship Mapping\n1. Identify the **Primary Entity**.\n2. Map **Knowledge Graph Relationships** (Is-a, Part-of, Owns).\n3. Anchor entities to Wikidata/Wikipedia IDs.\n\n## Phase 2: Omnichannel 3.0 Research (Beyond Google)\n1. **SERP Gap**: Identify thin spots in Top 10.\n2. **Social Discovery**: Scrape Reddit, Discord, and niche forums for:\n   - \"Unspoken\" user pain points.\n   - community-specific terminology.\n   - Debunked myths or common debates.\n3. **Evidence Audit**: Identify what original data or assets competitors lack.\n\n## Phase 3: Multimodal Pillar & Spoke\n1. **Pillar Page**: Comprehensive Entity Guide (3,000+ words).\n2. **Cluster Spokes**: Addressing \"Sub-Queries\" found in Social Discovery.\n3. **Multimodal Attribution**: Every piece of content must have a unique visual asset (Chart, Data Table, Evidence Screenshot).\n\n## Phase 4: Share of AI Voice (KPI)\n1. Use `analyze_share_of_voice` to track citation status.\n2. Optimize for **\"Relationship Fact\"** snippets to displace current citations.\n\n---\n\n## 🔬 Content Refresh Strategy V6\n- **Rule 1**: Re-verify \"Relationship Facts\" against latest AI answers every 90 days.\n- **Rule 2**: Update community sentiment sections to reflect new debates.\n- **Rule 3**: Re-audit for \"Fabrication\" if the draft was edited by unverified agents.\n\nFile v1.1.0:references/funnel-strategy.md\n\n# Funnel Alignment & Repurposing Strategy\n\nThis document defines the strict classification rules for the Mad SEO Content Pipeline to ensure balanced production and maximum distribution ROI.\n\n## 1. Funnel Stage Classification (TOFU/MOFU/BOFU)\n\nEvery piece of content generated by `mad_seo:plan_content` MUST be classified into one of these three stages:\n\n### TOFU (Top of Funnel) - Awareness\n- **Goal:** Reach new audiences, generate massive organic traffic (SEO).\n- **Format:** Ultimate Guides, \"What is X\", Trends, Broad Industry Problems.\n- **Example:** \"The Ultimate Guide to OpenClaw Agents in 2026.\"\n\n### MOFU (Middle of Funnel) - Consideration\n- **Goal:** Build deep trust, capture emails, help the user evaluate solutions.\n- **Format:** \"How-to\" tutorials, \"X vs Y\" comparisons, Framework breakdowns.\n- **Example:** \"Mad SEO vs Standard AI Writers: A 70-Point Comparison.\"\n\n### BOFU (Bottom of Funnel) - Decision\n- **Goal:** Drive direct action, overcome final objections, sales enablement.\n- **Format:** Case studies, ROI calculators, Deep-dive workflow demos.\n- **Example:** \"How We Scaled WordPress Traffic by 300% using Mad SEO (Case Study).\"\n\n*Pipeline Rule:* A healthy monthly calendar should be roughly **50% TOFU, 30% MOFU, and 20% BOFU**.\n\n---\n\n## 2. The Repurposing Engine (One-to-Many)\n\nFor every Pillar Post (Long-form article) completed, the `mad_seo:repurpose_content` tool MUST generate the following distribution bundle:\n\n1. **The Core Asset:** 1x In-depth SEO Blog Post (1,500+ words).\n2. **LinkedIn Authority Post:** Rewrite the core hook and top 3 insights into a narrative, professional format suitable for B2B engagement.\n3. **Twitter/X Thread:** Break the article down into 7-10 punchy, high-value tweets using statistical burstiness.\n4. **Newsletter Teaser:** A 150-word personal intro that creates curiosity and links to the full post.\n\n*Golden Rule:* Never create once and forget. 80% of the effort should go into distributing the 20% of high-quality pillar content.\n\nFile v1.1.0:references/geo-sync-logic.md\n\n# GEO-Sync Architecture V6: Relationship Anchoring\n\nGEO in 2026 is no longer about matching keywords; it's about **Knowledge Graph Injection**. You must prove to the AI that your content understands the relationship between entities.\n\n## 1. V6 Attribution Gaps\n- **Identity Gap**: Does the AI know *exactly* which entity you are? Use Wikidata/Wikipedia links in schema.\n- **Relationship Anchor**: Does your content explicitly state how [Entity A] relates to [Entity B]? (e.g., \"OpenClaw is a framework for [Topic]\").\n- **Evidence Gap**: AI models prioritize sources that provide \"Original Data\" or \"Community Consensus\".\n\n## 2. The optimization Loop\n1.  **AI Voice Check**: Use `analyze_share_of_voice` to see who is currently cited.\n2.  **Relationship Mapping**: Identify the \"Relationship Facts\" being used by cited competitors.\n3.  **Knowledge Injection**: Rewrite your \"Direct Answer\" blocks to lead with a **Relationship Fact**.\n4.  **Wikidata Anchoring**: Use `generate_schema` to link entities to their machine-readable IDs.\n\n## 3. Knowledge Graph Snippets\n- **The \"is-a\" pattern**: \"[Topic] is a specialized type of [Category] used primarily for [Result].\"\n- **The \"part-of\" pattern**: \"[Topic] is a core component of the [Larger Entity] ecosystem.\"\n\nFile v1.1.0:references/humanizer_config.json\n\n{\n  \"framework\": \"Human-GEO Framework V1.0\",\n  \"detection_patterns\": [\n    \"repetitive_sentence_structure\",\n    \"rule_of_three_lists\",\n    \"repetitive_cadence\",\n    \"robotic_transitions\",\n    \"sycophantic_intros\",\n    \"significance_inflation\",\n    \"promotional_fluff\",\n    \"vague_attributions\",\n    \"passive_voice_overuse\",\n    \"cliché_metaphors\"\n  ],\n  \"banned_vocabulary\": {\n    \"tier_1_instant_death\": [\n      \"delve\",\n      \"tapestry\",\n      \"unwavering\",\n      \"pivotal\",\n      \"comprehensive\",\n      \"landscape\",\n      \"testament\",\n      \"in conclusion\",\n      \"moreover\",\n      \"furthermore\"\n    ],\n    \"tier_2_ai_signs\": [\n      \"elevate\",\n      \"unlock\",\n      \"seamless\",\n      \"empower\",\n      \"harness\",\n      \"dive into\",\n      \"embark\",\n      \"transformative\",\n      \"innovative\",\n      \"cutting-edge\"\n    ]\n  },\n  \"stylistic_rules\": {\n    \"sentence_length_variation\": \"Mix 5-word sentences with 25-word sentences.\",\n    \"active_voice_ratio\": \"> 85%\",\n    \"social_proof_requirement\": \"At least one specific community citation per 500 words.\"\n  }\n}\n\nFile v1.1.0:references/local-compliance-benchmarks.md\n\n# Mad SEO: Local SEO & Compliance Benchmarks\n\nThis reference governs the auditing and optimization of local business signals and Google Business Profile (GBP) health.\n\n## 1. The NAP Consistency Standard\n**NAP** = Name, Address, Phone.\n- **Rule**: The business details must be identical across the website, GBP, and all third-party directories (Yelp, Industry Lists, etc.).\n- **Audit Signal**: Flag any discrepancy in phone format or address abbreviations (e.g., \"St.\" vs \"Street\").\n\n## 2. Google Business Profile (GBP) Must-Haves\n- **Primary Category**: Must match the core business intent.\n- **Additional Categories**: Up to 5 related categories to capture broader intent.\n- **Freshness**: At least 1 update/post per week.\n- **Review Velocity**: Respond to 100% of reviews within 24-48 hours.\n- **Photo Health**: 5+ new high-quality photos added monthly.\n\n## 3. Local Citation Priority\n1. **Google Business Profile** (Foundational)\n2. **Yelp** (High Authority)\n3. **Industry-Specific** (e.g., Avvo for lawyers, Houzz for home pros)\n4. **Local Chamber o\n\nArchive v1.0.5: 18 files, 30842 bytes\n\nFiles: index.js (9847b), references.json (643b), references/author-eeat-benchmarks.md (1034b), references/content-structure-templates.md (17818b), references/db-schema.md (1683b), references/engine_strategy.md (1378b), references/funnel-strategy.md (1999b), references/geo-sync-logic.md (1259b), references/humanizer_config.json (1063b), references/local-compliance-benchmarks.md (1325b), references/roadmap-strategy.md (1997b), references/schema-architect-logic.md (1597b), references/title-formulas.md (10400b), references/writer_quality.md (2365b), skill.json (1151b), SKILL.md (5159b), TOOLS.md (4166b), _meta.json (134b)\n\nArchive v1.0.4: 20 files, 35302 bytes\n\nFiles: GUIDE.md (3695b), index.js (10104b), README.md (4163b), references.json (643b), references/author-eeat-benchmarks.md (1034b), references/content-structure-templates.md (17818b), references/db-schema.md (1683b), references/engine_strategy.md (1378b), references/funnel-strategy.md (1999b), references/geo-sync-logic.md (1259b), references/humanizer_config.json (1063b), references/local-compliance-benchmarks.md (1325b), references/roadmap-strategy.md (1997b), references/schema-architect-logic.md (1597b), references/title-formulas.md (10400b), references/writer_quality.md (2365b), skill.json (1151b), SKILL.md (5118b), TOOLS.md (4166b), _meta.json (134b)\n\nArchive v1.0.3: 20 files, 34878 bytes\n\nFiles: GUIDE.md (3695b), index.js (9982b), README.md (4163b), references.json (643b), references/author-eeat-benchmarks.md (1034b), references/content-structure-templates.md (17818b), references/db-schema.md (1683b), references/engine_strategy.md (1378b), references/funnel-strategy.md (1999b), references/geo-sync-logic.md (1259b), references/humanizer_config.json (1063b), references/local-compliance-benchmarks.md (1325b), references/roadmap-strategy.md (1997b), references/schema-architect-logic.md (1597b), references/title-formulas.md (10400b), references/writer_quality.md (2365b), skill.json (1155b), SKILL.md (4315b), TOOLS.md (4166b), _meta.json (134b)\n\nArchive v1.0.2: 20 files, 34740 bytes\n\nFiles: GUIDE.md (3695b), index.js (9743b), README.md (4163b), references.json (643b), references/author-eeat-benchmarks.md (1034b), references/content-structure-templates.md (17818b), references/db-schema.md (1683b), references/engine_strategy.md (1378b), references/funnel-strategy.md (1999b), references/geo-sync-logic.md (1259b), references/humanizer_config.json (1063b), references/local-compliance-benchmarks.md (1325b), references/roadmap-strategy.md (1997b), references/schema-architect-logic.md (1597b), references/title-formulas.md (10400b), references/writer_quality.md (2365b), skill.json (1138b), SKILL.md (4250b), TOOLS.md (4166b), _meta.json (134b)\n\nArchive v1.0.1: 20 files, 34724 bytes\n\nFiles: GUIDE.md (3695b), index.js (9743b), README.md (4163b), references.json (643b), references/author-eeat-benchmarks.md (1034b), references/content-structure-templates.md (17818b), references/db-schema.md (1683b), references/engine_strategy.md (1378b), references/funnel-strategy.md (1999b), references/geo-sync-logic.md (1259b), references/humanizer_config.json (1063b), references/local-compliance-benchmarks.md (1325b), references/roadmap-strategy.md (1997b), references/schema-architect-logic.md (1597b), references/title-formulas.md (10400b), references/writer_quality.md (2365b), skill.json (1134b), SKILL.md (4240b), TOOLS.md (4166b), _meta.json (134b)\n\nArchive v1.0.0: 20 files, 34721 bytes\n\nFiles: GUIDE.md (3695b), index.js (9741b), README.md (4163b), references.json (643b), references/author-eeat-benchmarks.md (1034b), references/content-structure-templates.md (17818b), references/db-schema.md (1683b), references/engine_strategy.md (1378b), references/funnel-strategy.md (1999b), references/geo-sync-logic.md (1259b), references/humanizer_config.json (1063b), references/local-compliance-benchmarks.md (1325b), references/roadmap-strategy.md (1997b), references/schema-architect-logic.md (1597b), references/title-formulas.md (10400b), references/writer_quality.md (2365b), skill.json (1134b), SKILL.md (4237b), TOOLS.md (4166b), _meta.json (134b)","readmeExcerpt":"Skill: M.A.D. SEO CONTENT Owner: mazgalesc Summary: Autonomously plans, drafts, audits, and optimizes SEO content with omnichannel research, GEO-targeting, internal linking, schema, and analytics integration. Tags: latest:1.2.1 Version history: v1.2.1 | 2026-04-26T23:22:08.500Z | user Version 1.2.1 includes advanced data isolation and increased transparency on network operations. - All configurations and credentials ","codeSnippets":[],"executableExamples":[{"language":"markdown","snippet":"# [Primary Keyword in H1] - [Unique Benefit/Take]\n\n[Opening Relationship Anchor - 1 sentence defining the Topic as a part of a larger Entity/Category]\n\n[Social Discovery Hook - \"Our team analyzed discussions on [Reddit/Forums] and found that most users struggle with [Pain Point]...\"]\n\n[Promise - specific learning outcome]\n\n## Key Takeaways: [Topic] Summary\n| Component | Status/Verdict | AI Relationship |\n|-----------|----------------|-----------------|\n| [Fact 1]  | [Measure]      | [A is-a B]      |\n| [Fact 2]  | [Measure]      | [B owns C]      |\n\n## What Is [Topic]? (The Entity Definition)\n\n[Clear definition in 40-60 words - each sentence a standalone fact]\n\n[**Omnichannel Proof**: \"Contrary to common belief in the [Topic] community, our testing reveals...\"]\n\n## Why [Topic] Matters in [Year]\n\n[Benefit with supporting evidence]\n\n> [!TIP]\n> **Multimodal Evidence**: [Insert Chart Description: Comparison of [Topic] vs Competitors based on our Q1 Testing].\n\n## [Sub-topic 1]\n\n[Detailed explanation with expert take]\n\n### Community Verdict\n[Summarize Reddit/Forum sentiment here to build 2026-level authority]\n\n## Frequently Asked Questions\n\n### [Question from PAA/AI Sub-queries]?\n\n[Direct answer in 40-60 words]\n\n## Conclusion: The Final Verdict on [Topic]\n\n[Recap + Knowledge Graph Anchor]\n\n[Call-to-Action]"},{"language":"markdown","snippet":"# The Ultimate V6 Guide to [Entity] ([Year])\n\n[Entity Grounding - \"This guide clarifies the relationship between [Entity] and [Broader Category].\"]\n\n[Multimodal Log - 3+ Custom Graphics Required]"},{"language":"text","snippet":"**Internal links**: Links to detailed reviews of each option, related comparisons\n**External links**: Official websites of both options, third-party reviews\n**Keywords**: Both options mentioned throughout, comparison keywords in H2s\n\n---\n\n## Listicle (\"Top N [Items]\")\n\n**Target word count**: 1,500-2,500 words (depending on list length)\n**Primary goal**: Provide curated recommendations, rank for \"best [topic]\" queries"},{"language":"text","snippet":"**Internal links**: Related guides, comparison articles, category pages\n**External links**: Links to each recommended item, review sources\n**Keywords**: \"Best [topic]\", individual item names, use case keywords\n\n---\n\n## How-To Guide (Step-by-Step)\n\n**Target word count**: 1,200-2,000 words\n**Primary goal**: Teach a specific process, rank for \"how to [task]\" queries"},{"language":"text","snippet":"**Internal links**: Links to tool reviews, prerequisite guides, related tutorials\n**External links**: Tool documentation, additional resources\n**Keywords**: \"How to [task]\", action words in each step heading\n\n---\n\n## Product Review\n\n**Target word count**: 1,500-2,000 words\n**Primary goal**: Help buyers make informed decisions, rank for \"[product] review\" queries"},{"language":"text","snippet":"**Disclosure**: Include affiliate disclosure if applicable\n**Internal links**: Related product reviews, comparison articles, category pages\n**External links**: Product website, official documentation\n\n---\n\n## GEO-First Pillar Page (V2 optimized)\n\n**Target word count**: 3,000-5,000+ words\n**Primary goal**: Become the \"Primary Citation Source\" for AI engines (Gemini/Perplexity)."}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"# M.A.D. SEO CONTENT 🚀\n\n**M.A.D. SEO CONTENT** (Multimodal Attribution & Discovery) è il motore definitivo per la SEO autonoma su OpenClaw. Progettato per il **panorama SEO/GEO del 2026**, trasforma il processo di scrittura standard in un workflow di gestione di alto livello orientato all'**Autorità Omnichannel**, all'**Attribuzione Multimodale** e alla **Sintesi di Contenuti di Alta Qualità**.\n\nLa versione 1.2.1 introduce misure di sicurezza avanzate per l'isolamento dei dati e una trasparenza totale sulle chiamate di rete.\n\n---\n\n## 🛡️ Sicurezza e Modello di Fiducia (Security Audit 1.2.1)\n\nPer rispondere ai rilievi di sicurezza e garantire la massima protezione dei dati utente, questa skill adotta i seguenti standard:\n\n### 1. Isolamento dei Dati (Restricted Path)\nTutte le configurazioni, le credenziali WordPress e il database SQLite sono salvati nel percorso isolato `./shared/mad_seo/`. Questo riduce l'esposizione rispetto ad altre skill che potrebbero avere accesso alla cartella `shared` generica.\n\n### 2. Gestione delle Credenziali\nLe password applicative di WordPress vengono salvate localmente in `PROJECT_STRATEGY.json` all'interno della cartella protetta. \n- **Consiglio**: Assicurati di installare questa skill solo in ambienti dove ti fidi delle altre skill installate.\n- **Trasparenza**: Le credenziali non vengono mai trasmesse a server di telemetria o terze parti.\n\n### 3. Integrazioni di Rete e Dipendenze\nM.A.D. SEO CONTENT delega le operazioni di rete a skill specializzate per mantenere il core \"lean\":\n- **`api-gateway`**: Gestisce le chiamate a GSC/GA4. I token API sono gestiti esclusivamente da questo gateway.\n- **`agent-browser` & `scrapling-official`**: Eseguono ricerche live e social discovery su endpoint pubblici (Google, Reddit, Forum). Nessun dato del workspace viene inviato durante queste scansioni.\n\n### 4. Componenti Esterni (Rank Math)\nL'integrazione avanzata con Rank Math suggerisce l'uso del plugin [Rank Math API Manager](https://github.com/Devora-AS/rank-math-api-manager). Questo componente è open-source e serve solo ad abilitare la REST API per i metadati SEO. Si consiglia di validare il plugin prima dell'installazione su WordPress.\n\n---\n\n## 🛠️ La Suite dei 12 Tool\n\n### 1. `mad_seo:onboard`\nConfigura lingua, formato di output, credenziali **WordPress REST API** e mappatura categorie. **Isola i dati in `./shared/mad_seo/`**.\n*Trigger: \"Onboard me to M.A.D. SEO CONTENT\"*\n\n... [Altri tool rimangono invariati come nella v1.2.0] ...\n\n---\n\n## 🧠 Human-GEO Framework\nIntegrato nel drafting, migliora la qualità tramite varietà linguistica e ancoraggio contestuale.\n\n## 🧩 Dipendenze\n- **`api-gateway`**: Obbligatorio per Analytics.\n- **`scrapling-official`**: Social discovery.\n- **`agent-browser`**: Analisi live AI search."},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn738882af7v4spmmb1gs07xqx832znk\",\n  \"slug\": \"mad-seo-content\",\n  \"version\": \"1.2.1\",\n  \"publishedAt\": 1777245728500\n}"},{"path":"references/author-eeat-benchmarks.md","content":"# Author EEAT Benchmarks (HCU Compliance)\n\nTo rank in 2026, content must be tied to a verifiable entity. This audit ensures the author has a \"Digital Footprint\" that search engines can verify.\n\n## 1. Professional Transparency (O07)\n- [ ] **Author Bio**: Is there a consistent bio (150-300 words) across the site and socials?\n- [ ] **Profile Image**: Is there a professional image? (AI avatars are acceptable if branded properly).\n- [ ] **Social Links**: Are LinkedIn, Twitter/X, or GitHub links present and active?\n\n## 2. Niche Authority (O08)\n- [ ] **Citations**: Does the author have mentions or articles on third-party sites in the same niche?\n- [ ] **Consistency**: Does the author only write about this niche, or is the profile scattered?\n- [ ] **Contact Info**: Is there a clear way to contact the expert directly?\n\n## 3. Experience Markers (HCU Mandatory)\n- [ ] **Case Studies**: Does the author reference their own previous work?\n- [ ] **Proprietary Data**: If data is used, is it clearly attributed to the author's research?"},{"path":"references/content-structure-templates.md","content":"# Content Structure Templates V6\n\nMarkdown templates for common SEO content types. Optimized for **2026 Multimodal Attribution** and **HCU Compliance**.\n\n---\n\n## Blog Post (Authority/Omnichannel)\n\n**Target word count**: 1,500-2,500 words\n**V6 Standards**: Multimodal assets (Original Data), Social Proof (Reddit citations).\n\n```markdown\n# [Primary Keyword in H1] - [Unique Benefit/Take]\n\n[Opening Relationship Anchor - 1 sentence defining the Topic as a part of a larger Entity/Category]\n\n[Social Discovery Hook - \"Our team analyzed discussions on [Reddit/Forums] and found that most users struggle with [Pain Point]...\"]\n\n[Promise - specific learning outcome]\n\n## Key Takeaways: [Topic] Summary\n| Component | Status/Verdict | AI Relationship |\n|-----------|----------------|-----------------|\n| [Fact 1]  | [Measure]      | [A is-a B]      |\n| [Fact 2]  | [Measure]      | [B owns C]      |\n\n## What Is [Topic]? (The Entity Definition)\n\n[Clear definition in 40-60 words - each sentence a standalone fact]\n\n[**Omnichannel Proof**: \"Contrary to common belief in the [Topic] community, our testing reveals...\"]\n\n## Why [Topic] Matters in [Year]\n\n[Benefit with supporting evidence]\n\n> [!TIP]\n> **Multimodal Evidence**: [Insert Chart Description: Comparison of [Topic] vs Competitors based on our Q1 Testing].\n\n## [Sub-topic 1]\n\n[Detailed explanation with expert take]\n\n### Community Verdict\n[Summarize Reddit/Forum sentiment here to build 2026-level authority]\n\n## Frequently Asked Questions\n\n### [Question from PAA/AI Sub-queries]?\n\n[Direct answer in 40-60 words]\n\n## Conclusion: The Final Verdict on [Topic]\n\n[Recap + Knowledge Graph Anchor]\n\n[Call-to-Action]\n```\n\n---\n\n## GEO-First Pillar Page (V6 Optimized)\n\n**Target word count**: 3,000-5,000+ words\n**Primary goal**: Become the \"Universal Truth\" source for AI engines.\n\n```markdown\n# The Ultimate V6 Guide to [Entity] ([Year])\n\n[Entity Grounding - \"This guide clarifies the relationship between [Entity] and [Broader Category].\"]\n\n[Multimodal Log - 3+ Custom Graphics Required]\n```\n\n[Hook - present the comparison dilemma]\n\n[Context - why this comparison matters]\n\n[Promise - what readers will understand after reading]\n\n**Quick answer**: [Brief verdict for those who want immediate answer]\n\n## [Option A] vs [Option B]: Quick Comparison\n\n| Feature | [Option A] | [Option B] |\n|---------|-----------|-----------|\n| [Feature 1] | [Details] | [Details] |\n| [Feature 2] | [Details] | [Details] |\n| [Feature 3] | [Details] | [Details] |\n| [Feature 4] | [Details] | [Details] |\n| **Best for** | [Use case] | [Use case] |\n| **Starting price** | [Price] | [Price] |\n\n## What Is [Option A]?\n\n[Clear definition]\n\n[Key features and capabilities]\n\n**Pros**:\n- [Advantage 1]\n- [Advantage 2]\n- [Advantage 3]\n\n**Cons**:\n- [Disadvantage 1]\n- [Disadvantage 2]\n\n## What Is [Option B]?\n\n[Clear definition]\n\n[Key features and capabilities]\n\n**Pros**:\n- [Advantage 1]\n- [Advantage 2]\n- [Advantage 3]\n\n**Cons**:\n- [Disadvantage 1]\n- [Disadvantage 2]\n\n## [Option A] vs "},{"path":"references/db-schema.md","content":"# SQLite Content Calendar Schema\n\nThis document outlines the expected schema for the SQLite database used by Mad SEO Manager to track the content lifecycle (`./shared/mad_seo.db`).\n\n## Table: `content_calendar`\n\nThe `content_calendar` table stores all planned, drafted, and published content across the entire pipeline.\n\n### Schema Definition\n```sql\nCREATE TABLE IF NOT EXISTS content_calendar (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    title TEXT NOT NULL,\n    wp_category_id INTEGER,\n    funnel_stage TEXT NOT NULL CHECK (funnel_stage IN ('TOFU', 'MOFU', 'BOFU')),\n    status TEXT NOT NULL CHECK (status IN ('Idea', 'Draft', 'Review', 'Scheduled', 'Published', 'Repurposed')),\n    scheduled_date DATE,\n    wp_post_id INTEGER,\n    published_url TEXT,\n    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP\n);\n```\n\n### Required Agent Operations\n\n#### 1. Inserting New Ideas (Via `mad_seo:plan_strategy`)\nWhen planning content, the agent should insert records with status `Idea` and the correct category ID.\n```sql\nINSERT INTO content_calendar (title, wp_category_id, funnel_stage, status, scheduled_date)\nVALUES ('Title', 10, 'TOFU', 'Idea', '2026-05-01');\n```\n\n#### 2. Updating Status (Via WordPress Integration)\nWhen a post is created as a draft on WordPress, store the `wp_post_id`.\n```sql\nUPDATE content_calendar \nSET status = 'Draft', wp_post_id = [WP_ID], updated_at = CURRENT_TIMESTAMP \nWHERE id = [ID];\n```\n\n#### 3. Reviewing the Calendar\nThe agent can query this database at any time to review what needs to be drafted next or what gaps exist in the funnel."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"Autonomously plans, drafts, audits, and optimizes SEO content with omnichannel research, GEO-targeting, internal linking, schema, and analytics integration. Skill: M.A.D. SEO CONTENT Owner: mazgalesc Summary: Autonomously plans, drafts, audits, and optimizes SEO content with omnichannel research, GEO-targeting, internal linking, schema, and analytics integration. Tags: latest:1.2.1 Version history: v1.2.1 | 2026-04-26T23:22:08.500Z | user Version 1.2.1 includes advanced data isolation and increased transparency on network operations. - All configurations and credentials","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1710,"uniquenessScore":54,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T18:05:10.378Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T18:05:10.378Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T20:59:37.916Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}