Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Support via PayPal Telegram Create VPN Account

GAEC — Google AdSense Eligibility Checker

License: MIT Node.js PRs Welcome

GAEC is a free, open-source tool that analyzes any website against Google AdSense eligibility requirements. It performs 55 automated checks across 7 categories — from technical compliance and content quality to prohibited content scanning — and gives you an actionable score with detailed explanations for every finding.

Built from official Google AdSense documentation, program policies, and community best practices.


Demo

Live demo: gaec-tau.vercel.app

Try it out — enter any website URL and see the full AdSense eligibility report instantly.


Features

  • 55 comprehensive checks across 7 categories
  • Real-time analysis — fetches and analyzes any public website URL
  • Weighted scoring — critical failures cost more than minor warnings
  • Dark mode — toggle between light and dark themes
  • Recent checks — history saved locally in your browser
  • Copy report — export full analysis as text
  • No external APIs — fully self-contained, zero API keys needed
  • Responsive — works on desktop, tablet, and mobile

7 Analysis Categories

Category Checks What It Analyzes
Technical 12 HTTPS, SSL, HTTP status, mobile viewport, robots.txt, sitemap.xml, ads.txt, indexability, language, structured data, page size, response time
Content Quality 8 Word count, Flesch readability, paragraph structure, H1 count, heading hierarchy, text-to-HTML ratio, content freshness, author attribution
Meta Tags 7 Title tag, meta description, Open Graph, Twitter Cards, canonical URL, charset, favicon
Essential Pages 7 Privacy Policy, About Us, Contact Page, Terms of Service, Cookie Policy, DMCA/Copyright, Privacy Policy content verification
Prohibited Content 9 Adult, gambling, drugs/alcohol/tobacco, weapons, hate speech, piracy, hacking/malware, counterfeit, violence
Navigation & Structure 8 Internal links, external links, image alt text, nav bar, footer, breadcrumbs, search function, broken links
Domain 5 Custom domain vs free subdomain, TLD quality, domain length, www consistency, hyphens

Quick Start

Prerequisites

  • Node.js 18 or higher
  • npm (comes with Node.js)

Install & Run Locally

# Clone the repository
git clone https://github.com/arisedeepseek-dev/GAEC.git
cd GAEC

# Install dependencies
npm install

# Start the server
npm start

Open http://localhost:3000 in your browser. Enter any website URL and click Analyze Site.


Deploy

Deploy to Vercel

Deploy to Vercel

Or manually:

  1. Fork this repository on GitHub
  2. Go to vercel.com and click New Project
  3. Import your forked repository
  4. Configure:
    • Framework Preset: Other
    • Build Command: npm install
    • Output Directory: (leave empty)
    • Install Command: npm install
  5. Click Deploy

Important: Create a vercel.json file in the root directory (already included):

{
  "version": 2,
  "builds": [{ "src": "server.js", "use": "@vercel/node" }],
  "routes": [{ "src": "/(.*)", "dest": "server.js" }]
}

Deploy to Railway / Render / Heroku

Any platform that supports Node.js works. Just point it to server.js as the entry point and set the start command to npm start.

Deploy to a VPS

# Install Node.js
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# Clone and set up
git clone https://github.com/arisedeepseek-dev/GAEC.git
cd GAEC
npm install

# Run with PM2 (recommended for production)
npm install -g pm2
pm2 start server.js --name gaec
pm2 save
pm2 startup

Usage

  1. Open the app in your browser
  2. Enter a website URL (e.g., example.com or https://example.com)
  3. Click Analyze Site or press Enter
  4. Review the results:
    • Overall score (0-100) with color-coded gauge
    • Category breakdown — expand each to see individual checks
    • Copy Report to share or save the full analysis
  5. Fix the issues flagged as fail or warning before applying to AdSense

Understanding the Score

Score Meaning
80-100% Likely ready for AdSense — few or no issues detected
50-79% Needs improvement — fix warnings and failures first
0-49% Not ready — significant issues to resolve

How It Works

User enters URL
       ↓
Backend (Node.js + Express) fetches the target website HTML via axios
       ↓
Cheerio parses the HTML, runs all 55 checks across 7 modules
       ↓
Weighted scoring algorithm produces a final score
       ↓
JSON response sent to the frontend
       ↓
Vanilla JS renders the report with animated score gauge, category cards, and detailed results

All analysis happens server-side — no browser extensions or external APIs needed.


Project Structure

GAEC/
├── server.js           # Express backend + all 7 analysis modules
├── package.json        # Project config and dependencies
├── .gitignore          # Ignored files (node_modules, .env)
├── vercel.json         # Vercel deployment config
├── LICENSE             # MIT license
└── public/
    ├── index.html      # Frontend UI
    ├── style.css       # All styles (light/dark mode, responsive)
    └── script.js       # Frontend logic (API calls, rendering, dark mode)

Tech Stack

Layer Technology
Backend Node.js, Express
HTTP Client Axios
HTML Parser Cheerio
Frontend Vanilla HTML, CSS, JavaScript
Font Inter (Google Fonts)

Contributing

Contributions are welcome! Here's how:

  1. Fork the repository
  2. Create a branch: git checkout -b feature/your-feature
  3. Make changes and test locally
  4. Commit: git commit -m "Add your feature"
  5. Push: git push origin feature/your-feature
  6. Open a Pull Request

Ideas for Contributions

  • Add more analysis checks
  • Improve keyword lists for prohibited content detection
  • Add multi-page crawling for deeper analysis
  • Add PDF report export
  • Add i18n / multi-language support
  • Add comparison / history tracking between multiple checks

License

MIT — see LICENSE for details.


Disclaimer

This tool provides an estimate based on publicly documented Google AdSense requirements. Only Google can make the final approval decision. Use GAEC as a guide to identify and fix issues before applying to AdSense — not as a guarantee of approval.


References


Built with ❤️ for the open-source community. If you find this useful, please ⭐ star the repo!

About

Check if any website is ready for Google AdSense approval — 55 automated checks, 100% free.

Resources

Stars

Watchers

Forks

Contributors

Languages