Documentation
Content Alignment
Check a draft against a target keyword and review proposed revisions.
Content Alignment, the PirateSERP semantic-alignment checker, scores how closely each section, paragraph, and sentence of a page matches a target keyword. Analysis requires a Google Gemini API key saved in Account Settings. Improve Alignment, the rewrite step, also requires an OpenRouter API key.
Analyze content
- Select the project.
- Choose a source:
- Paste content: paste the page's HTML or plain text.
- From a URL: enter a public page URL.
- Saved article: choose a saved Content Editor draft.
- In Target keyword, enter the keyword—for example,
water heater repair. - Optional: If the page centers on a named brand, product, or organization, enter it in Primary entity (optional)—for example,
Rheem. - Review Language. The project's default language is selected when you open the tool.
- Click Analyze. To stop the analysis, click Cancel. A canceled analysis isn't saved.
The report keeps introduction text that appears before the first heading, including inside pasted HTML, and lists it as Main Content.
In Content Editor, to save the draft and open it here with Saved article selected, click Check Semantic Alignment.
Read the report
The report header reads Alignment for followed by the target keyword and the page's H1. Six score tiles follow:
| Score | What it measures |
|---|---|
| Target Keyword Focus | The average match between every sentence and the target keyword. |
| Sentence Flow | How well the text in each section stays on that section's topic. A heading with no text after it does not lower this score. |
| Paragraph Flow | How smoothly each paragraph follows the one before it. |
| Section Flow | How smoothly each section follows the one before it. |
| H1 Alignment | How well the page's H1 matches the target keyword. |
| Weak Content | The share of sentences that are weakly aligned. A lower value is better. |
Tiles and badges are colored as strong, moderate, or weak alignment. The line after the tiles counts the weakly aligned sentences, for example "3 of 42 sentences are weakly aligned (below 40%)." That count uses the same line as the weak badges.
Open the Detailed tab to expand each section and paragraph. Section rows carry Keyword and Coherence badges. Paragraph rows carry Keyword, Coherence, H1, and Heading badges. Each sentence row carries a Keyword badge, followed by its H1, Heading, and Paragraph scores as text. Open the Outline tab for a heading-level summary with the first words of each paragraph.
Read flagged text in context. A necessary qualification or supporting example can score lower and still belong on the page. These scores do not measure factual accuracy or predict search rankings.
Review a rewrite
Improve Alignment proposes a rewrite of the analyzed content that stays closer to the target keyword.
- In Model, choose a model, or keep Account default model.
- Click Improve Alignment.
- To stop the rewrite, click Cancel. Otherwise, read the result in Rewritten content, and then, to copy its HTML, click Copy.
Without an OpenRouter key, the panel reads "Add an OpenRouter API key in Account Settings to run a rewrite." The rewrite aims to name the entities in your content and state their attributes. Check that the rewrite keeps your facts, meaning, and required details before you paste it into your editor. Content Alignment does not publish content.
Find saved analyses
Each completed analysis saves to Past analyses in the active project. Each entry shows the page title or keyword, a keyword badge, and the analysis date.
- Click an entry to reopen its report. Clicking the entry that is already open keeps the report as it is.
- To remove an entry, click its Delete icon.
Analyses belong to one project, so switch projects in the header to find analyses saved elsewhere. If analysis completes but saving fails, the message Analysis complete, but not saved appears and the report stays visible in the current view, but the analysis does not appear in Past analyses.
Troubleshoot analysis
If analysis fails, confirm that your Google Gemini key is saved in Account Settings. An OpenRouter key alone cannot run the analysis. Read API keys for key setup and Languages for language support.
For vocabulary range instead of topical focus, use Lexical Diversity. For entity coverage and structure, use Entity SEO Auditor.