{ "schema": "aiblocks-page/1", "id": "agency-paid-media-search-query-analyst", "type": "agent", "name": "Search query analyst", "summary": "Find the wasted spend in your Google Ads search terms. Get a waste list, negative keywords by level and new keywords from converting searches.", "headline": "Search query analyst", "subhead": "Paste a search terms report with your conversion results and target cost. It groups queries by what the searcher wants and marks the ones that waste money. You get a waste list, a layered negative keyword plan, keyword ideas from searches that convert and checks to run before you add anything.", "job": { "id": "run-google-ads", "name": "Run Google Ads" }, "level": "intermediate", "thinking": "high", "tested": true, "updated": "2026-11-03", "first_published": "2026-10-26", "inputs": [ { "type": "search_query_report", "required": true, "label": "Search query report", "what": "a search query export from Google Search Console or the Google Ads search terms report: each query with clicks, views, position or spend, for set dates" }, { "type": "question", "required": false, "label": "Question", "what": "the problem, decision or piece of work you want help with, and what a good outcome looks like" } ], "outputs": [ { "type": "audit_report", "required": true, "label": "Audit report", "what": "findings with evidence, severity, missing inputs and next actions" }, { "type": "keyword_list", "required": true, "label": "Keyword list", "what": "a list of search keywords, each with what the searcher wants and, where known, monthly searches and difficulty" } ], "you_give": [ "A search terms report from Google Ads, pasted or attached as CSV, with spend, clicks and conversions for each term", "Your target cost per sale or lead, or what a sale is worth", "The date range of the report and your total spend in it", "Your current keyword list and negative keyword lists (optional)", "A note on which campaigns are brand and which are not (optional)" ], "you_get": [ "Queries grouped by shared words and by what the searcher wants", "A waste list showing the money spent on queries that did not sell", "Negative keywords sorted by level (account, campaign or ad group), with the match type for each", "A list of conflicts, where a negative could block a keyword you want", "New keyword ideas from searches that converted, with where each should go", "Queries marked \"review\" because the data is too thin to decide" ], "use_when": [ "You have not read your search terms report in a month and want to know where the money leaked.", "Cost per sale crept up and you suspect broad match or Performance Max is showing your ads on the wrong searches.", "You want a negative keyword list built in layers, not one long list for everything.", "Some searches sell well and you want them turned into keywords with their own control." ], "skip_when": [ "You want one quick sort of a single report into winners and junk. Use the Search term sorter.", "You need a plan for your whole account structure and budget. Use the Paid search campaign planner.", "You think your sales tracking is wrong. Use the Conversion tracking planner first.", "You want display or social ads reviewed. This agent covers search terms only." ], "output_sample": { "input": [ "A search terms report with spend, clicks and conversions", "Your target cost per sale or what a sale is worth", "The date range and total spend in the report", "Your current keywords and negative lists (optional)" ], "prerequisites": [ "A Google Ads account that has run for long enough to collect search terms" ], "output": [ { "name": "Query groups", "contains": "Searches grouped by shared words and intent, with spend, sales and a verdict for each group." }, { "name": "Waste list", "contains": "Queries and groups that took money without sales, ranked by spend, with the reason." }, { "name": "Negative keywords", "contains": "Each negative with its match type, its level and the campaign or group it belongs to." }, { "name": "Clashes and overlap", "contains": "Negatives that could block wanted keywords, and campaigns that compete for one search." }, { "name": "Keyword ideas from winners", "contains": "Converting searches to add as keywords, with match type and where each should go." }, { "name": "Review list", "contains": "Queries with too little data to judge, with what to watch." } ] }, "output_shape": "REPORT BASIS\n Date range | Spend in report | Conversions | Target cost per sale | Brand campaigns \n\nQUERY GROUPS\n | | | | | \n\nWASTE LIST\n | | | | \n\nNEGATIVE KEYWORDS\n | | | | \n\nCLASHES AND OVERLAP\n | | \n\nKEYWORD IDEAS FROM WINNERS\n | | | \n\nREVIEW LIST\n | | \n\nASSUMPTIONS AND CHECKS STILL NEEDED\n ", "how_to_use": [ "Download the pack from this page and add it to your AI as a skill. If you cannot, paste SKILL.md into a new chat, then paste references/source-agent.md.", "Export the search terms report from Google Ads, with at least 30 days of data if you can. Paste it in or attach the file.", "Add your target cost per sale, the date range and which campaigns are brand. Add your current negative lists if you have them. No code or Google Ads connection is needed.", "Type \"Review these search terms. Show the spend and sales behind every decision. Mark thin data as review.\"", "Read the waste list first, then check the negatives it proposes against your keyword list. Skip any that could block a sale.", "Add the negatives in Google Ads yourself. Run the report again in two to four weeks to see what changed." ], "checks": [ "The result addresses your actual task and cites the evidence used.", "Examples, role-play experience and targets are kept separate from verified results.", "Claims of tests, memory, tool access or completed actions match what actually happened." ], "next": [ { "name": "Google Ads scaling readiness reviewer", "url": "https://useaiblocks.com/skills/google-ads-scale-gate-checker", "why": "Google Ads scaling readiness reviewer" }, { "name": "Google Ads brand traffic splitter", "url": "https://useaiblocks.com/skills/brand-and-non-brand-splitter", "why": "Google Ads brand traffic splitter" }, { "name": "Shopping feed title writer", "url": "https://useaiblocks.com/skills/shopping-feed-title-writer", "why": "Shopping feed title writer" }, { "name": "Content brief writer", "url": "https://useaiblocks.com/skills/content-brief-writer", "why": "Content brief writer" }, { "name": "Keyword to post outline writer", "url": "https://useaiblocks.com/prompts/keyword-to-post-outline-writer", "why": "Keyword to post outline writer" } ], "source": { "by": "Michael Sitarzewski and Agency Agents contributors", "repo": "msitarzewski/agency-agents", "url": "https://github.com/msitarzewski/agency-agents/blob/b37b5bb33b78f2c1d6567d98e25ca818e3259219/paid-media/paid-media-search-query-analyst.md", "licence": "MIT", "original_name": "Search Query Analyst", "commit": "b37b5bb33b78f2c1d6567d98e25ca818e3259219" }, "credits": [ { "title": "Search Query Analyst", "by": "Michael Sitarzewski and Agency Agents contributors", "url": "https://github.com/msitarzewski/agency-agents/blob/b37b5bb33b78f2c1d6567d98e25ca818e3259219/paid-media/paid-media-search-query-analyst.md", "used": "Original agent profile, preserved in references/source-agent.md; AI Blocks adds setup and review instructions." } ], "files": [ "LICENSE", "references/source-agent.md", "SETUP.md", "source.json" ], "links": { "page": "https://useaiblocks.com/agents/agency-paid-media-search-query-analyst", "markdown": "https://useaiblocks.com/agents/agency-paid-media-search-query-analyst.md", "json": "https://useaiblocks.com/agents/agency-paid-media-search-query-analyst.json", "instructions": "https://useaiblocks.com/skills/agency-paid-media-search-query-analyst/SKILL.md", "download": "https://useaiblocks.com/skills/agency-paid-media-search-query-analyst.zip", "api_item": "https://useaiblocks.com/api/v1/items/agency-paid-media-search-query-analyst", "api_document": "https://useaiblocks.com/api/v1/documents/agent/agency-paid-media-search-query-analyst", "mcp": "https://useaiblocks.com/mcp" } }