Run Your Shopify SEO from NanoClaw
NanoClaw is a small open-source assistant that runs each agent in its own container, is built on Anthropic's Claude Agent SDK and answers you in WhatsApp, Telegram, Slack or Discord. With StoreSEO added to the agent, you ask in a chat message and it reads your store's SEO scores, previews optimized content and applies what you approve.
- Message it from the chat app you already use
- One MCP server added to your own fork's agent
- Scheduled tasks for a weekly read-only SEO report
Last updated: October 2026
StoreSEO is the AI SEO Agent for Shopify merchants — a Shopify app that optimizes your store for Google and gets it cited by ChatGPT, Gemini, Claude and Perplexity.
5.0/5 from 750+ Shopify reviews
Create a StoreSEO access token
In the StoreSEO app open Settings, AI Toolkit and generate a personal access token. Keep it out of chat messages and out of Git.
Settings → AI Toolkit → create a token
Access token header. Every step and the alternatives
Ask NanoClaw about your store
Once connected, NanoClaw opens a StoreSEO session and works from your store's real scores. Writes wait for your yes in the chat.
@Andy which of my products have the weakest SEO right now? Show a better title and description for the worst one.
Linen Shirt scores lowest. StoreSEO drafted a new meta title and description. The preview used AI credit and nothing is saved yet. Apply them to the product?
via StoreSEO · illustrative
Also try · tap to copy
- 1
Create a StoreSEO access token
In the StoreSEO app open Settings, AI Toolkit and generate a personal access token. Keep it out of chat messages and out of Git.
- 2
Add StoreSEO to your agent's container
Run this on the machine that hosts NanoClaw, using your agent group's ID from ncl groups list. The header goes in as a JSON object. NanoClaw may ask an admin to approve the change.
- 3
Restart the agent's container
The new server takes effect after a restart. Then message your agent with its trigger word, @Andy by default, and ask for your store's SEO score.
- 4
Or ask Claude Code to wire it into your fork(optional)
NanoClaw is customized by changing your own copy, and its README says to tell Claude Code what you want. Run this inside your NanoClaw folder if you would rather not type the command yourself.
How do I connect NanoClaw to StoreSEO?
- 1
Create a StoreSEO access token
In the StoreSEO app open Settings, AI Toolkit and generate a personal access token. Keep it out of chat messages and out of Git.
new message to NanoClawSettings → AI Toolkit → create a token
- 2
Add StoreSEO to your agent's container
Run this on the machine that hosts NanoClaw, using your agent group's ID from ncl groups list. The header goes in as a JSON object. NanoClaw may ask an admin to approve the change.
terminalncl groups config add-mcp-server --id <group-id> --name storeseo \ --url https://mcp.storeseo.com/mcp \ --headers '{"Authorization":"Bearer YOUR_TOKEN"}' - 3
Restart the agent's container
The new server takes effect after a restart. Then message your agent with its trigger word, @Andy by default, and ask for your store's SEO score.
terminalncl groups restart --id <group-id>
- 4
Or ask Claude Code to wire it into your fork Optional
NanoClaw is customized by changing your own copy, and its README says to tell Claude Code what you want. Run this inside your NanoClaw folder if you would rather not type the command yourself.
new message to NanoClawAdd the remote MCP server https://mcp.storeseo.com/mcp to my agent as storeseo, authenticated with this Authorization: Bearer token, then restart the agent.
Sign-in
NanoClaw's documentation describes no browser sign-in for an MCP server inside the agent's container, so connect with a personal access token from StoreSEO under Settings, AI Toolkit, sent as an Authorization: Bearer header.
Check it worked
@Andy use StoreSEO to show me my store's SEO score breakdown.
Full setup guide in the docs: How to connect StoreSEO MCP to NanoClaw
-
You: @Andy which of my products have the weakest SEO right now? Show a better title and description for the worst one.
- storeseo_start read-only
- storeseo_list_resources read-only
- storeseo_preview_resource_optimization preview
-
NanoClaw: Linen Shirt scores lowest. StoreSEO drafted a new meta title and description. The preview used AI credit and nothing is saved yet. Apply them to the product?
-
You: Yes, apply them.
- storeseo_apply_resource_optimization needs approval
-
NanoClaw: Applied. The product was re-scored. Want me to check the next one?
What is NanoClaw?
NanoClaw is an open-source AI assistant that runs agents in their own containers. It is built on Anthropic's Claude Agent SDK and is meant to be small enough to read, so you own a fork of the code and change it to fit what you need rather than editing a settings file.
You talk to it from a chat app. Its README lists WhatsApp, Telegram, Discord, Slack, Microsoft Teams, iMessage and others, installed as channels, and an agent answers when you use its trigger word, which defaults to @Andy. Each agent group has its own memory, workspace and container, and it can run scheduled tasks that you create from the command line or ask for in chat.
NanoClaw does not have a menu for adding connectors. A remote MCP server is added to an agent group's container configuration with the ncl command line, or by asking Claude Code to change your fork, and the agent's container is restarted to pick it up.
Why use NanoClaw with StoreSEO?
Ask from your phone
The chat app you already use becomes the front end. Send one message about your store from WhatsApp, Telegram, Slack or Discord and the agent calls StoreSEO for the answer.
You own the agent
NanoClaw runs on your own machine in containers you control, with its own memory per agent group. StoreSEO is one server added to one agent, and you can remove it the same way.
A report that arrives on its own
NanoClaw can run a recurring task and post the result to a chat. Point one at StoreSEO for a weekly read-only SEO summary without opening the Shopify admin.
Good to know
- NanoClaw's documentation describes no browser OAuth sign-in for an MCP server inside the container, so this setup uses a StoreSEO access token. Treat the token like a password: the header is stored in the agent group's container configuration on your host, so keep that machine and its backups private.
- NanoClaw says secrets belong with its credential gateway rather than in the agent. If you run a gateway, you can hold the StoreSEO token there for mcp.storeseo.com instead of in the header, following NanoClaw's gateway documentation.
- The server is added per agent group. Add it to each group that should reach your store, and restart that group's container afterwards.
- NanoClaw needs Docker on your own machine and the setup is yours to maintain. Whether it asks you before a tool runs depends on how your fork and your admins are set up, so the StoreSEO confirmation in the chat may be the only check.
What can you ask NanoClaw to do in StoreSEO?
Tap a prompt to copy it, then paste it into NanoClaw.
Send a weekly SEO report with a NanoClaw scheduled task
NanoClaw runs a prompt on a cron schedule in the agent's own session. A scheduled task has no chat attached, so the prompt has to say where to send the result. A scheduled run should be report-only: the prompt asks for reads, because nobody is there to say yes to a write.
ncl tasks create \ --group <group-id> \ --name "Monday SEO report" \ --recurrence "0 8 * * 1" \ --prompt "Use StoreSEO to report my SEO score breakdown and the five lowest-scoring products, and send it to telegram. Read only: do not preview, apply, generate or delete anything."
One connection gives NanoClaw your whole store
Connect NanoClaw once. It can then read and improve every part of your store below, through the same 44 StoreSEO tools and the same approval rules.
NanoClaw guides by job
Each guide covers one StoreSEO job end to end in NanoClaw: setup, prompts, an example session, the rules and the limits.
Which way should you connect?
MCP server with OAuth
- Best for
- Claude, ChatGPT and any client that supports remote MCP sign-in
- Sign-in
- Pick your store in Shopify and approve once
- What you get
- All 44 tools, scoped to the store you approved
MCP server with an access token
- Best for
- Terminal agents and editors, or any client without OAuth
- Sign-in
- Generate a named token in Settings, AI Toolkit and send it as a Bearer header
- What you get
- The same 44 tools; revoke the token in the app to cut access
Shopify Sidekick
- Best for
- Merchants who stay inside Shopify admin
- Sign-in
- Nothing to add: StoreSEO is installed in your store
- What you get
- SEO answers and deep links to the fix page, not the MCP tools
What runs without asking. Reads such as SEO scores, store listings, settings and Google reports run straight away. Generating a preview spends AI credit but writes nothing, and StoreSEO tells the agent to say what a generation will cost before it runs one. Applying content, optimizing images, changing settings, publishing llms.txt or agents.md, writing a product description and deleting anything wait for your yes in the conversation. That yes is an instruction the agent follows, not a lock on the server, so your client's own tool-approval setting is the hard stop.
Questions
How do I connect NanoClaw to StoreSEO?
Create an access token in StoreSEO under Settings, AI Toolkit. Then run ncl groups config add-mcp-server with the name storeseo, the URL https://mcp.storeseo.com/mcp and the token as an Authorization Bearer header, and restart the agent group with ncl groups restart. You can also ask Claude Code to make the same change in your NanoClaw fork.
Do I need a StoreSEO API key for NanoClaw?
You need a personal access token from StoreSEO under Settings, AI Toolkit. NanoClaw's documentation describes no browser OAuth sign-in for an MCP server inside its container, so the token is the supported route here.
Where does NanoClaw keep the StoreSEO server?
In the container configuration of the agent group you added it to. NanoClaw stores that configuration in its database and writes it to the group's container.json when the container starts, so the server is per agent group.
Will NanoClaw change my products without asking?
StoreSEO tells the agent to preview first and wait for your yes in the chat before it applies content, optimizes images, publishes a file or deletes anything. That yes is an instruction the agent follows, not a lock on the server, and NanoClaw's own approval behavior depends on how you configured your fork. Reads such as scores and reports run straight away.
Can NanoClaw send me a regular SEO report?
Yes. NanoClaw has scheduled tasks that run a prompt on a cron schedule. Write the prompt as read-only and name the chat destination in it, because a scheduled task has no conversation attached and nobody is there to approve a write.
Which StoreSEO plan does NanoClaw need?
Any active StoreSEO plan, including the free plan, can use the MCP server. Rank tracking is a Pro feature, Google reports need a paid plan with Google connected, and generated content spends AI Content Optimizer credit.
How do I disconnect NanoClaw from my store?
Remove the server from the agent group with ncl groups config remove-mcp-server and restart the group. Then revoke the token in StoreSEO under Settings, AI Toolkit, where every connected app and token is listed.
