AI search readiness Get products ready for AI search with Gemini CLI
Getting products ready for AI search with Gemini CLI means using Google's terminal agent to scan a Shopify product's description through StoreSEO, answer the questions it returns at the prompt, and have StoreSEO write an agent-ready description from your facts.
Last updated: October 2026
Set up Gemini CLI for StoreSEO
Skip this if Gemini CLI is already connected. The full guide, with the alternatives, is on the Gemini CLI page.
- 1
Add StoreSEO to Gemini CLI
Run this in any terminal. The user scope writes the server to ~/.gemini/settings.json so every project sees it. Without --scope user the command writes to the current project's .gemini/settings.json.
Terminalgemini mcp add --scope user --transport http storeseo https://mcp.storeseo.com/mcp
- 2
Sign in to your store
Start gemini. The first time it calls StoreSEO it opens your browser: pick your Shopify store and approve access. If the window does not open, type /mcp auth storeseo inside Gemini CLI. Then gemini mcp list should show storeseo as connected.
Prompt/mcp auth storeseo
How does this work in Gemini CLI?
You run gemini in a terminal and the storeseo server is already added with gemini mcp add, either for the project or for your user. You ask: scan the description of my Ceramic Pour Over for AI shopping agents. Gemini CLI calls storeseo_start, then storeseo_get_resource_seo, which returns the GEO block and shows whether the product has a focus keyword. If it does not, the scan will not run and the agent should tell you to set one in the StoreSEO app, because no tool here can set it. Then storeseo_scan_product_description scores seven pillars and returns the questions.
A terminal is a plain place to answer questions. Gemini CLI should print each question as StoreSEO wrote it, in order, and wait. Where a field comes with options, such as a Shopify category attribute, pick one or give your own value; where it carries a suggested value, it comes from what you saved in Shopify or from the current description, so confirm or change it. You type the answers in one reply and the agent passes them to storeseo_write_product_description. Gemini CLI shows a confirmation for the tool call, which is separate from the yes you give in the conversation, and the second one is the hard stop.
The write replaces the live description in Shopify immediately, with no undo and no revision history, and the response returns the old text once. Ask Gemini CLI to print it or save it to a file in your working folder straight after the write. If you only want the FAQs and AI snippet, use storeseo_preview_resource_optimization and storeseo_apply_resource_optimization instead, which show a draft and projected GEO score first.
-
You: Scan the description of Ceramic Pour Over for AI shopping agents.
- storeseo_start read-only
- storeseo_scan_product_description preview
-
Gemini CLI: The description is missing materials, dimensions and what is included. StoreSEO asks: What is the dripper made of, and how wide is it?
-
You: Stoneware, 12 cm wide, and it comes with 40 paper filters.
-
Gemini CLI: Writing replaces the live description now, with no undo in StoreSEO. I will save the old text to old-description.html. Write it?
-
You: Yes.
- storeseo_write_product_description needs approval
What to ask Gemini CLI
Scan the description of Ceramic Pour Over for AI shopping agents. Print each StoreSEO question exactly as returned and wait for my answers.
After you write the new description, save the previous description to old-description.html in this folder.
Which of my products lack a focus keyword, so that a description scan would not run?
- Which of my products have the lowest GEO score, and what is missing for AI shopping agents?
- Make the product Merino Beanie ready for AI search: FAQs, AI snippet and product schema. Preview first.
- Scan the description of my best seller for AI agents and ask me the questions it needs.
- Rewrite the description of Ceramic Pour Over from my answers. Keep a copy of the old one for me.
- Is product JSON-LD schema enabled on my store? If not, explain what turning it on changes.
What StoreSEO does: ai search readiness
GEO is StoreSEO's AI readiness score for products. The agent reads which GEO criteria fail, fixes the ones a tool can fix (FAQs, AI snippet, alt text, product schema), and can rewrite a thin description from your own answers to StoreSEO's questions.
Requires: FAQs, AI snippets and descriptions spend AI Content Optimizer credit. The product needs a focus keyword, set in the StoreSEO app, before a description scan or rewrite.
- 1
Read the GEO checklist
The agent reads the product's GEO block: the score and every AI-readiness criterion that passes or fails.
- 2
Turn on product schema if it is off
Product JSON-LD is a shop-wide setting, so enabling it clears that criterion for every product at once. If you then decide not to apply the rest, the agent switches back off only the schema it turned on.
- 3
Preview FAQs and the AI snippet
The preview generates FAQs and an AI snippet (summary, benefits, best for) and projects the new SEO and GEO scores without saving.
- 4
Scan the description
For a thin or missing description, StoreSEO scores it on seven pillars (identity, materials, dimensions, features, use cases, what is included, care) and returns questions. The agent asks you each one, word for word.
- 5
Write and apply
With your answers, StoreSEO writes the description and saves it immediately; the response holds the only copy of the old text. The previewed FAQs and snippet are applied after your yes.
AI search readiness reference
| Scope | Products only; collections, pages and articles have no GEO score |
|---|---|
| Fixable by tools | FAQs, AI snippet, image alt text, product schema, description |
| Fixed only in the app or admin | Product title, category, product type, image count, inventory, variant barcode, SKU, price, image |
| Description pillars | Identity, materials, dimensions, features, use cases, what is included, care |
| Description write | Saved immediately to Shopify and StoreSEO; no undo and no revision history |
| Old description | Returned once in the write response, the only remaining copy |
| Product schema | Shop-wide toggle; credits the schema criterion on every product |
| Prerequisite | A focus keyword on the product, set in the StoreSEO app |
Rules Gemini CLI follows
- The scan's questions go to you word for word and in order; the agent does not answer them for you.
- A description is only written without questions when you decline to answer or authorize a bulk run without them.
- Writing a description replaces the current one at once with no undo, so the agent asks first and keeps the old text the response returns.
- If the agent enabled product schema for this flow and you stop before applying, it turns that schema back off; it never disables a schema you already had on.
- Criteria only you can fix get one link to the product's fix page, not a link per criterion.
In Gemini CLI
Do not set --trust or trust: true on the storeseo server. Trust skips every tool confirmation in Gemini CLI, and then the confirmation StoreSEO asks for in the chat is the only check, which is a poor trade for a tool that saves a description with no undo. The browser sign-in needs a browser on the same machine, so over SSH or in a headless session use the access token header. gemini mcp add defaults to project scope, and Google's site says Antigravity CLI replaced Gemini CLI for some accounts, so check which agent your account can use.
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
Does Gemini CLI answer StoreSEO's description questions for me?
It should not. StoreSEO tells the agent to put each question to you word for word and in order, and your answers become stated facts in the new description. If you decline to answer, the agent can skip the questions at your request.
How do I keep the old product description after a Gemini CLI rewrite?
StoreSEO returns the previous description once in the write response and keeps no backup. Ask Gemini CLI to save it to a file in your working folder before you move on, since it is the only remaining copy.
What is a GEO score in StoreSEO?
GEO is StoreSEO's AI readiness score for products. It measures how well a product can be understood by AI shopping agents and generative search, using criteria such as FAQs, an AI snippet, image alt text, product schema and the quality of the description.
Can I undo a rewritten product description?
Not inside StoreSEO. The new description is saved immediately and StoreSEO keeps no revision history. The response returns the previous description once, so ask the agent to keep it for you before it writes.
Why does the agent ask me questions before writing a description?
StoreSEO scans the description on seven pillars and returns questions for the facts it cannot infer, such as materials or what is in the box. Your answers become stated facts in the new copy instead of guesses.
Does enabling product schema affect every product?
Yes. Product JSON-LD is a shop-wide setting, so turning it on clears that criterion for every product at once, and turning it off removes it everywhere.
Keep going
AI search readiness with other agents
More Gemini CLI guides