How to use the Entity Schema Engineer

A step-by-step guide for customers who already have the Entity Schema Engineer in one of their seats.

By Al, BuzFind founderUpdated Portland, Indiana (Reading, PA roots)
Entity Schema Engineer AI agent - Schema Checks and Fixes
The Entity Schema Engineer - Schema Checks and Fixes

This guide shows you how to run the Entity Schema Engineer, what to type, and how to read what it sends back. To see what it checks and which plans include it, read the Entity Schema Engineer page.

Before you start

  • Your real business details: name, address, phone, hours, and services. You will use them to check every value in the JSON-LD it suggests.
  • Access to your site editor, or a developer, who can paste code into the page head or a custom code block.
  • The Entity Schema Engineer picked in one of your seats under My AI agents, then Save selection.

Step by step

  1. Sign in and open My AI agents in the dashboard menu. Click the Entity Schema Engineer to put it in one of your seats, then click Save selection.
  2. Open the Dashboard page. In the chat box, type what you need in plain words and include your website address.
  3. Wait while the check runs. The answer shows in the chat, and the full report is saved under Audit reports & fixes.
  4. Make the changes you agree with, then send the same request again to see what is still open.

What to type in the chat

Copy one of these requests and change the details to match your business.

“Run a technical SEO audit on yourbusiness.com”
Use this for a general check. It reads up to 10 pages and runs with the Technical SSR Sentinel and the Speed Optimizer.

“Run an AI visibility check on yourbusiness.com”
Use this when you care most about AI search tools reading your business facts. It reads up to 8 pages.

“Run an e-commerce audit on yourstore.com”
Use this for a store with product pages, where product schema matters most.

“Run a video SEO audit on yourbusiness.com”
Use this when your pages have videos on them.

“Check the schema on yourbusiness.com”
The chat shows the audit list for this one. Reply 1 for the Technical SEO Audit or 6 for the AI Search Visibility Audit.

How to read the results

  • Each issue names a page and the schema types the agent saw there, or says the JSON-LD on that page cannot be read.
  • JSON-LD that cannot be read is marked high, because search engines ignore broken blocks. Fix those first.
  • For a missing type, the Fix: line can include an example JSON-LD block. Treat every value in it as a draft to check.

What to do next

  • Correct the values in the example block, paste it into the page it describes, and make sure it matches what the page shows.
  • Test the page in Google's Rich Results Test before you move on to the next issue.
  • Run the same audit again on the same address to confirm the issue is gone.

Tips

  • The word schema alone does not pick an audit, so name the audit you want or reply with a number from the list.
  • If a plugin already adds schema to your site, change the plugin settings instead of pasting a second block for the same thing.
  • Put each block only on the page it describes. For example, product schema belongs on that product's page.

Questions about using it

Where do I paste the JSON-LD code?

It goes inside a script tag with type application/ld+json, in the page head or a custom code block in your site editor. If you are not sure, give the code to the person who edits your site.

Does it check every page on my site?

No. It checks the pages the audit reads: up to 10 for the Technical SEO Audit and up to 8 for the AI Search Visibility Audit. To check other pages, start a new check from that section.

Agents work better together. Here are specialists that pair well with the Entity Schema Engineer:

  • AI Visibility Auditor - Checks your pages for the signals that help AI search tools like ChatGPT, Gemini, and Perplexity understand and cite your business.
  • Local SEO Guru - Checks the local SEO signals on your own pages (LocalBusiness schema, your town in titles and H1s, and easy-to-find contact details) and gives you a fix list.
  • Platform Readiness Lead - Checks the technical signals that affect whether search engines and AI tools (ChatGPT, Perplexity, Claude, Gemini) can reach your pages: robots.

Need a different agent? Browse all 25 agent guides or see the full agent catalog.

Was this article helpful?