How the content grader works
The grader scores a page or draft from 0 to 100 for one target keyword. It measures twelve things and adds them up with fixed weights. No AI is involved: the same text always gets the same grade, and you can see exactly why. This page is the full method (version 1.0).
The twelve measures
| Measure | Weight | What scores well |
|---|---|---|
| Keyword placement | 10 | The keyword (or all its words) in the title, the main heading, the first 100 words and a subheading. More than 3% of all words is treated as stuffing and loses points. |
| Topic and entity coverage | 15 | Covering the topics most top-10 pages share (from the brief). Topics used by 60% or more of those pages count double. 80% coverage scores full marks. |
| Heading structure | 8 | One main heading, enough subheadings for the length (about one per 350 words, at least 3, or 60% of the brief's outline), and no skipped levels. |
| Depth and length | 10 | Within the brief's word range (the median to the upper quarter of the top pages). Without a brief: 600 to 2,500 words. Shorter loses points in proportion; much longer loses a little. |
| Readability | 8 | English: Flesch reading ease of 70 or more scores full marks. Other languages: average sentence length of 12 words or fewer. Over 25 words per sentence caps the score at 50. |
| Questions answered | 8 | Answering the questions people ask (from the brief), in a heading or plainly in the text. 60% answered scores full marks. |
| Search intent match | 8 | Signals that fit what the results page shows: explanations for informational searches, comparisons for commercial ones, prices and a call to action for transactional ones, areas and contact details for local ones. |
| Formatting and media | 7 | Lists, a table where it helps, images with alt text, and no paragraph over 120 words. Pages under 400 words need little formatting. |
| Internal links | 7 | Three or more links to other pages of your own site. |
| Originality against the top 10 | 8 | Few runs of five words in a row shared with any one top page. 30% shared scores 0. |
| Experience and trust (E-E-A-T) | 6 | A named author, an expert reviewer, at least two sources with links, and signs of first-hand experience ("we tested", "in our experience"). |
| Freshness | 5 | Updated in the last 12 months. Mentioning a year two or more years ago as current loses points. |
Coverage, questions and originality need a brief (Content → Briefs). Without one they show "n/a" and are left out, and the grade is based on the other nine.
Is it right?
The grader is checked against human editors: editors grade at least 100 real pages by hand, the grader grades the same pages, and the average difference must be 10 points or less. Your administrator sees the comparison in Admin → Grader calibration. Until that check has passed, treat the grade as a guide. When a rule or weight changes, the method version changes too, and pages are compared again.
A grade is a checklist, not a promise of rankings. A page that grades 90 can still lose to a stronger site, and a page with real expertise can win with 70.
In WordPress
- Install or update the SerpTorch Connector plugin to 1.5 or later (download it from Content → Grader); 1.5 adds AI citation readiness and missing terms.
- In SerpTorch, open Content → Grader and click Create grader key. Copy the key; it is shown once.
- In WordPress, open Settings → SerpTorch and paste the grader address and the key.
- Open any post or page. The SerpTorch grade box appears beside the editor. Type the keyword and click Grade.
The post's text is sent to SerpTorch only when you click Grade. The key can only grade text; it cannot read or change anything else in your account.
In Google Docs
The add-on is a small Google Apps Script you install in your own Google account.
- Download the add-on files from Content → Grader (Google Docs add-on), or use the zip at
/downloads/serptorch-google-docs-addon.zip. - In Google Docs, open Extensions → Apps Script. Replace the files with
Code.gsandSidebar.htmlfrom the zip, and in Project Settings tick Show "appsscript.json" and replace it too. - Save, then reload the document. Open Extensions → SerpTorch grader → Settings and paste the grader address and key.
- Extensions → SerpTorch grader → Open grader, type the keyword and click Grade.
Google asks you to allow the add-on to read the open document, show a side panel and connect to SerpTorch. Headings set with Docs' heading styles count as headings.