Getting Started

ASEOKA is an autonomous SEO agent that continuously monitors your website, detects SEO issues, and generates code fixes delivered as pull requests on GitHub. This guide covers what to expect and how to work with ASEOKA after your agent is set up.

How It Works

ASEOKA runs a continuous cycle of scanning, analysis, and fix generation. Here is the full pipeline from scan to merged fix:

1. Scan -- Your agent crawls your website and collects page data (HTML, metadata, structured data, performance metrics).
2. Detect -- The agent analyzes each page against 137 SEO issue types across 14 categories, including meta tags, headings, structured data, performance, and GEO (AI search optimization).
3. Reason -- An AI reasoning engine prioritizes issues by severity and potential impact, deciding which fixes to generate first.
4. Generate -- The agent generates code fixes targeting the correct files in your repository (e.g., adding a meta description to your layout component).
5. Validate -- Each fix is tested in a sandbox environment. The agent runs your build process and type checks to make sure the fix does not break anything.
6. Deliver -- Validated fixes appear in your ASEOKA dashboard for review. When you approve a fix, a pull request is created on your GitHub repository.

Setup Process

During the beta period, the ASEOKA team handles all setup. Here is what the process looks like:

1. We provision your agent -- We create your client account in the ASEOKA Hub, generate a provisioning token, and deploy your agent.
2. We configure GitHub access -- We set up your GitHub Personal Access Token and target repository so the agent can create pull requests.
3. We run the first scan together -- We walk through the agent startup, crawling, and initial analysis with you so you understand what is happening.
4. You review issues in the dashboard -- After the scan completes, you can see detected issues, their severity, and recommended fixes at app.aseoka.com.

Your First Scan

After setup, your agent runs an initial scan automatically. Here is what to expect:

• The agent crawls up to 50 pages on your site (configurable).
• Scanning typically completes in under 2 minutes for most sites.
• Detected issues appear in your dashboard organized by severity (critical, high, medium, low) and category (meta tags, headings, structured data, etc.).
• The agent generates fixes for the highest-priority issues and validates them in a sandbox before presenting them to you.

Reviewing and Approving Fixes

Fixes appear in the dashboard with a confidence score and a preview of the code changes. The approval workflow is:

1. Open the Fixes page in your ASEOKA dashboard.
2. Review the fix -- See the issue it addresses, the files changed, and the code diff.
3. Click Approve -- The agent creates a pull request on your GitHub repository with the fix code.
4. Review and merge the PR -- Your development team reviews the pull request on GitHub and merges it using your normal workflow.
5. ASEOKA tracks the outcome -- After the fix is merged, the agent monitors whether your health score improves.

Dashboard Overview

Your ASEOKA dashboard at app.aseoka.com includes these main sections:

• Dashboard -- Overview of your site health score, recent activity, and scan status.
• Issues -- All detected SEO issues with filtering by severity, category, and status.
• Fixes -- Generated code fixes with confidence scores and code diffs.
• Pull Requests -- Track the status of PRs created by ASEOKA.
• GEO Insights -- Your Generative Engine Optimization score and signal breakdown. See the GEO Optimization guide.
• Chat -- Ask questions about your SEO issues directly to the agent.

Plan Tiers

Next Steps

• Configure your agent -- Customize scan behavior, site settings, and operation mode.
• Set up Git integration -- Configure GitHub access and understand the PR workflow.
• Explore GEO optimization -- Understand your AI search engine optimization score.