Skip to content

Documentation

Article Writer

Create an informational article, review its findings, and copy the finished HTML.

Open Article Writer

Article Writer, the PirateSERP informational-article generator, researches, plans, writes, and quality-checks an entity-first article from a single title. Use it for explainers and informational guides. For a commercial service page or an existing draft, use Content Editor.

Article Writer requires an OpenRouter API key and a model chosen in Model for all AI tools (required) in Account Settings. Every stage of the article runs on that model. Article research uses included search data.

Write an article

  1. Select the project.
  2. In Title, enter a specific subject or question—for example, How does a heat pump work?
  3. In Audience and Knowledge level, review or enter the reader—for example, General readers and Beginner.
  4. In Depth, choose Brief, Standard, or Deep.
  5. In Language, choose the article's language.
  6. In Market (country), choose the country.
  7. In Purpose, enter the reason a reader opens the article.
  8. Optional: To control coverage, enter topics in Required topics and Excluded topics, one per line or comma-separated.
  9. In Known facts, enter verified information. The writer treats these facts as given.
  10. Optional: In Notes, enter any other instructions.
  11. Click Write article.

Your business profile can fill the audience and market. Check both fields before you submit.

Follow progress

A progress display tracks the article through seven stages, from research to the final quality check. To request cancellation, click Cancel, and wait for the status to confirm that processing stopped.

Each article saves to Recent articles in the active project. Click an article to open it; its status reads Running, Ready, Needs review, Error, or Cancelled. Articles belong to one project, so switch projects in the header to find articles saved elsewhere.

Review the draft

The article aims to name each entity it covers and state that entity's attributes. It still requires editorial review: check names, figures, citations, and missing information against your sources before you publish.

Quality check marks the article PASS or REVISE. A PASS result has no blocking findings. Each finding carries a blocking or minor label, the quoted text, and a suggested fix. A passing check does not verify every fact independently.

Some findings mark a section whose opening doesn't answer its heading. These findings flag the following problems:

  • A question heading answered with another question.
  • An opening contrast word such as "However".
  • A how-much, how-long, or what-does-it-cost heading with no figure near the start of the section.
  • A how-to section whose steps run as prose instead of one numbered list.

Each one is a minor finding that you can fix with Regenerate this section. The contrast-word, figure, and step-list checks run on English articles only.

Other minor findings compare the article's structure with typical figures for informational articles. They are suggestions and never change the PASS or REVISE result:

  • A paragraph over 120 words. Split it so each paragraph makes one point.
  • A key takeaways section with fewer than five or more than seven points. Regenerate that section to keep the most important points.
  • An article over 1,000 words that states fewer than three figures, such as amounts, dates, or measurements. Add figures from your sources, or write the article again with them in Known facts.

The paragraph and figure checks run in every language. The key takeaways check runs on English articles only.

When the writer lacks evidence for part of the article, a notice reads The writer flagged followed by the number of gaps, with each gap listed under its section heading. Add the missing facts to the text yourself, or write the article again with them in Known facts.

Revise the article with these controls:

  • Regenerate this section rewrites the section a finding names, where the finding offers it. Findings about the article title have no Regenerate this section control. When two sections share a heading, the first one is rewritten. Before you click it, you can enter guidance in Extra instructions (optional), up to 500 characters, for example "open with the safety warning". The instructions guide only that one regeneration and cannot add facts: a detail your sources or known facts do not support stays out of the section.
  • Re-run QA checks the saved article again.

A recheck evaluates the article again and can return different findings. Read the resulting text after each revision.

Copy and reuse the article

To copy the article body, click Copy HTML. Paste it into your website editor, or into Content Editor for further work with its entity, term, and readability tools.

Article Writer does not publish to your website. To remove an article permanently, click its Delete icon. To check the finished text for topical focus, run Content Alignment; for entity coverage, run Entity SEO Auditor.

For supported content languages, read Languages.