aukeys-opscli 0.0.6__py3-none-any.whl

aukeys_opscli-0.0.6.dist-info/METADATA

@@ -0,0 +1,15 @@
+Metadata-Version: 2.4
+Name: aukeys-opscli
+Version: 0.0.6
+Summary: Aukeys 运营 CLI 工具集
+Requires-Python: >=3.10
+Requires-Dist: cryptography>=38
+Requires-Dist: httpx>=0.27
+Requires-Dist: keyring>=25
+Requires-Dist: rich>=13
+Requires-Dist: typer>=0.12
+Provides-Extra: amazon
+Requires-Dist: playwright>=1.44; extra == 'amazon'
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: respx>=0.21; extra == 'dev'

aukeys_opscli-0.0.6.dist-info/RECORD

@@ -0,0 +1,92 @@
+opscli/__init__.py,sha256=BcCmcibiVILynMDCEMT4ECjMqvGx6Ym97Wh7o-05MbI,303
+opscli/cli.py,sha256=Yvov0gICf11dqJlImp6klpTFDbQTEESmmM-0eftFJT8,1088
+opscli/config.py,sha256=eIV7yutla7rQkW9OA5Y6JG_x8c83K74OHNd0FTPeV0w,74
+opscli/version.py,sha256=oqBlQnY7eXGkvQ8vMDwYkq2bWCeGKtcwtJJP11ECxiI,443
+opscli/amazon/__init__.py,sha256=afpJXg0k0sVCtOXwtg4Mx5FYsMpEw5p0InnmBlOu0dw,396
+opscli/amazon/cli.py,sha256=DcylM64-FkU7Umh4JQZip8wSrW4GZf59O0tDM3lglHs,96
+opscli/amazon/client.py,sha256=DSVTY-9AKO59sWImEJmMdSqcAI8bY4aQOToUQWGJZLg,127
+opscli/amazon/exceptions.py,sha256=K_3_vS2oTeQzWI4lVYnngYaoA_CLMTTEHAU1Bk0T8ZY,446
+opscli/amazon/manager.py,sha256=Wesb_ONv7QP4tpPjhhb2tLxycm4k8UI0nY7O8lNODRo,124
+opscli/amazon/models.py,sha256=MKfAsj_ah8pgEyxQCV5IVsT525vyYAYxzbhKelwGcdI,222
+opscli/amazon/parser.py,sha256=Aq48kY-wmk1lhlulxoDyG-dyxMUbOfJVkD08_KT0YbI,224
+opscli/amazon/scraper.py,sha256=liXXxLiP_SNqFq5si0Vkyo3i9GMIPSbp9UjOTws9XlU,124
+opscli/amazon/commands/__init__.py,sha256=fjb54ZY-MKd8MV5tv1Shrh5Jfp3Un96iIUWmOms2Hq0,26
+opscli/amazon/commands/cli.py,sha256=wfN6c8_2F5OUeInWbNcNDSUES4VpaWuGehHWMx01J6w,6480
+opscli/amazon/domain/__init__.py,sha256=T1z0TBQPp7whDCMMFVsBkdOPP5F75FwDFjuP3qXbKe8,629
+opscli/amazon/domain/exceptions.py,sha256=FhaWfMSyNw6o_pahHgOvtTa_2IDHLDk9gfMH_ZxynD4,1635
+opscli/amazon/domain/models.py,sha256=bZIcNYl0BjrMZfIra2fzBrcHqWliKfVlibUIXvRw9V4,1739
+opscli/amazon/scraping/__init__.py,sha256=3leaa_l4MV5JP0bHw5zuNje2Dcs8cZw3FCekUrY0U_M,311
+opscli/amazon/scraping/parser.py,sha256=0oKwzo4lw8LwbeP7lvVTH89vA6PAN6A-J9S4kJw4Sb4,2121
+opscli/amazon/scraping/scraper.py,sha256=uzIX8GFbaritDEN8FhX2NpWYGHK38VFMJ9tVYu-I2LU,12743
+opscli/amazon/services/__init__.py,sha256=nigoKCItXBRc64ANj0wI5s0KA-mg3WfilsZdoBT7bfQ,113
+opscli/amazon/services/manager.py,sha256=Kr6D7RCdny9Pug5GMZNjNPdTiKXAX07z4KEa67oIZKs,3786
+opscli/amazon/transport/__init__.py,sha256=7J0EmXjDAbw7ZLmCf2L9rmfugdyLENjClPAZL_N80oI,123
+opscli/amazon/transport/client.py,sha256=u0K6pIo6em7SGbegDckDvo_vUwK6rmBJxXo7A6aZyMQ,3154
+opscli/auth/__init__.py,sha256=gaa7Tvetwiy2g6cXPPVTdJI_6mAtAuehcanMSu6pOUQ,2926
+opscli/auth/cli.py,sha256=pwuA8QPrkUTJJnrVLtSNEZVQsc8Z3z9yxKTHTq2q2QU,9462
+opscli/auth/config.py,sha256=9OUi88zOwtdQbm-kWM150eiqAtEx1tLF-y98NkDJawc,1519
+opscli/auth/exceptions.py,sha256=SqbDW3c3VUTKbLhi69Gw1S-1rCddDL4Rx8SxOK2248Y,494
+opscli/auth/commands/__init__.py,sha256=4fEKbn1RX587mt_wz0fu_LOuSMHLvsZWxeFEpuMhw6s,24
+opscli/auth/commands/cli.py,sha256=5sow76FvU5rQ7gKN4l36gUkJsbIC1asCQ5e5NvkwnSY,83
+opscli/auth/core/__init__.py,sha256=5VGShapu_K0zfId4sJ1bGJV8Tv0P059_SI4HAmXVvgo,13
+opscli/auth/core/device_flow.py,sha256=vPVBcul9rF2k5-07H94xbyJk0g6FOxE5TccyH-sjBoM,3182
+opscli/auth/core/system_registry.py,sha256=xxGNV1jcUw9YUbg76C8_w537nIvl2snT5RFfsf2nVQs,3885
+opscli/auth/core/token_manager.py,sha256=ZTNKk1H5NPredRc3QUeMv3BSzIPW757HXrO4jVfBo_w,7037
+opscli/auth/domain/__init__.py,sha256=4alApqTdpgecZEdm66c8qMPDuMlfyLeLi0sjhB9zK6U,483
+opscli/auth/domain/exceptions.py,sha256=OAdXPuCkD0QW_mzaxyAwct3o5y3a9E_rlnde0nMe7Hk,623
+opscli/auth/storage/__init__.py,sha256=6FEl8uU8oBsPmF_qVqODghEVQGx58mJNHKO1RGyjWE0,16
+opscli/auth/storage/credential_store.py,sha256=70EyWVpgqTno7tkF5VAPWrCuZA2OESpyn02fbVw20GI,5789
+opscli/auth/storage/crypto.py,sha256=aK0tY9AHAD1eEoz9WU5CU7eeMfLvnb-aiqWADb7SXEk,2349
+opscli/query/__init__.py,sha256=Ary6sHyrpluyubFrUOFktafJ18tPZTUBSYv4LO9ZZnQ,188
+opscli/query/cli.py,sha256=ZwRvedaPyBbCpQ56X6PVAaD4Ua0W_YPfVNoLH-j_LLI,94
+opscli/query/client.py,sha256=p0ID9wE1x0uZf11sszWyg8-ATNC4WjKWqMMSIFfbGoQ,117
+opscli/query/exceptions.py,sha256=BcVgurm8sgxElIXClPxM-Lfhh4if20DIJzBTHWymaBk,454
+opscli/query/manager.py,sha256=ix_WRhH2sQPOVhoDnVTzMKknPF7g5uc6fHtjyGJA1mA,120
+opscli/query/models.py,sha256=nUqrH86W6vQQ5tFW9YT-qTYwlhXB5KVITJ8t7Re_Qv4,130
+opscli/query/commands/__init__.py,sha256=taIghztA6XYlBLIguowlWDE__MNcojXjx3OXPeeB68k,25
+opscli/query/commands/cli.py,sha256=ikuUIxBDZmxInIqmke7e7splv6KR9qtgu_4yy3E_dnw,5320
+opscli/query/domain/__init__.py,sha256=6D1aprp2xWZdK8ZJmwSclo_wvNSdHz8g_YQwTx7kVDo,538
+opscli/query/domain/exceptions.py,sha256=-NDxXmUsADT8dINcqUikyN3ljiUvwUClIXSiej1rgrs,1670
+opscli/query/domain/models.py,sha256=uzNYMLipb-cwgVaHd0jv_VeOLgbBSrX5k_Qi6862HyI,410
+opscli/query/services/__init__.py,sha256=4fYylRwegYEvMZ4CjbCIQL139O6TQ16aWg6yGZ7L7u4,109
+opscli/query/services/manager.py,sha256=6FNhMBO4WU6uCCf5v4JkYV2ey7LdE6oK2lQV1BCBwh4,14987
+opscli/query/transport/__init__.py,sha256=ahB8_rcO71Fr7KqwKLbcnVSV3lU0RzWhGoAUJ0NWKt0,113
+opscli/query/transport/client.py,sha256=73qMS_yEYkNHHhmV2V0A6T8tMpVxWGV1Fda_9_cHsvo,2209
+opscli/skills/__init__.py,sha256=tTwzlqhaJQ_u1kgk1JNRiEWR1Wqswkf-CAiXUlBYUq0,1153
+opscli/skills/cli.py,sha256=3GSFpyORg87iEJkmZp1yrTSYxGV8EIovEBuUHITMG5s,96
+opscli/skills/detector.py,sha256=jesZFkTCDsrskpKFBQ6CQrXDq2gNy-V0tEPaOLfWhqE,127
+opscli/skills/exceptions.py,sha256=la6gyf962mVwljn0-aM0Pn_lI1efDsN7CZ9OQ-af2OE,194
+opscli/skills/manager.py,sha256=cbdVR4H5FkPNDKypedJuyG-Wv7XyV_0gpC7T8Frc8ug,124
+opscli/skills/models.py,sha256=plGImIaLhtHoeD072uPl5bANnZ8pCFpiEhK3pz4trjU,406
+opscli/skills/updater.py,sha256=GUAUpcXtjA36alPJ2c3I1ZSeQgEpOiuy8YAoy838WxQ,120
+opscli/skills/commands/__init__.py,sha256=jIkkkeuSVjIC-_c1hP2unDt9D3Q-hWcGYnuWPMRZyRs,26
+opscli/skills/commands/cli.py,sha256=FtcJdmllYkmsFu1VGxxcZhcDpXKU8-3cSneBIh7_k8I,14149
+opscli/skills/discovery/__init__.py,sha256=xNTs5bSmXYWSIZkLo5CE5PZUZlu3O5VLydCRtMZ3Aec,115
+opscli/skills/discovery/detector.py,sha256=3jwgDxlM7jD800BJ3_dHmIenF9IEPfK0MrE8uV2w_RU,9530
+opscli/skills/domain/__init__.py,sha256=5yp3aFgEJPujcBoLtuq6ugyEJhEUMhpa99TJQOQE22Y,561
+opscli/skills/domain/exceptions.py,sha256=4cqJluOz0JgN29zKVLhM850lj8uPM0DCySgSNCCtM2A,1412
+opscli/skills/domain/models.py,sha256=7woJ_2BPlTRprdvpc-4xtq3Zukb_WxYubUnYqkRujMU,4669
+opscli/skills/services/__init__.py,sha256=xxDaxtKuN3F01C5r7E6a0exzPdwfsfC_BXnSxzFX5bM,113
+opscli/skills/services/manager.py,sha256=on5uiZ6jP62-Xzp-Tqs8vqX0IonGgGlbBzxkN4XyS68,10937
+opscli/skills/sync/__init__.py,sha256=S2sB4lmbW0uq2-cgyTuYFUwwVD1_sqaOwh4NKUIta2I,109
+opscli/skills/sync/updater.py,sha256=7Z4Lbb1NVwyDaOS0ld3DdDOzJYOWndh4dA9i_tad7bQ,11159
+opscli/skills/templates/ops-amazon/SKILL.md,sha256=HIzKI1GzXIBhc4iFgI1D-2W4Mq9m9otX2j1QnNXNQe8,4022
+opscli/skills/templates/ops-amazon/data/VERSION.json,sha256=ndUU5OQ1bOhpWcyaYSjIWdZzAi3U6CRSJa2Rf4A-GEc,50
+opscli/skills/templates/ops-auth/SKILL.md,sha256=AOu1ux5W6HT0-7mMbIZeRIXNXoJiIkUEp9a9G2Vneus,11370
+opscli/skills/templates/ops-auth/data/VERSION.json,sha256=erVz4OwjCnFN6FDi_nQ9Av612rvhdKUPKf6C0I-1I4c,48
+opscli/skills/templates/ops-dataset-query/SKILL.md,sha256=xQS_OHI_IuTo2IyB-eaP-qaclxBJQbRofkcVWjmFmJE,22149
+opscli/skills/templates/ops-dataset-query/data/VERSION.json,sha256=2FGZJ4xTABl-Vup2ogzhMurwX1BFRbwq76SSt1tkkCg,57
+opscli/skills/templates/ops-dataset-query/data/dataset_fields.csv,sha256=5PHZ6yfA8fu2LmBl3ZSlHsYiz4bqtz4xUex5eTFt9OE,156
+opscli/skills/templates/ops-dataset-query/data/datasets.csv,sha256=EpIJWArdOS0ToeRcxiB3fqzllbRqM3VKcE5lTi5mWBA,178
+opscli/skills/templates/ops-dataset-query/data/query_metadata.json,sha256=DFQmOo-I7xipDJbSRpkQ8282NCHuLgc2umK2YRza4a8,37
+opscli/skills/templates/ops-dataset-query/references/数据查询服务开发说明文档.md,sha256=1MoO03y_lKhPTvB2wcIzx19Pj35HL3c3h85LLq-9K2w,43361
+opscli/skills/templates/ops-dataset-query/scripts/core.py,sha256=Us4lOaIiluEf8lh9f7XKfl4P45b0WYNIw3uKyGId0NE,3856
+opscli/skills/templates/ops-dataset-query/scripts/query.py,sha256=R1bqK8U_ca0hkEOrHfesZbyIJSqbMlNZTKQeyF-ukNg,5346
+opscli/skills/templates/ops-dataset-query/scripts/search.py,sha256=qN0ksYE-p5DVhJW50cgAesvg5TKR_2BmqtN46tGlNxE,1126
+opscli/skills/templates/ops-dataset-query/scripts/updater.py,sha256=w9oUqRyuxa66J0_WD7xeN0TCEsHq0ZvvF6lklQSutxY,3303
+opscli/skills/templates/ops-skills/SKILL.md,sha256=icBBUBWGyEWD1ifNDbkj58flRzRlx3QXbSljH7BQErw,14296
+opscli/skills/templates/ops-skills/data/VERSION.json,sha256=02sPWWjduv6NTJ15muSLuXVbDS1MziAZlZtnE1A4QwI,50
+aukeys_opscli-0.0.6.dist-info/METADATA,sha256=-tcaATjqF4P0BQ4pq-Y9sv3Jrh7SCoXruq00NR7J0MY,433
+aukeys_opscli-0.0.6.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+aukeys_opscli-0.0.6.dist-info/entry_points.txt,sha256=k9acUhcy0J166h-HxKxpkmLvITs2yS958wg1r2C97FE,42
+aukeys_opscli-0.0.6.dist-info/RECORD,,

aukeys_opscli-0.0.6.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

aukeys_opscli-0.0.6.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+opscli = opscli.cli:app

opscli/__init__.py

@@ -0,0 +1,9 @@
+"""opscli 包入口。
+
+有意 re-export AuthClient，使以下两种导入方式均可用（铁律3）：
+    from opscli import AuthClient        # 通过顶层 re-export
+    from opscli.auth import AuthClient   # 直接导入子模块
+"""
+from opscli.auth import AuthClient
+
+__all__ = ["AuthClient"]

opscli/amazon/__init__.py

@@ -0,0 +1,13 @@
+"""Amazon 模块对外导出。"""
+
+from opscli.amazon.domain.models import AmazonCollectResult, AmazonProductSnapshot, AmazonSearchResult
+from opscli.amazon.services.manager import AmazonManager
+from opscli.amazon.transport.client import AmazonOpsClient
+
+__all__ = [
+    "AmazonManager",
+    "AmazonOpsClient",
+    "AmazonProductSnapshot",
+    "AmazonSearchResult",
+    "AmazonCollectResult",
+]

opscli/amazon/cli.py

@@ -0,0 +1,5 @@
+"""amazon CLI 兼容导出。"""
+
+from opscli.amazon.commands.cli import app
+
+__all__ = ["app"]

opscli/amazon/client.py

@@ -0,0 +1,5 @@
+"""amazon client 兼容导出。"""
+
+from opscli.amazon.transport.client import AmazonOpsClient
+
+__all__ = ["AmazonOpsClient"]

opscli/amazon/commands/__init__.py

@@ -0,0 +1 @@
+"""amazon 命令层。"""

opscli/amazon/commands/cli.py

@@ -0,0 +1,200 @@
+"""amazon CLI 子命令定义。"""
+
+from __future__ import annotations
+
+import json
+
+import typer
+
+from opscli.amazon.domain.exceptions import AmazonError
+from opscli.amazon.services.manager import AmazonManager
+
+app = typer.Typer(help="Amazon 商品抓取与 ops 提交通道")
+
+
+def _emit(payload: dict, pretty: bool) -> None:
+    """统一输出 JSON。"""
+    if pretty:
+        typer.echo(json.dumps(payload, ensure_ascii=False, indent=2))
+    else:
+        typer.echo(json.dumps(payload, ensure_ascii=False))
+
+
+def _error_payload(command: str, exc: Exception) -> dict:
+    """统一错误输出。"""
+    if isinstance(exc, AmazonError):
+        error = exc.to_dict()
+    else:
+        error = {
+            "code": "AMAZON_ERROR",
+            "message": str(exc),
+        }
+    return {
+        "success": False,
+        "command": command,
+        "data": None,
+        "error": error,
+    }
+
+
+@app.command("scrape")
+def scrape(
+    asin: str = typer.Option(..., "--asin", help="目标 ASIN"),
+    zip_code: str = typer.Option("10001", "--zip-code", help="邮编，用于稳定价格口径"),
+    save_history: bool = typer.Option(True, "--save-history/--no-save-history", help="是否保存本地历史"),
+    include_raw: bool = typer.Option(False, "--include-raw", help="是否输出原始抓取字段"),
+    pretty: bool = typer.Option(False, "--pretty", help="格式化输出"),
+):
+    """抓取单个商品。"""
+    manager = AmazonManager()
+    try:
+        result = manager.scrape_product(
+            asin=asin,
+            zip_code=zip_code,
+            save_history=save_history,
+        )
+        payload = {
+            "success": True,
+            "command": "amazon scrape",
+            "data": result.to_dict(include_raw=include_raw),
+            "error": None,
+        }
+    except Exception as exc:
+        _emit(_error_payload("amazon scrape", exc), pretty)
+        raise typer.Exit(1)
+
+    _emit(payload, pretty)
+
+
+@app.command("payload")
+def payload(
+    asin: str = typer.Option(..., "--asin", help="目标 ASIN"),
+    zip_code: str = typer.Option("10001", "--zip-code", help="邮编，用于稳定价格口径"),
+    save_history: bool = typer.Option(True, "--save-history/--no-save-history", help="是否保存本地历史"),
+    pretty: bool = typer.Option(False, "--pretty", help="格式化输出"),
+):
+    """抓取商品并输出未来提交给 ops 的标准 payload。"""
+    manager = AmazonManager()
+    try:
+        result = manager.scrape_payload(
+            asin=asin,
+            zip_code=zip_code,
+            save_history=save_history,
+        )
+        response = {
+            "success": True,
+            "command": "amazon payload",
+            "data": result,
+            "error": None,
+        }
+    except Exception as exc:
+        _emit(_error_payload("amazon payload", exc), pretty)
+        raise typer.Exit(1)
+
+    _emit(response, pretty)
+
+
+@app.command("search")
+def search(
+    keyword: str = typer.Option(..., "--keyword", help="搜索关键词"),
+    zip_code: str = typer.Option("10001", "--zip-code", help="邮编，用于稳定价格口径"),
+    limit: int = typer.Option(10, "--limit", min=1, max=50, help="最大结果数"),
+    pretty: bool = typer.Option(False, "--pretty", help="格式化输出"),
+):
+    """抓取搜索结果页。"""
+    manager = AmazonManager()
+    try:
+        results = manager.search_products(keyword=keyword, zip_code=zip_code, limit=limit)
+        payload = {
+            "success": True,
+            "command": "amazon search",
+            "data": {
+                "keyword": keyword,
+                "zip_code": zip_code,
+                "count": len(results),
+                "results": [item.to_dict() for item in results],
+            },
+            "error": None,
+        }
+    except Exception as exc:
+        _emit(_error_payload("amazon search", exc), pretty)
+        raise typer.Exit(1)
+
+    _emit(payload, pretty)
+
+
+@app.command("schema")
+def schema(pretty: bool = typer.Option(False, "--pretty", help="格式化输出")):
+    """输出当前 Amazon 抓取模型与 API 预留结构。"""
+    payload = {
+        "success": True,
+        "command": "amazon schema",
+        "data": {
+            "snapshot_fields": {
+                "asin": "string",
+                "zip_code": "string",
+                "marketplace": "string",
+                "page_url": "string",
+                "page_title": "string",
+                "product_name": "string",
+                "price_text": "string",
+                "price_amount": "number|null",
+                "currency": "string|null",
+                "rating_text": "string",
+                "rating_value": "number|null",
+                "review_count_text": "string",
+                "review_count_value": "integer|null",
+                "location": "string",
+                "collected_at": "string",
+                "valid": "boolean",
+                "error": "string|null",
+                "raw": "object|null",
+            },
+            "reserved_submit_payload": {
+                "source": "string",
+                "snapshot": "AmazonProductSnapshot",
+            },
+            "search_result_fields": {
+                "asin": "string",
+                "keyword": "string",
+                "zip_code": "string",
+                "rank": "integer",
+                "title": "string",
+                "price_text": "string",
+                "price_amount": "number|null",
+                "rating_text": "string",
+                "rating_value": "number|null",
+                "review_count_text": "string",
+                "review_count_value": "integer|null",
+                "is_best_seller": "boolean",
+            },
+        },
+        "error": None,
+    }
+    _emit(payload, pretty)
+
+
+@app.command("history")
+def history(
+    asin: str = typer.Option(..., "--asin", help="目标 ASIN"),
+    pretty: bool = typer.Option(False, "--pretty", help="格式化输出"),
+):
+    """读取本地历史快照。"""
+    manager = AmazonManager()
+    try:
+        records = manager.load_history(asin)
+        payload = {
+            "success": True,
+            "command": "amazon history",
+            "data": {
+                "asin": asin.upper(),
+                "count": len(records),
+                "records": records,
+            },
+            "error": None,
+        }
+    except Exception as exc:
+        _emit(_error_payload("amazon history", exc), pretty)
+        raise typer.Exit(1)
+
+    _emit(payload, pretty)

opscli/amazon/domain/__init__.py

@@ -0,0 +1,25 @@
+"""amazon 领域模型与异常。"""
+
+from opscli.amazon.domain.exceptions import (
+    AmazonError,
+    BadRemoteJsonError,
+    InvalidAsinError,
+    RemoteBusinessError,
+    RemoteHttpError,
+    ScraperDependencyError,
+    SubmissionConfigError,
+)
+from opscli.amazon.domain.models import AmazonCollectResult, AmazonProductSnapshot, AmazonSearchResult
+
+__all__ = [
+    "AmazonError",
+    "InvalidAsinError",
+    "ScraperDependencyError",
+    "SubmissionConfigError",
+    "RemoteHttpError",
+    "RemoteBusinessError",
+    "BadRemoteJsonError",
+    "AmazonProductSnapshot",
+    "AmazonSearchResult",
+    "AmazonCollectResult",
+]

opscli/amazon/domain/exceptions.py

@@ -0,0 +1,73 @@
+"""amazon 模块异常定义。"""
+
+from __future__ import annotations
+
+
+class AmazonError(Exception):
+    """amazon 模块统一异常基类。"""
+
+    code = "AMAZON_ERROR"
+
+    def __init__(self, message: str):
+        super().__init__(message)
+        self.message = message
+
+    def to_dict(self) -> dict:
+        return {
+            "code": self.code,
+            "message": self.message,
+        }
+
+
+class InvalidAsinError(AmazonError):
+    """ASIN 参数不合法。"""
+
+    code = "INVALID_ASIN"
+
+
+class ScraperDependencyError(AmazonError):
+    """抓取依赖未安装。"""
+
+    code = "SCRAPER_DEPENDENCY_ERROR"
+
+
+class SubmissionConfigError(AmazonError):
+    """提交配置缺失或不合法。"""
+
+    code = "SUBMISSION_CONFIG_ERROR"
+
+
+class RemoteHttpError(AmazonError):
+    """远端 HTTP 请求失败。"""
+
+    code = "REMOTE_HTTP_ERROR"
+
+    def __init__(self, status_code: int, message: str):
+        super().__init__(message)
+        self.status_code = status_code
+
+    def to_dict(self) -> dict:
+        payload = super().to_dict()
+        payload["status_code"] = self.status_code
+        return payload
+
+
+class RemoteBusinessError(AmazonError):
+    """远端业务错误。"""
+
+    code = "REMOTE_BUSINESS_ERROR"
+
+    def __init__(self, business_code: int | str, message: str):
+        super().__init__(message)
+        self.business_code = business_code
+
+    def to_dict(self) -> dict:
+        payload = super().to_dict()
+        payload["business_code"] = self.business_code
+        return payload
+
+
+class BadRemoteJsonError(AmazonError):
+    """远端返回非法 JSON。"""
+
+    code = "BAD_REMOTE_JSON"

opscli/amazon/domain/models.py

@@ -0,0 +1,74 @@
+"""amazon 模块数据模型。"""
+
+from __future__ import annotations
+
+from dataclasses import asdict, dataclass
+from pathlib import Path
+from typing import Any
+
+
+@dataclass
+class AmazonProductSnapshot:
+    """单个 Amazon 商品抓取快照。"""
+
+    asin: str
+    zip_code: str
+    marketplace: str
+    page_url: str
+    page_title: str
+    product_name: str
+    price_text: str
+    price_amount: float | None
+    currency: str | None
+    rating_text: str
+    rating_value: float | None
+    review_count_text: str
+    review_count_value: int | None
+    location: str
+    collected_at: str
+    valid: bool
+    error: str | None = None
+    raw: dict[str, Any] | None = None
+
+    def to_dict(self, *, include_raw: bool = False) -> dict:
+        data = asdict(self)
+        if not include_raw:
+            data.pop("raw", None)
+        return data
+
+
+@dataclass
+class AmazonSearchResult:
+    """Amazon 搜索结果条目。"""
+
+    asin: str
+    keyword: str
+    zip_code: str
+    rank: int
+    title: str
+    price_text: str
+    price_amount: float | None
+    rating_text: str
+    rating_value: float | None
+    review_count_text: str
+    review_count_value: int | None
+    is_best_seller: bool
+
+    def to_dict(self) -> dict:
+        return asdict(self)
+
+
+@dataclass
+class AmazonCollectResult:
+    """采集结果聚合对象。"""
+
+    snapshot: AmazonProductSnapshot
+    history_path: Path | None = None
+    submit_result: dict | None = None
+
+    def to_dict(self, *, include_raw: bool = False) -> dict:
+        return {
+            "snapshot": self.snapshot.to_dict(include_raw=include_raw),
+            "history_path": str(self.history_path) if self.history_path else None,
+            "submit_result": self.submit_result,
+        }

opscli/amazon/exceptions.py

@@ -0,0 +1,21 @@
+"""amazon exceptions 兼容导出。"""
+
+from opscli.amazon.domain.exceptions import (
+    AmazonError,
+    BadRemoteJsonError,
+    InvalidAsinError,
+    RemoteBusinessError,
+    RemoteHttpError,
+    ScraperDependencyError,
+    SubmissionConfigError,
+)
+
+__all__ = [
+    "AmazonError",
+    "InvalidAsinError",
+    "ScraperDependencyError",
+    "SubmissionConfigError",
+    "RemoteHttpError",
+    "RemoteBusinessError",
+    "BadRemoteJsonError",
+]

opscli/amazon/manager.py

@@ -0,0 +1,5 @@
+"""amazon manager 兼容导出。"""
+
+from opscli.amazon.services.manager import AmazonManager
+
+__all__ = ["AmazonManager"]

opscli/amazon/models.py

@@ -0,0 +1,5 @@
+"""amazon models 兼容导出。"""
+
+from opscli.amazon.domain.models import AmazonCollectResult, AmazonProductSnapshot, AmazonSearchResult
+
+__all__ = ["AmazonProductSnapshot", "AmazonSearchResult", "AmazonCollectResult"]

opscli/amazon/parser.py

@@ -0,0 +1,5 @@
+"""amazon parser 兼容导出。"""
+
+from opscli.amazon.scraping.parser import normalize_text, parse_price, parse_rating, parse_review_count
+
+__all__ = ["normalize_text", "parse_price", "parse_rating", "parse_review_count"]

opscli/amazon/scraper.py

@@ -0,0 +1,5 @@
+"""amazon scraper 兼容导出。"""
+
+from opscli.amazon.scraping.scraper import AmazonScraper
+
+__all__ = ["AmazonScraper"]

opscli/amazon/scraping/__init__.py

@@ -0,0 +1,12 @@
+"""amazon 抓取层。"""
+
+from opscli.amazon.scraping.parser import normalize_text, parse_price, parse_rating, parse_review_count
+from opscli.amazon.scraping.scraper import AmazonScraper
+
+__all__ = [
+    "AmazonScraper",
+    "normalize_text",
+    "parse_price",
+    "parse_rating",
+    "parse_review_count",
+]

opscli/amazon/scraping/parser.py

@@ -0,0 +1,66 @@
+"""amazon 模块字段标准化工具。"""
+
+from __future__ import annotations
+
+import re
+
+
+_PRICE_PATTERN = re.compile(r"(\d[\d,]*\.?\d*)")
+_RATING_PATTERN = re.compile(r"(\d+(?:\.\d+)?)")
+_INTEGER_PATTERN = re.compile(r"(\d[\d,]*)")
+_LABELED_REVIEW_COUNT_PATTERN = re.compile(r"(\d[\d,]*)\s+(?:ratings?|reviews?)\b", re.IGNORECASE)
+_ABBREVIATED_COUNT_PATTERN = re.compile(r"(\d+(?:\.\d+)?)\s*([KM])\b", re.IGNORECASE)
+_ZERO_WIDTH_TRANSLATION = str.maketrans("", "", "\u200b\u200c\u200d\ufeff")
+
+
+def normalize_text(value: str | None) -> str:
+    """标准化抓取到的文本。"""
+    if not value:
+        return ""
+    cleaned = str(value).translate(_ZERO_WIDTH_TRANSLATION)
+    return " ".join(cleaned.strip().split())
+
+
+def parse_price(value: str | None) -> tuple[float | None, str | None]:
+    """从价格字符串中提取金额和币种。"""
+    text = normalize_text(value)
+    match = _PRICE_PATTERN.search(text)
+    amount = None
+    if match:
+        amount = float(match.group(1).replace(",", ""))
+
+    currency = None
+    if "$" in text:
+        currency = "USD"
+    return amount, currency
+
+
+def parse_rating(value: str | None) -> float | None:
+    """从评分字符串中提取数值。"""
+    text = normalize_text(value)
+    match = _RATING_PATTERN.search(text)
+    if not match:
+        return None
+    return float(match.group(1))
+
+
+def parse_review_count(value: str | None) -> int | None:
+    """从评论数字符串中提取数量。"""
+    text = normalize_text(value)
+    labeled_match = _LABELED_REVIEW_COUNT_PATTERN.search(text)
+    if labeled_match:
+        return int(labeled_match.group(1).replace(",", ""))
+
+    abbreviated_match = _ABBREVIATED_COUNT_PATTERN.search(text)
+    if abbreviated_match:
+        amount = float(abbreviated_match.group(1))
+        multiplier = 1000 if abbreviated_match.group(2).upper() == "K" else 1000000
+        return int(amount * multiplier)
+
+    if "out of" in text.lower() and "star" in text.lower():
+        return None
+
+    match = _INTEGER_PATTERN.search(text)
+    if not match:
+        return None
+    return int(match.group(1).replace(",", ""))