自动化 Amazon Seller Central 数据提取：CLI 优先方法
为什么不使用 SP-API
Amazon SP-API 是官方的数据访问路径，文档齐全，且有合理的速率限制。它也需要获得 Amazon 批准、维护 OAuth 凭据，并且并非所有 Seller Central 中的数据都通过 API 公开。
浏览器自动化方法更快上手，涵盖 API 中不可用的报告类型，并且可以使用现有的 Seller Central 凭据运行，无需单独的 API 访问批准。权衡是稳健性：UI 更改会破坏选择器，而 API 端点则不会。
CLI 架构
该工具被构建为 CLI 而非 Web 应用，有几个原因：更容易组合到现有脚本中，通过标准 shell 脚本进行调度，以及在无头服务器环境中运行，无需 UI。
命令结构：
seller-cli report --type business-report --date-range 30d --output csv
seller-cli report --type inventory-health --marketplace US
seller-cli report --type advertising-performance --campaign-type SP会话管理
Amazon 的登录流程包括 2FA，这使得自动化更加复杂。我们通过序列化和恢复 Playwright 会话状态来解决这个问题：首次运行时手动完成登录，会话状态保存到磁盘，后续运行从保存的状态恢复，直到会话过期。
会话通常持续 14 天，这对于日常数据提取来说已经足够了。当需要重新认证时，工具会提示用户完成手动登录步骤。
报告下载流程
大多数 Seller Central 报告遵循相同的模式：请求报告生成，轮询直到准备就绪，然后下载。这个循环从几秒到几分钟不等，取决于报告大小。
工具通过轮询间隔和最大重试次数来处理这个问题，并将 CSV 直接写入输出目录，带有时间戳后缀，以便多次运行不会相互覆盖。