Skip to content

scrapelesshq/GEO-Ready-Website

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GEO Ready Website

GEO Ready Website is an AI-driven tool built on top of Scrapeless that enables automated monitoring and auditing of websites for geo-specific indexing and local SEO readiness.

Follow on YouTuBe Join our Discord Follow us on X Join us on Reddit Official Website


Features

  • Geo-specific Monitoring: Check how your website appears in search results from different regions.
  • Local Indexing Audit: Detect if your content is properly indexed in target markets.
  • Automated Reports: Generate comprehensive SEO and indexing reports.
  • AI-powered Analysis: Intelligent insights into GEO readiness and search visibility.
  • Scrapeless Integration: Uses Scrapeless cloud browser for accurate rendering and scraping.

Installation

First, install the SDK

# Install the official Scrapeless SDK
npm install @scrapeless-ai/sdk

Click here to obtain your API-KEY

git clone https://github.com/scrapelesshq/GEO-Ready-Website.git
cd GEO-Ready-Website
cp .env.example .env
cd src
npm install
# edit .env and add at least SCRAPELESS_API_KEY=your_api_key_here

Important: after configuring .env, you need to edit geoaudit.js to replace placeholder values:

Field Description
OPENAI_API_KEY Your OpenAI API key. Example: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxx
TARGET_URL The URL of the website to audit. Example: https://www.example.com/
AI_SNIPPET_MAX Maximum number of characters extracted for AI analysis. Default: 12000
CRAWL_LIMIT Maximum number of pages to crawl per run. Example: 10. Default: undefined (no limit)

Note: The OPENAI_API_KEY is only required if you want AI-powered analysis or text generation features.


Example Output — GEO Audit Summary

Below is an Example Output exactly matching the plaintext report format your tool produces. After the example I list which parts are AI-dependent and which are base GEO/SEO checks. At the end there is a placeholder section for the HTML report preview — replace the path with your actual generated HTML file so users can open it in their browser.

---- GEO Audit Summary ----

URL: 
Pages found: 
Avg (prelim) SEO Score: 
GEO SCORE: 
Crawlability (calc): 
Accessibility (ARIA count): 
Sitemaps found: 
Top issues (top 10): [
  { issue: '', count: 1 },
  { issue: '', count: 1 },
  { issue: '', count: 1 },
  { issue: '', count: 1 },
  { issue: '', count: 1 },
  { issue: '', count: 1 },
  { issue: '', count: 1 },
  { issue: '', count: 1 }
]

---- Report Preview ----

geoaudit

About

AI-powered audit for GEO readiness & local indexing

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published