---
title: "The only SEO Skill your agent needs"
description: "One SEO skill gives your agent 50+ SEO audit tools through a local CLI and MCP server, using your crawl, Search Console, and GA4 data to grow your visibility."
canonical: "https://seoskill.dev"
language: "en"
---

# The only SEO skill your agent needs

One SEO skill and 50+ audit tools for AI agents to fix issues, measure performance, and grow your organic and AI search visibility.

Install the SEO CLI globally.

```
npm i -g seo
```

Run setup after installation.

```
seo start
```

## Chat with your SEO data to find out what works and what doesn't.

Ask why traffic dropped, which pages are close to page one, or what is blocking a crawl. Your agent answers from your crawl, Search Console, and GA4 data instead of guessing.

## Use the CLI with Codex or Claude Code to ship SEO fixes fast.

Run an audit in the terminal and let your coding agent trace each problem to the code. You get a reviewable fix without copying findings between tools.

## Run a complete SEO audit and know what to fix next.

Run 50+ reports across crawl health, content, search performance, and AI visibility. Each result shows the affected pages and gives your agent the evidence it needs to act.

## Make your site easier for AI search engines to understand and cite.

Check whether AI crawlers can access your pages and understand what your site is about. Your agent can fix the gaps and draft an llms.txt from the pages you choose.

## Build SEO checks into the tools and workflows your team already uses.

Import the typed crawler and reports from the seo package. Add audits to CI, content pipelines, internal tools, or whatever you are already building.

## See which SEO fixes worked and where your effort should go next.

Compare every release against saved crawl and search performance data. See what improved, what stayed flat, and which changes need more time before you call them a win.

## Reports for a complete SEO audit

50+ reports and tools across crawl health, Search Console and GA4, opportunities, AI readiness, and monitoring.

-   [Site crawl](https://seoskill.dev/docs/reports/site-crawl)
-   [Audit page](https://seoskill.dev/docs/reports/audit-page)
-   [Audit selected URLs](https://seoskill.dev/docs/reports/audit-urls)
-   [Redirect trace](https://seoskill.dev/docs/reports/redirect-trace)
-   [Performance audit](https://seoskill.dev/docs/reports/performance-audit)

Crawl & page checks

-   [Top fixes](https://seoskill.dev/docs/reports/top-fixes)
-   [Affected URLs](https://seoskill.dev/docs/reports/affected-urls)
-   [Explain a crawl issue](https://seoskill.dev/docs/reports/explain-crawl-issue)
-   [Crawler rules](https://seoskill.dev/docs/reports/crawler-rules)
-   [Crawl history](https://seoskill.dev/docs/reports/crawl-history)
-   [Saved crawl report](https://seoskill.dev/docs/reports/crawl-report)

Crawl findings

-   [Crawl diff](https://seoskill.dev/docs/reports/crawl-diff)
-   [Compare crawls](https://seoskill.dev/docs/reports/compare-crawls)
-   [Index coverage](https://seoskill.dev/docs/reports/index-coverage)
-   [Index plan](https://seoskill.dev/docs/reports/index-plan)
-   [Index monitor](https://seoskill.dev/docs/reports/index-monitor)
-   [Index watch](https://seoskill.dev/docs/reports/index-watch)
-   [Technical watch](https://seoskill.dev/docs/reports/technical-watch)

Indexing & monitoring

-   [Quick wins](https://seoskill.dev/docs/reports/quick-wins)
-   [Striking distance](https://seoskill.dev/docs/reports/striking-distance)
-   [Second page](https://seoskill.dev/docs/reports/second-page)
-   [Decaying pages](https://seoskill.dev/docs/reports/decaying-pages)
-   [CTR underperformers](https://seoskill.dev/docs/reports/ctr-underperformers)
-   [Page opportunities](https://seoskill.dev/docs/reports/page-opportunities)

Search opportunities

-   [Cannibalisation](https://seoskill.dev/docs/reports/cannibalisation)
-   [Internal links](https://seoskill.dev/docs/reports/internal-links)
-   [Content optimization](https://seoskill.dev/docs/reports/content-optimization)
-   [Query clusters](https://seoskill.dev/docs/reports/query-clusters)
-   [Link recovery](https://seoskill.dev/docs/reports/link-recovery)
-   [Community intent](https://seoskill.dev/docs/reports/community-intent)

Content & internal links

-   [AI agent readiness](https://seoskill.dev/docs/reports/agent-readiness)
-   [AI search scorecard](https://seoskill.dev/docs/reports/ai-search-scorecard)
-   [AI readiness](https://seoskill.dev/docs/reports/ai-readiness)
-   [Entity readiness](https://seoskill.dev/docs/reports/entity-readiness)
-   [Google AI search controls](https://seoskill.dev/docs/reports/geo-gaps)
-   [llms.txt audit](https://seoskill.dev/docs/reports/llms-txt-audit)
-   [Generate llms.txt](https://seoskill.dev/docs/reports/generate-llms-txt)
-   [SEO to AI query](https://seoskill.dev/docs/reports/seo-to-ai-query)
-   [AI referrals](https://seoskill.dev/docs/reports/ai-referrals)

AI search visibility

-   [Search performance overview](https://seoskill.dev/docs/reports/search-performance-overview)
-   [Segment impact](https://seoskill.dev/docs/reports/segment-impact)
-   [Traffic anomaly](https://seoskill.dev/docs/reports/traffic-anomaly)
-   [Google update correlation](https://seoskill.dev/docs/reports/update-correlation)

Understand performance

-   [Refresh priorities](https://seoskill.dev/docs/reports/refresh-priorities)
-   [Monthly report](https://seoskill.dev/docs/reports/monthly-report)
-   [Monthly action plan](https://seoskill.dev/docs/reports/monthly-action-plan)
-   [Narrative report](https://seoskill.dev/docs/reports/narrative-report)
-   [Update postmortem](https://seoskill.dev/docs/reports/update-postmortem)

Reports & priorities

-   [Setup check](https://seoskill.dev/docs/reports/setup-check)
-   [Measure a change](https://seoskill.dev/docs/reports/measure-change)
-   [pSEO audit](https://seoskill.dev/docs/reports/pseo-audit)
-   [OKF export](https://seoskill.dev/docs/reports/okf-build)
-   [OKF validation](https://seoskill.dev/docs/reports/okf-validate)

Testing, setup & exports

## Questions about the CLI, MCP, and your data

Give the best models better SEO evidence without replacing Claude, ChatGPT, Codex, Cursor, or the agent workflow you already use.

No. It gives Claude, ChatGPT, Codex, Cursor, and other agents better SEO context. The model still does the reasoning, writing, and implementation work, and the CLI provides the crawl data, Search Console data, GA4 data, and report evidence.

Dashboards are useful when you want to click around, but the CLI is built for the way agents work. They discover reports, run them, and read structured evidence without leaving your editor or terminal.

It gets JSON or Markdown with the date range, units, caveats, evidence, recommendations, and useful next commands. That gives the model enough context to explain the problem and help fix it.

Search Console proves you can access the site and gives reports real search demand. That lets your agent find page-two queries, weak CTR, decaying pages, cannibalisation, and indexing candidates using your own data. The CLI requests read-only access.

No. Crawls and Search Console reports work without GA4. Connect it when traffic, landing-page, engagement, or conversion context would change how you prioritise the work.

Reports, project profiles, tokens, crawls, and caches stay local. The CLI only sends the requests needed to fetch the site and call the Google APIs you connect.

The CLI does not publish changes by itself. It gives your agent the evidence it needs to edit code or content, draft a fix, or open a ticket inside the tools you already use.

No. Use the CLI directly, import the package in TypeScript, or run it in CI. MCP is the easiest way to give a compatible agent the same local report engine.

Fifty skill files would sit in your agent context window on every session, whether or not you are doing SEO work. This is one short skill that teaches your agent to discover the tools at runtime. The agent asks the CLI to describe a report only when it is about to run it, so it gets the full detail at the moment it matters and nothing before that.

Run seo report after setup. It checks the evidence available for the project, explains skipped sections, ranks the first investigation queue, and points to focused follow-up reports.

Generic advice guesses from best practices, but your agent works from the site, crawl, queries, search demand, and analytics data in front of it. It can inspect the evidence behind each finding instead of trusting a generic score.

Developers, founders, SEO consultants, agencies, and technical teams who want their agents to work from clean SEO evidence instead of screenshots or copied dashboard rows.
