Structured data (JSON-LD)

Set up structured data with Claude

Setting up structured data with Claude means asking the chat assistant to check which JSON-LD schema types StoreSEO has switched on for your Shopify store, collect your business details in the conversation and send back a complete settings object once you say yes.

Jump to the prompts Connect Claude

Last updated: October 2026

Set up Claude for StoreSEO

Skip this if Claude is already connected. The full guide, with the alternatives, is on the Claude page.

1
Add StoreSEO as a custom connector

In Claude, open Customize, then Connectors, choose + Add and then Add custom connector. Name it StoreSEO and paste this URL as the remote MCP server URL.
URL

https://mcp.storeseo.com/mcp
2
Approve your store

Claude opens the StoreSEO sign-in in your browser. Pick your Shopify store and approve access. Then start a new chat and ask this to confirm the connection works.
Prompt

Use StoreSEO to show me my store's SEO score breakdown.

How does this work in Claude?

You are in a claude.ai tab or the Claude Desktop app with the StoreSEO connector switched on for the chat, and you type something like which schema types are enabled on my store. Claude calls storeseo_start, which hands it the conversation id and a snapshot of the store, then storeseo_list_schema_types, and answers with a short table: each type, whether it is on, and whether it takes settings. Product, review, sale dates, product merchant, organization and local business are the configurable ones; the rest, including the four FAQ types, are on or off only.

Filling in organization or local business schema is a conversation rather than a form. Claude calls storeseo_get_schema_settings for the type, reads the field template it returns, and then asks you for whatever is blank, such as the legal name, logo URL, contact email, street address and opening hours. You answer in the chat, in any order, and can paste a block copied from your contact page. Claude shows the finished values back to you before it calls storeseo_update_schema_settings, so you can correct a typo while it is still only text on your screen.

Because the connection comes from Anthropic's servers and the tools show up in the chat as expandable tool calls, you can open any call and read exactly what was sent. That is useful here, since an update replaces the whole settings object and you will want to see that nothing you set earlier was dropped. Once it is done, ask Claude to list the types again to confirm the status on the live store.

Claude + StoreSEO Illustrative session

You: Which schema types are on for my store, and is organization schema ready?
storeseo_start read-only
storeseo_list_schema_types read-only
storeseo_get_schema_settings read-only
Claude: Product schema is on. Organization is off and its settings are empty. I need a business name, logo URL and a contact email. Want to give me those so I can switch it on?
You: Northline Outfitters, logo is on our CDN, [email protected]. Yes, turn it on.
storeseo_update_schema_settings needs approval

What to ask Claude

Prompt 1

Use StoreSEO to list my JSON-LD schema types and tell me which are on and which need settings.

Prompt 2

Set up organization schema. Read the current settings first, then ask me for anything that is missing before you save.

Prompt 3

Turn on product schema, then review schema, and tell me if either is refused.

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.

storeseo_list_schema_typesstoreseo_get_schema_settingsstoreseo_update_schema_settings

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

Claude's own prompts for tool calls are the hard stop here, and storeseo_update_schema_settings changes the markup on your live storefront. If you chose Allow always for the StoreSEO connector to avoid prompts, that choice covers this write tool as well, so keep the update tool on ask and let the read tools run freely. Also check the connector is on for the chat in the Search and Tools menu, because a new conversation does not always have it enabled.

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 fill in my organization schema from a message I paste into the chat?

Yes. Paste your business name, address and contact details, and Claude maps them onto the field template that storeseo_get_schema_settings returns. It should show you the finished values and wait for your yes before it saves them.

Why does Claude read the schema settings before it changes them?

A settings update in StoreSEO replaces the stored object instead of merging into it. Claude reads the current values first so the object it sends back keeps every field you already filled in.

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.