Site Diagnosis and Advisory Mode
Before you start creating articles, have your site's foundation diagnosed from an SEO perspective. This page covers reading your current site, what to enter, key pages, competitors and the research log, the author and reviewer, what the diagnosis tells you, and Advisory Mode.
Doing this first makes everything after easier
In "Sorabun > Site Diagnosis," you can have your site's foundation examined from an SEO perspective. Doing this before you start creating articles improves the accuracy of every article you create from then on.
If you're already running a site, let Sorabun read it
If you have 3 or more published articles or pages, a "Read from current site" button appears above the form. Click it and Sorabun reads your current site to fill in the fields below.
It reads your published articles (up to 30) and pages (up to 5). Pages like About Us, Services, or a profile page are read first, since they tend to state what the site is and who runs it more clearly than articles do. Drafts aren't read.
For articles, it reads the 12 newest plus 18 spread evenly from there back to your oldest article, along with the total count, the date range, and how many were published each year. Reading only the newest articles would mistake a topic you started recently for what the site is about (a theme you've written about for years could vanish from the reading just because it isn't in your latest posts).
The first-article ideas from "Get AI diagnosis" are also checked against the titles of articles you've already written (up to 300), back to the oldest, so it won't suggest a theme you covered years ago as a new article.
Read past articles (Pro)
If you have articles written before installing Sorabun, the Site Diagnosis screen shows "Read past articles." Clicking it analyzes those articles one by one, gives each a review date, and ranks which to work on first. It works the same as Existing Article Audit, and the results appear on that screen.
Once the fields are filled in, you'll see "Read N article(s) and N page(s)," along with what it based each answer on. If anything doesn't match how you'd describe your own site, correct it before moving on.
It only fills in the fields. The reading can be off, and whatever it fills in becomes the foundation for every article created afterward. Having something wrong get saved silently would cause far more trouble, so you're required to review it yourself before moving on to "Have AI run the diagnosis."
"Topics to avoid" is never filled in automatically. A topic not appearing anywhere isn't proof you're avoiding it (you may simply not have written about it yet). Only you know that, so this field is always left blank.
On sites with fewer than 3 articles, the button doesn't appear at all. Reading too little content would just leave the AI guessing from the site name instead.
What you enter
- Site name
- Topic you cover
- Target reader
- Target area (optional)
- What you want to achieve
- Competitor sites you're watching (up to 10, one per line)
Enter multiple competitors and Sorabun researches all of them via search, then compares their strong angles and their gaps to build its suggestions.
The competitor field shows the first 10 entries of the Competitors list below. Removing or adding one in the field removes or adds it in the list too (entries from the 11th on stay as they are).
Target area
Enter something like "Sapporo and the surrounding area" and articles on region-related topics will take that region's rules, prices, climate, and transportation into account. Add this if your site is aimed at readers searching within a specific region.
Leave it blank if you're aiming nationwide or mainly online. Sorabun won't force a place name into topics that have nothing to do with a region.
Key pages, competitors and the research log
Below the questionnaire there's a place to keep lists about your site. You can fill them in on the screen, and an AI connected through MCP can read and update them too (get_site_profile / update_site_profile).
| List | What it holds | Limit |
|---|---|---|
| Key pages | URL, role (summary, single topic, leads to sales, other) and a note | 100 |
| Competitors | Domain, name and a note | 100 |
| Research log | What was researched and what was found (up to 1,000 characters each) | Kept 90 days; the newest 20 are shown |
- You can enter a URL as a path like
/about/. http and https, with or without www, and a trailing / all count as the same page - Competitors entered as URLs are reduced to their domain. Competitors you entered by name in the earlier competitor field carry over as name-only entries
- Every entry shows who wrote it (you or MCP)
- The research log is there so nobody pays for the same research twice. When you ask an AI to do SEO work, have it read this first so it builds on what has already been looked into
What the article-writing AI receives
In Advisory Mode, the article-writing AI receives up to 5 key pages as internal link candidates (title, role and URL only).
- Only pages on this site that belong to a published post or page are passed, so it never links to pages that went back to draft or have a password
- They're ordered leads to sales → summary → single topic → other, and within a role in list order
- The AI is told to use them only when the topic clearly overlaps, and to link to the same page at most once per article
- Notes, competitors and the research log are not passed to the article-writing AI. The writing instructions go with every research, outline and section call, so adding to them adds cost. One article can use only a few internal links, so 5 are enough
On the screen, key pages passed to the article-writing AI are marked "passed to the article-writing AI."
The design of key pages, competitors and the research log (the limits, how URLs and domains are matched, applying a batch of changes all-or-nothing, 90 days and 20 entries) is based on the open-source SEO tool OpenSEO (MIT License, (c) 2026 Ben Senescu).
Things worth adding alongside Sorabun
Below the diagnosis form, you'll find plugins that fill in what Sorabun can't do on its own. This isn't a generic list of recommendations. Each one is listed only because there's a specific way Sorabun's own behavior falls short without it.
| Plugin | Without it |
|---|---|
| Site Kit by Google | The "Access Analytics" screen stays empty |
| Something to compress images | Pages get heavier from the auto-generated featured images and diagrams |
| A backup plugin | No way to undo after a batch of articles is created |
If something serving the same role is already installed, it won't even appear. Sorabun's own features count too.
- Image compression: hidden while the "Save AI-generated images lighter" setting is on (it's on by default). Pro can also convert uploaded images to WebP (Page speed), so it's hidden there.
- Backup: Pro has Backup / Restore, so it's hidden there.
- LiteSpeed Cache appears only when your server runs LiteSpeed. Nothing is recommended in an environment where it wouldn't work.
An SEO plugin and a contact form are not recommended. Without an SEO plugin, Sorabun outputs the meta description it wrote on the page itself (with Yoast SEO, Rank Math, SEO SIMPLE PACK or All in One SEO, it writes into that plugin instead). For inquiries, there's a built-in form.
You, the site owner, are the one who clicks. Sorabun only shows the suggestion.
"View details / Install" opens WordPress's standard plugin information window, so anything you're in the middle of typing elsewhere doesn't get lost. If a plugin is already installed but inactive, the button becomes "Activate" instead.
When structured data is turned off
Yoast SEO, Rank Math, and All in One SEO each output their own structured data (Article) for articles. Up to 2.132.0, Sorabun output an Article too, so two copies ended up on the same page, and this screen told you to turn off the Sorabun side.
Since 2.133.0, Sorabun adds only the author's job title, the reviewer, and the sources to the Article the SEO plugin outputs (never two copies). On sites that turned it off because of the earlier notice, none of these are output anywhere, so this screen now tells you it is fine to turn it back on.
The notice appears only when one of these three SEO plugins is present and Sorabun's "Output structured data (JSON-LD)" is off. SEO SIMPLE PACK only outputs meta tags and doesn't output structured data, so this notice never appears for it.
Author and reviewer (E-E-A-T)
There are fields, like medicine, law, or tax, where the qualification or standing behind the writer is itself part of an article's weight. This is especially true for topics involving health or money, what's known in SEO as YMYL (short for "Your Money or Your Life"), where an article is treated differently once nobody can tell who wrote it, even with the same content.
But this is exactly what tends to fall through the cracks when AI writes the article. AI doesn't hold any qualifications, so left alone, it fills the page with phrases like "it is generally said that...". The article ends up losing any sense that a particular person wrote it.
Register your details once under "Author and reviewer" in "Sorabun > Settings," and it's put to use in three ways.
- "Write from this standing" gets added to the article-writing instructions. Instead of retreating into generalities, the article explains the reasoning behind its judgments
- The author in the structured data becomes a qualified person, not just a name (job title, organization, qualifications, and external pages that confirm it's really you)
- It can be shown at the end of the article (off by default)
You can choose whether this person is presented as the one who wrote the article or the one who reviewed it. Choosing reviewer doesn't replace the article's author; it adds this person as the reviewer instead.
Whatever you enter here is published as-is. There's no way for us to verify whether a qualification is genuine.
Nor can we completely prevent the AI from inventing experience or case examples within the article. The prompt strongly instructs it not to write examples or first-person experience it wasn't given, but because you're now attaching a qualification to the article, the harm is greater if a fabrication slips through. Please make sure to read this before publishing.
The display at the end of the article is off by default. Turn it on and it appears only on articles Sorabun created (a reviewer credit on an article you wrote by hand would be inaccurate, so it's excluded).
When Site Diagnosis detects a health, money, or law related field and no author has been registered yet, the diagnosis screen recommends registering one. It doesn't appear for anyone outside these fields.
What does the diagnosis tell you?
- Site name suggestions (3): if your current name is fine, it will say "no need to change it"
- Tagline suggestions
- Category structure
- Differentiation angle: where you can win against your competitors
- Five articles to write first: each with a search intent (know / do / buy / go) and how realistic it is for this site to rank for it right now (easy / moderate / tough)
- A 3-step plan
You can generate any suggested article on the spot with "Create this article." You can also send them to bulk creation all at once.
Sorabun checks the titles of all your articles (published and draft) along with the keywords they were generated for, and automatically removes any overlapping suggestions. Variant spacing and formatting, like "〇〇 やり方" versus "〇〇 やり方," are treated as the same. The number of suggestions removed this way is shown below the list.
Any suggestion you adopt can be applied to your site name or tagline with one button. You can also choose to create the suggested categories or apply them to your default writing style and optimization type.
Your Site Health Report (the main event once you've diagnosed)
Once you save a diagnosis, the top of the Site Diagnosis screen turns into a Site Health Report. It's recalculated from your actual data every time you open it, so the numbers move as your site grows.
Health score (calculated from measured data, no AI involved)
| Axis | What it looks at |
|---|---|
| Content volume | Number of published articles (50 articles = full marks) |
| Freshness | Share of articles touched within the last six months |
| Search ranking | Share of tracked keywords in the top 10, and the 30-day improvement rate |
| Article quality | Average quality review score |
| Reader pathways | Whether CTAs, paid sales / LINE-exclusive content, "Ask AI," and related articles are active |
- The overall score is shown with the change (↑/↓) since you last opened it
- Axes with no data aren't penalized. A site with no rank tracking set up doesn't unfairly drop to zero on that axis
This month's prescription (the AI reads the data and writes it)
Press "Create prescription" and the AI reads the score, an inventory of your existing articles, and actual ranking data, then writes the following four:
- Findings: the most important thing the data shows, with figures cited
- Three things to do this month: each backed by a reason for why it matters now
- Five articles to write next: suggestions that don't overlap with existing articles. Each has a "Write this article" button that goes straight into article generation with the keyword already filled in
- Existing articles to fix: articles whose ranking is slipping or that have gone stale
The prescription is saved with the date it was created, and you can regenerate it anytime. We recommend regenerating it once a month and comparing it against last month's.
Advisory Mode
This turns on automatically once you save a diagnosis (advice_mode). From then on, every article you create is given the following information.
- Target reader
- What you're trying to achieve
- Your differentiation angle
- Topics not to cover
- Key pages (up to 5 published ones; see above)
In other words, articles follow your site's direction without you having to re-specify the same context every time. The same information is also passed to AI Editor-in-Chief's planning.
You can turn this on or off under "Settings > Generation defaults > Advisory Mode."
If the diagnosis judges your site to fall under fields like medicine, health, finance, or law, it points out specific concerns during diagnosis. Google holds these fields to strict evaluation standards, requiring expert review and clear disclosure of who runs the site. Please make sure to address any points it flags.