Skip to main content
Glama

RevenueScope: revenue-first analytics for your EC site

Page search trend over time

get_page_trend
Read-only

Return how ONE page's Google Search performance changed over time. Pass start_date and end_date together as inclusive JST dates; comparison dates are not supported. Or pass preset (last_4_weeks, last_12_weeks or year_to_date) for the same periods as the app's period picker: the period ends on the last Saturday that closes a complete week (weeks run Sunday to Saturday, judged in the site time zone), and year_to_date starts on January 1 of the year of that Saturday; preset cannot be combined with start_date or end_date, and period.preset echoes it. Omitting all of them preserves the current now-minus-30-days rolling window, which may touch 31 JST dates because GSC filters by date inclusively. Explicit dates are converted to JST day boundaries for GSC rows. granularity defaults to day for windows up to about 35 days and week for longer windows; pass it to override. Weeks run Sunday to Saturday and each weekly date is that week's Sunday; weeks at the edge of the period hold only the days inside it. Buckets without GSC rows are omitted. Google-search only; data lags 1-2 days. 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. For cross-page snapshots use get_breakdown(dimension='page'); for query trends use get_keyword_performance.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
pageYes
presetNo
site_idNo
end_dateNo
start_dateNo
granularityNo

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
pageYes
basisYes
periodYes
seriesYes
site_idYes
summaryYes
warningNo
assumptionsYes
granularityYes
limitationsYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedInput schema / properties / preset
      Added value: +{
      +  "enum": [
      +    "last_4_weeks",
      +    "last_12_weeks",
      +    "year_to_date"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / period / properties / preset
      Added value: +{
      +  "enum": [
      +    "last_4_weeks",
      +    "last_12_weeks",
      +    "year_to_date"
      +  ],
      +  "type": "string"
      +}
  2. Changed3 schema fields changed
    • addedInput schema / properties / end_date
      Added value: +{
      +  "$ref": "#/properties/start_date"
      +}
    • removedInput schema / properties / period
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "const": "today",
      -      "type": "string"
      -    },
      -    {
      -      "const": "7d",
      -      "type": "string"
      -    },
      -    {
      -      "const": "30d",
      -      "type": "string"
      -    },
      -    {
      -      "const": "90d",
      -      "type": "string"
      -    },
      -    {
      -      "maximum": 365,
      -      "minimum": 1,
      -      "type": "integer"
      -    }
      -  ],
      -  "default": "30d"
      -}
    • addedInput schema / properties / start_date
      Added value: +{
      +  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      +  "type": "string"
      +}
  3. Added

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources