cli-web-amazon 0.1.1__tar.gz

cli_web_amazon-0.1.1/PKG-INFO

@@ -0,0 +1,14 @@
+Metadata-Version: 2.4
+Name: cli-web-amazon
+Version: 0.1.1
+Summary: Amazon CLI — Search, browse, and shop Amazon from your terminal
+Requires-Python: >=3.10
+Requires-Dist: click>=8.0
+Requires-Dist: httpx>=0.25
+Requires-Dist: curl_cffi>=0.7
+Requires-Dist: beautifulsoup4>=4.12
+Requires-Dist: rich>=13.0
+Requires-Dist: prompt_toolkit>=3.0
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

cli_web_amazon-0.1.1/cli_web/amazon/README.md

@@ -0,0 +1,83 @@
+# cli-web-amazon
+
+> Generated by [CLI-Anything-Web](../../../../cli-anything-web-plugin/) from [amazon.com](https://www.amazon.com)
+
+Search Amazon products, view details, browse Best Sellers, and get autocomplete suggestions. No authentication required — all commands use public Amazon endpoints.
+
+## Installation
+
+```bash
+pip install cli-web-amazon
+```
+
+## Usage
+
+### Search
+
+```bash
+cli-web-amazon search "laptop"
+cli-web-amazon search "headphones" --dept electronics --page 2
+cli-web-amazon search "coffee maker" --json
+```
+
+### Autocomplete Suggestions
+
+```bash
+cli-web-amazon suggest "headp"
+cli-web-amazon suggest "lapt" --json
+```
+
+### Product Details
+
+```bash
+cli-web-amazon product get B0GRZ78683
+cli-web-amazon product get B0GRZ78683 --json
+```
+
+### Best Sellers
+
+```bash
+cli-web-amazon bestsellers electronics
+cli-web-amazon bestsellers books --page 2
+cli-web-amazon bestsellers --json
+```
+
+## JSON Output
+
+Every command supports `--json` for structured output suitable for piping and scripting:
+
+```bash
+cli-web-amazon search "laptop" --json | jq '.[0]'
+cli-web-amazon product get B0GRZ78683 --json | jq '.price'
+cli-web-amazon bestsellers electronics --json | jq '.[].title'
+```
+
+## REPL Mode
+
+Run without arguments to enter interactive REPL mode:
+
+```bash
+cli-web-amazon
+```
+
+Type `help` inside the REPL to see all available commands.
+
+## Testing
+
+```bash
+cd amazon/agent-harness
+pip install -e .
+
+# Unit tests (no network)
+python -m pytest cli_web/amazon/tests/test_core.py -v
+
+# All tests including E2E
+python -m pytest cli_web/amazon/tests/ -v -s
+```
+
+## Protocol
+
+- **Website:** https://www.amazon.com
+- **Protocol:** SSR HTML + REST JSON hybrid
+- **Auth:** None — all commands use public Amazon endpoints
+- **HTTP library:** curl_cffi (Chrome impersonation — bypasses Amazon's 503 bot block)

cli_web_amazon-0.1.1/cli_web/amazon/__init__.py

@@ -0,0 +1,3 @@
+"""cli-web-amazon — Amazon CLI package."""
+
+__version__ = "1.0.0"

cli_web_amazon-0.1.1/cli_web/amazon/__main__.py

@@ -0,0 +1,6 @@
+"""Allow running as: python -m cli_web.amazon"""
+
+from .amazon_cli import main
+
+if __name__ == "__main__":
+    main()

cli_web_amazon-0.1.1/cli_web/amazon/amazon_cli.py

@@ -0,0 +1,155 @@
+"""cli-web-amazon entry point — Amazon CLI."""
+
+import sys
+
+# Windows UTF-8 fix — must be before any imports that print
+if sys.stdout.encoding and sys.stdout.encoding.lower() not in ("utf-8", "utf8"):
+    try:
+        sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+    except AttributeError:
+        pass
+if sys.stderr.encoding and sys.stderr.encoding.lower() not in ("utf-8", "utf8"):
+    try:
+        sys.stderr.reconfigure(encoding="utf-8", errors="replace")
+    except AttributeError:
+        pass
+
+import shlex
+
+import click
+
+from .commands.bestsellers import bestsellers
+from .commands.product import product
+from .commands.search import search
+from .commands.suggest import suggest
+from .core.exceptions import AmazonError
+from .utils.repl_skin import ReplSkin
+
+__version__ = "1.0.0"
+
+_skin = ReplSkin("amazon", version=__version__)
+
+
+def _print_repl_help():
+    """Print REPL command reference."""
+    _skin.info("Available commands:")
+    print()
+    print("  suggest <query>                   Autocomplete suggestions")
+    print("  search <query> [OPTIONS]          Search Amazon products")
+    print("    --page N                        Page number (default: 1)")
+    print("    --dept <department>             Department filter")
+    print()
+    print("  product get <ASIN>                Product detail by ASIN")
+    print()
+    print("  bestsellers [<category>]          Best Sellers list")
+    print("    category: electronics, books, toys-and-games, music, ...")
+    print("    --page N                        Page number")
+    print()
+    print("  Global options: --json            Output as JSON")
+    print()
+    print("  help    Show this help")
+    print("  quit    Exit REPL")
+    print()
+
+
+@click.group(invoke_without_command=True)
+@click.option(
+    "--json", "json_mode", is_flag=True, default=False, help="Output all results as JSON."
+)
+@click.version_option(__version__, "--version", "-V")
+@click.pass_context
+def cli(ctx, json_mode):
+    """cli-web-amazon — Browse and search Amazon from your terminal.
+
+    Run without a subcommand to enter interactive REPL mode.
+
+    Examples:
+      cli-web-amazon search laptop
+      cli-web-amazon product get B0GRZ78683
+      cli-web-amazon bestsellers electronics
+      cli-web-amazon suggest headphones
+    """
+    ctx.ensure_object(dict)
+    ctx.obj["json"] = json_mode
+
+    if ctx.invoked_subcommand is None:
+        # Enter REPL mode
+        _run_repl(ctx, json_mode)
+
+
+def _run_repl(ctx, json_mode: bool):
+    """Run interactive REPL mode."""
+    _skin.print_banner()
+
+    if not json_mode:
+        _skin.info("Type 'help' for commands, 'quit' to exit.")
+        print()
+
+    pt_session = _skin.create_prompt_session()
+
+    while True:
+        try:
+            line = _skin.get_input(pt_session)
+        except (EOFError, KeyboardInterrupt):
+            _skin.print_goodbye()
+            break
+
+        if not line:
+            continue
+
+        cmd = line.strip().lower()
+        if cmd in ("quit", "exit", "q"):
+            _skin.print_goodbye()
+            break
+        if cmd in ("help", "?", "h"):
+            _print_repl_help()
+            continue
+
+        try:
+            args = shlex.split(line)
+        except ValueError as exc:
+            _skin.error(f"Parse error: {exc}")
+            continue
+
+        # Preserve --json flag
+        repl_args = ["--json"] + args if json_mode else args
+
+        try:
+            cli.main(args=repl_args, standalone_mode=False)
+        except SystemExit:
+            pass
+        except click.UsageError as exc:
+            _skin.error(str(exc))
+        except Exception as exc:
+            if json_mode and isinstance(exc, AmazonError):
+                import json as _json
+
+                click.echo(_json.dumps(exc.to_dict()))
+            else:
+                _skin.error(str(exc))
+
+
+# Register subcommands
+cli.add_command(search)
+cli.add_command(suggest)
+cli.add_command(product)
+cli.add_command(bestsellers)
+
+
+def main():
+    """Entry point for cli-web-amazon."""
+    cli()
+
+
+# MCP server mode — exposes every command as an MCP tool over stdio.
+# Canonical adapter: cli-web-core/cli_web_core/mcp_server.py (vendored copy).
+from cli_web.amazon import __version__ as _pkg_version  # noqa: E402
+from cli_web.amazon.utils.doctor import register_doctor_command  # noqa: E402
+from cli_web.amazon.utils.mcp_server import register_mcp_command  # noqa: E402
+
+register_mcp_command(cli, app_name="amazon", version=_pkg_version)
+register_doctor_command(cli, app_name="amazon", pkg="amazon")
+
+
+if __name__ == "__main__":
+    main()

cli_web_amazon-0.1.1/cli_web/amazon/commands/__init__.py

@@ -0,0 +1 @@
+"""CLI command groups for cli-web-amazon."""

cli_web_amazon-0.1.1/cli_web/amazon/commands/bestsellers.py

@@ -0,0 +1,61 @@
+"""Best sellers commands for cli-web-amazon."""
+
+import click
+
+from ..core.client import AmazonClient
+from ..utils.helpers import handle_errors, print_json
+from ..utils.output import print_bestsellers
+
+COMMON_CATEGORIES = [
+    "electronics",
+    "books",
+    "toys-and-games",
+    "music",
+    "video-games",
+    "home-garden",
+    "clothing-shoes-jewelry",
+    "sports-outdoors",
+    "kitchen",
+    "office-products",
+    "pet-supplies",
+    "beauty",
+    "health-household",
+    "automotive",
+    "tools-home-improvement",
+]
+
+
+@click.command("bestsellers")
+@click.argument("category", default="electronics")
+@click.option(
+    "--page", type=int, default=1, show_default=True, help="Page number (each page has ~50 items)."
+)
+@click.option("--json", "use_json", is_flag=True, default=False, help="Output as JSON.")
+def bestsellers(category, page, use_json):
+    """Browse Amazon Best Sellers by category.
+
+    CATEGORY defaults to 'electronics'. Other common values:
+    books, toys-and-games, music, video-games, home-garden,
+    clothing-shoes-jewelry, sports-outdoors, kitchen, beauty
+
+    Examples:
+      cli-web-amazon bestsellers
+      cli-web-amazon bestsellers books
+      cli-web-amazon bestsellers electronics --page 2
+      cli-web-amazon bestsellers toys-and-games --json
+    """
+    with handle_errors(json_mode=use_json):
+        with AmazonClient() as client:
+            items = client.get_bestsellers(category=category, page=page)
+
+        if use_json:
+            print_json([i.to_dict() for i in items])
+        else:
+            if not items:
+                click.echo(
+                    f"No best sellers found for category '{category}'.\n"
+                    f"Try one of: {', '.join(COMMON_CATEGORIES[:5])}"
+                )
+            else:
+                print_bestsellers(items, category=category)
+                click.echo(f"\n{len(items)} items. Use --page to see more.")

cli_web_amazon-0.1.1/cli_web/amazon/commands/product.py

@@ -0,0 +1,36 @@
+"""Product commands for cli-web-amazon."""
+
+import click
+
+from ..core.client import AmazonClient
+from ..utils.helpers import handle_errors, print_json
+from ..utils.output import print_product
+
+
+@click.group("product")
+def product():
+    """Amazon product operations."""
+    pass
+
+
+@product.command("get")
+@click.argument("asin")
+@click.option("--json", "use_json", is_flag=True, default=False, help="Output as JSON.")
+def get_product(asin, use_json):
+    """Get product details by ASIN.
+
+    ASIN is Amazon's Standard Identification Number (e.g., B0GRZ78683).
+
+    Examples:
+      cli-web-amazon product get B0GRZ78683
+      cli-web-amazon product get B087JWTWF9 --json
+    """
+    with handle_errors(json_mode=use_json):
+        asin = asin.upper().strip()
+        with AmazonClient() as client:
+            p = client.get_product(asin)
+
+        if use_json:
+            print_json(p.to_dict())
+        else:
+            print_product(p)

cli_web_amazon-0.1.1/cli_web/amazon/commands/search.py

@@ -0,0 +1,45 @@
+"""Search commands for cli-web-amazon."""
+
+import click
+
+from ..core.client import AmazonClient
+from ..utils.helpers import handle_errors, print_json
+from ..utils.output import print_search_results
+
+
+@click.command("search")
+@click.argument("query")
+@click.option("--page", type=int, default=1, show_default=True, help="Page number of results.")
+@click.option(
+    "--dept",
+    "--department",
+    "department",
+    default=None,
+    help="Department filter (e.g., 'electronics', 'books').",
+)
+@click.option("--json", "use_json", is_flag=True, default=False, help="Output as JSON.")
+def search(query, page, department, use_json):
+    """Search Amazon products by keyword.
+
+    Returns product cards with ASIN, title, price, and rating.
+
+    Examples:
+      cli-web-amazon search laptop
+      cli-web-amazon search "wireless headphones" --page 2
+      cli-web-amazon search camera --dept electronics
+    """
+    with handle_errors(json_mode=use_json):
+        with AmazonClient() as client:
+            results = client.search(query, page=page, department=department)
+
+        if use_json:
+            print_json([r.to_dict() for r in results])
+        else:
+            if not results:
+                click.echo(f"No results found for '{query}'.")
+            else:
+                title = f"Search: {query}"
+                if page > 1:
+                    title += f" (page {page})"
+                print_search_results(results, title=title)
+                click.echo(f"\n{len(results)} results. Use --page to see more.")

cli_web_amazon-0.1.1/cli_web/amazon/commands/suggest.py

@@ -0,0 +1,36 @@
+"""Autocomplete suggestion commands for cli-web-amazon."""
+
+import click
+
+from ..core.client import AmazonClient
+from ..utils.helpers import handle_errors, print_json
+from ..utils.output import print_suggestions
+
+
+@click.command("suggest")
+@click.argument("query")
+@click.option(
+    "--limit",
+    type=int,
+    default=11,
+    show_default=True,
+    help="Maximum number of suggestions to return.",
+)
+@click.option("--json", "use_json", is_flag=True, default=False, help="Output as JSON.")
+def suggest(query, limit, use_json):
+    """Get autocomplete suggestions for a search query.
+
+    Example: cli-web-amazon suggest laptop
+    """
+    with handle_errors(json_mode=use_json):
+        with AmazonClient() as client:
+            results = client.get_suggestions(query, limit=limit)
+
+        if use_json:
+            print_json([s.to_dict() for s in results])
+        else:
+            if not results:
+                click.echo(f"No suggestions for '{query}'.")
+            else:
+                click.echo(f"Suggestions for '{query}':")
+                print_suggestions(results)

cli_web_amazon-0.1.1/cli_web/amazon/core/__init__.py

@@ -0,0 +1 @@
+"""Core modules for cli-web-amazon."""