Skip to main content
Glama

RevenueScope: revenue-first analytics for your EC site

by io.github.toshihiroshishido
OverviewDiscussionsAdmin

Content actions (classify pages + playbook)

get_content_actions
Read-only

Return content action buckets and page evidence. By default the window length is N=7 days and GSC data is delayed by 3 days. To choose a window, pass start_date and end_date together: end_date must be today's date in Japan time, and N is end_date minus start_date (2-365 days; e.g. September 21 through September 28 sets N=7), so the pair describes a length ending today rather than the GSC source dates. The response separates window (actual JST GSC dates, inclusive) from session_window (sessions, revenue and AI metrics over N×24 hours ending at database statement time). session_window gives the relative start/end and duration; exact timestamps are unavailable because the RPC does not return its now() value. Search classifications, thresholds, bucket_summary, row prioritization, caveats and limits are included in the response. A page carries title_change when its title was rewritten within the last 8 weeks (detected from the titles the tracker recorded): do not recommend another title rewrite for it while it is tracked, and read a rank change since the rewrite as a before/after comparison, not proof of effect. The app's home screen takes such pages off its to-do list, but this tool keeps them and their order in pages and only adds the mark; title_changes.status is 'unavailable' when the marks could not be read. Revenue values (revenue_jpy, ai_revenue_jpy, expected_revenue_gain and the bucket_summary revenue_jpy) are null when revenue_status is 'unconfirmed': null means unverified, not 0 yen. site_id is optional when OAuth-authenticated (omitting it uses the primary site). When the user names a specific site, such as the sample site, call list_sites first and pass that site_id. Google Search only; data lags 1-2 days.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
limitNo
bucketNo
site_idNo
end_dateNo
start_dateNo

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
basisYes
notesNo
pagesYes
periodYes
windowYes
site_idYes
warningNo
criteriaYes
truncatedNo
assumptionsYes
limitationsYes
total_pagesYes
title_changesYes
bucket_summaryYes
revenue_statusYes
session_windowYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • addedOutput schema / properties / pages / items / properties / title_change
      Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "measuring": {
+      "type": "boolean"
+    },
+    "new_first_date": {
+      "type": "string"
+    },
+    "new_title": {
+      "type": "string"
+    },
+    "old_last_date": {
+      "type": "string"
+    },
+    "old_title": {
+      "type": "string"
+    },
+    "tracking_week": {
+      "maximum": 8,
+      "minimum": 1,
+      "type": "integer"
+    }
+  },
+  "required": [
+    "new_first_date",
+    "old_last_date",
+    "old_title",
+    "new_title",
+    "tracking_week",
+    "measuring"
+  ],
+  "type": "object"
+}
    • addedOutput schema / properties / title_changes
      Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "basis": {
+      "type": "string"
+    },
+    "marked_pages": {
+      "minimum": 0,
+      "type": "integer"
+    },
+    "record_days": {
+      "type": "number"
+    },
+    "status": {
+      "enum": [
+        "available",
+        "unavailable"
+      ],
+      "type": "string"
+    }
+  },
+  "required": [
+    "status",
+    "record_days",
+    "marked_pages",
+    "basis"
+  ],
+  "type": "object"
+}
    • changedOutput schema / required
      Previous value: -[
-  "site_id",
-  "revenue_status",
-  "period",
-  "window",
-  "session_window",
-  "basis",
-  "assumptions",
-  "limitations",
-  "criteria",
-  "bucket_summary",
-  "total_pages",
-  "pages"
-]New value: +[
+  "site_id",
+  "revenue_status",
+  "period",
+  "window",
+  "session_window",
+  "basis",
+  "assumptions",
+  "limitations",
+  "criteria",
+  "bucket_summary",
+  "total_pages",
+  "pages",
+  "title_changes"
+]
  2. Changed6 schema fields changed
    • changedOutput schema / properties / bucket_summary / properties / decaying / properties / revenue_jpy / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • addedOutput schema / properties / notes
      Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}
    • changedOutput schema / properties / pages / items / properties / ai_revenue_jpy / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • changedOutput schema / properties / pages / items / properties / revenue_jpy / type
      Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
    • addedOutput schema / properties / revenue_status
      Added value: +{
+  "enum": [
+    "confirmed",
+    "unconfirmed"
+  ],
+  "type": "string"
+}
    • changedOutput schema / required
      Previous value: -[
-  "site_id",
-  "period",
-  "window",
-  "session_window",
-  "basis",
-  "assumptions",
-  "limitations",
-  "criteria",
-  "bucket_summary",
-  "total_pages",
-  "pages"
-]New value: +[
+  "site_id",
+  "revenue_status",
+  "period",
+  "window",
+  "session_window",
+  "basis",
+  "assumptions",
+  "limitations",
+  "criteria",
+  "bucket_summary",
+  "total_pages",
+  "pages"
+]
  3. Changed5 schema fields changed
    • addedInput schema / properties / end_date
      Added value: +{
+  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+  "type": "string"
+}
    • removedInput schema / properties / period
      Removed value: -{
-  "anyOf": [
-    {
-      "const": "7d",
-      "type": "string"
-    },
-    {
-      "const": "30d",
-      "type": "string"
-    },
-    {
-      "const": "90d",
-      "type": "string"
-    },
-    {
-      "maximum": 365,
-      "minimum": 2,
-      "type": "integer"
-    }
-  ],
-  "default": "7d"
-}
    • addedInput schema / properties / start_date
      Added value: +{
+  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+  "type": "string"
+}
    • addedOutput schema / properties / session_window
      Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "basis": {
+      "const": "database_statement_time",
+      "type": "string"
+    },
+    "duration_days": {
+      "maximum": 365,
+      "minimum": 2,
+      "type": "integer"
+    },
+    "duration_hours": {
+      "maximum": 8760,
+      "minimum": 48,
+      "type": "integer"
+    },
+    "exact_timestamps_available": {
+      "const": false,
+      "type": "boolean"
+    },
+    "from_relative": {
+      "type": "string"
+    },
+    "to_relative": {
+      "const": "now()",
+      "type": "string"
+    }
+  },
+  "required": [
+    "basis",
+    "duration_days",
+    "duration_hours",
+    "from_relative",
+    "to_relative",
+    "exact_timestamps_available"
+  ],
+  "type": "object"
+}
    • changedOutput schema / required
      Previous value: -[
-  "site_id",
-  "period",
-  "window",
-  "basis",
-  "assumptions",
-  "limitations",
-  "criteria",
-  "bucket_summary",
-  "total_pages",
-  "pages"
-]New value: +[
+  "site_id",
+  "period",
+  "window",
+  "session_window",
+  "basis",
+  "assumptions",
+  "limitations",
+  "criteria",
+  "bucket_summary",
+  "total_pages",
+  "pages"
+]
  4. Changed7 schema fields changed
    • addedOutput schema / properties / criteria / properties / expected_revenue_gain
      Added value: +{
+  "type": "string"
+}
    • addedOutput schema / properties / criteria / properties / expected_sessions_gain
      Added value: +{
+  "type": "string"
+}
    • addedOutput schema / properties / criteria / properties / priority
      Added value: +{
+  "type": "string"
+}
    • changedOutput schema / properties / criteria / required
      Previous value: -[
-  "provisional",
-  "comparison",
-  "significant_clicks_delta",
-  "position_worsening",
-  "striking_band",
-  "striking_clicks_below",
-  "dormant",
-  "landing_attribution",
-  "caveat_flags"
-]New value: +[
+  "provisional",
+  "comparison",
+  "significant_clicks_delta",
+  "position_worsening",
+  "striking_band",
+  "striking_clicks_below",
+  "dormant",
+  "landing_attribution",
+  "priority",
+  "expected_sessions_gain",
+  "expected_revenue_gain",
+  "caveat_flags"
+]
    • addedOutput schema / properties / pages / items / properties / expected_revenue_gain
      Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}
    • addedOutput schema / properties / pages / items / properties / expected_sessions_gain
      Added value: +{
+  "type": "number"
+}
    • changedOutput schema / properties / pages / items / required
      Previous value: -[
-  "page",
-  "action",
-  "confidence",
-  "caveats",
-  "is_new",
-  "cur_clicks",
-  "cur_impressions",
-  "cur_position",
-  "prev_clicks",
-  "prev_impressions",
-  "prev_position",
-  "main_query_position",
-  "striking_uplift_clicks",
-  "striking_query_count",
-  "striking_queries",
-  "sessions",
-  "engaged",
-  "revenue_jpy",
-  "ai_sessions",
-  "ai_revenue_jpy",
-  "ai_sources",
-  "clicks_threshold"
-]New value: +[
+  "page",
+  "action",
+  "confidence",
+  "caveats",
+  "is_new",
+  "cur_clicks",
+  "cur_impressions",
+  "cur_position",
+  "prev_clicks",
+  "prev_impressions",
+  "prev_position",
+  "main_query_position",
+  "striking_uplift_clicks",
+  "striking_query_count",
+  "striking_queries",
+  "sessions",
+  "engaged",
+  "revenue_jpy",
+  "ai_sessions",
+  "ai_revenue_jpy",
+  "ai_sources",
+  "clicks_threshold",
+  "expected_sessions_gain",
+  "expected_revenue_gain"
+]
  5. Changed10 schema fields changed
    • addedInput schema / properties / bucket
      Added value: +{
+  "enum": [
+    "decaying",
+    "striking",
+    "rising",
+    "dormant",
+    "stable"
+  ],
+  "type": "string"
+}
    • addedOutput schema / properties / bucket_summary
      Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "decaying": {
+      "additionalProperties": false,
+      "properties": {
+        "clicks": {
+          "type": "number"
+        },
+        "count": {
+          "type": "number"
+        },
+        "revenue_jpy": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "count",
+        "revenue_jpy",
+        "clicks"
+      ],
+      "type": "object"
+    },
+    "dormant": {
+      "$ref": "#/properties/bucket_summary/properties/decaying"
+    },
+    "rising": {
+      "$ref": "#/properties/bucket_summary/properties/decaying"
+    },
+    "stable": {
+      "$ref": "#/properties/bucket_summary/properties/decaying"
+    },
+    "striking": {
+      "$ref": "#/properties/bucket_summary/properties/decaying"
+    }
+  },
+  "required": [
+    "decaying",
+    "striking",
+    "rising",
+    "dormant",
+    "stable"
+  ],
+  "type": "object"
+}
    • addedOutput schema / properties / criteria / properties / caveat_flags
      Added value: +{
+  "additionalProperties": {
+    "type": "string"
+  },
+  "type": "object"
+}
    • changedOutput schema / properties / criteria / required
      Previous value: -[
-  "provisional",
-  "comparison",
-  "significant_clicks_delta",
-  "position_worsening",
-  "striking_band",
-  "striking_clicks_below",
-  "dormant",
-  "landing_attribution"
-]New value: +[
+  "provisional",
+  "comparison",
+  "significant_clicks_delta",
+  "position_worsening",
+  "striking_band",
+  "striking_clicks_below",
+  "dormant",
+  "landing_attribution",
+  "caveat_flags"
+]
    • addedOutput schema / properties / pages / items / properties / caveats
      Added value: +{
+  "items": {
+    "enum": [
+      "geo_winning_suspect",
+      "zero_click_suspect",
+      "ai_cited"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}
    • addedOutput schema / properties / pages / items / properties / confidence
      Added value: +{
+  "enum": [
+    "high",
+    "low"
+  ],
+  "type": "string"
+}
    • changedOutput schema / properties / pages / items / required
      Previous value: -[
-  "page",
-  "action",
-  "is_new",
-  "cur_clicks",
-  "cur_impressions",
-  "cur_position",
-  "prev_clicks",
-  "prev_impressions",
-  "prev_position",
-  "main_query_position",
-  "striking_uplift_clicks",
-  "striking_query_count",
-  "striking_queries",
-  "sessions",
-  "engaged",
-  "revenue_jpy",
-  "ai_sessions",
-  "ai_revenue_jpy",
-  "ai_sources",
-  "clicks_threshold"
-]New value: +[
+  "page",
+  "action",
+  "confidence",
+  "caveats",
+  "is_new",
+  "cur_clicks",
+  "cur_impressions",
+  "cur_position",
+  "prev_clicks",
+  "prev_impressions",
+  "prev_position",
+  "main_query_position",
+  "striking_uplift_clicks",
+  "striking_query_count",
+  "striking_queries",
+  "sessions",
+  "engaged",
+  "revenue_jpy",
+  "ai_sessions",
+  "ai_revenue_jpy",
+  "ai_sources",
+  "clicks_threshold"
+]
    • addedOutput schema / properties / total_pages
      Added value: +{
+  "type": "number"
+}
    • addedOutput schema / properties / truncated
      Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "guidance": {
+      "type": "string"
+    },
+    "omitted_pages": {
+      "type": "number"
+    }
+  },
+  "required": [
+    "omitted_pages",
+    "guidance"
+  ],
+  "type": "object"
+}
    • changedOutput schema / required
      Previous value: -[
-  "site_id",
-  "period",
-  "window",
-  "basis",
-  "assumptions",
-  "limitations",
-  "criteria",
-  "pages"
-]New value: +[
+  "site_id",
+  "period",
+  "window",
+  "basis",
+  "assumptions",
+  "limitations",
+  "criteria",
+  "bucket_summary",
+  "total_pages",
+  "pages"
+]
  6. Added

TDQS

Score is being calculated.

All RevenueScope: revenue-first analytics for your EC site toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources