核心用法
amazon-orders 是一个非官方工具,通过网页抓取(scraping)方式访问 Amazon.com 的订单数据。提供两种使用模式:
Python 库模式:导入 AmazonSession 和 AmazonOrders 类,创建会话、登录后调用 get_order_history() 方法,支持按年份(year=2023)或时间过滤器(last30、months-3)查询订单。设置 full_details=True 可获取更完整的订单字段。
CLI 模式:通过 amazon-orders 命令行工具执行 login、history 等操作,支持 --year、--last-30-days、--full-details 等参数,可配合 jq 等工具实现 JSON 导出与数据处理。
显著优点
1. 双模支持:同时提供编程接口和命令行工具,满足不同技术背景用户需求
2. 时间过滤灵活:内置多种预设时间范围,支持精确年份查询
3. 数据导出便捷:原生输出 JSON 格式,易于与其他工具链集成
4. MFA 自动化支持:通过 AMAZON_OTP_SECRET_KEY 环境变量支持 TOTP,可实现无人值守运行
潜在缺点与局限性
- 稳定性风险:依赖网页抓取,Amazon 页面结构变更会导致功能失效
- 地域限制:仅官方支持 Amazon.com(美国站),其他区域站点兼容性未保证
- 功能边界:非官方 API,无法访问 Amazon 未在网页端展示的数据
- 性能考量:
full_details模式需额外页面请求,速度较慢
适合人群
- 需要批量导出 Amazon 订单数据进行个人财务分析的用户
- 希望自动化订单追踪的技术用户与开发者
- 使用美国 Amazon 账户的英语用户
常规风险
1. 账户安全:需提供 Amazon 登录凭证,存在凭证泄露风险;建议通过环境变量或密钥管理服务注入,避免硬编码
2. 服务条款:网页抓取可能违反 Amazon 服务条款,存在账户限制风险
3. OTP 密钥管理:AMAZON_OTP_SECRET_KEY 为敏感信息,泄露将导致 MFA 保护失效
4. 数据准确性:依赖页面解析,存在因页面结构变化导致数据缺失或错误的可能