NEWOur agents now make the SEO fixes on your site and check what worked →

nanoclaw SEO: Add SEOmatic to Any Agent Group

nanoclaw runs each agent group in its own container and answers in WhatsApp, Telegram, Slack or Discord. Add SEOmatic to the group that handles your website, and that agent can read Google Search Console, check indexing, audit pages and stage fixes for your approval. Your API key stays in the vault, outside the container.

  • One ncl command per agent group
  • API key held in the OneCLI Agent Vault, never in the container
  • Fixes are staged; a person approves them
Connect nanoclaw free
SEOmatic astronaut working in nanoclaw
nanoclaw logo
nanoclaw

About SEOmatic for nanoclaw

SEOmatic is a hosted MCP server that nanoclaw adds to an agent group with ncl. The OneCLI Agent Vault injects your SEOmatic API key, and the group's agent calls SEOmatic's SEO tools on one workspace.

Last Updated

November 2026

Requirements

A running nanoclaw install with OneCLI, and a free SEOmatic account with an API key from Settings, AI Agents, API Keys.

Pricing

Free to connect. Search Console, audits and page checks have no limit; market data uses 5 free questions a month (plus a one-time 5 the first time you sign in from an assistant, and 10 more when you connect Search Console). Paid plans add agents that stage fixes for your approval. See pricing.

Full Docs

Endpoint, auth, every tool and what it costs: SEOmatic MCP server docs.

nanoclaw for SEO, With the Key Kept Out of the Container

What a nanoclaw Agent Can Do for Your SEO

Shared SEO Desk in Slack or WhatsApp

Anyone in the group can ask how the site is doing and get the same answer, with dates and real numbers.

Indexing Sweep

The agent inspects every URL in your sitemap and lists the ones Google skipped, with the reason for each.

Monday Recap in the Group

A recurring job that posts last week against the week before, and only the pages that moved.

Pre-Launch Check

Before a redesign goes live, an audit of up to 30 pages for noindex tags, broken links, missing titles and slow pages.

Client Site per Group

Agencies can give each client's group its own SEOmatic key and workspace, kept apart by nanoclaw's containers.

Fixes Staged for Approval

On paid plans, the agent stages titles, descriptions, internal links and technical fixes, then posts the review link.

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.

Example: Ask nanoclaw About Your Site

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?”

Why the Key Goes in the Vault

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.

nanoclaw SEO Prompts for Your Group Chat

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.”

The SEO Tools Your nanoclaw Agent Gets

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.

How It Works, Step by Step

  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.

How to Connect SEOmatic to nanoclaw

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 generic, your key read from a file with --file (never typed on the command line, where it lands in your shell history), the host pattern app.seomatic.ai, header name Authorization and value format Bearer {value}, so the vault sends it as a Bearer header.
  3. Grant it to the group. Find the group's OneCLI agent id with onecli agents list (its identifier matches the group id; a brand new group gets one after its first message), then run onecli agents grants attach-secret with that id and the new secret id. On an older OneCLI without grants, onecli agents set-secrets still works but replaces the whole list, so include the secrets it already has; updated OneCLI servers answer it with 410 Gone.
  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 list your SEOmatic tools.” (use your agent's name). It should name tools such as mcp__seomatic__gsc_performance. Then ask “How is our site doing on Google this month?” Connect Search Console in SEOmatic first for click and ranking data.
nanoclaw setup
# 1. Store your SEOmatic key in the OneCLI Agent Vault
#    Save the key (smk_live_...) in a file first, e.g. with an editor,
#    so it never appears on the command line or in shell history
onecli secrets create --name SEOmatic --type generic \
  --file ~/.seomatic-key --host-pattern app.seomatic.ai \
  --header-name Authorization --value-format "Bearer {value}"
rm ~/.seomatic-key

# 2. Attach it to the group's OneCLI agent
onecli agents list        # the agent whose identifier is your group id (exists after the group's first message)
onecli agents grants attach-secret --id <agent-id> --secret-id <seomatic-secret-id>
# older OneCLI without grants (set-secrets replaces the whole list):
# onecli agents set-secrets --id <agent-id> --secret-ids <existing-ids>,<seomatic-secret-id>

# 3. Add SEOmatic to the group and restart it
ncl groups config add-mcp-server --id <group-id> \
  --name seomatic --url https://app.seomatic.ai/api/mcp
ncl groups restart --id <group-id>

# 4. Check: ask the agent "list your SEOmatic tools" (mcp__seomatic__...)

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 or gets a 401, check the secret's host pattern is app.seomatic.ai, its header name is Authorization with value format Bearer {value}, it is attached to this group's agent, and the group was restarted. nanoclaw does not report a server that failed to connect: the agent simply runs without its tools and may still answer. So after any change, ask the agent to list its SEOmatic tools before you trust an answer.

Add It From the Host, or Let the Agent Ask?

RouteBest forHow
MCP server for a groupMost setups: one agent group handles your site and gets SEOmatic's toolsStore the key with onecli secrets create, attach it to the group's OneCLI agent with onecli agents grants attach-secret, then ncl groups config add-mcp-server --id <group-id> --name seomatic --url https://app.seomatic.ai/api/mcp and ncl groups restart --id <group-id>.
Ask the agent to add itAdmins who would rather approve a card in chat than run ncl on the hostStore and attach the key in the vault as above, then ask the agent in the group: “Add the MCP server seomatic with the URL https://app.seomatic.ai/api/mcp.” It uses its add_mcp_server tool, and an admin approves the request card.

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. Both routes end in the same group config.

nanoclaw or OpenClaw: Which One Is This?

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.

What Is Free and What Is Paid

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 5 bonus questions the first time you sign in from an assistant, and 10 more 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 Trial for $1, credited to your first payment. 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.

Nothing Changes on Your Site Without Your Approval

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 in Approval mode 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.

Keep Exploring

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.

Frequently Asked Questions

How do I connect SEOmatic to nanoclaw?

Create an SEOmatic API key, store it in the OneCLI Agent Vault with the host pattern app.seomatic.ai, and grant it to your agent group. Then run ncl groups config add-mcp-server --id <group-id> --name seomatic --url https://app.seomatic.ai/api/mcp and ncl groups restart --id <group-id>. Ask the agent about your site in the group.

Why not pass the API key with --headers?

Headers on the ncl command are saved in the group's config, where the agent can read them. The OneCLI Agent Vault keeps the key outside the container and adds it to requests to app.seomatic.ai as they leave, which is how nanoclaw is meant to handle secrets.

Can I give SEO tools to only one group?

Yes. The ncl command adds SEOmatic to one group by id. Other groups do not get the tools unless you add them too, and each group can use a different SEOmatic key and workspace.

Can anyone in the group approve a fix?

No. Anyone can ask the agent to stage a fix, but approving happens in SEOmatic and needs a signed-in user with access to the workspace. The agent is told never to approve on its own.

Can the agent post SEO updates on a schedule?

Yes. nanoclaw runs recurring jobs you ask for in chat. Ask the agent to post a Search Console recap every Monday, and to skip the post when nothing changed.

Where do the numbers come from?

From your own Google Search Console, connected to SEOmatic with a normal Google sign-in. Answers name the exact date range they cover, for example Oct 3 to Oct 9, 7 days, so you can check them in Search Console.

Is SEOmatic for nanoclaw free?

Yes. Connecting and the SEOmatic account are free, with no card. Search Console reports, site audits and page checks are free with no limit. Live market data (keyword volumes, competitors, backlinks) uses free questions: 5 a month, plus a one-time 5 the first time you sign in from an assistant, and 10 more when you connect Search Console. Paid plans remove the limit and add agents that stage fixes, with a 14-Day Trial for $1, credited to your first payment.

Can it change my site without asking?

No. Every fix your assistant stages waits for your approval before it touches your site, and your assistant is told never to approve on its own. Approved changes are stored with the page's previous state, so any edit to an existing page can be rolled back. SEOmatic's own scheduled agents can ship reversible work, including single new articles, without a click unless you pick Approval mode in your autonomy settings; changes to your URLs or indexing, and new page sets, always wait for you.

The agent says it has no SEOmatic tools. What is wrong?

Usually one of three things: the group was not restarted after the ncl command, the vault secret has the wrong host pattern, or the secret was not granted to that group. Fix the one that applies and run ncl groups restart --id <group-id>. nanoclaw does not warn when a server fails to connect, so ask the agent to list its SEOmatic tools after each fix. If they are missing, it is not really using SEOmatic, even if it answers.

Is nanoclaw the same as OpenClaw?

No. nanoclaw is a smaller project built on the Claude Agent SDK, with one container per agent group. OpenClaw is a separate agent with a gateway and its own skill registry. SEOmatic works with both, with different steps.

digi-business-uk

Each local area page used to take us half a day to create and optimize.


With SEOmatic, we can create hundreds of pages in the same time, which helps our clients make the best use of their budget.


It's transformed how we deliver scalable SEO solutions.

will-hawkins

Will Hawkins

Marketing Director, Digi-Business UK

Give Your Site an SEO Team

Agents read your Search Console data, do the work, and prove what actually moved. You decide what ships.

  • You decide what ships
  • Verified live
  • One-click rollback

14-Day Trial for $1, credited to your first payment.