Skip to main content
Glama

SEO GSC Wizard MCP

by com.gscwizard.mcp
OverviewDiscussionsAdmin

Product free-listing status

get_product_listing_status
Read-only

Free-listing eligibility and item issues per product, from the Google Merchant Center account linked to a GSC Wizard site, sorted by clickPotentialRank (1 = the product Google expects the most clicks from). Answers "which products are invisible in free listings, and why": each row carries the aggregated status (ELIGIBLE / ELIGIBLE_LIMITED / PENDING / NOT_ELIGIBLE_OR_DISAPPROVED), the free-listings status when the synced catalog has it, the top issue code and whether fixing it needs a merchant action or is just pending Google processing. statusCounts, issueCounts, problemCount and merchantActionCount (problems that need a feed or site fix) summarise the whole scan, not just the returned page; page through every row with offset, passing back nextOffset until it is null. Answered from the catalog snapshot GSC Wizard syncs daily into its warehouse when the site has one (dataSource: "clickhouse", syncedAt says when, stale: true when it is more than two days old; every offer is counted), with a live Merchant API scan of up to 5,000 products as the fallback (dataSource: "merchant-api", truncated when the catalog had more or Merchant Center was too slow to read it all within about 40 seconds; truncationReason says which). itemIssuesUnavailable: true means Google refused the issue data, so a missing issue code is unknown rather than clean. syncPaused (with a one-line staleNote) means the daily sync is paused because Merchant Center no longer lets the connected Google account read the merchant: the data is still returned but may be stale, and syncPaused.message says how to fix it. syncNotice (reason "gmc_on_other_account") means Merchant Center is connected on another Google login than the property's Search Console one, so the snapshot cannot refresh; the data is still returned. This is catalog state, not traffic: pair it with get_organic_shopping_performance for the clicks a product actually got. Returns a notConfigured result (not an error) when Merchant Center is not connected, its credentials were revoked, no Merchant Center account is linked to the site in the GSC Wizard app, or (reason "gmc_on_other_account") nothing was ever synced because Merchant Center sits on another Google login and no live read is possible.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
limitNoProduct rows to return, highest click potential first (default 25, max 200).
offsetNoRows to skip, for reading past the first page: pass the previous answer's nextOffset (default 0, max 100,000).
siteUrlYesThe property URL as returned by list_sites (e.g. "sc-domain:example.com").
onlyProblemsNoReturn only products that are not plainly serving (limited, pending, disapproved, or carrying an item issue). Set false to list the whole catalog by click potential.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
hintNo
noteNo
rowsNo
rangeNo
staleNo
offsetNo
reasonNo
accountNo
hasMoreNo
scannedNo
siteUrlNo
cachedAtNo
rowCountNo
syncedAtNo
staleNoteNo
truncatedNo
dataSourceNo
nextOffsetNo
syncNoticeNo
syncPausedNo
issueCountsNo
gmcAccountIdNo
onlyProblemsNo
problemCountNo
statusCountsNo
notConfiguredNo
itemIssuesNoteNo
truncationNoteNo
truncationReasonNo
merchantActionCountNo
itemIssuesUnavailableNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedOutput schema / properties / syncNotice
      Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "message": {
+          "$ref": "#/properties/siteUrl"
+        },
+        "reason": {
+          "$ref": "#/properties/siteUrl"
+        }
+      },
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
    • addedOutput schema / properties / syncPaused
      Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "message": {
+          "$ref": "#/properties/siteUrl"
+        },
+        "reason": {
+          "$ref": "#/properties/siteUrl"
+        }
+      },
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
  2. Changed4 schema fields changed
    • addedInput schema / properties / offset
      Added value: +{
+  "default": 0,
+  "description": "Rows to skip, for reading past the first page: pass the previous answer's nextOffset (default 0, max 100,000).",
+  "maximum": 100000,
+  "minimum": 0,
+  "type": "integer"
+}
    • addedOutput schema / properties / merchantActionCount
      Added value: +{
+  "$ref": "#/properties/range/anyOf/0/properties/days"
+}
    • addedOutput schema / properties / nextOffset
      Added value: +{
+  "$ref": "#/properties/range/anyOf/0/properties/days"
+}
    • addedOutput schema / properties / offset
      Added value: +{
+  "$ref": "#/properties/range/anyOf/0/properties/days"
+}
  3. Changed8 schema fields changed
    • addedOutput schema / properties / cachedAt
      Added value: +{
+  "$ref": "#/properties/siteUrl"
+}
    • addedOutput schema / properties / itemIssuesNote
      Added value: +{
+  "$ref": "#/properties/siteUrl"
+}
    • addedOutput schema / properties / itemIssuesUnavailable
      Added value: +{
+  "$ref": "#/properties/notConfigured"
+}
    • addedOutput schema / properties / rows / items / properties / freeListingsStatus
      Added value: +{
+  "$ref": "#/properties/siteUrl"
+}
    • addedOutput schema / properties / stale
      Added value: +{
+  "$ref": "#/properties/notConfigured"
+}
    • addedOutput schema / properties / staleNote
      Added value: +{
+  "$ref": "#/properties/siteUrl"
+}
    • addedOutput schema / properties / syncedAt
      Added value: +{
+  "$ref": "#/properties/siteUrl"
+}
    • addedOutput schema / properties / truncationReason
      Added value: +{
+  "$ref": "#/properties/siteUrl"
+}
  4. First observed

TDQS

Score is being calculated.

All SEO GSC Wizard MCP 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