# AiSEO — AI-Powered SEO Audit Tool

> AiSEO is a Vietnamese-first SEO audit and AI content analysis tool by ERPFit. It checks websites against 312+ rules from Google and Bing official documentation, simulates how AI search engines extract and cite content, and generates professional branded reports in Vietnamese and English.

## What AiSEO Does

AiSEO audits websites for search engine optimization across six categories: on-page SEO, technical SEO, structured data (Schema.org), performance (Core Web Vitals), GEO/AI readiness, and content quality. It also simulates how AI-powered search engines like Google AI Overviews, ChatGPT, and Perplexity extract and cite web content.

## Key Capabilities

- SEO audit with 312+ rules from Google Search Central and Bing Webmaster docs
- AI content extraction simulation (citability scoring, passage ranking)
- Multi-page site crawl (up to 50 pages with concurrent fetching)
- Core Web Vitals via PageSpeed Insights and CrUX field data
- PDF and HTML report generation (branded ERPFit)
- Vietnamese (default) and English language support
- MCP server for Claude and AI agent integration

## API

Base URL: https://aiseo.erpfit.com

### Endpoints

- POST /api/scan — Run SEO audit on a URL. Body: {"url": "https://example.com"}
- POST /api/crawl — Multi-page site crawl. Body: {"url": "https://example.com", "maxPages": 10}
- POST /api/render — AI content extraction simulation. Body: {"url": "https://example.com"}
- GET /api/report/:id — HTML report for a scan
- GET /api/report/:id/pdf — PDF report for a scan
- GET /api/scans/:id — Full scan result by ID
- GET /api/sites/:domain/history — Scan history for a domain
- GET /api/sites/:domain/performance — Search Analytics summary (GSC)
- GET /api/sites/:domain/opportunities — SEO opportunities (striking-distance, CTR gaps, cannibalization)
- POST /api/sites/:domain/inspect — URL indexation status via GSC URL Inspection API
- GET /api/sites/:domain/gsc-diff — Compare two GSC performance snapshots
- POST /api/sites/:domain/rank-findings — Re-rank findings by traffic weight
- GET /api/health — Service health check

### Authentication

API key via Authorization header or api_key query param. Session cookies also accepted. Public access available with free tier limits (1 scan/month).

## MCP Server

AiSEO provides an MCP server with five tools for AI agent integration:

- seo_scan(url, skipPerf?) — Full SEO audit returning score, grade, and findings
- seo_render(url) — AI content extraction analysis with citability scoring
- seo_compare(urls, skipPerf?) — Side-by-side SEO comparison of 2-5 URLs
- seo_report(url, skipPerf?) — Audit + save to database, returns report URLs
- seo_schedule(domain, cron?, email?) — Set up recurring automated scans

## Technology

Built with Bun, Hono, PostgreSQL, Prisma ORM, better-auth, i18next, and cheerio. Uses Google PageSpeed Insights API (free) for Core Web Vitals data.

## Company

CONG TY TNHH ERPFIT (MST: 0317567782)
Website: https://erpfit.com
SEO Tool: https://aiseo.erpfit.com

## Links

- [API Documentation](https://aiseo.erpfit.com/docs/api.md)
- [MCP Server Documentation](https://aiseo.erpfit.com/docs/mcp.md)
- [SEO Wiki](https://aiseo.erpfit.com/wiki)
- [Pricing](https://aiseo.erpfit.com/pricing)