Keyword Research → Generate Pipeline

import os, requests
from google.ads.googleads.client import GoogleAdsClient

MV = os.environ["MAVERA_API_KEY"]
CUSTOMER_ID = os.environ["GOOGLE_ADS_CUSTOMER_ID"]
MB = "https://app.mavera.io/api/v1"
MH = {"Authorization": f"Bearer {MV}", "Content-Type": "application/json"}

client = GoogleAdsClient.load_from_env()
kw_service = client.get_service("KeywordPlanIdeaService")

request = client.get_type("GenerateKeywordIdeasRequest")
request.customer_id = CUSTOMER_ID
request.language = "languageConstants/1000"  # English
request.geo_target_constants = ["geoTargetConstants/2840"]  # US
request.keyword_plan_network = client.enums.KeywordPlanNetworkEnum.GOOGLE_SEARCH
request.keyword_seed.keywords.extend([
    "marketing automation", "content marketing software", "AI marketing tools"
])

ideas = kw_service.generate_keyword_ideas(request=request)

keywords = []
for idea in ideas:
    m = idea.keyword_idea_metrics
    if m.avg_monthly_searches and m.avg_monthly_searches > 100:
        keywords.append({
            "keyword": idea.text,
            "volume": m.avg_monthly_searches,
            "competition": idea.keyword_idea_metrics.competition.name,
            "low_bid": m.low_top_of_page_bid_micros / 1_000_000 if m.low_top_of_page_bid_micros else 0,
            "high_bid": m.high_top_of_page_bid_micros / 1_000_000 if m.high_top_of_page_bid_micros else 0,
        })

keywords.sort(key=lambda k: k["volume"], reverse=True)
top_kw = keywords[:15]

print(f"Found {len(keywords)} keywords, generating content for top {len(top_kw)}")

for kw in top_kw[:5]:
    gen = requests.post(f"{MB}/generations", headers=MH, json={
        "prompt": (
            f"Write an SEO-optimized blog post outline and 300-word introduction for the keyword: \"{kw['keyword']}\". "
            f"Monthly search volume: {kw['volume']}. Competition: {kw['competition']}. "
            f"Target audience: B2B marketing professionals. "
            f"Include: H1, meta description, 5+ H2 subheadings, introduction paragraph. "
            f"Naturally incorporate the primary keyword and 2-3 related long-tail variations."
        ),
    }).json()

    print(f"\n{'='*50}")
    print(f"Keyword: {kw['keyword']} | Vol: {kw['volume']} | Comp: {kw['competition']}")
    print(f"Bid range: ${kw['low_bid']:.2f}–${kw['high_bid']:.2f}")
    print(f"{'='*50}")
    print(gen.get("output", gen.get("content", ""))[:600])