Title: RLabs Search Performance Advisor
Author: kazn0317
Published: <strong>Июнь 3, 2026</strong>
Last modified: Июнь 3, 2026

---

Search plugins

![](https://ps.w.org/rlabs-search-performance-advisor/assets/icon-256x256.png?rev
=3560077)

# RLabs Search Performance Advisor

 By [kazn0317](https://profiles.wordpress.org/kazn0317/)

[Download](https://downloads.wordpress.org/plugin/rlabs-search-performance-advisor.0.1.3.zip)

 * [Details](https://os.wordpress.org/plugins/rlabs-search-performance-advisor/#description)
 * [Reviews](https://os.wordpress.org/plugins/rlabs-search-performance-advisor/#reviews)
 *  [Installation](https://os.wordpress.org/plugins/rlabs-search-performance-advisor/#installation)
 * [Development](https://os.wordpress.org/plugins/rlabs-search-performance-advisor/#developers)

 [Support](https://wordpress.org/support/plugin/rlabs-search-performance-advisor/)

## Description

RLabs Search Performance Advisor is a WordPress admin tool that:

 * Connects directly to Google Search Console and Google Analytics 4 through your
   own Google Cloud OAuth client.
 * Generates an AI overview of the selected period (sessions, channels, top pages,
   top queries, goal-page progress, notable changes), based on the actual numbers,
   not on guesses.
 * Lets you ask follow-up questions in plain language (How did /pricing do yesterday?”,
   Which queries dropped this week?”). The AI calls Search Console / GA4 with the
   period you are currently viewing.
 * Produces a printable HTML report (use your browser’s Print  Save as PDF”) that
   bundles site info, AI overview, key tables, and a factual summary of your Q&A.
 * Supports a plain-language tone (no jargon — click-through rate” instead of CTR”,
   visits” instead of sessions”) or an expert tone for users comfortable with SEO/
   analytics vocabulary.
 * Caches results per period for 24 hours; refetch on demand.
 * Available in Japanese (source language) and English (en_US). UI strings follow
   WordPress’s locale; AI replies follow the same locale.

#### External services this plugin uses

This plugin sends data to the following external services on your behalf. Please
review before installing.

 1. Google APIs (oauth2.googleapis.com, searchconsole.googleapis.com, analyticsdata.
    googleapis.com, analyticsadmin.googleapis.com)
 2.  * What is sent: OAuth tokens, the Search Console site URL or GA4 property ID you
       connect, and query parameters (date ranges, dimensions, metrics).
     * When: When you click Connect to Google”, Refetch data”, Generate overview”, 
       Ask AI”, or open a report.
     * Terms / privacy: [https://policies.google.com/terms](https://policies.google.com/terms)/
       [https://policies.google.com/privacy](https://policies.google.com/privacy).
 3. AI provider configured via the WordPress AI plugin. Depending on which provider
    you connected under Settings  Connectors, this plugin’s Generate overview” / Ask
    AI” actions will cause the WordPress AI Client to call one of the following endpoints
    on your behalf:
 4.  * Anthropic Claude API — host `api.anthropic.com`. Terms: [https://www.anthropic.com/legal/consumer-terms](https://www.anthropic.com/legal/consumer-terms).
       Privacy: [https://www.anthropic.com/legal/privacy](https://www.anthropic.com/legal/privacy).
     * OpenAI API — host `api.openai.com`. Terms: [https://openai.com/policies/row-terms-of-use/](https://openai.com/policies/row-terms-of-use/).
       Privacy: [https://openai.com/policies/row-privacy-policy/](https://openai.com/policies/row-privacy-policy/).
     * Google Generative Language API — host `generativelanguage.googleapis.com`. Terms:
       [https://policies.google.com/terms](https://policies.google.com/terms). Privacy:
       [https://policies.google.com/privacy](https://policies.google.com/privacy).
     * What is sent: a system instruction (your site URL, the purpose / goal pages /
       monthly goal you configured in Site Settings, your selected period, audience
       tone setting), your question or the overview prompt, prior conversation turns
       in the same session, and tool-call results pulled from Search Console / GA4.
     * When: every time Generate overview” or Ask AI” is invoked.

You must enable the relevant Google APIs (Search Console API, Google Analytics Data
API, Google Analytics Admin API) and set up your own OAuth 2.0 client in your own
Google Cloud project. API usage, quotas, and billing remain under your control.

## Installation

#### Step A. Install and activate the plugin

 1. Download the plugin .zip and go to Plugins  Add New  Upload Plugin” in your WordPress
    admin, or copy the plugin folder into /wp-content/plugins/.
 2. Activate RLabs Search Performance Advisor” from the Plugins screen.

#### Step B. Make sure an AI provider is available

This plugin relies on the WordPress AI Client (the function wp_ai_client_prompt()
and its tool-use API) and at least one configured AI connector.

 1. Install and activate the official AI” plugin (slug: ai, https://wordpress.org/plugins/
    ai/) if the AI Client is not already bundled in your WordPress build.
 2. Open Settings  Connectors” and add at least one provider (Anthropic, OpenAI, or
    Google), supplying that provider’s own API key.
 3. Confirm the connector shows as healthy. Without a working connector, Generate overview”
    and Ask AI” will not run.

#### Step C. Create your own Google Cloud project and OAuth client

The plugin talks to Google APIs using credentials in your own Google Cloud project.
Nothing is proxied through a third party.

 1. Go to https://console.cloud.google.com/ and create a new project (or select an 
    existing one).
 2. In APIs & Services  Library”, enable the following APIs for that project:
 3.  * Search Console API
     * Google Analytics Data API
     * Google Analytics Admin API (optional — needed only if you want the GA4 property
       dropdown inside the plugin)
 4. Configure the OAuth consent screen at APIs & Services  OAuth consent screen”:
 5.  * User type: External (or Internal, if your domain is on Google Workspace).
     * Add at least one test user — the Google account that has access to your Search
       Console property and your GA4 property.
     * Verification is not required while the app stays in Testing” mode and only listed
       test users connect.
 6. Create an OAuth 2.0 Client ID at APIs & Services  Credentials  Create credentials
    OAuth client ID”:
 7.  * Application type: Web application.
     * Authorized JavaScript origins: leave blank.
     * Authorized redirect URIs: paste the exact URI shown in RLabs Search Performance
       Advisor  Connection Settings  Step 2” inside your WordPress admin. A single-
       character mismatch causes a redirect_uri_mismatch error.

#### Step D. Connect WordPress to Google

 1. In WordPress admin, open RLabs Search Performance Advisor  Connection Settings”.
 2. In Step 3 of that screen, paste the Client ID and Client Secret from Google Cloud
    Console, then save.
 3. In Step 4, click Connect to Google”, sign in with the Google account that has access
    to your Search Console property and GA4 property, and approve the read-only scopes(
    analytics.readonly, webmasters.readonly).
 4. You should be redirected back to the plugin with Connected” shown. If you see redirect_uri_mismatch”,
    recheck Step C-4.

#### Step E. Pick the GA4 property and the Search Console site

 1. In RLabs Search Performance Advisor  Connection Settings”, scroll to Data source
    selection (GA4 / Search Console)”.
 2. Choose the GA4 property (numeric ID) for this site. If the dropdown is empty, enable
    the Google Analytics Admin API (see Step C-2) and reload after a few minutes, or
    enter the property ID manually (you can find it under GA4 Admin  Property Settings).
 3. Choose the Search Console property (URL-prefix property or Domain property) for
    this site. The auto-detect option matches the WordPress site host against your 
    available Search Console properties.
 4. Save. Saving discards any cached analysis results so the next page load refetches
    under the new property / site.

#### Step F. Configure site goals

 1. Open RLabs Search Performance Advisor  Site Settings”.
 2. Primary purpose of this site: describe what the site is for in your own words (
    e.g. Get renovation quote requests; the top priority is increasing inquiries from
    organic search.”). This is injected into the AI system instruction.
 3. Goal pages: one path per line. Pages that count as a conversion when reached (e.
    g. /contact/thanks, /quote/done). A leading slash is added automatically if missing.
 4. Monthly goal: how many goal-page hits you want per month. 0 means the goal is unset.
 5. Explanation level: pick Explain in plain language” for jargon-free output, or Jargon
    OK, concise” for SEO-savvy users. This affects both Overview and Ask AI replies.
 6. Save.

#### Step G. Run an analysis

 1. Open RLabs Search Performance Advisor  Site Analysis”.
 2. Pick a date range from the picker (Past 7 / 28 / 30 / 90 days, This / Last month,
    This / Last week, This quarter, This / Last year, or Custom). The dashboard widget
    is fixed to the past 28 days.
 3. Search Console and GA4 summary tables are fetched automatically and cached for 
    10 minutes. Click Refetch data” to force a refresh.
 4. Click Generate overview” to have the AI produce a six-section summary for the selected
    period (traffic, channels, top pages, top queries, goal-page status, notable changes).
    Results are cached per period for 24 hours.
 5. Use Ask AI” to ask follow-up questions in natural language. The AI remembers the
    conversation within the session, so follow-ups like What about yesterday?” or Show
    me the #3 page in more detail” work as-is. Click Reset conversation” to clear it.
 6. Click Open report (print to save as PDF)” to open a printable, single-page report.
    Use your browser’s Print  Save as PDF.

## FAQ

### Why do I need to create my own Google Cloud OAuth client?

So that API usage, quotas, billing, and permissions remain under the site owner’s
control. The plugin never proxies your data through a third party — your WordPress
site talks to Google APIs directly using your own credentials.

### What data leaves my site?

Two things:

 1. Google API calls (date ranges, dimensions, metrics, the configured property / site
    URL) signed with your OAuth tokens.
 2. AI provider calls — your question text, prior turns in the same Ask-AI session,
    the system instruction (your site URL, your Site Settings values, your selected
    period and tone), and the Search Console / GA4 numbers fetched to answer the question.

See External services this plugin uses” in the Description for details.

### Which AI model is used?

Whichever model you configured in Settings  Connectors via the WordPress AI plugin.
This plugin does not bundle or call any AI provider directly.

### Is the plugin free?

Yes. You may incur costs at your own Google Cloud project (the Search Console / 
GA4 APIs have a generous free quota for typical sites) and at your AI provider depending
on its pricing.

### What languages are supported?

The plugin source language is Japanese. An English (en_US) translation is bundled.
The AI replies in the same language as your active WordPress locale.

### My report shows no data” for a section. What does that mean?

The plugin refuses to guess. If Google APIs returned no rows for that section in
the selected period, the AI marks it as no data” rather than inventing numbers.

### Why do I need to re-authorize after some time?

Google access tokens are short-lived. The plugin stores a refresh token and renews
access tokens automatically. If the refresh token is revoked (e.g. you change Google
Cloud project, withdraw scope grants, or hit Google’s inactivity policy), the plugin
will ask you to reconnect.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“RLabs Search Performance Advisor” is open source software. The following people
have contributed to this plugin.

Contributors

 *   [ kazn0317 ](https://profiles.wordpress.org/kazn0317/)

[Translate “RLabs Search Performance Advisor” into your language.](https://translate.wordpress.org/projects/wp-plugins/rlabs-search-performance-advisor)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/rlabs-search-performance-advisor/),
check out the [SVN repository](https://plugins.svn.wordpress.org/rlabs-search-performance-advisor/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/rlabs-search-performance-advisor/)
by [RSS](https://plugins.trac.wordpress.org/log/rlabs-search-performance-advisor/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 0.1.3

 * Fix: Replaced legacy `ai_improvement_advisor_*` filter hook names (left over 
   from the original plugin name) with the current `rlspa_*` prefix to align all
   internal identifiers with the plugin’s unique prefix and avoid the reserved/common-
   word prefix `ai`.

#### 0.1.2

 * Improve: Search Console table titles now show (Search Console)” as a smaller 
   subtitle so users can tell at a glance which data source each table reflects.
 * Improve: 上位クエリ” renamed to 上位クエリ（キーワード）” for clarity.
 * Add: GA4 Users by city” table (city dimension) showing user count, sessions, 
   page views, and engagement rate.
 * Fix: GA4 top-pages table now includes the user count column (was missing because
   totalUsers metric was not requested).
 * Fix: GA4 channel breakdown table now includes the page views column (was missing
   because screenPageViews metric was not requested).

#### 0.1.1

 * Fix: Page URLs containing multibyte characters (Japanese, Chinese, Korean, etc.)
   were corrupted in the Search Console top-pages list because percent-encoded octets
   were stripped during row normalization. Page URLs are now preserved with `esc_url_raw()`,
   so the displayed URLs and the data passed to the AI match the actual pages.
 * Improve: Top-pages tables now display URLs decoded (e.g. Japanese paths shown
   as Japanese characters instead of %E3%81%8C…”), as clickable links, and wrap 
   properly within the cell.

#### 0.1.0

 * Initial release.
 * Direct Google OAuth integration with Search Console API and GA4 Data API (no 
   Site Kit dependency).
 * AI overview generation (period-aware, no recommendations — facts only).
 * Ask AI question form with multi-turn conversation memory.
 * Date range picker (Past 7 / 28 / 30 / 90 days, This / Last month, This / Last
   week, This quarter, This / Last year, custom).
 * Printable HTML report (browser-native print  PDF).
 * GA4 property and Search Console site selectors.
 * Site Settings: purpose, goal pages, monthly goal, explanation level (plain-language/
   expert).
 * Japanese (source) and English (en_US) UI and AI replies.

## Meta

 *  Version **0.1.3**
 *  Last updated **4 боны ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 7.0 or higher **
 *  Tested up to **7.0**
 *  PHP version ** 7.4 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/rlabs-search-performance-advisor/)
 * Tags
 * [AI](https://os.wordpress.org/plugins/tags/ai/)[analytics](https://os.wordpress.org/plugins/tags/analytics/)
   [reports](https://os.wordpress.org/plugins/tags/reports/)[Search Console](https://os.wordpress.org/plugins/tags/search-console/)
   [seo](https://os.wordpress.org/plugins/tags/seo/)
 *  [Advanced View](https://os.wordpress.org/plugins/rlabs-search-performance-advisor/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/rlabs-search-performance-advisor/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/rlabs-search-performance-advisor/reviews/)

## Contributors

 *   [ kazn0317 ](https://profiles.wordpress.org/kazn0317/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/rlabs-search-performance-advisor/)