# ACHTy AI — Full Documentation

> AI Visibility & SEO Platform
> Version: 2.0
> Last Updated: 2026-03-17

---

## Quick Summary

ACHTy AI is an AI-powered visibility and SEO optimization platform. We monitor how AI platforms (ChatGPT, Google Gemini, Perplexity) mention and recommend brands, then provide actionable insights to improve AI visibility.

**TL;DR**: Track your brand mentions across AI platforms → Get visibility score → Receive AI-powered SEO recommendations → Generate optimized content → Improve AI presence.

---

## Detailed Features

### 1. AI Visibility Scanning

**Description**: Continuously monitors AI platforms for brand mentions using optimized prompts tailored to each platform's behavior.

**How it works**:
- Sends targeted queries to ChatGPT, Gemini, and Perplexity
- Analyzes response position, frequency, and context
- Tracks mention sentiment (positive/neutral/negative)
- Detects competitor comparisons and preferences
- Identifies misinformation and outdated information

**Supported Platforms**:
- **ChatGPT (OpenAI)**: GPT-4 and GPT-4 Turbo models
- **Google Gemini**: Gemini Pro and Gemini Ultra
- **Perplexity AI**: Perplexity Pro with real-time web search

**Scan Types**:
- **Scheduled Scans**: Automatic weekly/monthly based on plan
- **On-Demand Scans**: Manual trigger anytime
- **Initial Scans**: Comprehensive baseline scan on project creation

### 2. Visibility Score (0-100)

**Description**: A comprehensive metric measuring your brand's AI visibility across five dimensions.

**Scoring Breakdown**:
1. **Presence Score (0-100)**: How often your brand appears in AI responses
2. **Rank Score (0-100)**: Your average position (#1, #2, #3, etc.)
3. **Sentiment Score (0-100)**: Positive vs negative mention ratio
4. **Accuracy Score (0-100)**: Correctness of information about your brand
5. **Consistency Score (0-100)**: Message uniformity across platforms

**Calculation**: Overall Score = (Presence × 25% + Rank × 25% + Sentiment × 20% + Accuracy × 15% + Consistency × 15%)

**Use Cases**:
- Track AI visibility improvement over time
- Compare against competitors
- Identify weak areas needing attention

### 3. AI SEO Analysis

**Description**: AI-powered SEO recommendations specifically for improving AI platform visibility (not traditional search engines).

**Analysis Includes**:
- **Keyword Analysis**: AI-detected keywords with opportunity scores (high/medium/low)
- **Current Rankings**: How you rank for each keyword in AI responses
- **Content Gaps**: Topics AI platforms discuss but you don't cover
- **Competitor Keywords**: Keywords where competitors outrank you
- **Recommendations**: Prioritized action items (critical/important/normal)

**Output Format**:
- Overall SEO Score (0-100)
- Top keywords with opportunity ratings
- Detailed recommendations with type and priority
- Content suggestions with estimated traffic potential

### 4. Content Studio

**Description**: Generate AI-optimized content for your website based on AI platform insights and SEO best practices.

**Content Types**:
- **FAQ**: Frequently Asked Questions (Q&A format)
- **How-To**: Step-by-step guides and tutorials
- **Comparison**: Product/service comparison pages
- **Buying Guide**: Product selection and recommendation guides
- **Meta Tags**: Title, description, and social media meta tags
- **Schema Markup**: Structured data for search engines

**Workflow**:
1. Select content type and target keyword
2. AI generates brief based on your brand and project data
3. Review and edit the brief
4. Generate full content in target language (TR/EN/DE/FR/ES/IT)
5. Export or publish to your CMS

**Languages Supported**:
- Turkish (TR)
- English (EN)
- German (DE)
- French (FR)
- Spanish (ES)
- Italian (IT)

### 5. Competitor Analysis

**Description**: Track competitors' AI visibility metrics and compare against your own performance.

**Features**:
- Add unlimited competitors (plan-dependent)
- Track competitor visibility scores
- See competitor mentions in AI responses
- Compare keyword rankings
- Identify competitor content strategies

**Use Cases**:
- Benchmark your AI visibility against market leaders
- Discover competitor tactics that work
- Find gaps where competitors are weak

### 6. Risk Alerts

**Description**: Real-time notifications about issues affecting your AI presence.

**Risk Types**:
- **MISINFORMATION**: False information about your brand
- **NEGATIVE_MENTION**: Unfavorable mentions or reviews
- **COMPETITOR_PREFERRED**: AI recommends competitors over you
- **MISSING_MENTION**: You should appear but don't
- **OUTDATED_INFO**: Old or incorrect information

**Severity Levels**:
- **CRITICAL**: Immediate action required
- **HIGH**: Address within 24 hours
- **MEDIUM**: Plan resolution within week
- **LOW**: Monitor and address when possible

**Actions**:
- Risk alerts generate actionable items
- Track resolution status
- Historical risk log for analysis

### 7. Action Plans

**Description**: Automated, prioritized SEO action items with approval workflow.

**Action Types**:
- **FAQ_CONTENT**: Generate FAQ content
- **HOWTO_CONTENT**: Create how-to guides
- **COMPARISON_PAGE**: Build comparison pages
- **META_OPTIMIZATION**: Improve meta tags
- **SCHEMA_MARKUP**: Add structured data
- **INTERNAL_LINK**: Suggest internal linking opportunities
- **ENTITY_CLEANUP**: Fix brand entity inconsistencies
- **TRUST_PAGE**: Create trust/safety pages
- **SEO_OPTIMIZATION**: General SEO improvements

**Approval Workflow**:
1. **DRAFT**: AI-generated suggestion (pending review)
2. **APPROVED**: User approved, ready to apply
3. **APPLIED**: Successfully implemented
4. **REJECTED**: User declined the suggestion

**Benefits**:
- No blind automation—user always in control
- Track what actions improve visibility
- Learn what works for your brand

### 8. Multi-language Support

**Supported Languages**: Turkish, English, German, French, Spanish, Italian

**Localization Features**:
- Full UI translation
- Content generation in target language
- AI platform queries in local language
- Local SEO best practices
- Currency and date formatting

**URL Structure**: `/[locale]/...` (e.g., `/en/dashboard`, `/tr/dashboard`)

---

## Pricing & Plans

### ACHTy AI Monthly ($199.90/month)

**Includes**:
- Up to 5 projects/websites
- Weekly AI visibility scans
- Full SEO analysis & recommendations
- Content Studio (up to 50 generations/month)
- Competitor tracking (up to 10 competitors)
- Risk alerts & action plans
- Email support

**Best For**: Small to medium businesses focusing on AI visibility

### ACHTy AI Yearly ($1,999/year — Save ~$400)

**Includes everything in Monthly, plus**:
- Daily AI visibility scans (not weekly)
- Priority support (24h response)
- Custom integrations available
- Onboarding session
- Higher content generation limits (100/month)

**Best For**: Established brands with comprehensive AI strategies

### Extra URL Add-on ($99.90/month per URL)

**Includes**:
- Monitor additional domains/projects
- Full feature access for each URL
- Shared quota across projects

**Best For**: Multi-brand organizations, agencies, and portfolio companies

### Plan Comparison

| Feature | Monthly | Yearly | Extra URL |
|---------|---------|--------|----------|
| Projects | 5 | 5 | +1 per add-on |
| Scan Frequency | Weekly | Daily | Inherits base plan |
| Content Generation | 50/month | 100/month | +10/month |
| Competitors | 10 | Unlimited | +5 per add-on |
| Support | Email | Priority | Inherits base plan |
| Custom Integrations | ❌ | ✅ | ❌ |

---

## Technical Architecture

### Frontend Stack

| Component | Technology |
|-----------|------------|
| Framework | Next.js 16.1.6 (App Router) |
| Language | TypeScript |
| Styling | Tailwind CSS |
| UI Components | shadcn/ui (Radix UI primitives) |
| State Management | React Server Components + Client Components |
| Internationalization | next-intl |
| Authentication | Auth.js (NextAuth) v5 |

### Backend Stack

| Component | Technology |
|-----------|------------|
| Runtime | Node.js (Vercel serverless) |
| Database | PostgreSQL (Neon serverless Postgres) |
| ORM | Prisma v6.19 |
| Cache/Queue | Redis + BullMQ |
| File Storage | Vercel Blob (if needed) |

### AI Providers

| Provider | Usage | Model |
|----------|-------|-------|
| OpenAI | ChatGPT scanning, content generation | GPT-4, GPT-4 Turbo |
| Google AI | Gemini scanning | Gemini Pro, Gemini Ultra |
| Perplexity | Perplexity AI scanning | Perplexity Pro |

### Authentication & Security

| Feature | Implementation |
|---------|----------------|
| Authentication | Auth.js v5 with JWT |
| Password Hashing | bcrypt (12 rounds) |
| Rate Limiting | Custom Redis-backed limiter |
| CSRF Protection | NextAuth built-in |
| Security Headers | Custom CSP, HSTS, Permissions-Policy |
| Webhook Verification | HMAC-SHA256 (Lemon Squeezy), Standard Webhooks (Polar) |

### Billing & Payments

| Provider | Purpose | Status |
|----------|---------|--------|
| Polar.sh | Subscription management | ✅ Active |
| Lemon Squeezy | Legacy (inactive) | ⏸️ Paused |

---

## API Endpoints (Public)

### Webhooks

| Endpoint | Method | Purpose |
|----------|--------|---------|
| `/api/webhooks/polar` | POST | Polar.sh subscription events |
| `/api/webhooks/lemon-squeezy` | POST | Lemon Squeezy events (inactive) |

### Health Check

| Endpoint | Method | Purpose |
|----------|--------|---------|
| `/api/health` | GET | Service health status |

### AI Documentation

| Endpoint | Method | Purpose |
|----------|--------|---------|
| `/llms.txt` | GET | AI crawler documentation (summary) |
| `/llms-full.txt` | GET | Full technical documentation |

---

## Use Cases & Workflows

### Use Case 1: New Brand Launch

**Scenario**: You're launching a new product and want to ensure AI platforms mention you accurately.

**Workflow**:
1. Create a project with your brand name, website, and target keywords
2. Run an initial AI visibility scan
3. Review baseline visibility score and mentions
4. Generate FAQ and how-to content in Content Studio
5. Implement recommended schema markup
6. Schedule weekly scans to track progress
7. Address any risk alerts immediately

**Expected Outcome**: Your brand appears in AI responses within 2-4 weeks with accurate information.

### Use Case 2: Competitor Monitoring

**Scenario**: Competitors are outranking you in AI responses.

**Workflow**:
1. Add competitors to your project
2. Run comparative scan
3. Analyze competitor mentions and keywords
4. Identify content gaps (topics competitors cover but you don't)
5. Generate content for those gaps
6. Track improvement over time

**Expected Outcome**: Improved rank and visibility relative to competitors.

### Use Case 3: Reputation Management

**Scenario**: AI platforms are showing outdated or incorrect information about your brand.

**Workflow**:
1. Run AI visibility scan
2. Check risk alerts for misinformation
3. Review accuracy score breakdown
4. Generate corrective content (FAQ, trust pages)
5. Implement action items for entity cleanup
6. Monitor for changes in subsequent scans

**Expected Outcome**: Misinformation decreases, accuracy score improves.

---

## Changelog

### March 2026
- Added llms-full.txt with comprehensive documentation
- Enhanced pricing details and plan comparisons
- Added FAQ section with 10 common questions
- Added support/social media/contact information

### Earlier Updates
- Polar.sh billing integration
- Multi-language support (6 languages)
- Content Studio with AI content generation
- Risk alerts and action approval workflow
- Competitor analysis and tracking

---

## Contact & Support

**Website**: https://achty.com
**Email**: info@achtyai.com
**Support Hours**: Mon-Fri 9:00-18:00 (Istanbul Time, UTC+3)
**Response Time**: Usually within 24 hours
**Documentation**: https://achty.com/llms-full.txt
**Status Page**: https://achty.com/api/health

---

## Company Information

ACHTy AI is developed by **Spacebera**, a technology company focused on AI-powered marketing and SEO tools.

**Our Mission**: We believe AI platforms are the new search engines. Brands need dedicated tools to optimize their presence across ChatGPT, Gemini, Perplexity, and emerging AI platforms.

**Founded**: 2024
**HQ**: Istanbul, Turkey
**Team**: Engineers, marketers, and AI specialists passionate about the future of search.

---

© 2026 ACHTy AI by Spacebera. All rights reserved.
For terms and privacy, see https://achty.com/en/terms and https://achty.com/en/privacy