Tidy SEO AI Refresh
| 开发者 | pierreferrolliet |
|---|---|
| 更新时间 | 2026年8月23日 15:35 |
| PHP版本: | 8.2 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPL-2.0-or-later |
| 版权网址: | 版权信息 |
详情介绍:
Tidy SEO AI Refresh scans all your published posts and pages, evaluates them against multiple SEO signals, and tells you exactly which content needs updating — and in what order.
Stop guessing which articles to refresh. Tidy SEO AI Refresh gives each post a priority score based on:
- Freshness — How long since the post was last updated
- Outdated years — References to past years in titles or content (e.g. "Best tools 2023")
- Thin content — Articles under 300 or 600 words
- Heading structure — Missing or insufficient H2 headings
- Images — Posts with no images
- Internal links — Posts with zero or few internal links
- FAQ section — Missing FAQ content
- Schema markup — Missing FAQ/HowTo structured data
- Alt text quality — Generic or missing image alt attributes
- Anchor text quality — Generic anchor text like "click here"
- Priority dashboard — Posts sorted by urgency: Critical, High, Medium, Low
- Health grade — Overall site content health from A (excellent) to E (needs work)
- Automatic weekly audits — Runs in the background via WP-Cron
- Per-post scoring — See exactly which signals are affecting each post
- Dashboard widget — Quick health overview right on your WordPress dashboard
- Batch processing — Handles large sites without timeout issues
- Cannibalization detection — Finds posts competing for the same keywords; identifies a pillar/hub or recommends creating one when 4+ posts share a topic
- Orphan page detection — Lists published posts that no other page links to
- Internal link suggestions — In the Gutenberg sidebar, get topically related posts to link from your draft (with 1-click insertion)
- FAQ block pattern with auto-schema — Insert a "FAQ section" pattern; FAQPage JSON-LD is emitted automatically (cached on save, no front-end overhead)
- Bulk anchor text rewrite — One click (or
wp tidy-seo-ai-refresh fix-anchors) replaces "click here" / "read more" with the linked target's title for internal links - Bad anchors / bad alt text reports — Dedicated dashboard tabs listing posts that need attention
- Utility page detection — Contact/About/Legal pages are scored against a relaxed template (they are short by design)
- Install and activate Tidy SEO AI Refresh
- Go to Tidy SEO AI Refresh > Dashboard
- Click "Run audit"
- Review your posts sorted by priority
- Start updating your most critical content
- Tidy Table of Contents — automatic, accessible table of contents
- Tidy Draft Share — share drafts via secure, expiring preview links
- Tidy Author Box — author bio box with avatar and social links
- Tidy Broken Link Scan — find broken links and images, no external service
安装:
- Upload the
tidy-seo-ai-refreshfolder to/wp-content/plugins/ - Activate the plugin through the Plugins menu
- Navigate to Tidy SEO AI Refresh in the admin sidebar
- Click "Run audit" to scan your content
屏幕截图:
常见问题:
How is the priority score calculated?
Each post is evaluated on ~10 SEO signals. Each signal adds points to the total score. Higher scores mean the post needs more urgent attention. Posts scoring 15+ are Critical, 10+ are High, 5+ are Medium, and below 5 are Low priority.
Does it slow down my site?
No. Tidy SEO AI Refresh only runs in the admin area and processes posts in small batches via WP-Cron to avoid timeouts. It does not affect frontend performance.
Which post types are audited?
Currently, posts and pages. Support for custom post types is planned for a future release.
Does it work with Yoast SEO or Rank Math?
Yes. Tidy SEO AI Refresh reads meta descriptions from Yoast SEO and Rank Math when available. It also detects Yoast FAQ and HowTo schema blocks.
How often does the automatic audit run?
Once per week via WP-Cron. You can also trigger a manual audit at any time from the dashboard.
Do I need an API key to use the plugin?
No. The audit, the scores, the orphan-page and cannibalization detection all run locally with no key and no external call. A Claude API key is only needed if you want the optional FAQ generation.
What is an orphan page?
A published page that no other page on your site links to. Search engines reach it only through the sitemap, and readers essentially never do. It is usually the cheapest SEO fix available: add a couple of internal links from related articles.
What is keyword cannibalization?
Two or more of your own pages competing for the same query. They split the clicks and the authority instead of concentrating them. The plugin groups the pages that overlap so you can merge them or differentiate them.
What does content decay mean here?
A post whose grade has dropped since the previous audit — because it aged, because references to past years became stale, or because its internal links disappeared. The dashboard flags what got worse rather than making you re-read everything.
Why is my score so low on a brand-new site?
The score rewards depth and internal linking, which a young site has not built yet. Short posts with no incoming links score low by design. Track the trend across audits rather than the absolute number.
Does the audit slow down my site?
No. It runs in the background in batches through WP-Cron, and nothing is computed while a visitor is loading a page. You can also switch it to manual only.
Can I import the keywords I already set in Yoast or Rank Math?
Yes, in one click from Settings. Focus keywords, secondary keywords and meta descriptions are copied over, and posts already scored by this plugin are skipped.
Is Google Search Console required?
No. Connecting it adds real impression and click data to the analysis, but every detection works without it.
更新日志:
1.7.7
- Fixed: the readability check was stuck on a half score for every post. It called a method that did not exist, so the guard around it always failed. Reading ease is now computed, with the Kandel & Moles coefficients on French sites.
- Fixed: the focus keyword is matched the way a search engine reads it. A plural ("short" vs "shorts") or a filler word ("sac à dos randonnée" vs "sac à dos de randonnée") no longer counts as a miss, and matching is case-insensitive on accented capitals.
- Fixed: the H1 check reads the post title when the content carries no
<h1>, which is what most themes render anyway. Posts were capped at half the weight with no way to fix it. - Changed: a check that cannot apply to a post now leaves the total instead of costing half its weight. This covers secondary keywords when none are set, and the two image checks on short posts.
- Changed: an article over 500 words with no image at all now fails the image checks rather than skipping them.
- Fixed: an alt attribute containing an apostrophe was read up to that apostrophe only, so the image counted as having no alt at all. This affected both the keyword checks and the "bad alt text" audit report.
- Fixed: the meta description is now read from the SEO plugin that is actually active. On a site migrated from Yoast to Rank Math, the leftover Yoast meta was scored instead of the description really served. A stored value made only of template variables (%%excerpt%%, %title%) counts as absent.
- Renamed to "Tidy SEO AI Refresh" (the descriptive suffix is gone from the display name).
- The posts-list grade styles and the settings importer script are now properly registered and enqueued instead of being printed inline.
- The
tsar_save_settingsaction receives an unslashed, sanitized copy of the submitted form instead of the raw$_POSTsuperglobal. - Editor-side REST endpoints (live keyword score, internal link suggestions) now check
edit_poston the target post instead ofmanage_options, so authors and editors can use the sidebar. Live scoring no longer writes the meta description as a side effect. - Post meta authorization is now checked per post rather than globally.
- The FAQ generator no longer sends a
temperatureparameter: recent Claude models reject sampling parameters, which made the request fail for anyone who had selected one in the settings. Grounding is enforced by the prompt. - Default Claude model updated to
claude-sonnet-5, and the documented default now matches the code. - The review prompt now waits for real usage: it only appears on the plugin screens, once at least three content audits have completed, and it states how many.
- WordPress.org coding-standards hardening: output escaping and translators comments for i18n placeholders (Plugin Check compliance).
- Added the required "External services" section to readme.txt documenting Google Search Console and Anthropic Claude API calls (WordPress.org guideline 6 compliance). No code change.
- Remove the
load_plugin_textdomain()call now that translations are auto-loaded by WordPress.org since WP 4.6.
- New WP-CLI command
wp tidy-seo-ai-refresh suggest-faq <post_id> [--apply] [--count=N] [--language=fr|en] [--model=<id>]— calls the Claude API to generate 3-5 questions a real reader would ask after reading the post, with concise answers grounded only in the post. Use without--applyto preview, with--applyto append the FAQ block to the post (a WP revision is created so you can roll back). - New settings card "Claude API" — API key (sk-ant-…) and model selector. Default model:
claude-haiku-4-5(fast and inexpensive). - New
--fix-externalflag onfix-anchors— also rewrites anchor text on external links using a host+slug heuristic. Built-in mappings for UTMB, Decathlon, Wikipedia, Strava, Western States, Hardrock, Diagonale des Fous, Santé Magazine, MovePainFree.
- New dashboard tabs Bad anchors and Bad images, listing affected posts with quick-edit links.
- New "Fix all internal anchors" button on the Bad anchors tab — replaces "click here" style anchors with the target post's title in one click. Skips external links (need human review).
- Cannibalization tab now surfaces hub detection: groups of 4+ competing posts highlight either an existing pillar (
merge_under_hub) or recommend creating one (create_hub) with a one-click "Create pillar page" button. - New WP-CLI command
wp tidy-seo-ai-refresh rebuild-faq-cache— backfills the FAQ schema cache on existing posts that already use the FAQ block pattern. - New REST endpoints
/bad-anchors,/bad-images,/link-suggestions/{post_id},/fix-anchorsfor programmatic access. - Refactor: extracted anchor rewriting into
TSAR_Anchor_Fixer(shared between WP-CLI and REST). - Tests: 28 new PHPUnit cases covering utility page detection, year cutoff, cannibalization tokenizer, FAQ extractor and link-suggester tokenizer.
- Perf:
wp_headno longer runsapply_filters('the_content')to detect FAQ structure. The FAQPage JSON-LD is computed once onsave_postand cached in post meta_tsar_faq_schema. Cheap regex pre-check (TSAR_FAQ::content_might_contain_faq) bails out before any DOM work — used both at save and during audits. - Removed all rendering and scaffolding code for premium-only features (AI rewrite, bulk rewrite queue, schedule publish, CSV export, rewrites database table). The free plugin now ships only the documented audit features. Premium features are implemented entirely in the companion Pro plugin via standard extension hooks (
tsar_dashboard_toolbar,tsar_dashboard_after_toolbar,tsar_dashboard_row_actions,tsar_dashboard_after_page,tsar_admin_localize_data,tsar_after_install).
- New "Suggested internal links" panel in the Gutenberg sidebar — fetches topically related posts (via focus/secondary keyword token overlap) and inserts a paragraph block with the link in 1 click.
- WP-CLI subcommands now use hyphens:
wp tidy-seo-ai-refresh fix-anchors(wasfix_anchors). Each subcommand is registered explicitly to keep the public command surface clean. - Scorer:
outdated_refsis bypassed for posts modified within the last 30 days — old years in the body are intentional when the author has just reviewed (book editions, historical references).outdated_titlestill triggers because the title is a public freshness signal.
- New
bad_anchors_jsonandbad_images_jsoncolumns intsar_scores— the scorer now persists the offending anchors/images so they can be queried in bulk. - New REST endpoints
/bad-anchorsand/bad-imageslisting posts with poor anchor text or missing/generic alt text. - New
TSAR_Link_Suggester— given a post ID, returns N candidate posts to link based on focus/secondary keyword overlap (Jaccard on tokens). Endpoint/link-suggestions/{post_id}. - New cannibalization hub detection: groups with 4+ posts that suggest merging now identify a pillar post (when a generic-titled candidate exists) or suggest creating a new one with a recommended title.
- New
TSAR_FAQ— block pattern "FAQ section (with auto schema)" plus automatic FAQPage JSON-LD emission. The scorer credits posts that use this pattern. - New WP-CLI command
wp tidy-seo-ai-refresh fix-anchors [--dry-run] [--limit=N]to bulk-replace generic anchors with the linked target's title (internal links only).
- New content type
utilityautomatically detected for boilerplate pages (Contact, About, Legal, T&C, Privacy, Sitemap, Jobs, Contributors). Editorial signals (thin content, missing FAQ, schema, internal links, alt text) are zeroed-out for these pages — only freshness, outdated references and generic anchors remain. Utility pages no longer dominate the Critical list. outdated_refscutoff is now dynamic: only years older thancurrent_year - 2are flagged. Recent years (2024/2025/2026 in 2026) are no longer false positives in book editions, comparisons, etc.- Cannibalization tokenizer now strips 4-digit years (1900-2099) from n-grams so unrelated comparison articles published the same year (e.g. "trail 2026", "vélo comparatif 2026") are no longer grouped together.
- Added a Rank Math / Yoast-style per-post keyword scorer: focus keyword + secondary keywords + meta description, weighted across 21 SEO checks (keyword in title/slug/H1/first paragraph/meta-desc/body/density/sub-headings/alt; title length, meta-desc length, slug length, title-starts-with-focus, sub-headings, min word count, alt text filled, internal/outbound links, readability).
- New per-post A–E grade pill in the posts list (sortable column).
- New classic-editor meta box with live checks as you type.
- New Gutenberg block-editor sidebar with the same live grade and checklist.
- New REST endpoint
/score-live(used by the metabox + sidebar). - New importer from Rank Math and Yoast SEO (focus + secondary keywords + meta description) — admin button + WP-CLI command (
wp tidy-seo-ai-refresh import rankmath|yoast). - New WP-CLI command
wp tidy-seo-ai-refresh rescoreto re-run the scorer on every post.
- Removed all licence checks and premium-feature gating from the free plugin code (AI rewriter, bulk rewriter, scheduled publishing and CSV export are now distributed via a separate companion plugin).
- Added extension hooks for add-on plugins (
tsar_settings_form_extra,tsar_settings_sidebar,tsar_admin_localize_data,tsar_plugin_action_links,tsar_save_settings,tsar_is_pro).
- Initial release
- Content scoring engine with 10+ SEO signals
- Priority dashboard with health grade (A-E)
- Automatic weekly audits via WP-Cron
- Dashboard widget for quick health overview
- REST API for programmatic access
- Batch processing for large sites