Entity Clarity Checker

Does your page say clearly what it is about?

Pages often assume the reader already knows the subject: the brand name sits in the logo but never in a sentence, or the product becomes "it" after the first paragraph. This checker gives you a fast read on that habit. Give it a draft and the main subject's name, and it applies five text rules and reports how many passed. The rules are pattern matches on your words; no model, entity database or outside service is involved, and the analysis happens in your browser.

Step by step

1. Copy the body text of your page or draft and drop it into the large content box.
2. In the Primary Entity field, enter the subject's name spelled exactly as it appears in the copy.
3. Press Analyze Entity Clarity. A results table lists each rule, a Pass or Improve status, and a note.
4. Revise the draft in the box and run it again.

What to watch for

The name match is literal and ignores case. "Acme" also matches "Acmeville", while "the company" or an abbreviation earns nothing. The opening rule reads just the first line with words in it, so a headline pasted at the top decides that result, while empty lines before it are ignored. The definition rule needs the name to sit right next to a trigger like "is an", "is a", "defined as" or "refers to"; an aside between the name and the verb breaks the match. The statistics rule only spots digits followed by a percent sign or by words such as million, billion, thousand, users, customers or years, so "4 billion" counts but a plain year like 2019 does not. The length rule wants 300 words.

Use the score to prompt edits, not as a grade. Five passes can sit on a page full of unsupported claims, since nothing here checks whether a number is true.

Questions people ask

Is this how Google or ChatGPT judges entities?

No. It checks a few writing habits that make a subject easier for any reader, human or machine, to identify, and it does not try to imitate any search or AI system.

Why did the definition check fail when my page clearly defines the entity?

It needs the name immediately followed by a trigger phrase. "Acme is the leading maker of..." fails because "is the" is not on the list. Rewording one sentence to "Acme is a..." passes, if that reads naturally.

Should I also add structured data?

It helps alongside clear prose. Organization or Person markup with sameAs links ties your name to your profiles elsewhere; the prose tells readers what you are.

Further reading: Semantic SEO and NLP: Optimizing for Entities and Topics, Not Just Keywords and Organization Schema and sameAs: Building Your Entity in Google's Knowledge Graph.

The same tool is also published on the static mirror at seoprocheck.github.io, and the rest of the set is on the free tools page.