Amazon Orders

📦 自动化管理 Amazon 订单历史

通过非官方Python API和CLI下载、查询Amazon订单历史,支持Python库与命令行双模式,适合自动化个人财务追踪与订单管理。

收藏
8.7k
安装
2.1k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

amazon-orders 是一个非官方工具,通过网页抓取(scraping)方式访问 Amazon.com 的订单数据。提供两种使用模式:

Python 库模式:导入 AmazonSessionAmazonOrders 类,创建会话、登录后调用 get_order_history() 方法,支持按年份(year=2023)或时间过滤器(last30months-3)查询订单。设置 full_details=True 可获取更完整的订单字段。

CLI 模式:通过 amazon-orders 命令行工具执行 loginhistory 等操作,支持 --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. 数据准确性:依赖页面解析,存在因页面结构变化导致数据缺失或错误的可能

Amazon Orders 内容

手动下载zip · 2.9 kB
skill-card.mdtext/markdown
请选择文件