search-term-cleanup

name	search-term-cleanup
description	Audit and clean up search terms (negative keywords, intent classification, query hygiene). Use when the user asks to clean up search queries, add negative keywords, review search term reports, or improve match quality. Cross-references Search Console, GA4, and ad platform data. Also use when the user asks in Japanese (検索語句のクリーンアップ / 除外キーワードを追加して / 無駄な検索クエリを止めたい).
metadata	{"version":"0.10.29"}

Search Term Cleanup

PREREQUISITE: Read ../_mureo-shared/SKILL.md for auth, security rules, output format, and Tool Selection (Read/Write on Code, mureo_strategy_* / mureo_state_* MCP on Desktop / Cowork).

Review and clean up search terms and keywords across all platforms.

Prerequisites

• STRATEGY.md and STATE.json must exist (run the onboard skill first)

Steps

Before you start: Run the Diagnostic preamble from ../_mureo-shared/SKILL.md — load learning insights (mureo_learning_insights_get) and consult advisors (mureo_consult_advisor) before drawing conclusions.

1. Load context: Read STRATEGY.md (Persona, USP, Target Audience, Data Sources) and STATE.json.

2. Discover platforms: Identify all configured platforms that support search term data from STATE.json platforms. Also include any hosted official-MCP connector present in the session (e.g. TikTok, key tiktok_ads) where it exposes search-term data — drive it via its own tools and skip mureo-only value-adds; see ../_mureo-shared/SKILL.md → Hosted-connector platforms.

3. Review search terms: For each ad platform that supports search term data:

   • Google Ads: prefer mureo native — call google_ads_search_terms_report for the raw query rows, then google_ads_search_terms_review (rule-based scoring) and google_ads_search_terms_analyze (intent classification) per campaign. These tools work in both Live API and BYOD mode. In BYOD they read from ~/.mureo/byod/google_ads/search_terms.csv (the Apps Script bundle output) — do not look for raw CSVs in the project directory; mureo BYOD data is centralized in the workspace byod/ directory (or ~/.mureo/byod/ for legacy CLI users) and is only accessible through mureo MCP tools. If mureo's Google Ads tools are unavailable (e.g. MUREO_DISABLE_GOOGLE_ADS=1 after mureo providers add google-ads-official), fall back to the official google-ads-official MCP's search-terms report tool for the raw rows, then skip the mureo-only rule-based scoring and intent-classification tools (google_ads_search_terms_review, google_ads_search_terms_analyze) and do the scoring/classification yourself using the rules described in step 6 below; note to the user that mureo's automated scoring is only available with the native MCP (install or re-enable via mureo setup claude-code).
   • Meta Ads: Skip — Meta is interest/audience-targeted and has no search-query data (this applies to both mureo native and the official Meta MCP).
   • Analyze N-gram patterns and user intent across the returned rows.

4. Paid/organic cross-reference (if Search Console is available):

   • Pull top organic queries for the site
   • Cross-reference with paid search terms to identify overlap
   • For terms ranking well organically (position 1-3), consider reducing paid bids or pausing paid keywords
   • For terms with strong paid performance but weak organic ranking, flag as SEO opportunity
   • Present a paid/organic overlap matrix

5. Landing page quality check (if GA4 is available): Check landing page performance for key search terms. Terms driving traffic to high-bounce-rate pages may need LP improvements rather than keyword changes.

6. Score candidates against strategy:

   • Exclude candidates: Terms with 0 conversions + high cost, informational-only queries, terms misaligned with Persona
   • Add candidates: High-converting terms not yet added as keywords, terms matching USP themes
   • Reduce candidates: Terms well-covered by organic rankings

7. Present recommendations in a table:

   Term	Platform	Action	Reason	Score	Campaign

   Group by platform and campaign. Show estimated cost savings from exclusions.

8. Ask for approval: Let me select which recommendations to apply.

9. Check pending observations: Before executing, check action_log for this campaign. If a previous action is still within its observation window, warn that stacking changes will make outcome evaluation difficult. Recommend waiting if possible.

10. Execute: Use each platform's keyword management tools to apply approved changes (add negative keywords, add positive keywords, adjust bids).

11. Record outcome context: For each campaign modified, log to action_log with metrics_at_action (current CPA, conversions, clicks, CTR, impressions, cost) and observation_due (14 days from today). This enables evidence-based evaluation later.

12. Update STATE.json with notes about the cleanup.

IMPORTANT: Always explain WHY a term should be excluded/added, referencing the Persona or USP from STRATEGY.md. Consult past action_log entries — if a similar cleanup was previously evaluated, reference whether it was effective.