geo-conflict-analyzer

Analyze search queries against active geos in Google Ads campaigns.

58|9|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/fourteenwm/ppc-ai-skills --skill geo-conflict-analyzer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: geo-conflict-analyzer
Source: https://github.com/fourteenwm/ppc-ai-skills/tree/main/geo-conflict-analyzer
Command: npx skills add https://github.com/fourteenwm/ppc-ai-skills --skill geo-conflict-analyzer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python-dotenv, openai, google-api-python-client, google-auth, and includes scripts (resource) components.

What problem does it solve?

geo-conflict-analyzer identifies when a search query conflicts with actively targeted geographic areas in Google Ads GEO campaigns, preventing unsafe negative keywords that would block legitimate traffic.

Core Features & Use Cases

  • Reads queries from a Google Sheet tab (status = Waiting) and groups them by CID with their active geo targets.
  • Sends batches to OpenAI GPT-4o to determine PASS/FAIL results with confidence levels and writes results back to an output tab.
  • Integrates with the off-brand analyzer to support a complete SQR workflow and guardrails for geo targeting decisions.

Quick Start

Configure your environment (OPENAI_API_KEY and Google Sheets token), then run the geo-conflict-analyzer using python scripts/analyze.py to begin processing.

Frequently Asked Questions about geo-conflict-analyzer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect geo-target conflicts in Google Ads search queries?

To detect geo-target conflicts in Google Ads, the analyzer reads search queries from a Google Sheet, groups them by CID with active geo targets, and sends batches to GPT-4o to determine PASS/FAIL results with confidence scores. It then writes the validated results back to an output tab.

Why do I need to check search queries for geo conflicts before adding negative keywords?

Checking search queries for geo conflicts prevents unsafe negative keywords that would block legitimate traffic. By validating whether a query matches active geographic areas in GEO campaigns, you avoid accidentally excluding valid search terms and losing relevant ad traffic.

How do I process search queries in batches using GPT-4o for Google Ads?

You process search queries in batches by running the analysis script after configuring your environment. The script reads queries marked as 'Waiting' from a Google Sheet tab and sends grouped batches to OpenAI GPT-4o for automated PASS/FAIL conflict evaluation.

Do I need an OpenAI API key and Google Sheets token to run geo-conflict analysis?

Yes, you need an OPENAI_API_KEY and a Google Sheets OAuth token to run geo-conflict analysis. These credentials allow the script to access your sheet data, process queries through GPT-4o, and write the conflict results back to the spreadsheet.

Can I integrate geo conflict analysis into an existing SQR workflow?

Yes, you can integrate geo conflict analysis into an SQR workflow. The analyzer works alongside an off-brand analyzer to provide complete Search Query Report guardrails, ensuring safe geo targeting decisions and preventing negative keyword conflicts across campaigns.