Structured data (JSON-LD) Set up structured data with Claude Cowork
Setting up structured data with Claude Cowork means delegating the schema work as a task: Cowork uses the StoreSEO connector to list your Shopify store's JSON-LD types, read their settings and hand back a report you review before any change is saved.
Last updated: October 2026
Set up Claude Cowork for StoreSEO
Skip this if Claude Cowork is already connected. The full guide, with the alternatives, is on the Claude Cowork page.
- 1
Add StoreSEO as a custom connector
In Cowork, open Customize, then Connectors, choose + Add and then Add custom connector. If you already added StoreSEO to your Claude account, look for it in that list first. Use this URL.
URLhttps://mcp.storeseo.com/mcp
- 2
Approve your store and check it
Sign in when the browser opens: pick your Shopify store and approve access. Then start a task and ask this first, so you know the connector works before you delegate real work.
PromptUse StoreSEO to show me my store's SEO score breakdown.
How does this work in Claude Cowork?
In Cowork you describe the outcome rather than steer each call, for example check my structured data and tell me what is missing before I launch the sale. Cowork opens its working view, calls storeseo_start and storeseo_list_schema_types, then storeseo_get_schema_settings for each configurable type, and returns a single summary: which types are on, which configurable ones have empty settings, and which dependencies are unmet, such as review schema requested while product schema is off. You get a reviewable document instead of a scroll of tool calls.
Doing the writing in Cowork works best as a second step. Read the report, supply the business details it asks for in the task thread, and tell it to go ahead. Cowork then calls storeseo_update_schema_settings with the complete object for the type, and it should stop and ask first, because StoreSEO tells the agent to wait for your yes before a write. Organization and local business share basic information, so one set of details settles both.
The scheduling feature is the other thing that makes Cowork different, and it suits the read half of this job well. A weekly task can list the types and read the configurable ones, then tell you if product schema was switched off or an FAQ type started being refused. Keep that scheduled task report-only, and do the changes in a task you are present for, so the yes always comes from a person who has just read the report and knows which type is about to change.
-
You: Review my structured data and tell me what is missing.
- storeseo_start read-only
- storeseo_list_schema_types read-only
- storeseo_get_schema_settings read-only
-
Claude Cowork: Product schema is on. Review schema is off, and organization has no settings. I can switch review on once I have your answers on the business details. Should I go ahead and enable review schema now?
-
You: Yes, enable review schema.
- storeseo_update_schema_settings needs approval
What to ask Claude Cowork
Use StoreSEO to check my structured data: list every JSON-LD type, read the configurable ones and write me a report of what is missing. Change nothing.
Prepare local business schema for my store. List the details you still need from me, and wait for my answers before you save anything.
Every Monday, list my StoreSEO schema types and tell me if any type that was on is now off. Do not update, enable or disable anything.
- Which JSON-LD schema types are enabled on my store?
- Set up organization schema with my business name, logo and contact email. Read the current settings first.
- Turn on product schema and review schema.
- Is local business schema configured? Show me what is missing.
- Enable FAQ schema for products if my plan includes it.
What StoreSEO does: structured data (json-ld)
StoreSEO adds JSON-LD schema to your storefront so search engines and AI assistants can read your products, business and FAQs as data. The agent lists every schema type, reads a type's settings and its field template, and sends back a complete settings object.
Requires: The FAQ schema types need the FAQ Schema feature in your plan.
- 1
List the schema types
The agent lists every type with whether it is on and whether it takes settings. Configurable types are product, review, sale dates, product merchant, organization and local business.
- 2
Read before writing
For a configurable type it reads the current settings and the field template, because an update replaces the whole settings object rather than merging into it.
- 3
Fill in your details
Business name, address, contact details and similar fields come from you. Organization and local business share the same business information, so changing one changes both.
- 4
Switch it on
After your yes the agent sends the complete settings with the status. Organization, local business and product merchant need complete settings to be enabled.
Structured data (JSON-LD) reference
| Configurable types | Product, review, sale dates, product merchant, organization, local business |
|---|---|
| Toggle-only types | Every other type, including the four FAQ types |
| Update behaviour | Settings replace the stored object; read first, then send the full object |
| Dependencies | Review, sale dates and product merchant need product schema on; disabling product also disables product merchant |
| Shared data | Organization and local business share basic business information |
| FAQ types | Product, collection, article and page FAQ need the FAQ Schema feature in your plan |
| Sale dates | Also needs a discount permission that only the app's own Sale Dates toggle can request |
Rules Claude Cowork follows
- The agent reads the current settings before every settings update, because the update replaces them wholesale.
- Business details come from you; the agent does not invent an address, phone number or opening hours.
- Turning a schema type on or off changes your live storefront markup, so the agent confirms the change first.
- When a type is refused for a missing plan feature or dependency, the agent says which one rather than retrying.
In Claude Cowork
A scheduled Cowork task runs while you are away, so nobody can say yes to storeseo_update_schema_settings. Write the schedule as read-only in plain words, naming the list and get tools and forbidding updates, and make changes in a task you are watching. If StoreSEO is missing inside Cowork, check Customize, Connectors there, and on Team and Enterprise ask an admin whether Cowork is switched on.
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 Claude Cowork check my schema on a schedule?
Yes, as a report. A scheduled Cowork task can list the schema types and read the configurable ones each week and tell you what changed, as long as you instruct it not to update, enable or disable anything.
Does Cowork use the same StoreSEO connector as Claude?
It uses the same custom connector model. If StoreSEO is not showing in Cowork, open Customize, then Connectors inside Cowork and add https://mcp.storeseo.com/mcp there.
What schema types can StoreSEO add to my store?
StoreSEO manages product, review, sale dates, product merchant, organization and local business schema with settings, plus toggle-only types such as the FAQ types for products, collections, articles and pages.
Why does the agent read my schema settings before changing them?
A settings update replaces the whole stored object instead of merging. Reading first and sending back the complete object is the only way to change one field without wiping the others.
Why was review schema refused?
Review, sale dates and product merchant schema depend on product schema. Turn product schema on first, then enable the dependent type.
Do I need a particular plan for FAQ schema?
Yes. The four FAQ schema types need the FAQ Schema feature in your StoreSEO plan. Without it, any change to them is refused with a message saying the feature is not in your plan.
Keep going
Structured data (JSON-LD) with other agents
More Claude Cowork guides