nanoclaw SEO: Add SEOmatic to Any Agent Group

A nanoclaw agent sits in a group chat and answers whoever asks. For a small business or an agency team, that makes it a shared SEO desk: one place to ask about traffic, indexing and what to fix next.

An example on the Acme Plumbing demo site. You ask nanoclaw:

“@Andy which of our pages has Google not indexed?”

nanoclaw calls SEOmatic:

• mcp__seomatic__site_pages: sitemap URLs, 14 pages
• mcp__seomatic__gsc_indexing: 14 URLs, inspected Oct 12

nanoclaw answers:

Google indexes 12 of the 14 pages in your sitemap. The two it skipped:

1. /drain-cleaning-cost: discovered, currently not indexed. Google found it on Sep 29 but has not crawled it. Only one internal link points to it, from the footer.
2. /water-heater-repair/tankless: excluded by a noindex tag, probably left over from staging.

/emergency-plumber and /water-heater-repair are indexed and were crawled this week.

I can stage a fix for each: two internal links to /drain-cleaning-cost, and removing the noindex. Removing a noindex needs an extra confirmation from you. Want me to stage them?

Also try:

• “Post a Search Console recap here every Monday”
• “Which pages are close to page 1?”
• “Audit /emergency-plumber”
• “Do AI answers mention Acme Plumbing?”

nanoclaw's design keeps each agent group sealed in its own container, so a prompt in one chat cannot reach another group's files or secrets. SEOmatic fits that model:

• The key lives in the OneCLI Agent Vault, scoped to the host app.seomatic.ai. The gateway adds it to requests as they leave, so the agent never holds it.
• Only the groups you pick get SEO tools. Your family chat agent does not need Search Console access; the group that runs your website does.
• The agent can stage, not approve. Even if a message in the group tells the agent to push a change live, approval happens in SEOmatic, by a signed-in person.

Do not pass the key with --headers on the ncl command: that writes it into the group's config.

Send these in the group, starting with your agent's trigger word (@Andy by default):

• “How did our site do on Google last week compared with the week before?”
• “Check every page in our sitemap and tell me which ones Google has not indexed.”
• “We relaunch the site on Friday. Audit it and list anything that could hurt rankings.”
• “Which searches bring us impressions but almost no clicks?”
• “Every Monday at 9, post a short Search Console recap in this group.”
• “Stage fixes for the two worst problems you found and post the approval link.”

nanoclaw runs on the Claude Agent SDK, so SEOmatic's tools appear as mcp__seomatic__<tool>:

• Search Console: gsc_performance and gsc_insights for clicks, impressions, CTR, position, comparisons and striking-distance keywords.
• Indexing: gsc_indexing for whether Google indexed a URL, and why not.
• Pages: site_pages for audits of up to 30 pages and a 0 to 100 score for one URL.
• AI visibility: ai_citations for where AI answers mention you.
• Fixes on paid plans: task_manage stages changes and rolls back applied ones.

The full roster and what each tool costs is in the SEO MCP server reference.

1. Someone in the group mentions the agent with a question about the site.
2. The agent, running in that group's container, calls SEOmatic's tools. The gateway adds your API key from the vault on the way out.
3. SEOmatic answers from your connected Search Console and its own checks, with exact date ranges.
4. The agent replies in the group.
5. On a paid plan, when someone asks for a fix, the agent stages it in SEOmatic and posts the link. A signed-in SEOmatic user approves it, and SEOmatic applies it through your CMS with a rollback point.

About five minutes. You need your agent group's id, which ncl groups list shows.

1. Create an API key. In SEOmatic (a free account works), open Settings, then AI Agents, then API Keys, and create a key.
2. Store it in the vault. Run onecli secrets create with the name SEOmatic, type api_key, your key as the value and the host pattern app.seomatic.ai.
3. Grant it to the group. Add the new secret to your agent group's secrets with onecli agents set-secrets, keeping the secrets it already has.
4. Add the server to the group. Run ncl groups config add-mcp-server --id <group-id> --name seomatic --url https://app.seomatic.ai/api/mcp, then ncl groups restart --id <group-id>.
5. Ask in the group. Message the group: “@Andy how is our site doing on Google this month?” (use your agent's name). Connect Search Console in SEOmatic first for click and ranking data.

Never put the key in --headers on the ncl command; nanoclaw writes headers into the group's config, and the vault exists to keep secrets out of it. If the agent says it has no SEOmatic tools, check the secret's host pattern is app.seomatic.ai and that the group was restarted.

Pick the MCP server for a group. The vault injects your key in flight, so the container never sees it, and only the groups you choose get SEO tools.

This page is about nanoclaw, the small open-source (MIT) agent built on the Claude Agent SDK. It runs each agent group in its own container, and you manage it with the ncl command.

• OpenClaw is a separate, larger project with a gateway and a skill registry called ClawHub: OpenClaw SEO.
• Hermes Agent is Nous Research's open agent: Hermes Agent SEO.

The names are close, the setups are not. Follow the steps for the agent you run.

Connecting is free, and so is the SEOmatic account behind it: no card. Free covers the diagnosis with no limit: Search Console reports and insights, site audits of up to 30 pages, live page analysis, and your AI visibility results.

Live market data, like keyword volumes, backlink profiles and competitor domains, uses free questions: 5 a month, plus a one-time 10 bonus questions when you connect Google Search Console. One question covers up to 5 lookups.

Paid plans remove the question limit and add the treatment: agents stage fixes on your site (titles, descriptions, content updates, technical fixes, internal links) and run campaigns and fresh AI visibility scans. Every paid plan starts with a 14-day free trial. See pricing.

A group chat can use questions quickly, because every member can ask. For a team group, a paid plan avoids running out mid-month.

In a group chat, anyone can type a request, so nanoclaw's agent is never the one who approves. A staged change is a proposal: it says what will change and why, and nothing touches your site until you approve it. The assistant records your decision, and it is told never to approve anything on its own judgment. Approved fixes start within seconds, the page's previous state is stored, and any applied change can be rolled back. Changes that could take a page out of Google, like a noindex, need an extra explicit confirmation. The agent can stage a fix when asked; the change waits until a signed-in SEOmatic user approves it. Revoke the key in SEOmatic or remove the vault secret to cut access at once.

Running OpenClaw instead? See OpenClaw SEO. Other open agents: Hermes Agent SEO and Paperclip. nanoclaw runs on the Claude Agent SDK; for coding work see Claude Code SEO. Learn what powers the answers: page indexing checks, the site audit and the approval workflow. All agents: AI SEO agents in every assistant.

Using another agent? See OpenClaw, Hermes Agent, Claude Code, or every AI agent.