What is the SEO Skill for Gemini CLI?
Google's Gemini CLI is an open-source terminal agent: it reads `GEMINI.md` for project context, runs shell commands after you confirm them, edits files, and can drive MCP servers. The SEOAgent Skill gives it an SEO procedure — a technical audit with a fix per finding, keyword research with real volume and difficulty, briefs and articles written as files in your repository — and a CLI that supplies the data. Gemini CLI reads the Skill like any project file, runs the `seoagent` commands in its shell tool, and shows you each edit before writing it. Nothing publishes on its own.
Three steps, about three minutes
- Choose how you work. The card above asks once; pick Coding agent, then Other and type your site.
- Paste the prompt. One paste into your coding agent installs the Skill, binds the site to your account and runs the first audit.
- Watch it bind. The card turns green the moment the code is redeemed; if nothing happens in three minutes it asks what you saw and routes you.
How to use SEOAgent in Gemini CLI
Create the prompt on this page
Type your site in the card above and choose Coding agent → Other. The paste block carries a one-time setup code: it installs the CLI, runs `seoagent init --code <code>`, and tells the agent where the Skill lives. The code is bound to your account and works once.
Paste it into Gemini CLI, in the repo
In a terminal, `cd` into the repository that builds your site, start `gemini`, and paste the block. Gemini CLI asks to run each shell command — confirm the install and the `init`. `seoagent init` writes the Skill bundle (`.agents/skills/seoagent/` when the repo uses `.agents/`, otherwise `.claude/skills/seoagent/`), adds a SEOAgent section to `AGENTS.md`, and prints the path.
Add the pointer to GEMINI.md
Gemini CLI loads `GEMINI.md` from the project root (and parents) on every session. Add one line — `For SEO work, read the SEOAgent SKILL.md that seoagent init installed and follow it` — or run `/memory add` with the same sentence. Every later session then finds the procedure without being told.
Ask for an audit and confirm the fixes
Say "audit my site". The Skill fetches the homepage, sitemap and robots.txt, runs the technical checks, and reports findings with the exact change for each. Gemini CLI proposes the edits — metadata, schema, canonicals, internal links — and shows a diff before writing each file. Confirm what makes sense.
Write content into the repo
Ask for keyword research and an article or landing page. The Skill writes the files where your framework expects them, internally linked into the cluster, and `seoagent content track` tells the dashboard what shipped. A reviewed commit puts them live.
Give it a weekday routine
The block asks the agent to set up ONE weekday routine. In a terminal that is a cron line — `0 9 * * 1-5 cd <repo> && seoagent sync --silent` — so `.seoagent/inbox/` stays fresh; then start `gemini` in the repo each morning and say "process the inbox". It works the items and runs `seoagent ack` for each, and writes what it learns to `.seoagent/` for the next session.
What SEOAgent does in Gemini CLI
Technical audits with the fix attached
Each finding names the file and the change, so the agent applies it instead of describing it.
Shell confirmation as the review gate
Gemini CLI confirms every command and shows a diff for every edit; the Skill never asks it to skip one.
Keyword research with real numbers
`seoagent keywords` pulls volume and difficulty so content targets queries you can win.
Content as files
Articles and landing pages are written into the repo with metadata and internal links already set.
Search Console grounding
`seoagent login` connects Google Search Console once; the Skill then reads your real queries and pages.
Terminal-native routine
A cron line and `seoagent sync` turn the inbox into a weekday habit the agent can run from the same terminal.
MCP-ready
Gemini CLI speaks MCP; SEOAgent also ships an MCP connector for the cloud queue.
AI search readiness
`seoagent llms` builds an `llms.txt` from your page inventory; `seoagent okf` serves an Open Knowledge Format bundle.
Frequently asked questions
How do I add SEO to Gemini CLI?
Create the prompt on this page and paste it into `gemini` running in the repository that builds your site. It installs the SEOAgent CLI and Skill, binds the site to your account and runs the first audit. Add one line to `GEMINI.md` so later sessions find the Skill.
Is the SEO Skill for Gemini CLI free?
Yes. The Skill runs on Gemini CLI's own model access and is free forever. Autopilot ($49 per site per month, 7-day free trial at the first bind) adds Search Console measurement, keyword and competitor research, and briefs and articles written for you.
Does Gemini CLI need network access for the install?
Yes — `npm install -g @seoagent-official/seoagent` and the bind call SEOAgent’s API. If the global npm folder is not writable, run `npx -y @seoagent-official/seoagent@latest init --code <code>` instead; the block explains the fallback.
Will it publish content without me?
No. Every edit is shown as a diff before it is written, and pages go live when you commit and deploy. SEOAgent never publishes to a CMS itself.
What if the paste fails?
The block tells the agent to stop and report the exact error, never to continue unbound. The card waits for the bind and, after three minutes, asks what you saw and routes you. Codes live 14 days and work once.
Does it work on a site without a repository?
If the site is on a hosted platform (WordPress.com, Shopify, Webflow, Wix and others) the block says so and the agent runs the setup in an empty folder; delivery goes through the platform’s API or the editor. With no agent at all, use the "Just my website" door.
How is this different from telling Gemini to "do SEO" in GEMINI.md?
Context tells the model how to behave; the Skill is a procedure plus a CLI that fetches real data — `seoagent crawl`, `seoagent keywords`, `seoagent indexing`. `GEMINI.md` only needs to point at it.
How do I update the Skill?
Run `npm install -g @seoagent-official/seoagent@latest`, then `seoagent init` again in the project. It refreshes the bundle and leaves `.seoagent/` untouched.
See also
Give Gemini CLI the SEO harness
Enter your site, create the prompt, and paste it into Gemini CLI — the Skill installs, the site binds, and the first audit runs in minutes.
Want measurement on top? See Autopilot pricing.
What do you use to work on your site?
Claude Code, Cursor, Codex or another terminal agent, in the repo that builds your site.
You get a prompt with a one-time code. Paste it into your coding agent; it installs the Skill, binds the site, and runs the first audit.
Free for your own agent. Autopilot is the paid part.
Start your 7-day free trial, no card · $49/site/month after · we stop if nothing improves