GWG SEO / 0.1.0CLI + Node.js + MCP

Website audits, in your terminal.

Check titles, canonical URLs, indexing directives, and crawl links. GWG SEO returns the observations and their limits as JSON, so you or your agent can decide what to fix.

RuntimeNode.js 22.19+
LicenseApache-2.0
Website auditsNo API key required
Install

Start with one page.

Run these commands inside the project where you want to use GWG SEO. Replace the example URL with your website.

Install and run a page audit
npm install @getwickedgrowth/seo@0.1.0
npx --no-install gwg-seo audit https://www.example.com/

The command prints a JSON report with coverage, data, and findings. A canonical pointing elsewhere or a noindex directive is an observation to review. Either can be intentional.

For a global command, use npm install --global @getwickedgrowth/seo@0.1.0. The package installs gwg-seo and seo. If either name already belongs to another tool, keep the project-local installation above and use npx --no-install gwg-seo.

Collect evidence

Crawl, save, and share a report.

A crawl follows links on the same origin and respects robots rules. Start with a small page limit, inspect the failures and coverage, then expand the run if needed.

Crawl up to 20 pages
npx --no-install gwg-seo crawl https://www.example.com/ --max-pages 20 --max-depth 3 --save
Write a standalone HTML report
npx --no-install gwg-seo audit https://www.example.com/ --format html --output ./audit.html

--save keeps a local snapshot. Use snapshots list and snapshots diff <before-id> <after-id> to compare observations. A finding disappearing from a smaller crawl does not prove it was fixed.

HTML output escapes report content and blocks scripts and external resources. The output file must be new; existing files are preserved.

Agent setup

Give your agent the same reports.

Use a client that supports local stdio MCP servers. After installing the package, generate the configuration for your installed copy:

Generate MCP configuration
npx --no-install gwg-seo mcp config

Copy the printed server entry into your client's MCP settings. It contains the Node executable and package path on your machine. The server starts with gwg-seo mcp serve; it does not require a hosted server URL. Regenerate the entry if you move the installation.

  1. seo_reports lists implemented reports.
  2. seo_describe returns a report's input schema.
  3. seo_run runs the report and returns its evidence.

Try asking your agent: “Audit my homepage with GWG SEO. Show the observed URL for each finding and preserve the report's coverage limits.”

Install the optional agent skill

Replace the path below with your agent's skills directory. The installer creates a new gwg-seo directory and refuses to replace an existing one.

Install the packaged skill
npx --no-install gwg-seo skill install --to /absolute/path/to/agent/skills
Build with it

Call it from a Node.js application.

The CLI, library, and MCP server share a report engine. TypeScript declarations ship with the package.

ES modules
import { auditPage } from '@getwickedgrowth/seo'

const result = await auditPage({
  url: 'https://www.example.com/',
})
console.log(result.coverage, result.findings)

Run this in Node.js. The package is intended for local tools and server-side applications, and does not ship a browser bundle.

Report catalog

Eight reports in 0.1.0.

Use gwg-seo reports describe <id> to inspect the inputs before running a report.

ReportWhat you receive
page.auditWebsiteInspect HTTP status, titles, descriptions, H1 headings, canonical links, indexing directives, image alt attributes, and JSON-LD syntax.
site.crawlWebsiteFollow same-origin HTML links within page and depth limits. Review duplicate titles, per-page findings, and failed requests.
site.robotsWebsiteEvaluate a URL against robots.txt for the GWG-SEO user agent and list declared sitemaps.
site.sitemapWebsiteRead one XML sitemap or sitemap index, with a limit on the retained entries.
google.sitesGoogle previewList the Search Console properties accessible to your configured Google identity.
google.searchGoogle previewRead Search Console rows for explicit dates, dimensions, and a row limit.
google.analyticsGoogle previewRead GA4 organic-search landing pages with sessions, engaged sessions, and key events.
search.opportunitiesGoogle previewPrioritize Search Console rows with average positions 4-20 and a minimum impression threshold.
Google preview

Connect search data when you need it.

Google reports are a preview in 0.1.0. Automated fixtures cover API requests and response handling. Live Google-account validation is still outstanding, so verify the integration against your own properties before relying on it.

Bring a Google Desktop OAuth client or a service-account file with access to your Search Console and GA4 properties. There is no shared credential. Browser authorization uses gwg-seo auth login --client /path/to/desktop-client.json.

Search Console omits some query data. Analytics sessions and Search Console clicks measure different events. The opportunity report uses a position and impression threshold to prioritize review; it does not forecast traffic.

Follow the Google setup guide for API enablement, credentials, date ranges, and access requirements. You can also import a Search Console CSV with explicit property and date information.

Scope and privacy

Know what the report covers.

  • Fetched HTML: audits do not execute JavaScript. A rendered page can contain additional content.
  • Bounded acquisition: crawls default to 20 attempted pages and depth 3. Reports identify skipped URLs, truncated evidence, and request failures.
  • Private networks: local and private addresses are blocked unless you explicitly enable them. Report parameters cannot turn on that access in an MCP server.
  • Local storage: settings and saved reports stay in ~/.gwg-seo, or the directory selected with GWG_SEO_HOME. There is no telemetry or automatic report upload.
  • Your agent's handling: an MCP client can send report content to its model provider. Review URLs and analytics data before sharing reports.

Read the privacy notes and full acquisition limits. The issue tracker is the place to report a reproducible problem.