{"id":"google_position_opportunities","name":"Google Position-based Click Opportunities","alias":"GooglePositionOpportunities","aliases":[],"description_short":"Analyze potential click gains from ranking position improvements.","description_long":"\n    Analyze potential click gains from improving search ranking positions for specific URLs or keywords.\n    \n    This agent uses historical Search Console data to calculate the expected additional clicks you could\n    gain by improving from your current position to better positions, broken down by device type\n    (mobile and desktop/tablet).\n    ","description_tool_prompt":"\n    Analyze potential click gains from improving search ranking positions for specific URLs or keywords.\n    \n    This agent uses historical Search Console data to calculate the expected additional clicks you could\n    gain by improving from your current position to better positions, broken down by device type\n    (mobile and desktop/tablet).\n    ","source":null,"conversation_examples":[],"tags":[],"available_in_chat":false,"available_in_deepthink":false,"available_in_mcp":null,"mcp_audience":"all","config":{"type":"object","properties":{},"required":[]},"item":{"type":"object","properties":{"period":{"description":"Time period to analyze","enum":["last_7d","last_28d"],"title":"Period","type":"string"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Specific URL to analyze (optional)","title":"Url"},"keyword":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Specific keyword to analyze (optional)","title":"Keyword"}},"required":["period"]},"response":{"$defs":{"CTRDataPoint":{"properties":{"avg_position":{"description":"Average ranking position","title":"Avg Position","type":"integer"},"device":{"description":"Device type","title":"Device","type":"string"},"nb_urls":{"description":"Number of URLs","title":"Nb Urls","type":"integer"},"pct_urls_with_clicks":{"description":"Percentage of URLs with clicks","title":"Pct Urls With Clicks","type":"number"},"impressions":{"description":"Total impressions","title":"Impressions","type":"integer"},"clicks":{"description":"Total clicks","title":"Clicks","type":"integer"},"ctr_global":{"description":"Global CTR","title":"Ctr Global","type":"number"}},"required":["avg_position","device","nb_urls","pct_urls_with_clicks","impressions","clicks","ctr_global"],"title":"CTRDataPoint","type":"object"},"DeviceOpportunity":{"properties":{"position":{"description":"Target ranking position","title":"Position","type":"integer"},"additional_clicks":{"description":"Additional clicks expected at this position","title":"Additional Clicks","type":"number"},"target_ctr":{"description":"Expected CTR at target position (as %)","title":"Target Ctr","type":"number"},"current_ctr":{"description":"Current CTR (as %)","title":"Current Ctr","type":"number"}},"required":["position","additional_clicks","target_ctr","current_ctr"],"title":"DeviceOpportunity","type":"object"},"FilteredCTRMetrics":{"properties":{"impressions":{"title":"Impressions","type":"integer"},"clicks":{"title":"Clicks","type":"integer"},"ctr":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ctr"},"avg_position":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Position"},"desktop_tablet_impressions":{"title":"Desktop Tablet Impressions","type":"integer"},"desktop_tablet_clicks":{"title":"Desktop Tablet Clicks","type":"integer"},"desktop_tablet_ctr":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Desktop Tablet Ctr"},"desktop_tablet_avg_position":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Desktop Tablet Avg Position"},"mobile_impressions":{"title":"Mobile Impressions","type":"integer"},"mobile_clicks":{"title":"Mobile Clicks","type":"integer"},"mobile_ctr":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Mobile Ctr"},"mobile_avg_position":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Mobile Avg Position"}},"required":["impressions","clicks","ctr","avg_position","desktop_tablet_impressions","desktop_tablet_clicks","desktop_tablet_ctr","desktop_tablet_avg_position","mobile_impressions","mobile_clicks","mobile_ctr","mobile_avg_position"],"title":"FilteredCTRMetrics","type":"object"},"OpportunitiesByDevice":{"properties":{"mobile":{"description":"Opportunities for mobile devices","items":{"$ref":"#/$defs/DeviceOpportunity"},"title":"Mobile","type":"array"},"desktop":{"description":"Opportunities for desktop devices","items":{"$ref":"#/$defs/DeviceOpportunity"},"title":"Desktop","type":"array"}},"required":["mobile","desktop"],"title":"OpportunitiesByDevice","type":"object"}},"properties":{"global_ctr_mobile":{"description":"Global CTR data for mobile devices by position","items":{"$ref":"#/$defs/CTRDataPoint"},"title":"Global Ctr Mobile","type":"array"},"global_ctr_desktop_and_tablet":{"description":"Global CTR data for desktop and tablet devices by position","items":{"$ref":"#/$defs/CTRDataPoint"},"title":"Global Ctr Desktop And Tablet","type":"array"},"ctr_for_filter":{"anyOf":[{"items":{"$ref":"#/$defs/FilteredCTRMetrics"},"type":"array"},{"type":"null"}],"description":"CTR metrics for the specific URL or keyword filter","title":"Ctr For Filter"},"opportunities":{"anyOf":[{"$ref":"#/$defs/OpportunitiesByDevice"},{"type":"null"}],"description":"Potential additional clicks by improving to each position"},"opportunities_explanations":{"description":"Explanation of what the opportunities data represents","title":"Opportunities Explanations","type":"string"}},"required":["global_ctr_mobile","global_ctr_desktop_and_tablet","ctr_for_filter","opportunities","opportunities_explanations"],"title":"GooglePositionOpportunitiesProcessedItem","type":"object"},"has_canvas":false,"open_canvas_automatically":false}