AI Assistants (Claude and others)
Connect Claude from its connectors directory, or another AI assistant with QueryCatch's address, so it can read your search, analytics and SEO data and, if you allow it, improve your site's content for you.
AI Assistants You can connect an AI assistant, such as Claude, to QueryCatch. Your assistant can then answer questions using your QueryCatch data ("which pages lost the most clicks this month?", "which products have no description?") and, if a profile admin allows it, make SEO improvements on your connected website or store, such as writing image alt text or meta descriptions. Every change is recorded and can be undone. AI assistant access is being rolled out gradually. If you don't see the AI assistants tab in Profile settings (or, in QueryCatch inside Shopify, the AI assistants section in Settings), it isn't available for your account yet. Turn it on for a profile Go to Profile settings → AI assistants. Only a profile admin can change the switches.. Switch on 'Allow AI assistant access'. Members of the profile can now connect an assistant and read this profile's data through it.. Optionally, switch on 'Allow AI assistants to make changes'. Only then can an admin's assistant change your connected website or store, and each change is previewed first (see 'You see each change first' below). While it is off, assistants can only read.. Optionally, also switch on 'Let AI assistants publish pages'. Only then can an admin's assistant publish a new page it creates on your Shopify store, or a new page, post or other item on your WordPress site, and only when asked to. While it is off, they are created hidden in Shopify and as drafts in WordPress. It can only be on while 'Allow AI assistants to make changes' is.. Once access is on, how to connect appears under the switches, with the address to add if you connect your assistant yourself. /assets/documentation/ai-assistants/settings-access.webp Connect your assistant QueryCatch is listed in Claude's connectors directory, so in Claude it takes a few clicks. In any other AI tool, or if you'd rather, you can add it yourself with its address. Either way, you sign in to QueryCatch and get the same tools. In Claude, from the connectors directory Open QueryCatch in Claude's connectors directory at claude.ai/directory/connectors/querycatch. Or, in Claude, go to Customize → Connectors, choose Discover and search for QueryCatch. Profile settings → AI assistants links to it too.. Click Connect. Claude opens a QueryCatch page: sign in if asked, read what the assistant will be able to do, and click Allow.. Ask Claude something about your site. If more than one of your profiles has AI assistant access switched on, it will ask which one to use. On a Claude Team or Enterprise plan, an owner of your Claude organisation may need to add QueryCatch for the organisation first, under Organization settings → Connectors. Each person then connects it for themselves. Add it yourself Copy the address shown under the switches. For most accounts it is https://www.querycatch.com/api/mcp.. In your assistant, add a custom connector with that address. In Claude: Customize → Connectors → Add → Add custom connector, name it QueryCatch and paste the address.. Your assistant opens a QueryCatch page. Sign in if asked, read what the assistant will be able to do, and click Allow. Using ChatGPT, Claude Code, Cursor, VS Code or another AI tool? See 'ChatGPT and other AI tools' in the documentation for the steps in each. The consent page shows the assistant's name as unverified and the address it will return to. Only allow assistants you trust and that you started connecting yourself, just now. /assets/documentation/ai-assistants/consent.webp Using QueryCatch inside Shopify If you use QueryCatch as an app in your Shopify admin, there are two ways to connect an assistant. You can connect it to your store and approve it inside Shopify, as below. Or link your own email from the app (Settings, then Use QueryCatch on the web and with Claude) and connect your assistant on querycatch.com like anyone else: one connection then reaches your store and any other profiles on your account. In your Shopify admin, open QueryCatch → Settings → AI assistants and switch on 'Allow AI assistant access'. 'How to connect' appears underneath, with the address to add if you connect your assistant yourself.. In Claude, add QueryCatch from the connectors directory and click Connect. In another assistant, add a custom connector with that address.. When the assistant opens the QueryCatch sign-in page, choose 'Inside Shopify' and enter your store's myshopify.com address. You are taken to your Shopify admin.. Read what the assistant will be able to do and click Allow. You are sent back to your assistant. /assets/documentation/ai-assistants/sign-in-inside-shopify.webp The connection belongs to the store, not only to you. Any staff member who can open QueryCatch in your Shopify admin can see it, revoke it, undo its changes and switch AI assistant access off under Settings → AI assistants. To approve a connection or switch anything on, your Shopify staff account needs permission to manage products and online store content. Uninstalling QueryCatch from your store ends every assistant connection and switches AI assistant access off. /assets/documentation/ai-assistants/shopify-settings.webp If your store is also connected to a QueryCatch profile on querycatch.com, the two share one set of AI assistant switches: changing them in either place changes both. If the store is later disconnected from that profile, AI assistant access for the store starts off again. Connected on querycatch.com with an email you linked from Shopify? Shopify confirms every day that you still work at the store. When that's due, your assistant says so for the store's profile, and works again once you open QueryCatch in your Shopify admin, or choose Confirm with Shopify on querycatch.com. Your other profiles aren't affected. What your assistant can do Read Google Search Console data: performance over time, top queries and pages, a query's trend, and sitemaps.. Read Google Analytics data: traffic overview, sessions by source, and event breakdowns.. See which integrations are connected.. List your Shopify store's pages, or your WordPress site's pages, posts and items of its own post types (such as recipes): each one's title, address, and whether it is published, hidden or a draft. On WordPress it also lists the post types it can create pages on.. Check the structured data (schema.org markup) on a page of your own site, and build markup for you to add to your theme or page: Organization, Shopify Product, and WebPage, FAQPage, Service or LocalBusiness for one page. Markup for a page is built from the text your assistant gives and your organisation's name and website; what only you know, such as your address, phone number and opening hours for LocalBusiness, is listed for you to fill in. QueryCatch never edits your theme itself.. Find images without alt text, and pages, products and collections whose meta titles, meta descriptions or descriptions need work, with the rules from your brand guidelines.. Ask QueryCatch's own AI for a blog outline, or to write a draft from one a section at a time, in your brand voice. Each section can link to up to two related pages of your own site: recent pages the SEO Analyzer has seen on your website, or your Shopify store's in-stock products, collections and published articles. A link to anything else is removed, and your assistant can name the pages earlier sections linked so none is linked twice. It changes nothing: your assistant shows you the text. There's a daily limit.. Plan a new page from your own data before anything is created: see 'Plan a new page' below.. Read your saved site audits: H1 headings, broken links, orphan pages, structured data, the SEO report, page scores from the QueryCatch analyser, and your saved keyword lists.. Read your saved reports from Intelligence → Reports: list them, and read one's headline figures, traffic, Google search, Google Ads and enquiries figures with their change, top channels, pages and searches, notes, or a technical snapshot's checks and actions. It reads the saved figures and doesn't make new reports. This isn't available when connected through the Shopify app.. Read your saved competitors from Competitor Analysis: how your site compares with each one on the same ten checks, who is ahead on each, what to change where they are, and which of their pages were checked. It reads their last check and doesn't check a site again. This isn't available when connected through the Shopify app.. With 'Allow AI assistants to make changes' on, and only for profile admins: add alt text to images that have none, set meta titles and descriptions (WordPress with Yoast, and Shopify), and set Shopify product and collection descriptions and collection fields. In descriptions, blog drafts and rich-text collection fields, links to your store's own pages stay followed, whether they use your store's main domain (its primary domain in Shopify) or its myshopify.com address. Links to other sites are marked nofollow in descriptions and drafts, and refused in rich-text fields, which can't mark them. It can also change your brand voice guidelines in QueryCatch (tone, writing style, dos and don'ts, notes and the meta title suffix), which QueryCatch's own AI features follow. And it can create blog post drafts on your connected site or store, and edit Shopify drafts that aren't published yet; drafts stay unpublished until someone publishes them. For a Shopify store with IndexNow set up, it can switch automatic submission on or off and ask search engines to recrawl pages now. And it can create new pages on your Shopify store, and new pages, posts and items of your own post types on your WordPress site: see 'Create new pages' below.. For profile admins: save blog topic outlines in QueryCatch for your team to write from. Start a storefront audit or refresh your keyword lists (Shopify stores), run a PageSpeed test of your profile's website, or run a technical snapshot of it (saved in Intelligence → Reports; not through the Shopify app). These replace results saved in QueryCatch and change nothing on your website. Each has a daily limit. /assets/documentation/ai-assistants/blog-draft-links.webp What your assistant cannot do Read data from a profile you don't belong to, or from one where an admin hasn't switched on AI assistant access. (It can see the names of all the profiles you belong to, so you can choose one.). Sign in to QueryCatch as you, or change billing, team members or connected integrations.. See your password or your connected Google, Shopify or WordPress credentials.. Publish a blog draft or anything else that already exists, delete pages or posts, or change the address of an existing page. It publishes only a new page or post it creates itself, and only where 'Let AI assistants publish pages' is on.. Overwrite something a person has changed since the assistant last looked at it: it re-checks every item just before changing it. One profile per conversation If more than one of your profiles has AI assistant access switched on, QueryCatch asks your assistant to work on one of them per conversation: to ask you which one at the start, unless you've already said (for example "using QueryCatch for Example Bakery, improve our meta titles"), and to keep to it until you ask for another one by name. Every answer about a profile's data names the profile it came from, and QueryCatch asks your assistant to tell you which profile it's working on when it reports back or shows you a preview of changes. Other connectors in your assistant can be signed in to a different business. A Shopify connector, for example, uses whichever store you signed it in to. QueryCatch asks your assistant to check that another connector is connected to the same website as the profile before using them together, and to ask you first if it isn't. Turning off connectors you don't need in a conversation avoids the mix-up altogether.. In Claude, a project for each business you work on keeps its conversations, and what Claude remembers from them, apart from your other work. Add a line such as "Use the QueryCatch profile Example Bakery" to the project's instructions. Plan a new page Before a page is created, your assistant can ask QueryCatch to plan it from your own data, in your brand voice. Ask for one, for example "plan a service page for our wedding cakes". Your assistant passes on the search the page should be found for, and the kind of page: a general page, a service page, a location or local business page, or an FAQ page. Planning changes nothing on your site or store, and any member of your profile can ask for a plan. Duplicates come first. QueryCatch looks for pages already getting clicks or impressions in Google Search Console for that search or one very like it, and for pages whose title or address is already about it. If one is a close match, your assistant is told which page and why, so it can suggest improving that page instead of adding a second page that competes with it. You still get the plan.. Search details: a short address, checked against the pages on your store or site (if the addresses QueryCatch suggests are all in use, your assistant is told to choose another), the main heading (H1), and a search title and meta description that follow your meta title rules, ending with your title suffix if you've set one.. An outline of H2 and H3 sections, each with a note on what it covers and draft text.. An FAQ built from questions people really search for, from your Search Console data. Your assistant is told which questions came from real searches and which QueryCatch's AI wrote. The answers are drafts for you to check.. Internal links: up to three of your own pages for the new page to link to (your store's products, collections and articles, or pages the SEO Analyzer has seen on your website), placed in the text when QueryCatch knows your site's address, and existing pages that should link to the new one, with suggested link text. Links only ever point to pages of your own site.. Structured data (JSON-LD) for the page: WebPage (or FAQPage for an FAQ page), FAQPage when it has an FAQ, and Service for a service page or LocalBusiness for a location page. QueryCatch returns it for you to add to the page, for example with an SEO plugin or in your theme. Besides the page's own text it holds only your organisation's name and website: what only you know, such as your address, phone number, opening hours, prices or the areas you serve, is listed for you to fill in, never made up.. QueryCatch's AI is told not to give prices, phone numbers, addresses, opening hours or claims about your business, since it doesn't know them, and text where QueryCatch spots one is left out of the plan. Check the draft before you publish, and add your own details where the page needs them.. Without Search Console, or a connected store or site, you still get a plan, and your assistant is told what couldn't be checked.. Up to 30 plans a day for each organisation. When you're happy with the plan, your assistant can create the page from it as it stands, once you agree (see 'Create new pages' below). If every address QueryCatch suggested is in use, it chooses another first. /assets/documentation/ai-assistants/plan-in-wordpress.webp Create new pages With 'Allow AI assistants to make changes' on, a profile admin's assistant can create new pages on your Shopify store, and new pages, posts and items of your own post types (such as recipes) on your WordPress site. Ask it for one, for example "make a page about our same-day cake delivery". It writes the title, the address, the text, an optional FAQ, and the search title and meta description, shows them to you, and creates the page once you agree. If your profile has both a store and a WordPress site, it uses the store unless you ask for WordPress. A new page is hidden in Shopify, or a draft in WordPress, for you to review and publish there. It is published only when you ask for that and 'Let AI assistants publish pages' is on. While that switch is off, a request to publish is refused and nothing is created.. An address already in use is refused, and your assistant is told which page or post has it whenever the store or site can say. On WordPress that includes drafts and anything in the bin, and a page can't take a post's address or a post a page's. If Shopify or WordPress ever saves the new page at a different address (WordPress adds "-2"), or WordPress saves a draft beside another post that took the address at the same moment, the new page is removed straight away (on WordPress, moved to the bin) or listed under AI changes for you to undo.. A page holds headings, paragraphs, lists, bold and italic text, links, and an optional FAQ: each question as a heading with its answer under it. Scripts, embedded frames, forms, styles and any other HTML are refused. Links to other sites are marked nofollow. On WordPress the text is saved as standard blocks, which every theme shows; words in square brackets are refused, since WordPress would run them as a shortcode, and so is a paragraph that is only a web address, since WordPress would embed it.. On WordPress, your assistant can create posts, pages, and items of your site's own post types that your WordPress user can create. It never creates media, templates, reusable blocks, menus or page builder layouts.. Your assistant can use one of your theme's page templates on Shopify, if another page already uses it.. On WordPress, the search title and meta description are saved as QueryCatch's other WordPress tools save them, through the QueryCatch plugin for WordPress (1.6 or later, with Yoast SEO). If WordPress doesn't take them, the page is still created and your assistant is told they weren't saved.. After saving, QueryCatch reads the page back and tells your assistant what was saved, whether it is live, and where to edit it in your Shopify admin or in WordPress.. Up to 20 new pages a day for each organisation, Shopify and WordPress together.. It only creates pages: it never changes, hides or deletes a page or post that already exists. /assets/documentation/ai-assistants/publish-pages-switch.webp Assistants connected before QueryCatch could create pages are asked to reconnect first. The page you approve them on names new pages: /assets/documentation/ai-assistants/consent-new-pages.webp You see each change first Changes an assistant makes to your website or store, your brand voice or IndexNow never happen in one step. When it asks for one, QueryCatch first answers with a preview: for each item, what it holds now and what it would hold, or a new page or draft with everything it would be saved with. A preview changes nothing and doesn't count towards any daily limit. Your assistant is asked to show you the preview and check with you. QueryCatch makes the changes only when the assistant asks again with the preview's code, and then only the changes in the preview. A preview's code works once, within 15 minutes, for the person and the assistant connection that asked for it, and only for exactly what was previewed. To change anything in it, your assistant asks for a new preview.. If something has changed by the time your assistant asks again, for example someone edited the item or the store's address changed, that change isn't made, and nor is anything after it in the same request. Your assistant can show you a new preview. /assets/documentation/ai-assistants/changes-switch.webp See and undo changes Profile admins can see the changes assistants made under Profile settings → AI assistants → AI changes (the 200 most recent): what changed, the old and new value, who asked for it and through which assistant. Undo puts the previous value back, but only if nobody has changed it since. Undoing a new Shopify page deletes it if nobody has changed it since; if someone has, it only hides the page, so their work isn't lost. Undoing a new WordPress page, post or other item moves it to the bin if nobody has changed it since; if someone has, other pages sit under it, or your site keeps no bin, it sets it back to draft, or leaves it as it is if it is a draft already. It is never deleted for good. If the page is already gone, Undo says so. After an undo, the list says what happened, for example "Wedding cakes" moved to the bin. Undoing a change needs an active plan. Change records are kept for 12 months. /assets/documentation/ai-assistants/ai-changes.webp An assistant does what you ask, and can make changes you agreed to that turn out to be poor ones. Review its suggestions before you approve them, and use Undo if something isn't right. Disconnect To disconnect one assistant: Profile settings → AI assistants → Your connections → Revoke. It loses access straight away. You can also remove the connector in the assistant.. To stop all assistants using a profile: switch off 'Allow AI assistant access' for that profile. It takes effect on their next request.. If you leave a profile, or your role changes, assistants you connected lose that access on their next request. /assets/documentation/ai-assistants/your-connections.webp Your data When your assistant asks QueryCatch for data, QueryCatch sends only what that request needs, for profiles you can access, to the assistant you connected. From then on, that data is handled by your assistant's provider under your agreement with them. QueryCatch keeps a record of changes an assistant made (12 months) and of the connections you approved, and its server logs record which tools were used and when, without the content. See our Privacy Policy for details. Requirements An active QueryCatch plan for the profile (for everything except listing your profiles and connections). For a store using QueryCatch inside Shopify, that is its QueryCatch plan in Shopify, and the assistant can use only the tools that plan includes.. Claude, where QueryCatch is in the connectors directory, or another AI assistant that supports custom connectors (the Model Context Protocol).. For reading: the integrations the data comes from, such as Google Search Console or Google Analytics.. For changes: a connected WordPress site (with Yoast SEO and the QueryCatch plugin for WordPress, 1.6 or later, for meta titles and descriptions) or Shopify store. New pages need a connected Shopify store, or a WordPress site connected under Integrations with an application password.Documentation
Everything you need to know about using QueryCatch