批量管理 Amex Offers，并集中查看多卡 Benefits 进度。
Manage Amex Offers across cards and review Benefits progress in one panel.
 一个 offer，加到所有符合条件的卡 Search across cards, pick offers, enroll in one click. |
 提交后逐卡核对真实结果 Re-reads each card — confirmed, failed, or unverified. No guessing. |
 跨卡追踪每一笔 statement credit Remaining amounts, per-card progress, expiry — all read-only. |
 面板就在 Amex 官网页面里 Runs in your own logged-in session. Local-only, no telemetry. |
Amex Assistant 用于在 American Express 官网中集中管理 Amex Offers 和 Benefits。 它会在当前登录会话中读取每张卡的 Offers，显示在一个独立面板中；用户选择 offer 和目标卡后，工具会提交对应的 Add to Card 请求，并在完成后重新读取 added list， 以确认每张卡的实际结果。
除 Offers 外，工具还提供只读的 Benefits 页面，用于汇总主卡上的 statement credits。 该页面展示本月剩余额度、今年已抵扣金额、年费抵扣比例、到期时间以及多卡 benefit 的逐卡进度。
提供两种安装形式，功能完全相同：Chrome 扩展（商店一键安装、自动更新）和 userscript（Tampermonkey / Violentmonkey）。
- 跨卡 Offers 管理。 在一个面板中查看所有卡的 eligible offers，支持搜索、按卡筛选和多卡筛选。
- 精确选择目标卡。 勾选 offer 时默认选择所有可添加的卡，也可以展开 offer 后只选择指定卡。
- 同一 offer 并发提交。 对同一个 offer，所有目标卡会同时提交，以减少某张卡成功后其他卡失去资格的概率；不同 offer 之间会稍作间隔。
- 提交后复查结果。 工具不会只依赖接口返回的 success，而会重新读取每张卡的 added list，并将结果归类为确认已加、添加失败、疑似去重、无法确认或未提交。
- 谨慎处理重试和限流。 瞬时网络错误和 5xx 响应会快速重试；遇到 429、403 或疑似拦截时，本轮剩余请求会停止，避免继续触发风控。
- 只读 Benefits 汇总。 Benefits 页面仅读取 statement credit 进度，不执行 enroll，也不会改动账户。
- 本地运行，无遥测。 没有后端服务，不上传数据，不读取 cookie 内容，也不收集 IP。userscript 版头部使用
@grant none，没有跨站特权 API；扩展版只申请 Amex 站点的 host 权限。
本项目依赖 Amex 网页内部接口，而不是公开 API。American Express 可能随时调整字段、endpoint、行为或风控策略。使用前请阅读
DISCLAIMER.md。
方式一：Chrome 扩展（推荐）
从 Chrome Web Store 一键安装，后续自动更新。Edge 等 Chromium 内核浏览器同样适用。
方式二：Userscript
- 安装 userscript 管理器，例如 Tampermonkey 或 Violentmonkey。
- 从 Greasy Fork 安装；也可以直接安装 GitHub raw 脚本。
安装后打开 https://global.americanexpress.com/ 并登录，页面右侧会出现 Amex 助手 按钮。
- 点击 Amex 助手，面板会读取所有卡的 Offers。
- 在 Offers 页面搜索或筛选 offer。勾选一行会选择所有可添加的卡；展开后可以调整目标卡。
- 点击 加到所选卡 并确认。提交完成后，面板会自动复查每张卡的 added list。
- 如果结果显示 疑似去重，表示接口返回成功，但复查时该 offer 没有出现在目标卡的 added list 中。这通常与 Amex 对同一 offer 的按人去重有关，不一定代表工具错误。
- 切换到 Benefits 页面可以只读查看 statement credits。该页面不会执行任何账户变更。
Amex Assistant 没有服务器，不收集 IP，不上传数据，也不读取 cookie 内容。所有请求都发生在
global.americanexpress.com 页面上下文中，并使用浏览器已经登录的 Amex 会话。
可以直接审查 src/amex-assistant.user.js：脚本头部为 @grant none，没有 GM.xmlHttpRequest、没有 @connect，也没有第三方 endpoint。Chrome 扩展由同一份源码构建（见 docs/CHROME_WEB_STORE.md），只申请 Amex 站点的 host 权限。
src/amex-assistant.user.js 是唯一的源码文件，本身就是可安装的
userscript，无需构建；Chrome 扩展和商店素材由它一键构建生成。测试使用本地 mock，不需要 Amex 登录态。
npm install
npm test # 单元测试（本地 mock）
npm run lint
npm run build # 构建 Chrome 扩展 -> dist/extension/ + dist/*.zip
npm run release # 发版：版本号、tag、GitHub Release、商店草稿一条龙真实账户首次使用前，建议按 docs/FINDINGS.md 中的 DevTools checklist
确认 Amex 当前接口仍然匹配，然后先选择一个 offer 和一张卡做小范围 smoke test。
| Doc | 内容 |
|---|---|
docs/FINDINGS.md |
当前整理出的 Amex 内部 Offers API。 |
docs/PLAN.md |
设计思路、里程碑和行为约束。 |
docs/IMPLEMENTATION.md |
给 coding agent 的实现计划和验收点。 |
docs/CHROME_WEB_STORE.md |
Chrome 扩展的构建、发布与自动发版流程。 |
本项目与 American Express 无关联。自动化操作自己的账户可能违反或处在 Amex 服务条款的灰色地带；请自行承担风险。本工具不能保证同一个 offer 一定能添加到多张卡。详见 DISCLAIMER.md 和 LICENSE。
Amex Assistant manages American Express Offers and Benefits from a consolidated panel on the Amex website. It reads Offers for each card in the current signed-in browser session, lets the user select an offer and target cards, submits the corresponding Add to Card requests, and then re-reads the added list to verify the actual result for each card.
The tool also includes a read-only Benefits view for statement credits on primary cards. It summarizes remaining credit for the current period, year-to-date redeemed value, annual-fee payback, expiration timing, and per-card progress for multi-card benefits.
It ships in two identical flavors: a Chrome extension (one-click install from the store, auto-updates) and a userscript (Tampermonkey / Violentmonkey).
- Cross-card Offers management. View eligible offers across all cards in one panel, with search, card filtering, and multi-card filtering.
- Explicit target-card selection. Selecting an offer queues all eligible cards by default; expanding the row allows per-card selection.
- Concurrent submission for the same offer. Target cards for the same offer are submitted together to reduce the chance that one successful card makes the offer unavailable on the others. Different offers are paced apart.
- Post-submit verification. The tool does not rely only on success responses. It re-reads each card's added list and classifies results as confirmed, failed, suspected dedupe, unconfirmed, or skipped.
- Conservative retry and throttling behavior. Transient network errors and 5xx responses are retried quickly. If the session receives 429, 403, or an interception-looking response, the remaining run stops instead of continuing to send requests.
- Read-only Benefits summary. The Benefits view reads statement credit progress only; it does not enroll benefits or modify the account.
- Local-only, no telemetry. No backend, no data upload, no cookie reading, no IP collection. The userscript header uses
@grant nonewith no privileged cross-site APIs; the extension requests host access to the Amex site only.
This project relies on internal Amex web endpoints, not public APIs. American Express may change fields, endpoints, behavior, or throttling at any time. Review
DISCLAIMER.mdbefore use.
Option 1 — Chrome extension (recommended)
Install from the Chrome Web Store — one click, auto-updates. Works on Edge and other Chromium browsers too.
Option 2 — Userscript
- Install a userscript manager, such as Tampermonkey or Violentmonkey.
- Install from Greasy Fork, or install the raw GitHub userscript.
Then open https://global.americanexpress.com/, sign in, and click the
Amex Assistant button on the page.
- Click Amex Assistant. The panel reads Offers from all cards.
- In the Offers view, search or filter offers. Selecting a row queues all eligible cards; expanding the row allows target-card adjustment.
- Click Add to selected cards and confirm. After submission, the panel automatically re-reads each card's added list.
- Suspected dedupe means Amex reported success, but the offer did not appear in the target card's added list during verification. This is commonly related to Amex deduplicating the same offer per person and is not necessarily a tool error.
- Switch to Benefits for read-only statement credit tracking. This view does not perform any account-changing action.
Amex Assistant has no server, collects no IP addresses, uploads no data, and
does not read cookie contents. Requests run in the global.americanexpress.com
page context using the browser's already signed-in Amex session.
You can audit src/amex-assistant.user.js
directly: the userscript header declares @grant none, with no
GM.xmlHttpRequest, no @connect, and no third-party endpoint. The Chrome
extension is built from the same single source (see
docs/CHROME_WEB_STORE.md) and requests host
access to the Amex site only.
src/amex-assistant.user.js is the single source
file and is itself the installable userscript — no build step needed. The
Chrome extension and store assets are generated from it. Tests use local mocks
and do not require an Amex login.
npm install
npm test # unit tests (local mocks)
npm run lint
npm run build # build the Chrome extension -> dist/extension/ + dist/*.zip
npm run release # cut a release: version, tag, GitHub Release, store draftBefore trusting a real run, use the DevTools checklist in
docs/FINDINGS.md to confirm Amex has not changed the
internal endpoints, then run a small smoke test with one offer on one card.
| Doc | Contents |
|---|---|
docs/FINDINGS.md |
Current notes on the internal Amex Offers API. |
docs/PLAN.md |
Design, milestones, and behavior constraints. |
docs/IMPLEMENTATION.md |
Implementation plan and validation notes for coding agents. |
docs/CHROME_WEB_STORE.md |
Building, publishing, and the automated release flow for the Chrome extension. |
This project is not affiliated with American Express. Automating your own
account may violate or sit in a gray area of the Amex Terms of Service; use it
at your own risk. The tool cannot guarantee that an offer will be added to more
than one card. See DISCLAIMER.md and LICENSE.