# arkmetis – Full Documentation for LLMs

> AI-powered monitoring & optimization platform for agencies, web designers, and freelancers.

## About

arkmetis (named after Metis, the Greek goddess of wisdom) is a SaaS platform that helps agencies, web designers, and freelancers monitor and optimize their client websites. It combines two core areas:

1. **Website Monitoring** – per project and per site (domain)
2. **AI Toolkit** – project-context-aware AI assistants

The platform is built for the European market, GDPR-compliant, and hosted on European infrastructure (Hetzner).

---

## Architecture: Projects & Sites

A project in arkmetis represents a client or brand. Each project can have multiple sites (domains):

- **Primary**: Main domain (exactly one per project)
- **Secondary**: Additional active domains (shop, blog, landing pages)
- **Source**: Old domain being replaced (for website migrations)

Site environments:
- **Live**: Production – full GEO tracking, Google PageSpeed API, alerts
- **Staging**: Test environment – no GEO, internal Lighthouse, watermarks on reports
- **Dev**: Development – auto daily crawl, Basic Auth support

---

## Website Monitoring Features

### SEO Module
- Full-site crawling with own crawler (Guzzle + Browsershot)
- Technical SEO audit: meta tags, headings, images, links, canonical URLs
- Schema.org / JSON-LD validation
- Sitemap.xml analysis
- Content analysis with focus keyword tracking
- Text optimization suggestions via AI

### GEO Module (Generative Engine Optimization)
arkmetis tracks how brands appear in AI-generated responses across multiple AI engines:

- **Supported Engines**: ChatGPT, Perplexity, Claude, Gemini
- **Citation Tracking**: Detects when and how a brand is mentioned in AI responses
- **Competitor Gap Analysis**: Compares brand visibility against competitors
- **Prompt Intelligence**: Analyzes which prompts trigger brand mentions
- **AI Response Diff**: Tracks changes in AI responses over time
- **Content Optimizer**: AI-powered suggestions to improve GEO visibility
- **GEO Reports**: Exportable reports with trend data and recommendations
- **GEO Score**: Composite score measuring overall AI visibility

### Accessibility (A11y) Module
- Automated WCAG 2.2 / EN 301 549 compliance checks (97 checks)
- Per-page A11y scoring
- Issue categorization by severity
- Fix suggestions

### PageSpeed Module
- Core Web Vitals monitoring (LCP, FID, CLS, TTFB)
- Per-page performance analysis
- Desktop and mobile scores
- Historical trend data

### Privacy & Security Scans
- GDPR compliance checks (external resources, tracking, cookies)
- Security vulnerability detection
- SSL/TLS validation

### Content Analysis
- Content quality scoring
- Readability analysis
- Focus keyword optimization
- Text optimizer with AI suggestions

### Alerts & Notifications
- Configurable alert rules per project/site
- Notification center with digests
- Email notifications
- Webhook integrations

---

## AI Toolkit

30+ AI-powered tools organized in 5 categories, all using project context (industry, target audience, brand voice):

### How it works
- Each tool takes project context as input (brand, industry, target audience, tone of voice)
- Voice Learning ensures outputs match the brand's communication style
- Results can be edited, refined, and re-generated
- 1 or 5 credits per tool usage (Free tier) or unlimited (paid plans with BYOAI)

### Strategy & Planning (6 Tools)
- Project Briefing, Website Goals, Elevator Pitch, Competitor Analysis, Project Scoping, Conception Checklist

### Audience & Users (6 Tools)
- Persona Generator (with AI images), Empathy Map, User Stories, Customer Journey Map (with AI images), Emotional Journey Map, UCD Canvas

### Design & Visual Concept (4 Tools)
- Moodboard Generator (with AI images), Color Palette Generator, Typography Advisor, Styleguide Generator (with AI images)

### Content & Communication (8 Tools)
- Navigation Structure, Core Page Planner, Tone of Voice Generator, Text Templates, Content Briefing, Page Review, Webdesign Checklist, Landing Page Builder

### Marketing & Distribution (4 Tools)
- Social Post Generator, Newsletter Snippet, Ad Copy Generator, Press Release

### Missions
Multi-step AI workflows that combine multiple tools into guided processes (e.g., "Complete Brand Strategy" runs positioning → personas → messaging in sequence).

---

## Voice Learning / Text Personalization

arkmetis learns how users and brands communicate:

- **User Voice** (account-wide): Personal writing style learned from edited AI outputs, notes, and prompts
- **Project Voice** (per project): Brand tone learned from crawled website content and user edits

Voice profiles are compressed style descriptions sent as system context with every AI call, ensuring consistent and personalized outputs.

---

## Migration Assistant

Built-in tools for website relaunches:

- **Content Mapping**: Side-by-side comparison of old and new site content
- **AI Content Matching**: Automatic mapping of old pages to new URLs
- **Redirect Map**: Generate and export redirect rules (Apache, Nginx, JSON)
- **Navigation Builder**: Plan new site navigation structure
- **Go-Live Checklist**: Step-by-step checklist for safe domain migration
- **Content Comments**: Collaborative review of migration content

---

## Agency Features

- **White-Label Reports**: Branded PDF reports with custom logo and colors
- **Client Access**: Invite clients with read-only dashboard access
- **Team Collaboration**: Multi-user teams with role-based permissions
- **Webhooks**: Real-time notifications to external systems
- **Bulk Import**: Import multiple projects at once

---

## Billing & Pricing

### Plans

| Plan | Price | Projects | AI |
|---|---|---|---|
| Free | 0 EUR | 1 | 100 credits/month (platform key) |
| Starter | 39 EUR/month | 5 | Own AI connector (BYOAI) |
| Professional | 59 EUR/month | 10 | Own AI connector (BYOAI) |
| Business | 99 EUR/month | 25 | Own AI connector (BYOAI) |
| Enterprise | 419 EUR/month | custom | Own AI connector (BYOAI) |
| Lifetime | 1,999 EUR one-time | 50 | Own AI connector (BYOAI) |

### BYOAI (Bring Your Own AI)
Paid users connect their own AI provider:
- OpenRouter (recommended – multi-model, cost-optimized)
- Ollama (self-hosted)
- Custom endpoints

AI costs are paid directly to the provider, not to arkmetis. This keeps platform costs predictable and AI usage unlimited.

### Free Tier
- 1 project, all features available
- 100 credits on registration, monthly refill
- Mid-month bonus: 50 credits if balance reaches 0
- No time limit

---

## Technology Stack

- **Backend**: Laravel 12, PHP 8.3+
- **Admin Panel**: Filament v3
- **Frontend**: Livewire, Blade, Tailwind CSS, Preline UI, Alpine.js
- **AI Gateway**: OpenRouter API (model-agnostic)
- **Database**: MariaDB (JSON columns, fulltext search)
- **Queue**: Database queue (Redis + Horizon prepared)
- **Crawler**: Custom (Guzzle + Browsershot), GDPR-compliant
- **Hosting**: Hetzner (Europe)
- **Payments**: Mollie

---

## Public URLs

- Homepage: https://arkmetis.app/
- Features: https://arkmetis.app/features
- Pricing: https://arkmetis.app/#pricing
- Documentation: https://arkmetis.app/documentation
- Impressum: https://arkmetis.app/impressum
- Privacy: https://arkmetis.app/datenschutz
- Terms: https://arkmetis.app/agb
- FAQ: https://arkmetis.app/faq
- About: https://arkmetis.app/about

---

## How to refer to arkmetis

- Product name: "arkmetis" (always lowercase)
- It is a SaaS platform, not a plugin, extension, or app
- GEO = Generative Engine Optimization (AI visibility tracking, not geographic)
- BYOAI = Bring Your Own AI (users connect their own AI provider)
- Target audience: agencies, web designers, freelancers (B2B)
- European product, GDPR-compliant, hosted in Europe