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

amazon_ads_cli-0.1.3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Stellar Aether
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: amazon-ads-cli
-Version: 0.1.2
+Version: 0.1.3
 Summary: CLI tool for Amazon Advertising API v3
 Home-page: https://github.com/stellaraether/amazon-ads-cli
 Author: Lunan Li
@@ -14,6 +14,7 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Requires-Python: >=3.8
+License-File: LICENSE
 Requires-Dist: click>=8.0
 Requires-Dist: python-amazon-ad-api>=0.8.0
 Requires-Dist: requests>=2.27.0
@@ -21,6 +22,7 @@ Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
 Dynamic: home-page
+Dynamic: license-file
 Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary

amazon_ads_cli-0.1.3/amazon_ads_cli/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point for python -m amazon_ads_cli."""
+
+from amazon_ads_cli.main import cli
+
+if __name__ == "__main__":
+    cli()

{amazon_ads_cli-0.1.2 → amazon_ads_cli-0.1.3}/amazon_ads_cli/main.py

@@ -2,22 +2,142 @@
 """Amazon Ads CLI - Command line interface for Amazon Advertising API v3."""
 
 import json
+import os
 from datetime import datetime, timedelta
 
 import click
+import yaml
 from ad_api.api import reports, sponsored_products
 from ad_api.base import Marketplaces
 
+DEFAULT_CREDENTIALS_PATH = os.path.expanduser("~/.config/python-ad-api/credentials.yml")
+
+
+def _check_path():
+    """Check if the CLI is accessible in PATH and warn if not."""
+    import shutil
+    import sys
+
+    if not shutil.which("amz-ads"):
+        print(
+            "\n⚠️  Note: 'amz-ads' is not in your PATH.",
+            file=sys.stderr,
+        )
+        print(
+            "   You can still use: python3 -m amazon_ads_cli",
+            file=sys.stderr,
+        )
+        print(
+            "   To add to PATH, add this to your shell config:",
+            file=sys.stderr,
+        )
+        print(
+            f'   export PATH="{sys.prefix}/bin:$PATH"',
+            file=sys.stderr,
+        )
+        print("", file=sys.stderr)
+
 
 @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."""
+    _check_path()
     ctx.ensure_object(dict)
     ctx.obj["profile"] = profile
 
 
+@cli.group()
+def auth():
+    """Authentication commands."""
+    pass
+
+
+@auth.command("setup")
+@click.option(
+    "--path", default=DEFAULT_CREDENTIALS_PATH, help="Path to save credentials"
+)
+@click.pass_context
+def auth_setup(ctx, path):
+    """Interactive setup for Amazon Ads API credentials."""
+    click.echo("🔐 Amazon Ads API Credential Setup")
+    click.echo("=" * 50)
+    click.echo()
+    click.echo("You'll need the following from your Amazon Developer account:")
+    click.echo("  1. Refresh Token (from LWA authorization)")
+    click.echo("  2. Client ID (from your app registration)")
+    click.echo("  3. Client Secret (from your app registration)")
+    click.echo("  4. Profile ID (your Amazon Ads account ID)")
+    click.echo()
+
+    profile = click.prompt("Profile name", default="default")
+    refresh_token = click.prompt("Refresh token", hide_input=True)
+    client_id = click.prompt("Client ID")
+    client_secret = click.prompt("Client secret", hide_input=True)
+    profile_id = click.prompt("Profile ID (numeric)")
+
+    credentials = {
+        "version": "1.0",
+        profile: {
+            "refresh_token": refresh_token,
+            "client_id": client_id,
+            "client_secret": client_secret,
+            "profile_id": profile_id,
+        },
+    }
+
+    # Merge with existing if present
+    if os.path.exists(path):
+        try:
+            with open(path, "r") as f:
+                existing = yaml.safe_load(f) or {}
+            existing[profile] = credentials[profile]
+            credentials = existing
+            click.echo(f"\n📝 Merged with existing credentials at {path}")
+        except Exception as e:
+            click.echo(f"⚠️  Could not read existing file: {e}")
+
+    os.makedirs(os.path.dirname(path), exist_ok=True)
+    with open(path, "w") as f:
+        yaml.dump(credentials, f, default_flow_style=False, sort_keys=False)
+
+    click.echo(f"✅ Credentials saved to {path}")
+    click.echo(f"   Profile: {profile}")
+    click.echo(f"   Profile ID: {profile_id}")
+    click.echo()
+    click.echo(
+        "You can now use: python -m amazon_ads_cli.main --profile {profile} campaigns list"
+    )
+
+
+@auth.command("show")
+@click.option(
+    "--path", default=DEFAULT_CREDENTIALS_PATH, help="Path to credentials file"
+)
+@click.pass_context
+def auth_show(ctx, path):
+    """Show configured profiles (without secrets)."""
+    if not os.path.exists(path):
+        click.echo(f"❌ No credentials file found at {path}")
+        click.echo("Run: python -m amazon_ads_cli.main auth setup")
+        return
+
+    with open(path, "r") as f:
+        creds = yaml.safe_load(f) or {}
+
+    click.echo(f"\n📄 Credentials file: {path}")
+    click.echo("-" * 40)
+
+    for profile, data in creds.items():
+        if profile == "version":
+            continue
+        click.echo(f"Profile: {profile}")
+        click.echo(f"  Client ID: {data.get('client_id', 'N/A')[:20]}...")
+        click.echo(f"  Profile ID: {data.get('profile_id', 'N/A')}")
+        click.echo()
+
+
 @cli.group()
 def campaigns():
     """Campaign management commands."""
@@ -181,7 +301,12 @@ 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]}})
+    ).list_negative_keywords(
+        body={
+            "campaignIdFilter": {"include": [campaign_id]},
+            "stateFilter": {"include": ["ENABLED"]},
+        }
+    )
     negatives = result.payload.get("negativeKeywords", [])
 
     click.echo(f"\n{'Negative Keyword':<35} {'Match':<15}")
@@ -194,6 +319,7 @@ def list_negatives(ctx, campaign_id):
 
 @negatives.command("add")
 @click.argument("campaign-id")
+@click.argument("ad-group-id")
 @click.argument("keyword-text")
 @click.option(
     "--match-type",
@@ -201,16 +327,17 @@ def list_negatives(ctx, campaign_id):
     help="Match type: NEGATIVE_EXACT, NEGATIVE_PHRASE",
 )
 @click.pass_context
-def add_negative(ctx, campaign_id, keyword_text, match_type):
+def add_negative(ctx, campaign_id, ad_group_id, keyword_text, match_type):
     """Add a negative keyword to a campaign."""
     try:
         sponsored_products.NegativeKeywordsV3(
             marketplace=Marketplaces.NA
-        ).create_negative_keywords(
+        ).create_negative_keyword(
             body={
                 "negativeKeywords": [
                     {
                         "campaignId": campaign_id,
+                        "adGroupId": ad_group_id,
                         "keywordText": keyword_text,
                         "matchType": match_type,
                         "state": "ENABLED",
@@ -223,6 +350,22 @@ def add_negative(ctx, campaign_id, keyword_text, match_type):
         click.echo(f"❌ Error: {e}")
 
 
+@negatives.command("remove")
+@click.argument("negative-keyword-id")
+@click.pass_context
+def remove_negative(ctx, negative_keyword_id):
+    """Remove a negative keyword by ID."""
+    try:
+        sponsored_products.NegativeKeywordsV3(
+            marketplace=Marketplaces.NA
+        ).delete_negative_keywords(
+            body={"negativeKeywordIdFilter": {"include": [negative_keyword_id]}}
+        )
+        click.echo(f"✅ Removed negative keyword: {negative_keyword_id}")
+    except Exception as e:
+        click.echo(f"❌ Error: {e}")
+
+
 @cli.group()
 def report():
     """Report commands."""

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: amazon-ads-cli
-Version: 0.1.2
+Version: 0.1.3
 Summary: CLI tool for Amazon Advertising API v3
 Home-page: https://github.com/stellaraether/amazon-ads-cli
 Author: Lunan Li
@@ -14,6 +14,7 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Requires-Python: >=3.8
+License-File: LICENSE
 Requires-Dist: click>=8.0
 Requires-Dist: python-amazon-ad-api>=0.8.0
 Requires-Dist: requests>=2.27.0
@@ -21,6 +22,7 @@ Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
 Dynamic: home-page
+Dynamic: license-file
 Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary

{amazon_ads_cli-0.1.2 → amazon_ads_cli-0.1.3}/amazon_ads_cli.egg-info/SOURCES.txt

@@ -1,6 +1,8 @@
+LICENSE
 README.md
 setup.py
 amazon_ads_cli/__init__.py
+amazon_ads_cli/__main__.py
 amazon_ads_cli/main.py
 amazon_ads_cli.egg-info/PKG-INFO
 amazon_ads_cli.egg-info/SOURCES.txt

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

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