Get products ready for AI search with Paperclip
Preparing products for AI search from Paperclip means tasking an agent to read StoreSEO's GEO checklist for a product, preview FAQs and an AI snippet on the ticket, and hold the schema switch and description rewrite until you start a supervised run.
Last updated: October 2026
Set up Paperclip for StoreSEO
Skip this if Paperclip is already connected. The full guide, with the alternatives, is on the Paperclip page.
- 1
Add StoreSEO to the agent Paperclip runs
Run this on the machine that hosts the agent, as the same OS user the Paperclip heartbeat runs as, from the agent's working directory. It is the claude_local adapter path, and user scope makes StoreSEO available to every Claude Code agent that user runs.
terminalclaude mcp add --transport http --scope user storeseo https://mcp.storeseo.com/mcp
- 2
Sign in once, then let Paperclip run headless
Start claude interactively as that same user, run /mcp, choose storeseo and finish the browser sign-in: pick your Shopify store and approve. Claude Code keeps the credentials, so later Paperclip runs need no browser. Check with claude mcp get storeseo.
new message to Paperclip/mcp
Step-by-step guide in the docs: How to connect StoreSEO MCP to Paperclip
How does this work in Paperclip?
A GEO task starts like an audit. You assign the ticket, say which product or how many of the lowest GEO scores to look at, and the agent calls storeseo_get_resource_seo to read the product's GEO block: the score and each AI-readiness criterion that passes or fails. It tells you in a comment which gaps a tool can fix, namely FAQs, the AI snippet, alt text, product schema and the description, and which only you can fix in the app or Shopify admin, such as the product title, category or barcode. That first pass is all reads and suits a scheduled routine.
The second pass previews. storeseo_preview_resource_optimization generates the FAQs and an AI snippet with summary, benefits and best for, and projects the new SEO and GEO scores without saving, spending credit. The agent posts it on the ticket. The risky steps come after your reply. Turning on product schema through storeseo_update_schema_settings affects every product at once, and storeseo_write_product_description replaces the live description immediately with no undo, returning the old text once. A description scan also produces questions about materials, dimensions and care, and those are yours to answer: the agent should relay them word for word as a comment and wait, which is slow in a task queue but gives the copy real facts.
Because a rewrite has no undo, treat it as its own supervised task, and ask the agent to paste the old description into the ticket before it writes the new one.
-
You: Ticket: get Merino Beanie ready for AI shopping agents. Preview first.
- storeseo_get_resource_seo read-only
- storeseo_preview_resource_optimization preview
-
Paperclip: Preview is on the ticket: FAQs and an AI snippet, GEO projected 44 to 71. Product schema is off and it is a shop-wide setting. Apply the previewed FAQs and snippet, and leave schema alone?
-
You: Apply the FAQs and snippet. Do not touch schema.
- storeseo_apply_resource_optimization needs approval
-
Paperclip: Applied the FAQs and snippet and posted the new GEO score. Product schema is still off, and the description needs your answers if you want a rewrite.
What to ask Paperclip
Tap a prompt to copy it, then paste it into Paperclip.
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 Paperclip 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 Paperclip
A description rewrite and the shop-wide product schema switch are the two steps here you cannot easily take back, and a headless Claude Code agent with dangerouslySkipPermissions left on will run them if it decides to. Keep scheduled GEO routines to reading and previewing. Run storeseo_write_product_description only in a task you are watching, after you have answered the scan questions and the agent has pasted the old description onto the ticket.
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
Can a Paperclip agent answer the description questions for me?
It should not. StoreSEO returns questions about facts such as materials and what is in the box, and the agent is meant to relay them to you word for word. Answer in a comment on the ticket so the copy states real facts.
Is a GEO check a good routine to schedule in Paperclip?
Reading the GEO score and the failing criteria is. Previews spend credit and apply, schema and description changes write to your store, so leave those to a task you start and review.
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 Paperclip guides