1#!/usr/bin/env python3
2"""
3Google Autocomplete keyword suggestions using DataForSEO API
4Get real-time search suggestions from Google Autocomplete
5 
6Usage: python3 scripts/autocomplete_ideas.py "Claude Code"
7"""
8import argparse
9from dataforseo_api import api_post, get_result
10 
11 
12def main():
13    parser = argparse.ArgumentParser(description="Google Autocomplete keyword suggestions")
14    parser.add_argument("keyword", help="Seed keyword for autocomplete")
15    parser.add_argument("--location", "-loc", type=int, default=2840,
16                        help="Location code (default: 2840 = US)")
17    args = parser.parse_args()
18 
19    data = [{
20        "keyword": args.keyword,
21        "location_code": args.location,
22        "language_code": "en"
23    }]
24    
25    response = api_post("serp/google/autocomplete/live/advanced", data)
26    results = get_result(response)
27    
28    print(f"keyword: {args.keyword}")
29    print(f"location: {args.location}")
30    print()
31    
32    if results:
33        suggestions = []
34        for result in results:
35            items = result.get("items", [])
36            
37            # Try different possible field names if items is empty
38            if not items:
39                items = result.get("autocomplete", [])
40                if not items:
41                    items = result.get("suggestions", [])
42            
43            for item in items:
44                # Handle different response formats
45                suggestion = None
46                if isinstance(item, dict):
47                    if item.get("type") == "autocomplete_item":
48                        suggestion = item.get("title", "").strip()
49                    elif "value" in item:
50                        suggestion = item.get("value", "").strip()
51                elif isinstance(item, str):
52                    suggestion = item.strip()
53                
54                if suggestion:
55                    suggestions.append(suggestion)
56        
57        if suggestions:
58            print(f"autocomplete_suggestions[{len(suggestions)}]:")
59            for i, suggestion in enumerate(suggestions, 1):
60                print(f"  {i}. {suggestion}")
61        else:
62            print("No suggestions found")
63    else:
64        print("No results found")
65    
66    print()
67    print("Tip: These are real user searches. Use them to:")
68    print("  - Create content matching user intent")
69    print("  - Optimize page titles and meta descriptions")
70    print("  - Discover long-tail keyword opportunities")
71 
72 
73if __name__ == "__main__":
74    main()
75