amazon-ads-cli 0.1.0__tar.gz → 0.1.2__tar.gz

{amazon_ads_cli-0.1.0 → amazon_ads_cli-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: amazon-ads-cli
-Version: 0.1.0
+Version: 0.1.2
 Summary: CLI tool for Amazon Advertising API v3
 Home-page: https://github.com/stellaraether/amazon-ads-cli
 Author: Lunan Li

{amazon_ads_cli-0.1.0 → amazon_ads_cli-0.1.2}/README.md

@@ -28,29 +28,49 @@ default:
 
 ```bash
 # List campaigns
-amz-ads campaigns list
+python3 -m amazon_ads_cli.main campaigns list
 
 # Pause campaign
-amz-ads campaigns pause <campaign-id>
+python3 -m amazon_ads_cli.main campaigns pause <campaign-id>
 
 # Enable campaign
-amz-ads campaigns enable <campaign-id>
+python3 -m amazon_ads_cli.main campaigns enable <campaign-id>
 ```
 
 ### Keywords
 
 ```bash
 # List keywords for a campaign
-amz-ads keywords list <campaign-id>
+python3 -m amazon_ads_cli.main keywords list <campaign-id>
 ```
 
 ### Reports
 
 ```bash
 # Get today's performance
-amz-ads report today
+python3 -m amazon_ads_cli.main report today
 ```
 
+## Development
+
+```bash
+# Clone repo
+git clone https://github.com/stellaraether/amazon-ads-cli.git
+cd amazon-ads-cli
+
+# Install in editable mode
+pip install -e .
+
+# Run locally
+python3 -m amazon_ads_cli.main campaigns list
+```
+
+## Requirements
+
+- Python 3.8+
+- `python-amazon-ad-api` library
+- Amazon Advertising API credentials
+
 ## License
 
 MIT

amazon_ads_cli-0.1.2/amazon_ads_cli/main.py

@@ -0,0 +1,420 @@
+#!/usr/bin/env python3
+"""Amazon Ads CLI - Command line interface for Amazon Advertising API v3."""
+
+import json
+from datetime import datetime, timedelta
+
+import click
+from ad_api.api import reports, sponsored_products
+from ad_api.base import Marketplaces
+
+
+@click.group()
+@click.option("--profile", "-p", default="default", help="Credential profile")
+@click.pass_context
+def cli(ctx, profile):
+    """Amazon Ads CLI - Manage campaigns, keywords, and reports."""
+    ctx.ensure_object(dict)
+    ctx.obj["profile"] = profile
+
+
+@cli.group()
+def campaigns():
+    """Campaign management commands."""
+    pass
+
+
+@campaigns.command("list")
+@click.pass_context
+def list_campaigns(ctx):
+    """List all campaigns."""
+    result = sponsored_products.CampaignsV3(marketplace=Marketplaces.NA).list_campaigns(
+        body={}
+    )
+    campaigns = result.payload.get("campaigns", [])
+
+    click.echo(f"\n{'Campaign':<30} {'State':<10} {'Budget':<10} {'Type'}")
+    click.echo("-" * 65)
+    for camp in campaigns:
+        name = camp["name"][:28]
+        state = camp["state"]
+        budget = f"${camp['budget']['budget']}"
+        ctype = camp.get("targetingType", "N/A")
+        click.echo(f"{name:<30} {state:<10} {budget:<10} {ctype}")
+
+
+@campaigns.command("pause")
+@click.argument("campaign-id")
+@click.pass_context
+def pause_campaign(ctx, campaign_id):
+    """Pause a campaign."""
+    try:
+        sponsored_products.CampaignsV3(marketplace=Marketplaces.NA).edit_campaigns(
+            body={"campaigns": [{"campaignId": campaign_id, "state": "PAUSED"}]}
+        )
+        click.echo(f"✅ Campaign {campaign_id} paused")
+    except Exception as e:
+        click.echo(f"❌ Error: {e}")
+
+
+@campaigns.command("enable")
+@click.argument("campaign-id")
+@click.pass_context
+def enable_campaign(ctx, campaign_id):
+    """Enable a campaign."""
+    try:
+        sponsored_products.CampaignsV3(marketplace=Marketplaces.NA).edit_campaigns(
+            body={"campaigns": [{"campaignId": campaign_id, "state": "ENABLED"}]}
+        )
+        click.echo(f"✅ Campaign {campaign_id} enabled")
+    except Exception as e:
+        click.echo(f"❌ Error: {e}")
+
+
+@campaigns.command("budget")
+@click.argument("campaign-id")
+@click.argument("amount", type=float)
+@click.pass_context
+def set_budget(ctx, campaign_id, amount):
+    """Set campaign daily budget."""
+    try:
+        sponsored_products.CampaignsV3(marketplace=Marketplaces.NA).edit_campaigns(
+            body={
+                "campaigns": [
+                    {
+                        "campaignId": campaign_id,
+                        "budget": {"budget": amount, "budgetType": "DAILY"},
+                    }
+                ]
+            }
+        )
+        click.echo(f"✅ Campaign {campaign_id} budget set to ${amount}/day")
+    except Exception as e:
+        click.echo(f"❌ Error: {e}")
+
+
+@cli.group()
+def keywords():
+    """Keyword management commands."""
+    pass
+
+
+@keywords.command("list")
+@click.argument("campaign-id")
+@click.pass_context
+def list_keywords(ctx, campaign_id):
+    """List keywords for a campaign."""
+    result = sponsored_products.KeywordsV3(marketplace=Marketplaces.NA).list_keywords(
+        body={}
+    )
+    keywords = [
+        k
+        for k in result.payload.get("keywords", [])
+        if k.get("campaignId") == campaign_id
+    ]
+
+    click.echo(f"\n{'Keyword':<35} {'Match':<10} {'Bid':<8} {'State'}")
+    click.echo("-" * 70)
+    for kw in keywords:
+        text = kw["keywordText"][:33]
+        match = kw["matchType"]
+        bid = f"${kw['bid']}"
+        state = kw["state"]
+        click.echo(f"{text:<35} {match:<10} {bid:<8} {state}")
+
+
+@keywords.command("add")
+@click.argument("campaign-id")
+@click.argument("ad-group-id")
+@click.argument("keyword-text")
+@click.option("--match-type", default="EXACT", help="Match type: EXACT, PHRASE, BROAD")
+@click.option("--bid", default=1.0, help="Bid amount")
+@click.pass_context
+def add_keyword(ctx, campaign_id, ad_group_id, keyword_text, match_type, bid):
+    """Add a keyword to a campaign."""
+    try:
+        sponsored_products.KeywordsV3(marketplace=Marketplaces.NA).create_keyword(
+            body={
+                "keywords": [
+                    {
+                        "campaignId": campaign_id,
+                        "adGroupId": ad_group_id,
+                        "keywordText": keyword_text,
+                        "matchType": match_type,
+                        "bid": bid,
+                        "state": "ENABLED",
+                    }
+                ]
+            }
+        )
+        click.echo(f"✅ Added keyword: {keyword_text} ({match_type}) - ${bid}")
+    except Exception as e:
+        click.echo(f"❌ Error: {e}")
+
+
+@keywords.command("bid")
+@click.argument("keyword-id")
+@click.argument("amount", type=float)
+@click.pass_context
+def set_bid(ctx, keyword_id, amount):
+    """Update keyword bid."""
+    try:
+        sponsored_products.KeywordsV3(marketplace=Marketplaces.NA).edit_keyword(
+            keywordId=keyword_id,
+            body={"keywords": [{"keywordId": keyword_id, "bid": amount}]},
+        )
+        click.echo(f"✅ Keyword {keyword_id} bid updated to ${amount}")
+    except Exception as e:
+        click.echo(f"❌ Error: {e}")
+
+
+@cli.group()
+def negatives():
+    """Negative keyword management commands."""
+    pass
+
+
+@negatives.command("list")
+@click.argument("campaign-id")
+@click.pass_context
+def list_negatives(ctx, campaign_id):
+    """List negative keywords for a campaign."""
+    result = sponsored_products.NegativeKeywordsV3(
+        marketplace=Marketplaces.NA
+    ).list_negative_keywords(body={"campaignIdFilter": {"include": [campaign_id]}})
+    negatives = result.payload.get("negativeKeywords", [])
+
+    click.echo(f"\n{'Negative Keyword':<35} {'Match':<15}")
+    click.echo("-" * 55)
+    for neg in negatives:
+        text = neg["keywordText"][:33]
+        match = neg["matchType"]
+        click.echo(f"{text:<35} {match:<15}")
+
+
+@negatives.command("add")
+@click.argument("campaign-id")
+@click.argument("keyword-text")
+@click.option(
+    "--match-type",
+    default="NEGATIVE_PHRASE",
+    help="Match type: NEGATIVE_EXACT, NEGATIVE_PHRASE",
+)
+@click.pass_context
+def add_negative(ctx, campaign_id, keyword_text, match_type):
+    """Add a negative keyword to a campaign."""
+    try:
+        sponsored_products.NegativeKeywordsV3(
+            marketplace=Marketplaces.NA
+        ).create_negative_keywords(
+            body={
+                "negativeKeywords": [
+                    {
+                        "campaignId": campaign_id,
+                        "keywordText": keyword_text,
+                        "matchType": match_type,
+                        "state": "ENABLED",
+                    }
+                ]
+            }
+        )
+        click.echo(f"✅ Added negative keyword: {keyword_text} ({match_type})")
+    except Exception as e:
+        click.echo(f"❌ Error: {e}")
+
+
+@cli.group()
+def report():
+    """Report commands."""
+    pass
+
+
+@report.command("today")
+@click.pass_context
+def report_today(ctx):
+    """Get today's performance report."""
+    today = datetime.now().strftime("%Y-%m-%d")
+
+    click.echo(f"Requesting report for {today}...")
+
+    report_body = {
+        "name": f"SP_Today_{today}",
+        "startDate": today,
+        "endDate": today,
+        "configuration": {
+            "adProduct": "SPONSORED_PRODUCTS",
+            "columns": [
+                "impressions",
+                "clicks",
+                "cost",
+                "purchases14d",
+                "sales14d",
+                "campaignName",
+                "campaignId",
+            ],
+            "reportTypeId": "spCampaigns",
+            "format": "GZIP_JSON",
+            "groupBy": ["campaign"],
+            "timeUnit": "SUMMARY",
+        },
+    }
+
+    try:
+        # Submit report
+        result = reports.Reports(marketplace=Marketplaces.NA).post_report(
+            body=report_body
+        )
+        report_id = result.payload["reportId"]
+
+        click.echo(f"Report submitted: {report_id}")
+        click.echo("Polling for completion...")
+
+        # Poll
+        import time
+
+        for i in range(20):
+            result = reports.Reports(marketplace=Marketplaces.NA).get_report(
+                reportId=report_id
+            )
+            status = result.payload.get("status")
+
+            if status == "COMPLETED":
+                # Download
+                import gzip
+
+                import requests
+
+                url = result.payload.get("url")
+                response = requests.get(url)
+                data = gzip.decompress(response.content)
+                report_data = json.loads(data)
+
+                click.echo(
+                    f"\n{'Campaign':<30} {'Impr':>8} {'Clicks':>7} {'Spend':>8} {'Sales':>8} {'ACOS'}"
+                )
+                click.echo("-" * 75)
+
+                for row in report_data:
+                    camp_name = row.get("campaignName", "N/A")[:28]
+                    impr = int(row.get("impressions", 0) or 0)
+                    clicks = int(row.get("clicks", 0) or 0)
+                    cost = float(row.get("cost", 0) or 0)
+                    sales = float(row.get("sales14d", 0) or 0)
+                    acos = (cost / sales * 100) if sales > 0 else 0
+
+                    click.echo(
+                        f"{camp_name:<30} {impr:>8} {clicks:>7} ${cost:>7.2f} ${sales:>7.2f} {acos:>5.1f}%"
+                    )
+
+                return
+
+            elif status == "FAILED":
+                click.echo(f"❌ Report failed: {result.payload.get('failureReason')}")
+                return
+
+            time.sleep(3)
+
+        click.echo("⏳ Report still processing...")
+
+    except Exception as e:
+        click.echo(f"❌ Error: {e}")
+
+
+@report.command("search-terms")
+@click.option("--days", default=7, help="Number of days to look back")
+@click.pass_context
+def search_terms_report(ctx, days):
+    """Get search term report."""
+    end_date = datetime.now().strftime("%Y-%m-%d")
+    start_date = (datetime.now() - timedelta(days=days)).strftime("%Y-%m-%d")
+
+    click.echo(f"Requesting search term report: {start_date} to {end_date}...")
+
+    report_body = {
+        "name": f"SP_SearchTerms_{start_date}_{end_date}",
+        "startDate": start_date,
+        "endDate": end_date,
+        "configuration": {
+            "adProduct": "SPONSORED_PRODUCTS",
+            "columns": [
+                "impressions",
+                "clicks",
+                "cost",
+                "purchases14d",
+                "sales14d",
+                "searchTerm",
+                "matchType",
+                "campaignName",
+                "keyword",
+            ],
+            "reportTypeId": "spSearchTerm",
+            "format": "GZIP_JSON",
+            "groupBy": ["searchTerm"],
+            "timeUnit": "SUMMARY",
+        },
+    }
+
+    try:
+        result = reports.Reports(marketplace=Marketplaces.NA).post_report(
+            body=report_body
+        )
+        report_id = result.payload["reportId"]
+
+        click.echo(f"Report submitted: {report_id}")
+        click.echo("Polling for completion...")
+
+        import time
+
+        for i in range(30):
+            result = reports.Reports(marketplace=Marketplaces.NA).get_report(
+                reportId=report_id
+            )
+            status = result.payload.get("status")
+
+            if status == "COMPLETED":
+                import gzip
+
+                import requests
+
+                url = result.payload.get("url")
+                response = requests.get(url)
+                data = gzip.decompress(response.content)
+                report_data = json.loads(data)
+
+                # Sort by cost (highest first)
+                report_data.sort(
+                    key=lambda x: float(x.get("cost", 0) or 0), reverse=True
+                )
+
+                click.echo(
+                    f"\n{'Search Term':<40} {'Campaign':<20} {'Spend':>8} {'Sales':>8} {'ACOS'}"
+                )
+                click.echo("-" * 90)
+
+                for row in report_data[:20]:
+                    term = row.get("searchTerm", "N/A")[:38]
+                    camp = row.get("campaignName", "N/A")[:18]
+                    cost = float(row.get("cost", 0) or 0)
+                    sales = float(row.get("sales14d", 0) or 0)
+                    acos = (cost / sales * 100) if sales > 0 else 0
+
+                    click.echo(
+                        f"{term:<40} {camp:<20} ${cost:>7.2f} ${sales:>7.2f} {acos:>5.1f}%"
+                    )
+
+                return
+
+            elif status == "FAILED":
+                click.echo(f"❌ Report failed: {result.payload.get('failureReason')}")
+                return
+
+            time.sleep(5)
+
+        click.echo("⏳ Report still processing...")
+
+    except Exception as e:
+        click.echo(f"❌ Error: {e}")
+
+
+if __name__ == "__main__":
+    cli()

{amazon_ads_cli-0.1.0 → amazon_ads_cli-0.1.2}/amazon_ads_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: amazon-ads-cli
-Version: 0.1.0
+Version: 0.1.2
 Summary: CLI tool for Amazon Advertising API v3
 Home-page: https://github.com/stellaraether/amazon-ads-cli
 Author: Lunan Li

{amazon_ads_cli-0.1.0 → amazon_ads_cli-0.1.2}/setup.py

@@ -1,8 +1,8 @@
-from setuptools import setup, find_packages
+from setuptools import find_packages, setup
 
 setup(
     name="amazon-ads-cli",
-    version="0.1.0",
+    version="0.1.2",
     description="CLI tool for Amazon Advertising API v3",
     author="Lunan Li",
     author_email="lunan@stellaraether.com",

amazon_ads_cli-0.1.0/amazon_ads_cli/main.py

@@ -1,179 +0,0 @@
-#!/usr/bin/env python3
-"""Amazon Ads CLI - Command line interface for Amazon Advertising API v3."""
-
-import click
-import json
-from datetime import datetime, timedelta
-from ad_api.api import sponsored_products, reports
-from ad_api.base import Marketplaces
-
-
-@click.group()
-@click.option('--profile', '-p', default='default', help='Credential profile')
-@click.pass_context
-def cli(ctx, profile):
-    """Amazon Ads CLI - Manage campaigns, keywords, and reports."""
-    ctx.ensure_object(dict)
-    ctx.obj['profile'] = profile
-
-
-@cli.group()
-def campaigns():
-    """Campaign management commands."""
-    pass
-
-
-@campaigns.command('list')
-@click.pass_context
-def list_campaigns(ctx):
-    """List all campaigns."""
-    result = sponsored_products.CampaignsV3(marketplace=Marketplaces.NA).list_campaigns(body={})
-    campaigns = result.payload.get('campaigns', [])
-    
-    click.echo(f"\n{'Campaign':<30} {'State':<10} {'Budget':<10} {'Type'}")
-    click.echo("-" * 65)
-    for camp in campaigns:
-        name = camp['name'][:28]
-        state = camp['state']
-        budget = f"${camp['budget']['budget']}"
-        ctype = camp.get('targetingType', 'N/A')
-        click.echo(f"{name:<30} {state:<10} {budget:<10} {ctype}")
-
-
-@campaigns.command('pause')
-@click.argument('campaign-id')
-@click.pass_context
-def pause_campaign(ctx, campaign_id):
-    """Pause a campaign."""
-    try:
-        result = sponsored_products.CampaignsV3(marketplace=Marketplaces.NA).edit_campaigns(
-            body={"campaigns": [{"campaignId": campaign_id, "state": "PAUSED"}]}
-        )
-        click.echo(f"✅ Campaign {campaign_id} paused")
-    except Exception as e:
-        click.echo(f"❌ Error: {e}")
-
-
-@campaigns.command('enable')
-@click.argument('campaign-id')
-@click.pass_context
-def enable_campaign(ctx, campaign_id):
-    """Enable a campaign."""
-    try:
-        result = sponsored_products.CampaignsV3(marketplace=Marketplaces.NA).edit_campaigns(
-            body={"campaigns": [{"campaignId": campaign_id, "state": "ENABLED"}]}
-        )
-        click.echo(f"✅ Campaign {campaign_id} enabled")
-    except Exception as e:
-        click.echo(f"❌ Error: {e}")
-
-
-@cli.group()
-def keywords():
-    """Keyword management commands."""
-    pass
-
-
-@keywords.command('list')
-@click.argument('campaign-id')
-@click.pass_context
-def list_keywords(ctx, campaign_id):
-    """List keywords for a campaign."""
-    result = sponsored_products.KeywordsV3(marketplace=Marketplaces.NA).list_keywords(body={})
-    keywords = [k for k in result.payload.get('keywords', []) if k.get('campaignId') == campaign_id]
-    
-    click.echo(f"\n{'Keyword':<35} {'Match':<10} {'Bid':<8} {'State'}")
-    click.echo("-" * 70)
-    for kw in keywords:
-        text = kw['keywordText'][:33]
-        match = kw['matchType']
-        bid = f"${kw['bid']}"
-        state = kw['state']
-        click.echo(f"{text:<35} {match:<10} {bid:<8} {state}")
-
-
-@cli.group()
-def report():
-    """Report commands."""
-    pass
-
-
-@report.command('today')
-@click.pass_context
-def report_today(ctx):
-    """Get today's performance report."""
-    today = datetime.now().strftime('%Y-%m-%d')
-    
-    click.echo(f"Requesting report for {today}...")
-    
-    report_body = {
-        "name": f"SP_Today_{today}",
-        "startDate": today,
-        "endDate": today,
-        "configuration": {
-            "adProduct": "SPONSORED_PRODUCTS",
-            "columns": [
-                "impressions", "clicks", "cost",
-                "purchases14d", "sales14d",
-                "campaignName", "campaignId"
-            ],
-            "reportTypeId": "spCampaigns",
-            "format": "GZIP_JSON",
-            "groupBy": ["campaign"],
-            "timeUnit": "SUMMARY"
-        }
-    }
-    
-    try:
-        # Submit report
-        result = reports.Reports(marketplace=Marketplaces.NA).post_report(body=report_body)
-        report_id = result.payload['reportId']
-        
-        click.echo(f"Report submitted: {report_id}")
-        click.echo("Polling for completion...")
-        
-        # Poll
-        import time
-        for i in range(20):
-            result = reports.Reports(marketplace=Marketplaces.NA).get_report(reportId=report_id)
-            status = result.payload.get('status')
-            
-            if status == 'COMPLETED':
-                # Download
-                import requests
-                import gzip
-                
-                url = result.payload.get('url')
-                response = requests.get(url)
-                data = gzip.decompress(response.content)
-                report_data = json.loads(data)
-                
-                click.echo(f"\n{'Campaign':<30} {'Impr':>8} {'Clicks':>7} {'Spend':>8} {'Sales':>8} {'ACOS'}")
-                click.echo("-" * 75)
-                
-                for row in report_data:
-                    camp_name = row.get('campaignName', 'N/A')[:28]
-                    impr = int(row.get('impressions', 0) or 0)
-                    clicks = int(row.get('clicks', 0) or 0)
-                    cost = float(row.get('cost', 0) or 0)
-                    sales = float(row.get('sales14d', 0) or 0)
-                    acos = (cost / sales * 100) if sales > 0 else 0
-                    
-                    click.echo(f"{camp_name:<30} {impr:>8} {clicks:>7} ${cost:>7.2f} ${sales:>7.2f} {acos:>5.1f}%")
-                
-                return
-            
-            elif status == 'FAILED':
-                click.echo(f"❌ Report failed: {result.payload.get('failureReason')}")
-                return
-            
-            time.sleep(3)
-        
-        click.echo("⏳ Report still processing...")
-        
-    except Exception as e:
-        click.echo(f"❌ Error: {e}")
-
-
-if __name__ == '__main__':
-    cli()