Documentation

Content Editor

Research a page, write a draft, and use review tools before publishing.

Content Editor, the PirateSERP research-backed drafting workspace, builds a page around one primary entity or keyword. It compares your draft with the entities, attributes, relationships, terms, and reader questions found in your research, and marks each one as you use it.

Search data is included. AI writing requires an OpenRouter API key saved in Account Settings. Outline, Review answers, and both rewrite actions run on the Preferred LLM you select there.

Start a draft

Select the project, then choose one of two research methods.

Start from industry research. Use research you already ran in Service Atlas. This method loads terms, entities, outlines, and questions at once, with no search and no API key.

Under Start from Industry Research, choose an industry. Type in the field to filter the list.
Choose a service to narrow the research to that service, or keep All services (optional) for the whole industry.
Enter a Post title (optional).
Click Create Post.

Research a keyword. Use the pages that rank for a keyword as your references.

Enter Keyword you want to rank for.
Review Search Location and Search Lang, then click Submit.
Select the ranking articles to compare against. Content Editor recommends 5 to 10 articles and requires at least 2.
Click Continue. Keep the page open while Content Editor analyzes your chosen articles; the editor opens when the analysis is saved.

The results list also shows badges for search features on the results page, such as Featured Snippet, People Also Ask, or Local Pack. Your business profile can supply starting values for either method, so review them before you continue.

Each draft saves to Saved drafts in the active project.

Set the main subject

The main subject is the keyword or entity that question research and generated writing are about.

Enter Main keyword / entity.
Open Settings to review Country, Language, and Search intent.
Click Save target.

The status beside Save target reads Target saved or Unsaved target. Generation tools stay unavailable until you save the target.

Choose the Search intent that matches the page's purpose:

Choice	Writing guidance
Informational	Explain the subject, answer questions, and connect relevant entities and attributes.
Commercial investigation	Compare alternatives through supported criteria, differences, and tradeoffs.
Transactional	Explain the offer, requirements, and next steps for a purchase, booking, or other action.
Navigational	Help readers identify and reach the named destination, organization, or resource.
Not specified	Preserve the draft's purpose without assuming commercial intent.

The saved intent guides Review answers, Outline, and Rewrite. Changing intent keeps your saved questions. A draft without a chosen intent shows Not specified.

Changing the target keeps the original research and your draft, and it does not collect replacement research. Existing reference analysis belongs to the previous target, so Content Editor excludes it from generated writing. After you change the subject, review the existing entities and references for relevance.

Write or import text

Use the toolbar to add headings (Heading 1 to Heading 3), text formatting, lists, quotes, code blocks, tables, and images. Click Save before you leave the page or open another task.

To import a public page, enter its URL and click Import URL, then confirm Replace the current draft?. The imported article replaces the editor content; click Save to keep it.

Add URL in Outline adds a reference page to your research and merges its terms. It does not import that page into the draft.

Draft history

Click History to open Draft history. Each save that changes the text records a revision; saving unchanged text does not.

Choose a Revision to compare Selected revision with Current editor.
To label it, enter a Revision name and click Name revision.
To restore it, click Restore revision, review the confirmation, then click Confirm restore.

Restoring saves the selected content at once and keeps your current text in history, so undo can reverse the change. Click Save to keep a reversal.

If another session changed the draft, save and restore reject the outdated version. Copy your unsaved edits, reload the saved draft, and compare the two before you save again.

Revisions belong to your account, project, and draft. Deleting a draft also deletes its revisions and its saved review.

Choose an editor tool

The editor tools sit in three groups. Click Collapse editor tools for more writing space, and Show editor tools to bring them back.

Group	Tools
Research	Questions, Competitor Gap, and Topic Clusters
Entities & Terms	Entities, Attributes, Relations, Terms, Verbs, and Linguistics
Write & Review	Outline, Meta Description, Diversity, Readability, Sentiment, Style Review, and Rewrite

Open tools keep their results while the editor stays open. Save draft changes before you navigate to another page.

If reference analysis fails, click Retry reference analysis.

Review entities and terms

Entities and terms turn green as you use them in the draft. Highlighting updates while you type, delete, paste, or undo, with no button or save required.

Green highlighting confirms a matching mention. It does not confirm that the draft explains an entity, relationship, or answer.

Click All, Not used, or Used to filter entries by draft coverage.
Click a used entry to select its matching text in the draft; click again to move to the next match.
Click the delete icon on an entry to remove an irrelevant suggestion from the research.
Click Copy Missing Terms to copy every suggestion that the draft does not contain yet.

Add only relevant information. Matching the research vocabulary does not require repeated mentions.

Each tool covers one kind of research:

Entities lists named things. Identity shows an existing Wikidata identifier or Wikipedia link when one is stored; it does not run another lookup.
Attributes lists entity characteristics.
Terms lists words and phrases from the research, including hyphenated phrases such as "move-in cleaning" when the research supports them.
Verbs lists actions, and Linguistics lists phrases from the research.

What reference pages say

The Attributes tool ends with What reference pages say, a list of the attributes and descriptions your reference pages state, in their own words. Examples include a product weight, a warranty length, or "licensed and insured."

Each row shows how many sites state it, and the most-stated rows come first.
Open a row to read each site's own wording, with the site's domain. Hold the pointer over an example to read the full source sentence.
Examples marked possible or conditional were hedged or qualified on the page, and a negated claim keeps its "not."
Click the delete icon on a row to remove it.

When the list is empty, it reads No shared statements found in your references yet. Research analyzed before this section existed shows no rows until you analyze your references again.

When research panels are empty

For a draft started from industry research, reopen the editor to load the available research for the saved industry and service. Your draft and removed suggestions stay intact. If the panels remain empty, confirm that the selected service has completed research in Service Atlas, or add reference pages with Add URL.

Read relationships and topic groups

Relations separates four kinds of evidence:

What sources say lists, for each entity, statements that two or more industry sources make about it, each with the source sentence and a source link. Entities your draft already mentions come first and carry an In draft label, so you see supporting detail for what you are writing about. Expand an entity to read its statements, and click Show all to list every entity. Treat a statement as what sources say, not as a verified fact about your business.
Service connections come from the service research. Each connection carries a label: Appears together, Entity / action, Hierarchy, or Stated relationship. A Stated relationship reads as subject, relation, and object, in the direction the source stated it. Entity and action pairs show associations, not who performs an action.
Reference co-occurrence lists entity pairs that appear together in your reference pages. Co-occurrence suggests a connection; it does not verify a relationship.
Topic groups repeat the group memberships from Topic Clusters. A topic group organizes related subjects for planning; membership does not establish a factual relationship between every pair of entities.

An empty Service connections list reads No service connections are available yet. Service connections and What sources say depend on completed research for the selected industry, service, and language.

In Topic Clusters, click Build Clusters to group your research terms into topics, and Refresh to rebuild them. Use the groups and their graph to plan coverage and related pages. For a draft started from industry research, Entity groups from industry research also appears: groups of entities that sources confirm and mention together, such as a water heater with its installation, maintenance, and repair. Each group is a candidate section, and the first name is the group's most central entity. The content brief includes these groups as subtopics.

Industries researched more recently produce more entity groups. If none appear, open the industry in Service Atlas and click Research More.

Find competitor keyword gaps

Competitor Gap lists keywords that a competitor domain ranks for and your domain does not.

Enter Your domain and Competitor domain.
Click Find Gaps.
Review each Keyword with its Volume and Competitor position.

Domain gaps can span many subjects. Use a phrase on this page only when it serves the saved target, and plan a separate page for a distinct reader need. Competitor Gap does not support Catalan.

Fetch Google questions

Save Main keyword / entity and its market settings.
Open Research, then Questions.
Click Fetch questions.

Questions lists Google People Also Ask (PAA) questions for the saved keyword, country, and language. Typing a keyword or opening the tab does not fetch questions, and clicking Fetch questions also saves the target. Results are saved for the keyword, so other drafts with the same keyword and market reuse them. Capitalization and extra spaces do not count as a different keyword.

After you change the target, click Fetch questions again. Questions from the previous target stay marked as earlier research.

Click Insert to add a question as a heading. If the question already appears in the draft, Find selects it instead; repeated clicks cycle through matches. Finding a question does not confirm that the draft answers it.
Click Dismiss to hide an irrelevant question. Click Show dismissed questions, then Restore, to return it. Dismissals belong to the draft.

Review answers and relationships

Content review, in the Questions tool, judges how well your open draft, including unsaved text, answers its questions and explains its relationships. Save your target and search intent before you click Review answers.

Review uses your Preferred LLM and the existing research. It does not fetch questions, and it excludes dismissed questions.

What to address lists prioritized question gaps, relationship gaps, search-intent differences, and topic placement suggestions. Expand the list to read more findings.

Open Review details to read each judgment:

Answered marks a substantive answer in body text. A heading or a repeated question alone is not an answer.
Explained marks a relationship that the draft explains, as opposed to one it only mentions.
Partial marks incomplete coverage, Not found marks absent coverage, and Uncertain marks an inconclusive judgment.
Reference pairs do not establish business capabilities or causal claims.
Topic suggestions separate subjects for this page from subjects for a separate page.

Open Supporting passages and click Find passage to select the exact quotation in the draft. Coverage judgments do not verify factual accuracy or predict rankings.

Insert writing guidance adds a labeled instruction to the suggested section. When no section fits, it adds a heading with the instruction. Guidance stays out of the draft HTML and exports until you insert it. Use undo to reverse an insertion, then click Save to keep your changes.

The latest review saves privately with its draft and project, and reopening the editor loads it without another model request. Changes to the text, intent, target, active questions, or references mark the result out of date with Review is out of date. Click Review answers again before you use outdated passages or insert guidance. Restoring the exact reviewed text makes those actions available again when the other inputs still match.

Overlapping findings in the same section are combined, and their supporting passages and writing requirements remain available. Separate-page suggestions stay distinct. A failed review shows an error instead of unanswered labels; retry when your model provider is available.

Review has a size limit on questions and draft length, and it tells you when a draft or question list is too large. Dismiss out-of-scope questions or shorten the draft to fit. Each review reports how many research items it reviewed out of those available. The limit never truncates your draft text, and the detailed panels keep the full research.

Generate an outline with writing guidance

Open Write & Review, then Outline. Every generated outline includes writing guidance.

Current draft lists the draft's headings. Click a heading to locate it in the draft.
Suggested shows generated headings with section guidance.
Competitor headings shows headings from your reference pages. Click Insert heading to add one to the draft.

Click Generate outline to combine competitor headings with your entities, active reader questions, topic groups, and a suggested length. Generation follows the saved search intent and excludes references from an earlier target.

Review the suggestion before you apply it. Insert adds one section with its writing guidance. Replace draft with suggestion replaces the whole draft after confirmation. Use undo to reverse an insertion, and click Save to keep changes. Generation alone does not replace or save draft content.

Rewrite the draft

Rewrite proposes a full replacement draft that works in the terms, entities, verbs, word combinations, attributes, and reader questions the sidebar shows as not yet covered. Rewrites aim to name entities and state their attributes instead of using vague descriptions.

Open Write & Review, then Rewrite.
Keep Default Rewrite, or choose another listed rewrite style.
Click Rewrite article (or Rewrite with followed by the style name).
Read the Preview. The rewrite works from the facts already in the draft, so add any missing facts yourself.
Click Apply rewrite and confirm, because the rewrite replaces the whole draft. Then click Save. Press Ctrl+Z or Cmd+Z to undo an applied rewrite.

If the target or research changes after a rewrite, run Rewrite again before you apply the result.

To revise one passage, select its text and click Rewrite selection in the toolbar. Review the change before you save.

Review style and wording

Open Style Review and click Run style review for wording suggestions. Read the proposed text and its Changelog, then click Apply rewrite and confirm to use it. Applying the style fix replaces the draft.

Meta Description generates a description from the draft in the editor. Click Generate, edit the text, aiming for 50 to 160 characters, then click Copy. Content Editor does not save the description, so paste it into your page's meta tag.

Compare vocabulary diversity

Open Diversity and click Score my draft to score your draft's vocabulary range. Reference median MTLD shows the median score of your reference articles; with an even number of references, the median is the average of the two middle scores. The panel states whether your draft is at or above, or below, that median, and lists each reference with its word count and score. Read Lexical Diversity for what each score means.

Check sentiment

Open Write & Review, then Sentiment. Click Analyze sentiment to review the tone of the current draft.

The panel shows Entire document, each section, and each sentence. A section contains one heading or subheading and its text, ending at the next heading; text before the first heading forms its own section. Expand a section to see its sentences, and click a sentence to select it in the editor.

Measurement	What it reports
Score	Tone from −1 (negative) to +1 (positive) for the document, each section, and each sentence.
Magnitude estimate	Estimated emotional intensity. Longer documents can have larger values, and the estimate can miss mixed sentiment within one sentence.

These measurements are PirateSERP's own, not Google Natural Language scores, and the magnitude estimate is not a confidence value. Green marks positive tone, red negative tone, and amber near-neutral tone; blue badges show magnitude estimates. Each badge includes a text label.

Language coverage is experimental. You can analyze any supported project language, but sentiment accuracy is not validated for each one. Sentiment can misread factual service descriptions, negation, and mixed sentiment, so review the source text before you change it.

Editing the draft or changing its language clears the results. Click Clear sentiment to remove results without changing the draft. Sentiment tells you when a draft is too long to analyze.

Check readability

Open Write & Review, then Readability. Click Analyze to review an English draft. Readability supports English only; drafts in other languages show Readability is English-only.

Choose Target audience to set the long-sentence guideline. Expand a category, then click an example to select that passage in your draft.

Readability highlights never become part of saved content. Click Clear to remove the analysis and highlights without changing your text. Editing the draft clears the analysis, so click Analyze again after you edit. Switching tools keeps the results until the draft changes.

Choose an audience level

The Common European Framework of Reference for Languages (CEFR) describes language proficiency from A1 to C2. A1 and A2 describe basic proficiency, B1 and B2 independent proficiency, and C1 and C2 proficient language use. These levels describe readers, not writing quality.

Level	Reading ability	Sentence guideline in PirateSERP
A1, beginner	Familiar words and short, simple sentences.	10 words
A2, elementary	Short texts about everyday needs and familiar topics.	15 words
B1, intermediate	Straightforward factual texts about familiar subjects.	20 words
B2, upper intermediate	Complex texts and technical discussions in a familiar field.	25 words
C1, advanced	Long, demanding texts with meaning that is not stated directly.	30 words
C2, proficient	Dense, abstract, or structurally complex texts.	35 words

PirateSERP flags sentences longer than the selected guideline. These word limits are editorial presets, not official CEFR thresholds or a validated proficiency assessment.

B1 is the default. Choose the level of your intended audience, keep technical terms your readers need, and explain unfamiliar terms. Changing the level adjusts only the long-sentence check; your text, measured counts, and other checks stay the same. Choosing C2 does not make a draft better.

Expand What do A1 to C2 mean? in the panel to compare levels without leaving the editor. For the framework's own definitions, read the Council of Europe level descriptions.

Interpret the checks

Check	What it reports	How to use it
Word and sentence counts	Total words, total sentences, and average words per sentence.	Review the draft's length without treating length as a quality score.
Long sentences	Sentences that exceed your selected audience guideline.	Split sentences where splitting clarifies meaning.
Complex sentences	Sentence estimates from the Automated Readability Index (ARI), based on character count and sentence length.	Review highlighted sentences in context.
Vocabulary to review	Words with three or more syllables, excluding proper nouns.	Keep necessary terms or explain them. This check does not assign CEFR vocabulary levels.
Possible passive constructions	Constructions identified through grammatical analysis.	Decide whether the sentence needs to name who performs the action.
Adjectives	Adjective occurrences and their percentage of total words.	Review descriptions for precision. The percentage does not measure credibility or factual accuracy.

The highlight counts also report adverbs and qualifiers. Grammatical estimates require review in context; a flagged passage does not require a rewrite.

Readability analyzes draft text, including headings. Formatting labels such as H1 and PARAGRAPH are not part of that text. Readability sets no total sentence limit and no target adjective percentage.

Send the draft for another check

Send to Entity SEO Auditor saves the draft and opens Entity SEO Auditor with the draft selected.
Check Semantic Alignment saves the draft and opens Content Alignment with the draft selected.
In E-E-A-T Analysis, choose the saved draft under Or a saved draft.
In Entity Graph Viewer, choose My Articles to see the draft's entities as a graph.

None of these actions publishes the page. Review the final text and copy it into your website editor when it is ready.

Find saved work

Drafts belong to the active project. If an expected draft is missing from Saved drafts, check the project selected in the header.

Research you contribute through Content Editor can enter shared industry research. Submit public reference material, not confidential documents.

Read Languages for language-specific analysis limits.