RevenueScope: revenue-first analytics for your EC site

Peer shop keywords (external search snapshot)

get_competitor_keywords

Read-only

Return the keywords where the site's PEER SHOPS (up to 3 shops of a similar size that compete for the same searches) rank in Google's top 10 (Japan/ja), each listed beside the site's OWN rank, from the latest completed research of third-party search-result data. READ-ONLY — this tool never starts a research (a research is started from the search screen of the RevenueScope app and uses a monthly allowance); it only reads what was already fetched. The values equal the app's search screen ("Rank breakdown"); nothing is recounted. counts (total/top/near/out/unknown) always cover ALL keywords, independent of band and limit. keywords returns limit keywords (default 10, max 100) ordered by monthly search_volume (high first), starting at offset; truncated ({shown, matching_total, next_offset}) says whether more remain (a large limit can exceed the default output budget; page with offset instead). band filters by the site's own rank: top = 1-3, near = 4-20, out = 21 or lower or not in the top 100, unknown = the own rank could not be fetched (unknown is NOT out). Each keyword has own_rank / own_status (ranked | not_in_top100 | unknown) / own_url, top_domain and top_rank (the best peer), and every peer's rank in peers. shops lists the peer shops (scale_ratio is an estimated ratio of search traffic, not of revenue or visits; fetch_failed marks a shop whose fetch failed). Ranks are organic-result positions 1-100 and are NOT comparable with the ranks this tool returned before v7. No rank change, ETV or CPC is returned, and no previous research is compared. When the site has NO completed research of this kind the response is { researched:false } with a guidance string. site_id is OPTIONAL when OAuth-authenticated. For YOUR OWN search performance use get_keyword_performance, and for your content playbook use get_content_actions.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`band`	No
`limit`	No
`offset`	No
`site_id`	No

Output Schema

TableJSON Schema

Name	Required	Description	Default
`band`	No
`basis`	Yes
`limit`	No
`notes`	No
`shops`	No
`counts`	No
`offset`	No
`guidance`	No
`keywords`	No
`truncated`	No
`fetch_rule`	No
`fetched_at`	No
`own_domain`	No
`researched`	Yes
`assumptions`	Yes
`limitations`	Yes
`research_id`	No
`rule_params`	No
`own_complete`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed23 schema fields changedOct 11, 2026

addedInput schema / properties / band

Added value: +{
+  "enum": [
+    "all",
+    "top",
+    "near",
+    "out",
+    "unknown"
+  ],
+  "type": "string"
+}

removedInput schema / properties / domain

Removed value: -{
-  "minLength": 1,
-  "type": "string"
-}

removedInput schema / properties / min_volume

Removed value: -{
-  "minimum": 0,
-  "type": "integer"
-}

addedInput schema / properties / offset

Added value: +{
+  "minimum": 0,
+  "type": "integer"
+}

removedInput schema / properties / sort

Removed value: -{
-  "enum": [
-    "etv",
-    "volume",
-    "rank"
-  ],
-  "type": "string"
-}

removedOutput schema / properties / available_domains

Removed value: -{
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}

addedOutput schema / properties / band

Added value: +{
+  "enum": [
+    "all",
+    "top",
+    "near",
+    "out",
+    "unknown"
+  ],
+  "type": "string"
+}

addedOutput schema / properties / counts

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "near": {
+      "type": "number"
+    },
+    "out": {
+      "type": "number"
+    },
+    "top": {
+      "type": "number"
+    },
+    "total": {
+      "type": "number"
+    },
+    "unknown": {
+      "type": "number"
+    }
+  },
+  "required": [
+    "total",
+    "top",
+    "near",
+    "out",
+    "unknown"
+  ],
+  "type": "object"
+}

removedOutput schema / properties / domains

Removed value: -{
-  "items": {
-    "additionalProperties": false,
-    "properties": {
-      "domain": {
-        "type": "string"
-      },
-      "keywords": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "change": {
-              "enum": [
-                "new",
-                "improved",
-                "declined",
-                "same",
-                "unknown"
-              ],
-              "type": "string"
-            },
-            "cpc": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "etv": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "keyword": {
-              "type": "string"
-            },
-            "prev_rank": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "rank": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "rank_delta": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "search_volume": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "serp_item_type": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "serp_url": {
-              "type": [
-                "string",
-                "null"
-              ]
-            }
-          },
-          "required": [
-            "keyword",
-            "rank",
-            "search_volume",
-            "cpc",
-            "etv",
-            "serp_url",
-            "serp_item_type",
-            "prev_rank",
-            "rank_delta",
-            "change"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "lost_keywords": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "etv": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "keyword": {
-              "type": "string"
-            },
-            "prev_rank": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "search_volume": {
-              "type": [
-                "number",
-                "null"
-              ]
-            }
-          },
-          "required": [
-            "keyword",
-            "prev_rank",
-            "search_volume",
-            "etv"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "previous": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "fetched_at": {
-                "type": "string"
-              },
-              "research_id": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "research_id",
-              "fetched_at"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "summary": {
-        "additionalProperties": false,
-        "properties": {
-          "rank_bands": {
-            "additionalProperties": false,
-            "properties": {
-              "rank11_20": {
-                "type": "number"
-              },
-              "rank21_50": {
-                "type": "number"
-              },
-              "rank4_10": {
-                "type": "number"
-              },
-              "rank51_plus": {
-                "type": "number"
-              },
-              "top3": {
-                "type": "number"
-              },
-              "unranked": {
-                "type": "number"
-              }
-            },
-            "required": [
-              "top3",
-              "rank4_10",
-              "rank11_20",
-              "rank21_50",
-              "rank51_plus",
-              "unranked"
-            ],
-            "type": "object"
-          },
-          "total_etv": {
-            "type": "number"
-          },
-          "total_keywords": {
-            "type": "number"
-          },
-          "volume_bands": {
-            "additionalProperties": false,
-            "properties": {
-              "vol_1000_plus": {
-                "type": "number"
-              },
-              "vol_100_999": {
-                "type": "number"
-              },
-              "vol_under_100": {
-                "type": "number"
-              },
-              "vol_unknown": {
-                "type": "number"
-              }
-            },
-            "required": [
-              "vol_1000_plus",
-              "vol_100_999",
-              "vol_under_100",
-              "vol_unknown"
-            ],
-            "type": "object"
-          },
-          "vs_previous": {
-            "anyOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "declined": {
-                    "type": "number"
-                  },
-                  "improved": {
-                    "type": "number"
-                  },
-                  "lost_count": {
-                    "type": "number"
-                  },
-                  "new_count": {
-                    "type": "number"
-                  },
-                  "same": {
-                    "type": "number"
-                  }
-                },
-                "required": [
-                  "new_count",
-                  "lost_count",
-                  "improved",
-                  "declined",
-                  "same"
-                ],
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          }
-        },
-        "required": [
-          "total_keywords",
-          "total_etv",
-          "volume_bands",
-          "rank_bands",
-          "vs_previous"
-        ],
-        "type": "object"
-      },
-      "truncated": {
-        "additionalProperties": false,
-        "properties": {
-          "lost_total": {
-            "type": "number"
-          },
-          "matching_total": {
-            "type": "number"
-          },
-          "shown": {
-            "type": "number"
-          }
-        },
-        "required": [
-          "shown",
-          "matching_total",
-          "lost_total"
-        ],
-        "type": "object"
-      },
-      "warning": {
-        "type": [
-          "string",
-          "null"
-        ]
-      }
-    },
-    "required": [
-      "domain",
-      "summary",
-      "previous",
-      "keywords",
-      "lost_keywords",
-      "truncated",
-      "warning"
-    ],
-    "type": "object"
-  },
-  "type": "array"
-}

addedOutput schema / properties / fetch_rule
```
Added value: +{
+  "type": "string"
+}
```
removedOutput schema / properties / keyword_count
```
Removed value: -{
-  "type": "number"
-}
```

addedOutput schema / properties / keywords

Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "band": {
+        "enum": [
+          "top",
+          "near",
+          "out",
+          "unknown"
+        ],
+        "type": "string"
+      },
+      "keyword": {
+        "type": "string"
+      },
+      "own_rank": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "own_status": {
+        "enum": [
+          "ranked",
+          "not_in_top100",
+          "unknown"
+        ],
+        "type": "string"
+      },
+      "own_url": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "peers": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "domain": {
+              "type": "string"
+            },
+            "rank": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "domain",
+            "rank"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "search_volume": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "top_domain": {
+        "type": "string"
+      },
+      "top_rank": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "keyword",
+      "search_volume",
+      "band",
+      "own_rank",
+      "own_status",
+      "own_url",
+      "top_domain",
+      "top_rank",
+      "peers"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

removedOutput schema / properties / language_code
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / properties / location_code
```
Removed value: -{
-  "type": "number"
-}
```

removedOutput schema / properties / min_volume

Removed value: -{
-  "type": [
-    "number",
-    "null"
-  ]
-}

addedOutput schema / properties / notes

Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / offset
```
Added value: +{
+  "type": "number"
+}
```
addedOutput schema / properties / own_complete
```
Added value: +{
+  "type": "boolean"
+}
```

addedOutput schema / properties / own_domain

Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / properties / rule_params

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "rank_max": {
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "row_cap": {
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "scale_max_ratio": {
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "volume_max": {
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "volume_min": {
+      "type": [
+        "number",
+        "null"
+      ]
+    }
+  },
+  "required": [
+    "rank_max",
+    "volume_min",
+    "volume_max",
+    "row_cap",
+    "scale_max_ratio"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / shops

Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "domain": {
+        "type": "string"
+      },
+      "fetch_failed": {
+        "type": "boolean"
+      },
+      "keyword_count": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "researched": {
+        "type": "boolean"
+      },
+      "scale_ratio": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "source": {
+        "enum": [
+          "auto",
+          "manual"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "domain",
+      "source",
+      "scale_ratio",
+      "researched",
+      "keyword_count",
+      "fetch_failed"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

removedOutput schema / properties / sort

Removed value: -{
-  "enum": [
-    "etv",
-    "volume",
-    "rank"
-  ],
-  "type": "string"
-}

addedOutput schema / properties / truncated

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "matching_total": {
+      "type": "number"
+    },
+    "next_offset": {
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "shown": {
+      "type": "number"
+    }
+  },
+  "required": [
+    "shown",
+    "matching_total",
+    "next_offset"
+  ],
+  "type": "object"
+}

AddedJul 10, 2026

TDQS

Score is being calculated.

All RevenueScope: revenue-first analytics for your EC site tools Inspect

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

Need Help?