API & AI Copilot Quickstart

Prefer to watch? Here's the full setup in a quick video walkthrough: Connect Claude or ChatGPT to your Amazon Ads

Get set up with the Merch Jar API and your AI assistant in minutes. Download the Copilot Pack and start working with your ad data in plain English, in either Claude or ChatGPT.

The Merch Jar API lets you read your advertising data, write and preview segments, and deploy automations programmatically. Paired with an AI assistant, you can describe what you want in plain English and have it generate, test, and deploy segment logic directly against your live accounts.

What You Can Do

• Ask questions about your advertising data across any account or marketplace
• Write a segment in plain English and have AI generate the V2 logic
• Preview exactly which keywords, campaigns, or search terms a segment would affect before it runs
• Deploy and manage segments across multiple profiles without touching the UI
• Duplicate segment logic across client accounts instantly

What You Need

• A Merch Jar account (free trial available)
• One of these AI setups:
  • Claude: the Claude desktop app plus the Claude for Chrome extension, or
  • ChatGPT: the Codex app
• The Merch Jar Copilot Pack (download below)

The pack is the same for both. One download works in either app.

Step 1 — Download the Copilot Pack

The Copilot Pack is a folder of reference files that gives your AI assistant everything it needs to work with your Merch Jar account. Download it, unzip it, and keep it somewhere you can find.

[DOWNLOAD COPILOT PACK]

When you upgrade later, replace the pack contents but keep your user folder. That folder holds your API key and account settings and carries over between versions.

Step 2 — Open the Pack in Your AI App

Path A, Claude (Cowork):

1. Install the Claude desktop app from claude.ai/download and the Claude for Chrome extension from the Chrome Web Store. The Chrome extension is what lets Claude reach your Merch Jar account.
2. Open Claude, start a conversation, click the Cowork icon, and point it at the folder where you unzipped the pack.

Path B, ChatGPT (Codex):

1. Open the pack folder in the Codex app.
2. The first time Codex reaches out to app.merchjar.com, it will ask you to approve network access. Approve it, and it will continue.

Make sure the folder you're selecting in your AI app contains the Claude, Agents, and other references folders. When you unzip the Copilot Pack, it may be nested inside of another folder.

Step 3 — Connect Your Account

Now grab your API key and hand it to your assistant.

1. In Merch Jar, go to Account Menu > API Keys and create a new key. Give it a name like "AI Copilot," then enable all scopes.
2. Copy the key and paste it straight into the chat. (The full key is only shown once at creation, but you are using it right now, so there is no need to store it separately.)

Your assistant will ask you to confirm before saving it (Claude double-checks any pasted key, which is normal, just say yes), then it will:

• Save the key to your config file
• Fetch your connected ad accounts and marketplaces
• Populate your config with the account list
• Greet you and offer a first action

After this, every new session reads your config automatically. You will not need to paste your key again.

If your assistant does not seem to know about the pack (some setups, including ChatGPT/Codex desktop, do not read the pack's instruction file on their own), send this as your first message and it will pick everything up:

Read CLAUDE.md (or AGENTS.md) in this folder and follow its setup instructions. Here's my Merch Jar API key: mj_live_...

Step 4 — Run Your First Scan

Once you are connected, try this first:

"Run a quick scan on my search terms."

You will get a dollar figure for wasted spend in under a minute, with the top offenders and one recommended next step. From there you can ask it to build and deploy the fix, all previewed before anything goes live.

A few more things to try once you are rolling:

• "Review my whole account and tell me what to automate first."
• "Write a segment that pauses keywords with more than 30 clicks and no orders in the last 14 days, and preview it before deploying."
• "Duplicate my bid management segment to all my client accounts."
• "What's my total spend across all accounts in the last 30 days?"

‍

‍