seo

SEO Skill

The SEO command for AI agents. Audit sites, find search opportunities, research competitors, and verify the work from one local command and MCP server.

Get started · Features · SEO MCP server · Documentation · npm · Questions · Privacy · Security · License · Agent notes

The seo command turns crawl, Search Console, connected traffic analytics, and optional research-provider data into work you can inspect and ship. Find technical blockers, recover existing demand, research new keywords and competitors, review programmatic page patterns, and catch regressions after a release.

Who this is for

• People running their own sites who want a clear audit and a ranked list of fixes, without learning a heavy dashboard.
• AI agents that need real crawl, Search Console, traffic analytics, keyword, result, domain, competitor, and link evidence through MCP and one packaged SEO skill instead of screenshots or guesses.
• Developers who want to embed the same report engine in a script, a CI job, or a TypeScript app.

Quick start

Requires Node 22 or newer.

npm i -g seo
seo start
seo report

The setup walks you through Google sign-in, your Search Console property, an optional traffic analytics connection, and a local project profile. Public releases can include the shared Google app. If it is unavailable in your build, setup guides you through adding your own desktop OAuth client.

DataForSEO, Semrush, and Ahrefs are optional research providers built into the main package. Connect one only when external result, keyword, domain, competitor, or link evidence would change the decision.

That is the normal path. The seo command is then available in every terminal, script, CI job, and local MCP client on the machine.

The main report uses the evidence you have, explains what it could not check, and recommends a short list of follow-up commands. You can start with a local technical report before connecting Google: seo report --url crawls the site and returns findings and an action list with no sign-in at all.

Running seo help shows the shape of the tool:

Run SEO audits, find what needs fixing, and ship the changes with your agent.

Start here
  seo start                                Connect first-party data and save a project profile
  seo report                               Run the main SEO report for the default project
  seo report --site sc-domain:example.com  Run without a profile
  seo report --url https://example.com     Start with a local technical report

Projects
  seo projects list  List saved project profiles
  seo projects add   Create or update a project profile
  seo sites          List Search Console properties
  seo doctor         Check local auth and config

Act on a report
  seo refresh-priorities  Rank the next best SEO actions
  seo quick-wins          Find ranking 4-10 low-CTR wins
  seo second-page         Investigate URLs averaging positions 10-20
  seo technical-watch     Crawl and index-monitor a site

Agent and power tools
  seo report --json    Run the main report as structured JSON
  seo export diagnose  Export report data to CSV
  seo mcp install      Install SEO tools into MCP clients
  seo skill list       Show the packaged SEO skill
  seo reports list     Discover every structured report

Use `seo help <command>` or `seo <command> --help` for command help.
Use `seo help all` for the longer command list.