Amazon Returns Recovery
Why this exists
This started as a test of a general-purpose contract/customer-service negotiation
tool — the goal was just to see if it could hold its own in a dispute. Pointed at a
live Amazon account, it surfaced two restocking fees ($44.99 and $28.50) the account
owner had no idea existed, on returns processed weeks earlier. Both got waived in the
same sitting — the first refunded exactly the $44.99 fee, the second came back at
$30.63 (the associate rounded up past the $28.50 fee as a goodwill gesture). Total
recovered from fees alone: $75.62, on charges the account owner never would have
gone looking for. The lesson: money like this doesn't announce itself — restocking
fees, partial refunds, and price-protection differences sit quietly in order history
unless something goes and checks. That's what this skill automates.
Treat this as a metal detector, not an autopilot: it surfaces what's buried and drafts
the case, but every dispute goes through the account owner before anything gets sent.
The same account also had a third case worth knowing about, even though it's outside
this skill's default restocking-fee scope: a $372.69 electric shaver the account
owner had already been denied a refund on once — while still inside the return
window. Re-disputed two days after the window closed, hands-off, the case ended in
a full $372.69 refund with no return required — the associate just let the account
owner keep it. Overturning an existing denial after the window shut is the ceiling of
what a well-reasoned exception ask can get, not just fee waivers. See
references/example-cases.md for the full writeup of
all three real cases, including exactly what was said and what worked.
Prerequisites
- Claude in Chrome browser extension connected to the browser, and the user already
signed into the target Amazon account. If
mcp__claude-in-chrome__* tools aren't
loaded yet, fetch them via ToolSearch first (see the extension's own MCP
instructions for the batch-load query).
- This runs against a real account. If the account is shared (family members with
separate shipping addresses on the same login), be ready to see orders that aren't
the user's — flag those, don't just fold them into the same batch without asking.
Phase 1a — Order/return discovery (read-only, no side effects)
Goal: find every completed return where Amazon deducted a restocking fee, without
touching anything.
- Search order history broadly by category keyword, not just exact terms — Amazon's
your-orders/search matches loosely, so one keyword (e.g. "razor") surfaces
adjacent items (shavers, trimmers) too. Restocking fees concentrate on
higher-value electronics/appliances, so prioritize checking those over
consumables or clothing.
https://www.amazon.com/your-orders/search/ref=ppx_yo2ov_dt_b_search?opt=ab&search=<keyword>
- Paginate through all result pages — don't stop at page 1. Older orders (a year+
back) still show up here even though they've long since dropped off
Your Returns.
- For faster coverage of recent activity, also check
https://www.amazon.com/your-returns — but note it only shows roughly the last
3 months, so it's a supplement to the search sweep, not a replacement for it.
- For each order that shows "Return complete" / "Refund Complete" / "Refund issued",
open its detail page:
https://www.amazon.com/your-orders/order-details?orderID=<orderID>
Find the Refund Total line — it has a small chevron that expands to an
itemized breakdown (Item(s) refund / Tax refund / Restocking fee / Refund Total).
Click it. Orders with no fee just show item + tax = refund total; orders with a
fee show the deduction explicitly.
- Record every hit: order #, item name, item price, restocking fee amount, who it
shipped to, and whether it was sold by Amazon.com directly or a third-party
seller (first-party listings are the strongest cases — Amazon's own chat agents
can waive those without looping in a marketplace seller).
- Don't try to make this exhaustive on the first pass if the account has a long
history — report what's found so far and note that more may be scattered across
older years if the user wants a deeper sweep.
Stop here. Do not open the dispute chat yet.
Phase 1b — Digital subscription audit (read-only, no side effects)
Unvalidated click-path — the exact URLs below are the best-known entry points as
of this writing, not yet confirmed live like the Phase 1a flow. If a URL 404s or
redirects somewhere unexpected, navigate from the account menu instead (Amazon moves
these pages periodically) and note the working path back into this file once
confirmed.
Goal: find every recurring digital subscription billed through the Amazon account —
Prime Video Channels, Audible, Kindle Unlimited, Prime itself — and flag ones that
look forgotten, unused, or worth reconsidering. This is a different shape of "money
Amazon is quietly taking" than restocking fees: it's ongoing, not a one-time
deduction, so the fix is usually "cancel it" rather than "waive it," with a refund
ask reserved for genuinely forgotten charges.
- Prime Video Channels (this is how Britbox, Starz, AMC+, Paramount+, Shudder,
MGM+, etc. actually bill — they're not separate Amazon relationships, they're
add-on channels on top of Prime Video):
https://www.primevideo.com/settings/channels — lists every active channel
subscription, price, and next billing date. If that redirects, go to Prime
Video → Account & Settings (top right) → Channels.
- Audible membership:
https://www.audible.com/account/membership-overview —
same Amazon login, separate billing page. Shows plan tier, price, next charge
date, and credit balance (unused credits are themselves worth flagging — they
don't expire immediately but do eventually).
- Kindle Unlimited:
https://www.amazon.com/kindle-dbs/subscribe/kindle_unlimited
or via Account → Digital Services and Devices → Kindle Unlimited.
- Prime membership itself:
https://www.amazon.com/manageprime — for cases
where the user isn't using Prime shipping/video/music benefits and it's worth
flagging (this one is more consequential to cancel than a $9 channel add-on, so
treat it as report-only unless the user specifically asks about it).
- For each subscription found, record: name, monthly/annual price, next billing
date, and — if the page shows it — last-used or last-watched date. If usage data
isn't visible on the billing page, ask the user directly whether they still use
it rather than guessing.
- Don't cancel or touch anything in this phase. Just build the list.
Phase 2 — Confirm with the user
Report the findings as a plain list: for fees, item / order # / fee amount / who it
shipped to / first-party or third-party; for subscriptions, name / price / billing
cadence / next charge date / whether it looks used or forgotten. Ask which ones to
pursue and what outcome they want for each (waive a fee, dispute a charge, cancel a
subscription, or cancel and ask for the last charge back). Some fees are legitimate
(e.g. an opened-item policy the seller disclosed at return time) and some
subscriptions may turn out to still be wanted — don't assume every finding is worth
acting on, and say so if one looks earned or intentional rather than a mistake.
Phase 3 — Dispute or cancel (one item at a time, only after confirmation)
For fee/refund disputes, drive Amazon's live chat to request a waiver. The exact
click-path, a critical popup-window workaround, and the escalation flow to a human
associate are documented in
references/dispute-chat-flow.md — read that file
before starting this phase, since Amazon's chat UI has a specific gotcha (it opens in
a popup window Claude in Chrome's tab tracking can't see) that will silently strand
the flow if skipped. The same chat flow and associate-facing script apply whether the
ask is "waive this restocking fee" or "cancel this channel and refund the last
charge" — only the specifics of the ask change.
For subscription cancellations, note the two distinct asks are not equally strong:
- "Cancel this subscription" is unconditional — the user is entitled to cancel
anytime, no negotiation needed. This can usually be done directly on the
subscription's own settings page (the URLs in Phase 1b) without needing chat at
all — try that first, it's faster than a chat dispute.
- "Refund the last charge because I forgot to cancel / wasn't using it" is a
goodwill ask, same as a restocking-fee waiver — reasonable to make once, but don't
push past a single polite counter if declined, and don't claim you tried to cancel
earlier if that isn't true.
Ground rules while chatting with the associate:
- State only true facts: order number or subscription name, item, price, fee amount
(or subscription charge amount), and that it was sold/billed by Amazon.com (when
true). Don't invent a prior contact attempt or a return/cancellation reason that
didn't happen — the ask itself is reasonable on its own and doesn't need
embellishment to land.
- When offered a refund method, default to original payment method unless the user
said otherwise.
- Confirm the exact refund amount and stated timeline, or the exact cancellation
effective date, before ending the chat.
Phase 4 — Report
After each dispute or cancellation resolves (or if the associate declines), tell the
user: amount recovered or subscription canceled, refund method, stated ETA or
effective date, and associate name if given. If several items were pursued in one
session, summarize as a running total across fees, refunds, and subscriptions
canceled (report subscription savings as "$X/month going forward" separately from
one-time dollars recovered — they're not the same kind of money).
Stretch goal — not yet built
Price-protection refunds: some categories/sellers refund the difference if a
listing's price drops within the return window after purchase. This would mean
comparing paid price vs. current listing price on recent (still-returnable) orders
and flagging drops worth claiming. Worth building once the restocking-fee and
subscription flows are both solid, but out of scope for now — don't attempt it
without discussing it with the user first, since it's unvalidated.
1---2name: amazon-returns-recovery3description: Use when the user wants to audit Amazon returns or Amazon-billed subscriptions, mentions a restocking fee, short or denied refund, forgotten Prime Video Channel, Audible, Kindle Unlimited, or Prime charge, or asks whether Amazon still owes or bills them. Read order, refund, and subscription evidence first; report findings and require confirmation before chat, cancellation, or dispute. The documented cases recovered $448.31, but never promise recovery. Requires an authenticated Claude in Chrome session. NOT FOR: bank chargebacks, marketplace A-to-z seller claims, price-protection claims, or subscriptions billed outside Amazon — use subscription-recovery for those.4---5
6# Amazon Returns Recovery
7
8## Why this exists
9
10This started as a test of a general-purpose contract/customer-service negotiation
11tool — the goal was just to see if it could hold its own in a dispute. Pointed at a
12live Amazon account, it surfaced two restocking fees ($44.99 and $28.50) the account
13owner had no idea existed, on returns processed weeks earlier. Both got waived in the
14same sitting — the first refunded exactly the $44.99 fee, the second came back at
15$30.63 (the associate rounded up past the $28.50 fee as a goodwill gesture). Total
16recovered from fees alone: **$75.62**, on charges the account owner never would have
17gone looking for. The lesson: money like this doesn't announce itself — restocking
18fees, partial refunds, and price-protection differences sit quietly in order history
19unless something goes and checks. That's what this skill automates.
20
21Treat this as a metal detector, not an autopilot: it surfaces what's buried and drafts
22the case, but every dispute goes through the account owner before anything gets sent.
23
24The same account also had a third case worth knowing about, even though it's outside
25this skill's default restocking-fee scope: a $372.69 electric shaver the account
26owner had already been **denied a refund on once — while still inside the return
27window**. Re-disputed two days after the window closed, hands-off, the case ended in
28a full **$372.69** refund with no return required — the associate just let the account
29owner keep it. Overturning an existing denial after the window shut is the ceiling of
30what a well-reasoned exception ask can get, not just fee waivers. See
31[references/example-cases.md](references/example-cases.md) for the full writeup of
32all three real cases, including exactly what was said and what worked.
33
34## Prerequisites
35
36- Claude in Chrome browser extension connected to the browser, and the user already
37 signed into the target Amazon account. If `mcp__claude-in-chrome__*` tools aren't
38 loaded yet, fetch them via ToolSearch first (see the extension's own MCP
39 instructions for the batch-load query).
40- This runs against a real account. If the account is shared (family members with
41 separate shipping addresses on the same login), be ready to see orders that aren't
42 the user's — flag those, don't just fold them into the same batch without asking.
43
44## Phase 1a — Order/return discovery (read-only, no side effects)
45
46Goal: find every completed return where Amazon deducted a restocking fee, without
47touching anything.
48
491. Search order history broadly by category keyword, not just exact terms — Amazon's
50 `your-orders/search` matches loosely, so one keyword (e.g. "razor") surfaces
51 adjacent items (shavers, trimmers) too. Restocking fees concentrate on
52 higher-value electronics/appliances, so prioritize checking those over
53 consumables or clothing.
54 - `https://www.amazon.com/your-orders/search/ref=ppx_yo2ov_dt_b_search?opt=ab&search=<keyword>`
55 - Paginate through all result pages — don't stop at page 1. Older orders (a year+
56 back) still show up here even though they've long since dropped off `Your
57 Returns`.
582. For faster coverage of *recent* activity, also check
59 `https://www.amazon.com/your-returns` — but note it only shows roughly the last
60 3 months, so it's a supplement to the search sweep, not a replacement for it.
613. For each order that shows "Return complete" / "Refund Complete" / "Refund issued",
62 open its detail page:
63 `https://www.amazon.com/your-orders/order-details?orderID=<orderID>`
64 Find the **Refund Total** line — it has a small chevron that expands to an
65 itemized breakdown (Item(s) refund / Tax refund / Restocking fee / Refund Total).
66 Click it. Orders with no fee just show item + tax = refund total; orders with a
67 fee show the deduction explicitly.
684. Record every hit: order #, item name, item price, restocking fee amount, who it
69 shipped to, and whether it was sold by Amazon.com directly or a third-party
70 seller (first-party listings are the strongest cases — Amazon's own chat agents
71 can waive those without looping in a marketplace seller).
725. Don't try to make this exhaustive on the first pass if the account has a long
73 history — report what's found so far and note that more may be scattered across
74 older years if the user wants a deeper sweep.
75
76**Stop here.** Do not open the dispute chat yet.
77
78## Phase 1b — Digital subscription audit (read-only, no side effects)
79
80**Unvalidated click-path** — the exact URLs below are the best-known entry points as
81of this writing, not yet confirmed live like the Phase 1a flow. If a URL 404s or
82redirects somewhere unexpected, navigate from the account menu instead (Amazon moves
83these pages periodically) and note the working path back into this file once
84confirmed.
85
86Goal: find every recurring digital subscription billed through the Amazon account —
87Prime Video Channels, Audible, Kindle Unlimited, Prime itself — and flag ones that
88look forgotten, unused, or worth reconsidering. This is a different shape of "money
89Amazon is quietly taking" than restocking fees: it's ongoing, not a one-time
90deduction, so the fix is usually "cancel it" rather than "waive it," with a refund
91ask reserved for genuinely forgotten charges.
92
931. **Prime Video Channels** (this is how Britbox, Starz, AMC+, Paramount+, Shudder,
94 MGM+, etc. actually bill — they're not separate Amazon relationships, they're
95 add-on channels on top of Prime Video):
96 `https://www.primevideo.com/settings/channels` — lists every active channel
97 subscription, price, and next billing date. If that redirects, go to Prime
98 Video → Account & Settings (top right) → Channels.
992. **Audible membership**: `https://www.audible.com/account/membership-overview` —
100 same Amazon login, separate billing page. Shows plan tier, price, next charge
101 date, and credit balance (unused credits are themselves worth flagging — they
102 don't expire immediately but do eventually).
1033. **Kindle Unlimited**: `https://www.amazon.com/kindle-dbs/subscribe/kindle_unlimited`
104 or via Account → Digital Services and Devices → Kindle Unlimited.
1054. **Prime membership itself**: `https://www.amazon.com/manageprime` — for cases
106 where the user isn't using Prime shipping/video/music benefits and it's worth
107 flagging (this one is more consequential to cancel than a $9 channel add-on, so
108 treat it as report-only unless the user specifically asks about it).
1095. For each subscription found, record: name, monthly/annual price, next billing
110 date, and — if the page shows it — last-used or last-watched date. If usage data
111 isn't visible on the billing page, ask the user directly whether they still use
112 it rather than guessing.
1136. Don't cancel or touch anything in this phase. Just build the list.
114
115## Phase 2 — Confirm with the user
116
117Report the findings as a plain list: for fees, item / order # / fee amount / who it
118shipped to / first-party or third-party; for subscriptions, name / price / billing
119cadence / next charge date / whether it looks used or forgotten. Ask which ones to
120pursue and what outcome they want for each (waive a fee, dispute a charge, cancel a
121subscription, or cancel *and* ask for the last charge back). Some fees are legitimate
122(e.g. an opened-item policy the seller disclosed at return time) and some
123subscriptions may turn out to still be wanted — don't assume every finding is worth
124acting on, and say so if one looks earned or intentional rather than a mistake.
125
126## Phase 3 — Dispute or cancel (one item at a time, only after confirmation)
127
128For fee/refund disputes, drive Amazon's live chat to request a waiver. The exact
129click-path, a critical popup-window workaround, and the escalation flow to a human
130associate are documented in
131[references/dispute-chat-flow.md](references/dispute-chat-flow.md) — read that file
132before starting this phase, since Amazon's chat UI has a specific gotcha (it opens in
133a popup window Claude in Chrome's tab tracking can't see) that will silently strand
134the flow if skipped. The same chat flow and associate-facing script apply whether the
135ask is "waive this restocking fee" or "cancel this channel and refund the last
136charge" — only the specifics of the ask change.
137
138For subscription cancellations, note the two distinct asks are not equally strong:
139- **"Cancel this subscription"** is unconditional — the user is entitled to cancel
140 anytime, no negotiation needed. This can usually be done directly on the
141 subscription's own settings page (the URLs in Phase 1b) without needing chat at
142 all — try that first, it's faster than a chat dispute.
143- **"Refund the last charge because I forgot to cancel / wasn't using it"** is a
144 goodwill ask, same as a restocking-fee waiver — reasonable to make once, but don't
145 push past a single polite counter if declined, and don't claim you tried to cancel
146 earlier if that isn't true.
147
148Ground rules while chatting with the associate:
149- State only true facts: order number or subscription name, item, price, fee amount
150 (or subscription charge amount), and that it was sold/billed by Amazon.com (when
151 true). Don't invent a prior contact attempt or a return/cancellation reason that
152 didn't happen — the ask itself is reasonable on its own and doesn't need
153 embellishment to land.
154- When offered a refund method, default to original payment method unless the user
155 said otherwise.
156- Confirm the exact refund amount and stated timeline, or the exact cancellation
157 effective date, before ending the chat.
158
159## Phase 4 — Report
160
161After each dispute or cancellation resolves (or if the associate declines), tell the
162user: amount recovered or subscription canceled, refund method, stated ETA or
163effective date, and associate name if given. If several items were pursued in one
164session, summarize as a running total across fees, refunds, and subscriptions
165canceled (report subscription savings as "$X/month going forward" separately from
166one-time dollars recovered — they're not the same kind of money).
167
168## Stretch goal — not yet built
169
170**Price-protection refunds**: some categories/sellers refund the difference if a
171listing's price drops within the return window after purchase. This would mean
172comparing paid price vs. current listing price on recent (still-returnable) orders
173and flagging drops worth claiming. Worth building once the restocking-fee and
174subscription flows are both solid, but out of scope for now — don't attempt it
175without discussing it with the user first, since it's unvalidated.