# Raken AI Audit App

Raken AI Audit App is the authenticated application behind the public RakenAI audit offer.
It runs market and visibility diagnostics for websites, especially clinics and high-intent service businesses.

## Canonical application entry points

- German landing: https://audit.rakenai.com/
- English landing: https://audit.rakenai.com/en/
- Brazilian Portuguese landing: https://audit.rakenai.com/pt-br/
- German app workspace: https://audit.rakenai.com/app
- English app workspace: https://audit.rakenai.com/en/app
- Brazilian Portuguese app workspace: https://audit.rakenai.com/pt-br/app

## What the application does

- starts preview and final audits for submitted domains
- infers market, business type, specialty, location, and competitors
- combines crawl data with external market signals
- produces HTML and PDF reports for completed audit jobs
- manages credits, history, and invite-based onboarding

## Public onboarding flow

1. The user starts on the website audit form on https://rakenai.com.
2. The website sends a lead to the audit app.
3. The audit app returns an activation link.
4. The user claims access in the browser, sets a password, and receives a session.
5. The new account starts with 3 free preview audits.

## Public API endpoints

- https://audit.rakenai.com/api/public/security-config
  Returns the public security configuration, including Turnstile enablement and whether open registration is allowed.

- https://audit.rakenai.com/api/public/invites/{token}
  Returns a masked preview of an invite token before claiming it.

- https://audit.rakenai.com/api/public/invites/{token}/claim
  Accepts a password and, in production, a Turnstile token to activate access.

## Authenticated API endpoints

- https://audit.rakenai.com/api/system/readiness
  Returns whether the audit runtime has the required environment and providers configured.

- https://audit.rakenai.com/api/audit
  Starts a new audit run. Requires an authenticated session and available credits.

- https://audit.rakenai.com/api/audit/{id}
  Returns audit state, business profile, market outputs, report availability, and summary data.

- https://audit.rakenai.com/api/audit/{id}/report
  Returns the HTML report for a completed audit.

- https://audit.rakenai.com/api/audit/{id}/report/pdf
  Returns the PDF report when available.

## Important operational notes

- The production app is session-based, not OAuth-based.
- Public registration is disabled intentionally in production.
- Public onboarding is protected by rate limits, allowed-origin checks, business-email validation, and Turnstile.
- Agents should respect robots.txt and the declared Content-Signal.