amazon-orders

核心用法

amazon-orders 提供两种使用方式：作为 Python 库 集成到现有项目，或作为 命令行工具 直接执行。用户需先通过 pip install amazon-orders 安装依赖，并配置 Amazon 账户凭据（支持环境变量 AMAZON_USERNAME、AMAZON_PASSWORD 及可选的 AMAZON_OTP_SECRET_KEY）。

Python 库模式下，开发者通过 AmazonSession 建立会话，使用 AmazonOrders 类调用 get_order_history() 方法，支持按年份（year=2023）或时间过滤器（last30、months-3）查询。CLI 模式则提供 amazon-orders login 和 amazon-orders history 等命令，支持 --full-details 参数获取完整订单信息并导出为 JSON 格式，便于配合 jq 等工具进行数据处理。

显著优点

该工具最大优势在于填补了 Amazon 官方 API 的空白，为个人用户提供完整的订单数据所有权。开源 MIT 许可证（GitHub 121 Stars）确保代码可审计，社区持续维护（更新至 2026 年）。双模式设计兼顾开发者自动化需求与普通用户便捷操作，支持 OTP/TOTP 双因素认证，适合自动化脚本场景。输出格式为标准 JSON，便于对接 Excel、记账软件或数据分析流程。

潜在缺点与局限性

作为非官方网页抓取工具，其稳定性高度依赖 Amazon 页面结构，一旦 Amazon 改版可能导致功能失效。仅支持 Amazon.com 英文站点，国际站点（Amazon.cn、Amazon.co.uk 等）兼容性未保证。此外，频繁查询可能触发 Amazon 反爬虫机制，存在账户临时限制风险。功能上仅支持读取订单历史，无法实现退款、物流跟踪修改等操作。

适合的目标群体

主要面向需要个人财务对账的用户（如月度消费统计、年度报税准备）、数据分析师（研究个人消费模式）以及自动化爱好者（希望将订单数据同步到 Notion/Airtable 等第三方系统）。不适合企业级商用场景或需要实时物流追踪的高频查询需求。

使用风险

凭据安全是首要风险，用户需在环境变量中配置 Amazon 账户密码，若配置不当（如硬编码在脚本中）可能导致账户泄露。建议在受信任环境运行，使用 1Password、Vault 等密钥管理工具，并考虑创建专用 Amazon 子账户。服务稳定性风险包括：Amazon 页面变更导致解析失败、网络波动影响数据获取、以及非官方工具可能违反 Amazon 服务条款（尽管个人使用风险较低）。性能方面，开启 --full-details 会显著降低查询速度，大量历史订单导出可能耗时较长。