Amazon Orders — 亚马逊订单

Amazon 订单 Skill 使用非官方的 amazon-orders Python 包和 CLI 与您的 Amazon.com 订单历史进行交互。 注意：amazon-orders 通过抓取/解析 Amazon 的消费者网站来工作，因此如果 Amazon 更改其页面，它可能会中断。仅支持英文 Amazon .com 站点。

安装 安装/升级： python3 -m pip install --upgrade amazon-orders （安装详情和版本固定指导请参阅项目 README。）

身份验证选项 amazon-orders 可以从以下来源获取凭据（优先顺序最高先）： 环境变量、传递给 AmazonSession 的参数或本地配置。

环境变量： export AMAZON_USERNAME="you@example.com" export AMAZON_PASSWORD="your-password" # 可选：用于启用 OTP/TOTP 的帐户 export AMAZON_OTP_SECRET_KEY="BASE32_TOTP_SECRET" （OTP 密钥的使用方法请参阅项目文档。）

使用方法 您可以将 amazon-orders 用作 Python 库或从命令行使用。

Python： 基本用法 from amazonorders.session import AmazonSession from amazonorders.orders import AmazonOrders amazon_session = AmazonSession("", "") amazon_session.login() amazon_orders = AmazonOrders(amazon_session) # 获取特定年份的订单 orders = amazon_orders.get_order_history(year=2023) # 或使用时间筛选器获取最近的订单 orders = amazon_orders.get_order_history(time_filter="last30") # 最后 30 天 orders = amazon_orders.get_order_history(time_filter="months-3") # 过去 3 个月 for order in orders: print(f"{order.order_number} - {order.grand_total}")

完整详细信息（更慢，更丰富的字段） 某些订单字段仅在请求完整详细信息时才会填充；当您需要更丰富的订单数据时启用它： Python：full_details=True CLI：--full-details

CLI：常用命令 # 身份验证（交互式/使用环境变量） amazon-orders login # 订单历史 amazon-orders history --year 2023 amazon-orders history --last-30-days amazon-orders history --last-3-months

提示 如果您的帐户启用了 MFA，请首选设置 AMAZON_OTP_SECRET_KEY 以进行自动运行。 在自动化时，请将凭据保留在 shell 历史记录之外：使用环境变量和密钥管理器（1Password、Vault、GitHub Actions 密钥等）。

示例 将年度历史记录导出为 JSON amazon-orders history --year 2023 --full-details > orders_2023.json 快速检查总数（需要 jq） amazon-orders history --last-30-days --full-details | jq -r '.[] | [.order_number, .grand_total] | @tsv'

注意 这是一个非官方的基于抓取的工具（无官方 Amazon API）。 官方文档托管在 Read the Docs 上，用于高级用法和 API（Orders、Transactions 等）。