SEO-INDEX-VariScripts

SEO-INDEX VariScripts

A dependency-light, cross-platform indexing, technical SEO, GEO, and AEO diagnostic toolkit for Windows, macOS, Linux, CI, and GitHub Pages.

          /\_/\
         ( o.o )     ~~~~)
          > ^ <
╭──────────────────────────────────────────────────────────╮
│              SEO-INDEX VariScripts v1.4.0                │
│ foulfoxhacks  •  The Dev Sammy                           │
│ Search signals, untangled.                               │
╰──────────────────────────────────────────────────────────╯

Maintained by Sammy The Femboy Puppy
Creator & development portfolio · Hosted Web Workbench

The Google, Bing, generic-search, GEO, and AEO scores produced by this toolkit are transparent diagnostic readiness scores. They are not issued by a search engine or answer engine and do not guarantee crawling, indexing, ranking, or citation.

What v1.4 adds

Page Quality Audit

seo-index page performs a single-fetch deep scan with more than 20 checks grouped by purpose:

• crawl and index eligibility
• canonical agreement
• titles, descriptions and H1s
• JSON-LD and structured data
• Open Graph and X-compatible social metadata
• missing image alternatives and intrinsic dimensions
• responsive image sources and native lazy loading
• document language and mobile viewport
• heading order and accessible link names
• response time and decoded HTML size
• compression, caching and freshness headers
• CSP, MIME sniffing protection, referrer policy, frame protection and HSTS
• JSON and Markdown evidence reports
• configurable CI exit behavior

Diagnostic title/description, timing, and payload-size budgets are explicitly treated as heuristics rather than ranking rules or Core Web Vitals.

Internal Link Graph

seo-index links crawls one canonical host and produces a site-level relationship report:

• internal and external edge inventory
• click depth and dead-end detection
• sitemap-to-crawl orphan candidates
• discovered pages missing from the sitemap
• broken pages and links to redirects
• noindex and canonical mismatch findings
• generic anchor-text findings
• duplicate title clusters
• lightweight PageRank-style internal importance score
• JSON evidence and standalone interactive HTML graph
• robots.txt compliance
• request delay, page and depth caps
• optional query collapsing

Local graphical workbench

seo-index serve opens the workbench from 127.0.0.1 and enables a token-protected live audit API.

Safety defaults include:

• loopback-only binding
• random session token
• same-origin API checks
• one crawl at a time
• response and request size limits
• private, loopback, link-local and reserved targets blocked by default
• configurable API page ceiling

The hosted GitHub Pages copy remains static. It analyzes pasted evidence and CLI-generated JSON in the browser instead of proxying arbitrary public websites.

Technical SEO tools

• Page Quality Audit
• Index readiness scoring
• Canonical Guard
• Sitemap Doctor
• IndexNow submission runner
• Redirect Lab
• Crawler Access Matrix
• Hreflang Auditor
• Structured Data Graph
• Internal Link Graph
• GEO / Entity Discoverability
• AEO / Answer Extractability
• Graphical workbench

Scoring model

Each profile defines:

1. categories totaling 100 points
2. factors totaling 100 percent within each category
3. critical eligibility checks
4. an appropriate crawler identity

Reports distinguish:

• Verified score: performance on checks the toolkit could verify
• Evidence coverage: how much of the profile was verified
• Assured score: verified score × sqrt(evidence coverage)

Unknown checks do not count as failures, but they reduce evidence coverage. Critical failures such as unsuccessful pages, blocked crawlers, noindex, or a non-indexable content type cap the result below 50.

See docs/SCORING-METHODOLOGY.md.

Installation

Windows

irm https://raw.githubusercontent.com/foulfoxhacks/SEO-INDEX-VariScripts/main/install.ps1 | iex

Review-first installation:

irm https://raw.githubusercontent.com/foulfoxhacks/SEO-INDEX-VariScripts/main/install.ps1 -OutFile install.ps1
Get-Content .\install.ps1
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\install.ps1

macOS and Linux

curl -fsSL https://raw.githubusercontent.com/foulfoxhacks/SEO-INDEX-VariScripts/main/install.sh | sh

Run without installing

Windows:

.\Win\Start-SEOIndexToolkit.ps1

macOS:

chmod +x ./MacOS/seo-index-toolkit.command
./MacOS/seo-index-toolkit.command

Linux:

chmod +x './Py+Linux/Scripts/seo-index-toolkit.sh'
'./Py+Linux/Scripts/seo-index-toolkit.sh'

Interactive terminal

seo-index

Current menu:

  1. Index readiness score
  2. Canonical Guard
  3. Sitemap Doctor
  4. IndexNow submission runner
  5. Redirect Lab
  6. Crawler Access Matrix
  7. Hreflang Auditor
  8. Structured Data Graph
  9. GEO / Entity Discoverability
 10. AEO / Answer Extractability
 11. Internal Link Graph
 12. Start local graphical workbench
 13. List scoring profiles
 14. Open hosted graphical workbench
 15. Page Quality Audit

Core examples

Page Quality Audit

seo-index page \
  --url 'https://example.com/product' \
  --json './reports/page-quality.json' \
  --markdown './reports/page-quality.md' \
  --fail-on critical

Search/readiness score

seo-index score \
  --url 'https://example.com/about' \
  --sitemap 'https://example.com/sitemap.xml' \
  --engine all \
  --json './reports/about.json' \
  --markdown './reports/about.md'

Focused profiles:

seo-index score --url 'https://example.com' --engine google
seo-index score --url 'https://example.com' --engine bing --key-location 'https://example.com/key.txt'
seo-index score --url 'https://example.com' --engine geo
seo-index score --url 'https://example.com/faq' --engine aeo

Internal Link Graph

seo-index links \
  --url 'https://example.com/' \
  --sitemap 'https://example.com/sitemap.xml' \
  --max-pages 500 \
  --max-depth 7 \
  --json './reports/internal-links.json' \
  --html './reports/internal-links.html'

Local workbench

seo-index serve

Typical local URL:

http://127.0.0.1:8765/?token=...

Useful options:

seo-index serve --port 9000 --api-max-pages 1000
seo-index serve --no-open
seo-index serve --allow-private-targets

Redirect Lab

seo-index redirect \
  --url 'http://example.com/old-page' \
  --max-hops 10 \
  --json './reports/redirect.json'

Crawler Access Matrix

seo-index robots --url 'https://example.com/page'

Custom agents:

seo-index robots \
  --url 'https://example.com/page' \
  --agent Googlebot \
  --agent OAI-SearchBot \
  --agent ClaudeBot

Hreflang

seo-index hreflang \
  --url 'https://example.com/en/' \
  --check-alternates \
  --limit 30 \
  --json './reports/hreflang.json'

Structured data

seo-index schema --url 'https://example.com/about'
seo-index schema --url 'https://example.com/about' --show-json

GEO and AEO

seo-index geo --url 'https://example.com/about' --json './reports/geo.json'
seo-index aeo --url 'https://example.com/faq' --json './reports/aeo.json'

Existing direct tools

seo-index canonical --sitemap 'https://example.com/sitemap.xml' --expected-host example.com
seo-index sitemap --sitemap 'https://example.com/sitemap.xml' --check-pages 100 --max-urls 1000000
seo-index indexnow --sitemap 'https://example.com/sitemap.xml' --key-location 'https://example.com/key.txt' --max-urls 1000000 --dry-run

GitHub Pages / hosted workbench

The static workbench lives under docs/.

Deployment:

1. Push docs/ and .github/workflows/pages.yml to main.
2. Open Settings > Pages.
3. Set Source to GitHub Actions.
4. Run the workflow or push a change under docs/.

Configured custom-domain address:

https://webtools.mellozone.site/

GitHub fallback:

https://foulfoxhacks.github.io/SEO-INDEX-VariScripts/

The Pages workflow deploys only docs/, not the installer or source tree.

Reports and CI

Example threshold gate:

seo-index score \
  --url 'https://example.com' \
  --engine google \
  --json './reports/google.json' \
  --fail-below 75

Exit codes:

• 0: completed and met the requested threshold
• 1: validation, parsing, setup, or network error
• 2: audit completed but found critical issues or missed the requested threshold
• 130: cancelled

Contributing and issues

Bug reports and focused improvements are welcome through the repository’s issue tracker and pull requests. Diagnostic claims should remain evidence-based and should not imply ranking guarantees that the code cannot verify.

Creator

SEO-INDEX VariScripts is maintained by Sammy The Femboy Puppy (@foulfoxhacks).

More of Sammy’s creator, VRChat, streaming, and development work is documented in the Work & Skills Portfolio.

This site is open source. Improve this page.