MARKETING ANALYSIS / Agency Agents community
Paid search query analyst
A query-audit profile that requires actual account reports before suggesting negative keywords or expansion opportunities.
“Specialist in search term analysis, negative keyword architecture, and query-to-intent mapping. Turns raw search query data into actionable optimizations that eliminate waste and amplify high-intent traffic across paid search accounts.”
01 / THE REASONING
Why this made the selection.
- It considers account, campaign and ad-group negative scopes and cross-campaign overlap rather than producing one undifferentiated exclusion list.
- It requires the real search-term report and uses recurring n-grams to investigate irrelevant modifiers.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- paid-media/paid-media-search-query-analyst.md (pinned complete source retained)
- LICENSE
- Repository README and current official host configuration documentation
Our findings
- It considers account, campaign and ad-group negative scopes and cross-campaign overlap rather than producing one undifferentiated exclusion list.
- It requires the real search-term report and uses recurring n-grams to investigate irrelevant modifiers.
Not established by this review
- Source review only: no agent was installed or invoked. Task correctness, effective host restrictions and integration behaviour were not tested.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Use the role in your project.
- Read the pinned source and its licence, then configure an explicitly bounded host context.
- Check the original display-style name and optional color/emoji/vibe metadata against the installed host requirements before loading a working copy. Current Claude Code documentation says unknown frontmatter fields are ignored; it does not establish a need to rewrite these names. Keep the archived/downloaded original unchanged.
- Start from a read-only export or restricted API; review conversion lag, query coverage and each proposed exclusion before granting campaign writes.
- Supply a dated search-term export, conversion definitions, attribution window and campaign structure.
Before you start
- Search-term data and attribution context
- Optional explicitly scoped Ads API/MCP integration
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/msitarzewski/agency-agents/blob/bd956db032d907387e6b9ddebff3e18f1de8c679/paid-media/paid-media-search-query-analyst.md
Supports: Workflow, inputs, outputs and stated boundaries
- Applicable licence ↗Checked
https://github.com/msitarzewski/agency-agents/blob/bd956db032d907387e6b9ddebff3e18f1de8c679/LICENSE
Supports: Redistribution and attribution
https://code.claude.com/docs/en/sub-agents.md
Supports: Host loading and effective permission boundaries