---
title: "Analytics Module"
module_id: "analytics"
version: "1.0.0"
category: "insights"
autonomy: "view-required"
generated: true
generated_at: "2026-05-04"
---

# Analytics

> Dashboard with insights on leads, deals, and newsletter performance

Ships with **4 agent skills**.

## Quick Facts

| Property | Value |
|----------|-------|
| **Module ID** | `analytics` |
| **Version** | 1.0.0 |
| **Category** | insights |
| **Autonomy** | view-required |
| **Core** | No |
| **Capabilities** | `data:read` |
| **MCP-exposed skills** | 4 |
| **Owns tables** | — |

## Integrations

**Optional:** `google_analytics`, `meta_pixel`

## Skills

These skills are seeded into `agent_skills` when the module is enabled and exposed via MCP.
External operators (FlowPilot, OpenClaw, Claude Desktop, custom MCP clients) can call them directly.

| Skill | Scope | Description |
|-------|-------|-------------|
| `analyze_analytics` | internal | Get page view analytics for a given period. Use when: reviewing website traffic; analyzing page performance; generating traffic reports. NOT for: analyzing chat feedback (analyze_chat_feedback); ge… |
| `seo_audit_page` | internal | Run an SEO audit on a page or blog post, checking title, meta, content depth, images, links. Use when: optimizing a page for search engines; reviewing SEO before publishing; identifying SEO issues.… |
| `kb_gap_analysis` | internal | Analyze chat data to find questions not covered by KB articles, underperforming articles, and content gaps. Use when: improving knowledge base coverage; identifying frequently asked but unanswered … |
| `analyze_chat_feedback` | internal | Analyze chat feedback: summary stats, negative feedback drill-down. Use when: monitoring customer satisfaction; identifying knowledge gaps; reviewing support quality. NOT for: getting raw feedback … |

## Module API Contract

**Actions:** `dashboard`, `seo_audit`, `feedback_analysis`, `weekly_digest`

**Input fields:** `action`, `page_url`, `period_days`

**Output fields:** `success`, `message`, `error`

## File Map

| Purpose | Path |
|---------|------|
| Module definition | `src/lib/modules/analytics-module.ts` |
| Hook | `src/hooks/useAnalytics.ts` |

## Contributing

To enhance this module, see [Contributing Guide](../contributing/contributing.md).

Key rules:
- Follow `ModuleDefinition<I, O>` contract pattern
- All schema changes require idempotent migrations
- Skills must be self-describing ([Law 2](../concepts/openclaw-law.md))
- Blocks are interfaces, not pipelines ([Law 3](../concepts/openclaw-law.md))
- New skills must pass the [Agent Contract Integrity](../architecture/agent-contract-integrity.md) checklist (`bun run lint:skills`)

---

*This file is auto-generated by `scripts/generate-module-docs.ts`. Do not edit manually — re-run the script after changing the module definition.*