amazon-orders 技能

使用非官方的 amazon-orders Python 包及命令行工具，访问您的 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：在 history 命令中添加 --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 secrets 等）。

示例

导出年度订单历史至 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 支持）。
• 高级用法与 API 文档（如 Orders、Transactions 等模块）托管于 Read the Docs。