Skip to content

Documentation

Entity SEO Auditor

Audit a page or draft, review content findings, and rewrite its sections one at a time.

Open Entity SEO Auditor

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 Preferred LLM selected in Account Settings.

Run an audit

  1. Select the project.
  2. Enter a page address in From a URL, or choose a Content Editor draft in Or a saved article.
  3. Choose Industry from your researched industries. Type in the field to filter the list.
  4. Choose a Service for a single service page, or leave it on All services (optional) to grade against the whole industry.
  5. Review Language.
  6. Enter Target keyword (optional) to compare the page with the top-ranking page for that keyword.
  7. 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 in Or 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. 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.
  • 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.

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. Click Print report to print or save the report.

Scores support content review. They are not Google scores or predictions of rankings, traffic, or AI citations.

View the original and rewritten article

Below the score, Article 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 once 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 your own Preferred LLM, one section at a time.

  1. Open 14. Priority Improvements in Full Report. The rows name the section each finding points at.
  2. Optional: type guidance for this rewrite in Extra instructions (optional), for example "mention we're family-owned". The box holds up to 500 characters.
  3. Click Rewrite this section on a finding. When a finding points at more than one section, each section has its own button.
  4. For a finding that names no section, choose the section it belongs in from Choose a section…, then click Rewrite this section.

A progress display tracks the rewrite; click Cancel to stop it. 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 your own Preferred LLM, so it costs the same as running any audit. You can rewrite and re-audit the new audit in turn.

Load the article for older audits

Audits saved before the article was kept with them show Load article instead. 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 may have changed since the audit, some findings can point at no section; place those with Choose a section….

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.