← Explore all agents

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.

Upstream setup instructions ↗
  1. Read the pinned source and its licence, then configure an explicitly bounded host context.
  2. 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.
  3. Start from a read-only export or restricted API; review conversion lag, query coverage and each proposed exclusion before granting campaign writes.
  4. 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.

  1. https://github.com/msitarzewski/agency-agents/blob/bd956db032d907387e6b9ddebff3e18f1de8c679/paid-media/paid-media-search-query-analyst.md

    Supports: Workflow, inputs, outputs and stated boundaries

  2. Applicable licence ↗Checked

    https://github.com/msitarzewski/agency-agents/blob/bd956db032d907387e6b9ddebff3e18f1de8c679/LICENSE

    Supports: Redistribution and attribution

  3. https://code.claude.com/docs/en/sub-agents.md

    Supports: Host loading and effective permission boundaries

Evidence & Ask