How to Install geoptimize: A Free Pre-Launch Check for Every Page You Publish

You wrote the page. You picked the photo. You hit publish. You felt great.

Then someone pointed out it has no meta description, two H1s and a heading outline that looks like a staircase built by a toddler.

geoptimize is a free tool that checks a page for missing basics before it goes live. Here's how to install it and use it.

Quick words (one line each):

• Meta description: the short summary that often shows under your title in Google results.

• H1: the main headline of a page. You want exactly one.

• Schema: extra code that labels what's on a page (a business, a product, an article) for search engines.

• Terminal: the text window where you type commands instead of clicking.

• npx: a command that downloads and runs a Node.js tool in one go.

• CI: an automatic check that runs every time a site is built, before it goes live.

What it actually checks

geoptimize reads a page (a live web address, or the built files of a site) and gives a 0-100 "content readiness" score in 5 parts:

1. Page structure (headings and outline).

2. How quotable your facts are.

3. Schema tidiness.

4. Meta tags.

5. Padding and repetition.

Its audit mode lists each check as PASS, WARN or FAIL, with the exact text it found.

And it's honest. The README says the score does not predict Google rankings or AI citations. It also gives no points for llms.txt or FAQ schema. Love a tool that doesn't oversell.

Step 1: Do a 60-second safety check

Here's what geoptimize showed when we checked it on Oct 29, 2026:

1. Licence: MIT. Free to use, including for client work.

2. Last update: Oct 19, 2026. Latest release v0.12.0 (Oct 17, 2026).

3. Stars: 263 (as of Oct 29, 2026).

4. No install scripts. It runs other programs only to find Chrome (for optional page rendering), check git, and run optional extra scorers.

5. No API key for scan or audit.

6. Young project (version 0.x), so its rules can change between versions.

Step 2: Install Node.js 22.12 or newer

geoptimize needs Node.js 22.12 or newer. Grab it from nodejs.org. Already have Node? Type node -v in a terminal to check the version.

Step 3: Scan a live page

npx geoptimize scan https://example.com

You get the overall score and the 5 part scores.

Our test: on a 3-page test site, it scored 70/100 overall. The good page scored 89. Two bare pages scored 61 with the warnings "No meta description found" and "No paragraphs detected." Correct on both.

Step 4: Get the detailed PASS / WARN / FAIL list

npx geoptimize audit https://example.com --json

This is the useful one. In our test, it gave PASS for title, meta description and heading outline, and showed the exact text it found for each.

Fix every FAIL. Read every WARN. Ignore nothing until you've looked.

Step 5: Check several pages of a site at once

npx geoptimize audit-site https://example.com --max-pages 20 --json

Change 20 to however many pages you want checked.

Step 6: Check a site before it goes live

Building a site with a tool that outputs files (into a folder like dist)? Scan the folder:

npx geoptimize scan ./dist --dir

It can also run in a site's build (CI) to stop a bad page from going live. The README has a tutorial for that.

Step 7: Use the score the right way

The score is a rule-of-thumb checklist, not a ranking factor. The tool says so itself.

So use it one way: compare a page with itself. Score it, fix things, score it again. Never show it to a client as an "AI visibility score."

What it costs

Nothing. MIT licence, no key. The optional extra scorers and plugin are extras you don't need.

Do this today

1. Check your Node.js version with node -v (you need 22.12 or newer).

2. Run npx geoptimize audit https://yoursite.com --json on your homepage.

3. Fix every FAIL it lists.

4. Run it on your 3 newest blog posts.

5. Re-run and write down the before and after scores.

Related reading

• Install linkinator to find broken links

• Install ultimate-seo-geo for a free SEO audit report

• Add an AI summary block to the top of your page

Sources

• GitHub: cucuwang/geoptimize

Don't worry if this seems like it's a pain in the ass for someone who doesn't build websites. That's because it is. The good news: just click the link below, pull the trigger, and we'll take care of the rest.