1#!/usr/bin/env python3
2"""
3Competitor keyword gap analysis using DataForSEO API
4Finds keywords where competitor ranks but you don't
5 
6Usage: python3 scripts/competitor_gap.py "opc.dev" "claudemarketplaces.com" --limit 50
7"""
8import argparse
9from dataforseo_api import api_post, get_result, format_count
10 
11 
12def main():
13    parser = argparse.ArgumentParser(description="Competitor keyword gap analysis")
14    parser.add_argument("my_domain", help="Your domain (without https://)")
15    parser.add_argument("competitor_domain", help="Competitor domain (without https://)")
16    parser.add_argument("--location", "-loc", type=int, default=2840,
17                        help="Location code (default: 2840 = US)")
18    parser.add_argument("--limit", "-l", type=int, default=50, 
19                        help="Max results (default: 50)")
20    args = parser.parse_args()
21 
22    data = [{
23        "target1": args.my_domain,
24        "target2": args.competitor_domain,
25        "location_code": args.location,
26        "language_code": "en",
27        "intersections": False,  # Only show keywords where target2 ranks but target1 doesn't
28        "limit": args.limit
29    }]
30    
31    response = api_post("dataforseo_labs/google/domain_intersection/live", data)
32    results = get_result(response)
33    
34    print(f"my_domain: {args.my_domain}")
35    print(f"competitor_domain: {args.competitor_domain}")
36    print(f"location: {args.location}")
37    print()
38    
39    if results:
40        all_items = []
41        for result in results:
42            items = result.get("items", [])
43            if items:
44                all_items.extend(items)
45        
46        if not all_items:
47            print("No keyword gaps found")
48            return
49        
50        # Results show keywords where competitor ranks but you don't
51        print(f"keyword_gaps[{len(all_items)}]{{keyword,volume,difficulty,comp_position}}:")
52        for item in all_items:
53            kw_data = item.get("keyword_data", {})
54            keyword = kw_data.get("keyword", "N/A")
55            
56            # Get search volume from keyword_info
57            kw_info = kw_data.get("keyword_info", {})
58            volume = format_count(kw_info.get("search_volume", 0))
59            
60            # Get keyword difficulty
61            difficulty = kw_info.get("competition_level", "N/A")
62            
63            # Get competitor's ranking position
64            # When intersections=false, we get keywords where only second_domain (competitor) ranks
65            comp_element = item.get("second_domain_serp_element")
66            if comp_element and isinstance(comp_element, dict):
67                comp_pos = comp_element.get("rank_absolute", comp_element.get("rank_group", "N/A"))
68            else:
69                comp_pos = "N/A"
70            
71            print(f"  {keyword},{volume},{difficulty},{comp_pos}")
72    else:
73        print("No keyword gaps found")
74    
75    print()
76    print("Tip: Focus on keywords with high volume and low difficulty where competitor ranks in top 10")
77 
78 
79if __name__ == "__main__":
80    main()
81