MCPHerramientas MCP/Listados/get_listings_rollup

get_listings_rollup

Readlistings:read

Listings health summary across all of a client's locations: publisher sync rate, connection issues, duplicate listings, per-location sync status, per-publisher coverage breakdown, weakest publishers, which locations need attention. Use for listings issues, directory coverage, listing health check. `health` is the Listing overview over each location's ELIGIBLE directory universe (sites with no listing yet included), summed as counts across locations (never an average of percentages); `health.needsAction` counts directory listings needing action and `health.locationsNeedingAction` the distinct locations. With `withVisibility`, `visibility.citation` sums each location's current live pages (indexed over that one total; pending/not-checked pages are unknown, not negatives; locations with no live page or no verdict are coverage gaps) and `visibility.maps` sums each measured location's exact top-3 and measured spots for its default keyword (newest keyword with a current-scope measured scan); `rows[].maps.completedAt` is a verified collection receipt and `generatedAt` only the report's recorded date. When you tell the user about listing sync, state it as a percentage only; never quote synced/total counts (e.g. never '39/57' or '39 of 57').

Parámetros
clientIdstringopcional
Limit to a single client (from list_clients). Omit to roll up across all of the agency's clients. Accepts the database ID or public cli- ID. IDs must belong to the authenticated agency and permitted client.
tagsstring[]opcional
Internal tag NAMES — narrow the rollup to locations carrying ANY of these tags (the names list_location_tags returns). A name that matches no tag returns no locations, not all of them. Each returned row also carries its location's tag names so you can segment client-side.
withVisibilitybooleanopcional
Also return Listings in Google Search and Top 3 on Google Maps per location (`rows[].citation`, `rows[].maps`) and their weighted totals (`visibility`). Off by default; it reads more.
Solicitud de ejemplo
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_listings_rollup",
    "arguments": {}
  }
}
Respuesta de ejemplo
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "..."
      }
    ]
  }
}

La forma de la respuesta se muestra a modo ilustrativo — el contenido real depende de la herramienta y de tus datos.