Skip to main content
Glama

rowfeed/google-ai-overview-tracker

rowfeed--google-ai-overview-tracker
Destructive

This tool calls the Actor "rowfeed/google-ai-overview-tracker" and retrieves its output results. Actor description: Check which keywords show a Google AI Overview, get its full text and every cited source, and see whether your domains are cited or rank in the top 10. Any country, language and device. An AI Overview checker and GEO tracker for SEO teams.

Input Schema

NameRequiredDescriptionDefault
deviceNoSearch as a desktop or mobile user. Example values: "desktop"desktop
keywordsNoGoogle searches to check, one per line. Up to 1,000 per run. Example values: ["best crm for small business"]
languageNoGoogle interface language, e.g. "English", "German". Example values: "English"English
locationNoSearch from this country, e.g. "United States", "United Kingdom", "Germany". Example values: "United States"United States
waitSecsNoMax seconds (0–45, default 30) to cap the wait for the Actor run to reach terminal state. For long-running Actors the response returns at the cap with the current run status; follow `nextStep` to poll via get-actor-run. Set to 0 to fire-and-forget.
trackDomainsNoDomains to look for: are they cited in the AI Overview, at which source position, and where do they rank in the top 10? Up to 20. Free. Example values: ["salesforce.com","hubspot.com"]

Output Schema

NameRequiredDescriptionDefault
tipNoAdvisory guidance RAG Web Browser wrote to its key-value store under the reserved "TIP" key
runIdYesActor run ID
statsNoRun statistics
statusYesRun status: READY | RUNNING | TIMING-OUT | TIMED-OUT | ABORTING | ABORTED | SUCCEEDED | FAILED
actorIdYesStable Apify Actor ID from the run record
summaryYesPast-tense summary of the run state
exitCodeNoActor process exit code; populated for terminal states (especially FAILED)
nextStepYesOne primary follow-up action with identifiers interpolated
storagesYesDataset and key-value store metadata, keyed by alias. "default" is always the primary entry.
actorNameNo"username/actor-name"
startedAtNoISO timestamp when the run started
finishedAtNoISO timestamp when the run finished (terminal states only)
statusMessageNoPass-through from Apify run.statusMessage
apifyConsoleUrlNoPersonalized Apify Console link to the run; present only for Console sessions

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Added value: +{
      +  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      +  "properties": {
      +    "ai_overview_position": {
      +      "type": "number"
      +    },
      +    "ai_overview_text": {
      +      "type": "string"
      +    },
      +    "any_tracked_cited": {
      +      "type": "boolean"
      +    },
      +    "checked_at": {
      +      "type": "string"
      +    },
      +    "cited_domains": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "device": {
      +      "type": "string"
      +    },
      +    "from_snapshot": {
      +      "type": "boolean"
      +    },
      +    "google_url": {
      +      "type": "string"
      +    },
      +    "has_ai_overview": {
      +      "type": "boolean"
      +    },
      +    "keyword": {
      +      "type": "string"
      +    },
      +    "language": {
      +      "type": "string"
      +    },
      +    "location": {
      +      "type": "string"
      +    },
      +    "organic_top10": {
      +      "items": {
      +        "properties": {
      +          "domain": {
      +            "type": "string"
      +          },
      +          "position": {
      +            "type": "number"
      +          },
      +          "title": {
      +            "type": "string"
      +          },
      +          "url": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "sources": {
      +      "items": {
      +        "properties": {
      +          "domain": {
      +            "type": "string"
      +          },
      +          "position": {
      +            "type": "number"
      +          },
      +          "source": {
      +            "type": "string"
      +          },
      +          "title": {
      +            "type": "string"
      +          },
      +          "url": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "sources_count": {
      +      "type": "number"
      +    },
      +    "tracked_domains": {
      +      "items": {
      +        "properties": {
      +          "cited_in_ai_overview": {
      +            "type": "boolean"
      +          },
      +          "domain": {
      +            "type": "string"
      +          },
      +          "mentioned_in_text": {
      +            "type": "boolean"
      +          },
      +          "organic_position": {
      +            "type": "null"
      +          },
      +          "source_position": {
      +            "type": [
      +              "null",
      +              "number"
      +            ]
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "type": "object"
      +}
  2. Changed5 schema fields changed
    • addedInput schema / properties / keywords / prefill
      Added value: +[
      +  "best crm for small business"
      +]
    • addedInput schema / properties / language / prefill
      Added value: +"English"
    • addedInput schema / properties / location / prefill
      Added value: +"United States"
    • addedInput schema / properties / trackDomains / prefill
      Added value: +[
      +  "salesforce.com",
      +  "hubspot.com"
      +]
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Removed value: -{
      -  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      -  "properties": {
      -    "ai_overview_position": {
      -      "type": "number"
      -    },
      -    "ai_overview_text": {
      -      "type": "string"
      -    },
      -    "any_tracked_cited": {
      -      "type": "boolean"
      -    },
      -    "checked_at": {
      -      "type": "string"
      -    },
      -    "cited_domains": {
      -      "items": {
      -        "type": "string"
      -      },
      -      "type": "array"
      -    },
      -    "device": {
      -      "type": "string"
      -    },
      -    "from_snapshot": {
      -      "type": "boolean"
      -    },
      -    "google_url": {
      -      "type": "string"
      -    },
      -    "has_ai_overview": {
      -      "type": "boolean"
      -    },
      -    "keyword": {
      -      "type": "string"
      -    },
      -    "language": {
      -      "type": "string"
      -    },
      -    "location": {
      -      "type": "string"
      -    },
      -    "organic_top10": {
      -      "items": {
      -        "properties": {
      -          "domain": {
      -            "type": "string"
      -          },
      -          "position": {
      -            "type": "number"
      -          },
      -          "title": {
      -            "type": "string"
      -          },
      -          "url": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "sources": {
      -      "items": {
      -        "properties": {
      -          "domain": {
      -            "type": "string"
      -          },
      -          "position": {
      -            "type": "number"
      -          },
      -          "source": {
      -            "type": "string"
      -          },
      -          "title": {
      -            "type": "string"
      -          },
      -          "url": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "sources_count": {
      -      "type": "number"
      -    },
      -    "tracked_domains": {
      -      "items": {
      -        "properties": {
      -          "cited_in_ai_overview": {
      -            "type": "boolean"
      -          },
      -          "domain": {
      -            "type": "string"
      -          },
      -          "mentioned_in_text": {
      -            "type": "boolean"
      -          },
      -          "organic_position": {
      -            "type": "null"
      -          },
      -          "source_position": {
      -            "type": [
      -              "null",
      -              "number"
      -            ]
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    }
      -  },
      -  "type": "object"
      -}
  3. Changed2 schema fields changed
    • addedInput schema / description
      Added value: +"Live lookups need a paid Apify plan (any plan). The pre-filled example works on the free plan."
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Added value: +{
      +  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      +  "properties": {
      +    "ai_overview_position": {
      +      "type": "number"
      +    },
      +    "ai_overview_text": {
      +      "type": "string"
      +    },
      +    "any_tracked_cited": {
      +      "type": "boolean"
      +    },
      +    "checked_at": {
      +      "type": "string"
      +    },
      +    "cited_domains": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "device": {
      +      "type": "string"
      +    },
      +    "from_snapshot": {
      +      "type": "boolean"
      +    },
      +    "google_url": {
      +      "type": "string"
      +    },
      +    "has_ai_overview": {
      +      "type": "boolean"
      +    },
      +    "keyword": {
      +      "type": "string"
      +    },
      +    "language": {
      +      "type": "string"
      +    },
      +    "location": {
      +      "type": "string"
      +    },
      +    "organic_top10": {
      +      "items": {
      +        "properties": {
      +          "domain": {
      +            "type": "string"
      +          },
      +          "position": {
      +            "type": "number"
      +          },
      +          "title": {
      +            "type": "string"
      +          },
      +          "url": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "sources": {
      +      "items": {
      +        "properties": {
      +          "domain": {
      +            "type": "string"
      +          },
      +          "position": {
      +            "type": "number"
      +          },
      +          "source": {
      +            "type": "string"
      +          },
      +          "title": {
      +            "type": "string"
      +          },
      +          "url": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "sources_count": {
      +      "type": "number"
      +    },
      +    "tracked_domains": {
      +      "items": {
      +        "properties": {
      +          "cited_in_ai_overview": {
      +            "type": "boolean"
      +          },
      +          "domain": {
      +            "type": "string"
      +          },
      +          "mentioned_in_text": {
      +            "type": "boolean"
      +          },
      +          "organic_position": {
      +            "type": "null"
      +          },
      +          "source_position": {
      +            "type": [
      +              "null",
      +              "number"
      +            ]
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "type": "object"
      +}
  4. Changed1 schema field changed
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Removed value: -{
      -  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      -  "properties": {
      -    "ai_overview_position": {
      -      "type": "number"
      -    },
      -    "ai_overview_text": {
      -      "type": "string"
      -    },
      -    "any_tracked_cited": {
      -      "type": "boolean"
      -    },
      -    "checked_at": {
      -      "type": "string"
      -    },
      -    "cited_domains": {
      -      "items": {
      -        "type": "string"
      -      },
      -      "type": "array"
      -    },
      -    "device": {
      -      "type": "string"
      -    },
      -    "google_url": {
      -      "type": "string"
      -    },
      -    "has_ai_overview": {
      -      "type": "boolean"
      -    },
      -    "keyword": {
      -      "type": "string"
      -    },
      -    "language": {
      -      "type": "string"
      -    },
      -    "location": {
      -      "type": "string"
      -    },
      -    "organic_top10": {
      -      "items": {
      -        "properties": {
      -          "domain": {
      -            "type": "string"
      -          },
      -          "position": {
      -            "type": "number"
      -          },
      -          "title": {
      -            "type": "string"
      -          },
      -          "url": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "sources": {
      -      "items": {
      -        "properties": {
      -          "domain": {
      -            "type": "string"
      -          },
      -          "position": {
      -            "type": "number"
      -          },
      -          "source": {
      -            "type": "string"
      -          },
      -          "title": {
      -            "type": "string"
      -          },
      -          "url": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "sources_count": {
      -      "type": "number"
      -    },
      -    "tracked_domains": {
      -      "items": {
      -        "properties": {
      -          "cited_in_ai_overview": {
      -            "type": "boolean"
      -          },
      -          "domain": {
      -            "type": "string"
      -          },
      -          "mentioned_in_text": {
      -            "type": "boolean"
      -          },
      -          "organic_position": {
      -            "type": "null"
      -          },
      -          "source_position": {
      -            "type": "null"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    }
      -  },
      -  "type": "object"
      -}
  5. Changed5 schema fields changed
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / ai_overview_position / type
      Previous value: -[
      -  "number",
      -  "null"
      -]New value: +"number"
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / ai_overview_text / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +"string"
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / from_snapshot
      Removed value: -{
      -  "type": "boolean"
      -}
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / tracked_domains / items / properties / organic_position / type
      Previous value: -[
      -  "null",
      -  "number"
      -]New value: +"null"
    • changedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / tracked_domains / items / properties / source_position / type
      Previous value: -[
      -  "null",
      -  "number"
      -]New value: +"null"
  6. Added

TDQS

B3.1/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare destructiveHint=true, openWorldHint=true and readOnlyHint=false, so the agent knows this is a stateful, open-world, cost-bearing operation. The description adds the proxy mechanic ("calls the Actor ... and retrieves its output results"), which clarifies that work runs asynchronously on Apify. It does not disclose cost implications, the wait/polling behavior, or that results arrive as an Actor run output rather than a direct answer.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The opening sentence about calling the Actor is largely meta-boilerplate restating the tool name, and the genuinely useful capability detail is pushed into the second sentence. What remains is dense and free of filler, but the front-loading is poor for an agent scanning descriptions.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values need not be explained, and all six parameters are fully documented in-schema with sensible defaults. What is missing is the routing context an agent needs in this crowded sibling set: no statement of how this differs from ai-search-visibility-tracker or google-serp-api, and no plan/cost prerequisite in the description itself.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% and every parameter including waitSecs and trackDomains is documented in-schema, so the baseline is 3. The line "Any country, language and device" gestures at the location, language and device inputs but adds no syntax, format or constraint detail beyond what the schema already supplies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The second sentence names a specific verb and resource chain: check which keywords trigger a Google AI Overview, extract its full text and every cited source, and test whether given domains are cited or rank top 10. That is far more concrete than the boilerplate opener about calling an Actor. It does not, however, distinguish this from the close sibling rowfeed--ai-search-visibility-tracker, which an agent could easily confuse it with.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Only an audience tag ("for SEO teams") hints at usage; there is no when-to-use, no when-not-to-use, and no reference to alternatives such as google-serp-api or ai-search-visibility-tracker. The one operationally critical condition — that live lookups require a paid Apify plan while the pre-filled example works free — appears only in the schema description, not here.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.