Documentation
Entity SEO Auditor
Audit a page or draft, review content findings, and rewrite its sections one at a time.
Entity SEO Auditor, the PirateSERP on-page entity audit, grades one page on its entities, relationships, topical coverage, terminology, and heading structure, judged only on what the page says. Each audit compares the page with an industry researched in Service Atlas. The written report requires an OpenRouter API key and a model selected in Model for all AI tools in Account Settings.
Run an audit
- Select the project.
- In Page to audit, enter a page address in From a URL, or choose A saved article and select a Content Editor draft.
- In the Industry list, select one of your researched industries. To filter the list, type in the field.
- To grade a single service page, select a service in the Service list. To grade against the whole industry, keep All services (optional).
- Review Language.
- Optional: To compare the page with a top-ranking page for a keyword, enter the keyword in Target keyword (optional). The comparison uses a top result on your page's topic.
- Click Run Audit.
Run Audit stays unavailable until you supply a URL or a saved article and choose an industry with research. If your industry is missing or has no research, research it in Service Atlas first. Your business profile can fill Industry and Service; a selected service without matching research shows a message asking you to choose a researched service or use the whole industry.
In Content Editor, click Send to Entity SEO Auditor to save the draft and open it here, selected under A saved article.
Read the findings
The report header shows the page title, a Graded against badge with the industry, and Visit page for URL audits. The summary under the header gives the score and verdict, a sentence naming the weakest and strongest areas, and the first three fixes; each fix has a Show in article or Show in report link on its title line. Use the section links under the summary to jump to any card. Work through the report in this order:
- Semantic quality / 100: the overall score with a verdict, plus a score out of 10 for each category. The categories are listed weakest first.
- Entity Map, Entity Types, and Entity Salience: the entities the page names, their types, and how prominent each one is.
- Readability: word and sentence counts, plus Reading ease and Grade level for English pages.
- Terminology Consistency: Same entity, different names, Inconsistent casing, and Acronyms never expanded.
- Topical Drift by Section: sections that move away from the page's main subject.
- Services Related Providers Offer and Topics Related Pages Cover: coverage gaps against the industry research.
- What the Top Result Covers: subjects found on the top-ranking page, shown only when you enter a target keyword.
- Heading Structure: the page's heading outline.
- Verified Entities: entities matched to Wikipedia and Wikidata, with a link to each.
- Schema Markup (JSON-LD): markup for the verified entities, with Copy.
- Full Report: the written audit in numbered sections. Click Expand all to open every section.
Each card carries a small label that says where its numbers come from: Computed for measures taken from the page's own text, Knowledge base for matches to Wikipedia and Wikidata, and AI-scored for the scores and written report that the AI model produces. A key under the summary explains the three labels in one line.
Entity Types and Entity Salience show each entity's check state as text: Verified (matched to Wikipedia and Wikidata), Not found (looked up, with no match), or Not checked (no recent lookup exists for it, so it is not a miss).
To save the results, click Export. It downloads the entities or the gaps as a CSV file, or the summary, fixes, and findings as a Markdown file, named for the page and the audit date.
In 17. AI-Search Citability, Answer passages lists sections whose opening doesn't answer the section's heading. Each row names the problem:
- The section answers a question heading with another question.
- The section opens with a contrast word such as "However".
- A heading that asks how much, how long, or what something costs gets no figure near the start of the section.
Fix each one by opening the section with a direct statement that answers its heading. Put the figure or range first when the heading asks for one. The contrast-word and figure checks run on English pages only.
Answer-first structure in the same section lists sections that open with an introduction, a story, or another subject before what their heading promises. Move the answer to the first sentence. On English pages, the check reads each section's opening and uses your OpenRouter API key. On other languages, or when that check can't run, it checks whether the heading's words appear near the start of the section.
The Structure line in the same section also names:
- A subheading that stands alone under its parent. Add a second subtopic, or fold its text into the parent section.
- A heading that runs straight into a subheading with no text of its own. Open it with a sentence that introduces what follows.
- A heading that ends with a period or a colon. Drop the punctuation, or shorten a sentence-length heading.
Use the linked evidence to decide which recommendations fit your page. A competitor's topic is not automatically relevant to your business, and a top result is one comparison page, not a requirement. To print the report or save it as a PDF, click Print.
Scores support content review. They are not Google scores or predictions of rankings, traffic, or AI citations.
Review findings
Findings sits under the summary and lists the points that the checks found on this page. Each row shows:
- Your evidence: the exact text from your page, with the section it appears in.
- Reference evidence: the matching text from other pages in the industry, when the check uses it.
- Status: Open, Reopened, Resolved, or Dismissed. Reopened means a finding you had resolved has returned. Resolved means the page no longer shows it.
- Fact and Relevance: the fact status is Stated, Missing, Conflicting, or Source needed. The relevance is Covered, Ambiguous, or Potentially relevant.
Potentially relevant is not a requirement. It means other pages in the industry mention the topic. Decide for yourself whether your business needs it.
Under the heading, one line per check says what it found, such as "Conflicting statements: none found". That is a result: the check ran and found nothing. Two cases never show "none found". When the checks could not run on an audit, because it has no stored analysis, the card says so. When a check cannot read the page's language, such as the conflict check on a non-English page, its line reads Not evaluated with the reason. Missing entities list the topics most other sites state first, and show the top 10. Click Show more missing entities to see the rest. Each missing entity says how many other sites in the industry's research state it, and is marked as not a requirement.
The top of Findings compares this audit with the previous audit of the same page. It starts with Resolved since the previous audit, followed by the number of findings the page no longer shows, and lists their titles. A list longer than 10 shows the first 10; use the button under it to see the rest. Below it, the counts show how many findings are new, reopened, or dismissed. When the earlier audit cannot be compared, the line says so, and no finding is marked resolved.
To hide a finding that does not apply to your page, click Dismiss, optionally type a reason of up to 200 characters, and click Confirm dismiss. A dismissed finding stays dismissed when you run the audit again. If its evidence changes later, the row says so.
Click Show dismissed or Show resolved to see the hidden rows. Click Restore on a dismissed row to bring it back. It returns as Open, or as Resolved if the page no longer shows it.
View the original and rewritten article
The Article section shows the whole audited page, split at its headings. Switch between two views:
- Original: the page exactly as it was audited.
- Rewritten: the current version. Each rewritten section is highlighted with a Rewritten badge and a Revert button that restores its original text.
The article opens on Rewritten after any section has been rewritten, and on Original before that. Click Copy HTML, Copy text, or Download to take the version on screen to your site or editor.
The article is saved with the audit, so rewrites are still there when you reopen the audit from Past audits.
Rewrite sections from the Full Report
In Full Report, section 14. Priority Improvements lists each recommended change as its own row. Rewrites run on the model that you select in Model for all AI tools, one section at a time.
- Open 14. Priority Improvements in Full Report. The rows name the section each finding points at.
- Optional: type guidance for this rewrite in Extra instructions (optional), for example,
mention we're family-owned. The box holds up to 500 characters. - Click Rewrite this section on a finding. When a finding points at more than one section, each section has its own button.
- For a finding that names no section, select the section that it belongs in from the Choose a section list, and then click Rewrite this section.
A progress display tracks the rewrite. To stop the rewrite, click Cancel. When the rewrite finishes, the page scrolls to Article and shows the Rewritten view. Rewrite buttons stay unavailable while a rewrite runs.
Each finding's button rewrites its section for that finding only; to apply another finding to the same section, click that finding's own button. Your extra instructions guide only that one rewrite, and they cannot add facts: when an instruction asks for something your page does not say, the rewrite leaves it out. Rewriting a section again starts fresh from its original text. Headings stay as they were unless a finding asks for a different heading. A rewrite uses only facts already on your page; when a finding needs information the page does not contain, the rewrite tightens or qualifies the text instead. A section that shows Not on the original page has a number the original page did not contain, so confirm or remove it before you publish.
Re-audit the rewritten article
After you rewrite at least one section, click Re-audit rewritten article in Article to see whether the scores moved. The re-audit grades the article as it stands now, rewrites included, against the same industry, service, language, and target keyword as the original audit. When it finishes, the new audit opens, and it appears in Past audits with a Re-audit badge; the original audit stays there unchanged, so you can compare before and after. A re-audit runs the full audit on the model that you select in Model for all AI tools, so it costs the same as running any audit. You can rewrite and re-audit the new audit in turn.
Load the article for an audit
Audits that show Load article don't include the article yet. Click it to add the article to the audit. A saved-article audit loads the draft's current text from Content Editor; a URL audit fetches the page again. Loading costs nothing and runs no AI.
If the page can no longer be fetched, or the saved article was deleted, an error explains why; run a new audit instead. Because the page might have changed since the audit, some findings can point at no section; place those with the Choose a section list.
Reuse results
Each audit saves to Past audits in the active project. Click an entry to reopen its report without starting another run. Audits belong to one project, so switch projects in the header to find audits saved elsewhere.
Open a saved audit as the Entity SEO Audit source in Entity Graph Viewer to inspect its entity connections and relationship evidence. Review generated markup before installing it, or build structured data step by step in Schema Generator.
Language limits
Entity SEO Auditor supports the listed content languages. Reading ease and grade level are English only, and the casing and acronym checks are skipped for other languages. Chinese, Japanese, and Korean pages can produce fewer relationship findings.
Separate findings from business facts
Industry research supplies comparison material; it does not confirm what your business offers. Check claims about services, qualifications, products, and locations against your business records before you add them to a page.