The Free, Open-Source, Local-First Alternative to Paid Audit Tools
Run comprehensive website growth audits, technical SEO checks, AI-readiness evaluations, and actionable fix guides on your local machine with ZERO API keys, ZERO paid subscriptions, and ZERO cloud dependencies.
Traditional audit tools (Ahrefs, Semrush, Screaming Frog) cost $120–$500/month, send your website data to third-party cloud servers, and leave you with raw data without clear fix steps.
AidenScan changes the game:
- 🛡️ 100% Local-First & Private: Your site data stays strictly on your machine. Zero telemetry, zero external tracking.
- 💰 $0 Forever: Zero subscription fees. Runs using standard local Python without requiring paid API keys.
- 🔧 AidenFix™ Action Engine: Doesn't just report errors — provides exact CMS step-by-step resolution steps for Shopify, WordPress, Webflow, and Custom sites.
- 📊 Agency & Client-Ready Exports: Generates print-ready multi-page PDFs, Excel workbooks (
.xlsx), CSV datasets, and Markdown reports. - 🎯 Data Honesty Contract:
NOT_CONNECTED != ZERO. Unmeasured metrics render as—(Data unavailable), never as misleading zeros.
┌───────────────────────────────────────────────────────────────────────────────────┐
│ AIDENSCAN ECOSYSTEM TARGETS │
├─────────────────┬───────────────────┬─────────────────────┬───────────────────────┤
│ 🛒 D2C Brands │ 💼 Agencies │ 💻 Freelancers │ 🛠️ Developers │
│ Fix SEO & CRO │ Client Onboarding │ $500 Audit Reports │ Build Plugins & Rules │
│ Free Local Scans│ White-Label PDFs │ Retainer Prospecting│ Custom CMS Connectors │
└─────────────────┴───────────────────┴─────────────────────┴───────────────────────┘
AidenScan gives freelancers and agency owners an instant, zero-cost growth toolkit to generate recurring income:
- High-Converting Prospecting: Run a 30-second scan on prospective client sites and export a multi-page PDF audit report.
- Charge for Audit Deliverables: Offer a $250–$500 "Website Health & AI Readiness Audit" deliverable to small businesses and e-commerce stores.
- Close Monthly Retainers ($1,500–$3,000/mo): Use the AidenFix™ Action Engine step-by-step guides to implement the technical SEO, canonical, schema, and CRO fixes for the client.
- Audit your Shopify, WooCommerce, or custom store locally for broken links, thin content, missing meta tags, and orphan product pages.
- Save $1,200–$3,000/year on paid SEO software subscriptions.
- Fix issues directly in your CMS admin using built-in AidenFix™ step-by-step instructions.
Because AidenScan is 100% open-source, you can extend it to build custom solutions:
- Build Custom Audit Rules: Write deterministic Python rule detectors for specialized frameworks (Next.js, Astro, Laravel).
- Add CMS Connectors: Expand platform detection for Wix, Squarespace, Magento, and Headless CMSs.
- Build Micro-SaaS Applications: Wrap the core AidenScan CLI/REST API into internal dashboards, Slack bots, or automated CI/CD deployment checks.
- Python 3.9+
- Web browser (Chrome, Firefox, Edge, Safari)
# 1. Clone the repository
git clone https://github.com/YOUR_USERNAME/aidenscan.git
cd aidenscan
# 2. Install dependencies
pip install -r requirements.txt
# 3. Start the AidenScan local server
python server.py 8888Open your web browser and navigate to:
👉 http://localhost:8888/dashboard.html
| Category | Implemented Rules | Description |
|---|---|---|
| Technical SEO | SEO-ROBOTS-001, SEO-SITEMAP-001, SEO-HTTPS-001, SEO-CANONICAL-001 |
Crawlability, SSL encryption, canonical directives, robots.txt |
| On-Page SEO | SEO-TITLE-MISSING, SEO-TITLE-LENGTH, SEO-META-DESC-MISSING, SEO-H1-COUNT |
Title tag length, meta descriptions, heading hierarchy |
| Content Quality | SEO-CONTENT-THIN |
Detects thin content pages (< 160 words) |
| Site Architecture | SEO-LINK-ORPHAN, SEO-LINK-BROKEN |
Discovers orphan pages and broken internal link paths |
| Answer Readiness (AEO) | AEO-ANSWER-READINESS, AEO-FAQ-SCHEMA |
Direct answer summaries and FAQPage JSON-LD structured data |
| AI Search Readiness (GEO) | GEO-AI-SEARCH-SCHEMA, GEO-CITATION-READINESS |
LLM indexing readiness and citation structure |
| Conversion (CRO) | CRO-CTA-PRESENCE, CRO-FORM-INPUT |
CTA buttons and contact form inputs |
AidenScan includes an independent Backlink Intelligence Module designed around strict Data Honesty:
VERIFIED_SOURCE: Connect official, authenticated Google Search Console or Bing Webmaster APIs (100% Free).IMPORTED_DATASET: Import free backlink CSV or JSON exports from GSC, Bing, Ahrefs, or Semrush.NOT_CONNECTED: When no data source is connected, AidenScan strictly displays— Data unavailableinstead of fabricating fake zeros.
We actively invite developers, agency owners, and SEO engineers to join us in building the ultimate open-source website intelligence system.
- Add New Deterministic Rules: Submit PRs for new audit rules in
engine/rules/. - Enhance AidenFix™ CMS Guides: Add platform-specific resolution steps in
engine/solutions_registry.json. - Build Integrations: Create plugins for GitHub Actions, Slack, Discord, or CMS admin panels.
Check out our CONTRIBUTING.md guide to get started!
- Zero Telemetry: AidenScan contains no tracking scripts, analytics, or phone-home pingbacks.
- Local Network Scans: The web crawler contacts ONLY the target domain specified by the user.
- Zero API Requirement: Core engine runs 100% locally without cloud subscriptions.
- No Absolute Warranties: Technical audit recommendations improve site health structure but do not promise or guarantee search engine rankings or traffic.
This project is licensed under the MIT License — see the LICENSE file for details.