Skip to content

Releases: merchjar/copilot

Merch Jar Copilot v1.2.6

Choose a tag to compare

@caminator06 caminator06 released this 10 Sep 20:12

The Copilot now includes Library management. Ask it to install a skill, check all installed skills for updates, or update itself. Updates preserve your settings, saved naming conventions and custom skills, and report conflicting edits before replacing files.

Campaign naming is available as an optional Library skill. Establish a convention for an account, review changes to existing campaign names and reuse that convention in Campaign Creation. Account Review can recommend naming work when inconsistent names get in the way.

Campaign naming starts with a proposed taxonomy and a few examples. The saved convention keeps campaign method (Auto, KW or PT) separate from keyword match type.

Get started at https://merchjar.com/library/. Existing users can copy the update request from https://merchjar.com/library/get-started/.

Automation remains disabled until a human enables it. Installing or updating local skills does not change an ad account.

Merch Jar Copilot Pack v1.2.2

Choose a tag to compare

@caminator06 caminator06 released this 09 Sep 16:44

Create a campaign structure from a pasted ASIN list or a one-column file. The bundled create-campaigns skill helps choose a structure, reviews the complete plan before account changes, and can save a reusable setup when asked.

Budget questions now distinguish per-campaign amounts from a batch total. A local preflight checks monetary precision, supported limits and the configured total. Campaign and ad-group names are included in the plan.

Manual campaigns can be prepared with generated dummy keywords. They stay paused by default. With explicit approval, manual parents can be enabled while dummy keywords remain paused.

Validation: 12 offline regression tests, online Library lint and package checks passed. The corrected enablement flow has not had a fresh end-to-end live acceptance run. Existing-account restructuring, keyword research and Smart Campaign rules remain separate workflows.

Merch Jar Copilot Pack v1.2.1

Choose a tag to compare

@caminator06 caminator06 released this 08 Sep 11:10

This update corrects the Copilot instructions used to create campaigns through the Merch Jar API.

  • Removes outdated instructions that said campaign and ad-group creation were broken. Corrects the Product Ad request format and profile header.
  • Explains automatic campaign creation and how to check the targets Amazon generates. The Copilot should not create those targets again when Merch Jar has not shown them yet.
  • Adds the verified keyword request format, including setting the initial bid on the parent ad group and checking the inherited bid. Campaign launches preserve parent IDs and inspect each result before creating children.
  • Adds the client's --idempotency-key option for update and archive requests that require it. The client does not retry automatically.

Campaigns and their explicitly created children stay paused for review. This update also documents observed target-sync, bidding-strategy display and archive-result discrepancies. It does not fix those API behaviors.

The Library inventory remains seven templates, ten skills and the Core Six collection. No new collections or property sets are included.

Download merch-jar-copilot-pack.zip below and extract it into a new folder. Keep your existing account configuration and user notes when moving to the updated pack; do not overwrite them with the blank setup files.

Merch Jar Copilot Pack v1.2.0

Choose a tag to compare

@caminator06 caminator06 released this 04 Sep 09:42

Skills on the Agent Skills standard

  • Every skill now carries spec frontmatter: license, compatibility, and metadata (version, tags, goal, risk, required scopes, what it produces).
  • New base skill merchjar-connect: the API client (scripts/merchjar_client.py, now also reads MERCHJAR_API_KEY), key handling, the deploy safety protocol, and the API / DSL / guidelines references. Every other skill declares it as a dependency.
  • Install without the zip: npx skills add merchjar/copilot (any Agent Skills client), or in Claude Code /plugin marketplace add merchjar/copilot then /plugin install merchjar-copilot@merchjar.
  • Auto-discovery mirrors added for GitHub Copilot / VS Code (.github/skills/) and Gemini CLI (.gemini/skills/), alongside .claude/ and .agents/.

Library

  • Template header v2: Risk, Schedule, Goal, Requires-Properties, Pairs-With, Changelog on every template.
  • Manifest schema v2 catalogs templates, skills, property sets, and collections (top-level templates array is unchanged for existing consumers).
  • New shelves: collections/ (first: The Core Six) and properties/ (custom-property schemas; first sets land with the skills that use them).
  • Anomaly Detection: Spend v1.1 and Core: Pause Underperforming Keywords & Targets v1.1: standards fixes only (does not contain all exclusion filter, $planned_action diagnostic). Logic unchanged.

Tooling

  • tools/library_lint.py (standards + spec checks, --online flags body changes without a version bump), tools/library_test.py (live validate + preview of every template, read-only), tools/library_drift.py (lab account vs library), tools/release.py (the one-command gate).

Pack

  • The Copilot behaves the same in a session. tools/merchjar_client.py and reference/ are now generated copies of the merchjar-connect skill. Existing installs can keep running; re-download to pick up MERCHJAR_API_KEY support.

Fetch paths

Merch Jar Copilot Pack v1.1.0

Choose a tag to compare

@caminator06 caminator06 released this 04 Sep 09:19

Library

  • Core: Search Term Waste Elimination v1.1 - CTR-relevance scaling. The search term's CTR now scales the zero-order click threshold: at or below 0.15% CTR the click bar drops to 0.5x (weak relevance, negate sooner); at or above 0.60% it rises to 1.5x (strong relevance, more runway). New settings $ctr_reference, $ctr_low_floor, $ctr_high_ceiling; CTR-aware $reason diagnostics. Validated and previewed on a live account.

Pack

  • Version stamp only. No skill behavior changes. Existing installs pick up the new template via python tools/library.py check-updates or the manifest fetch; there is no need to re-download the pack.

Fetch paths

Merch Jar Copilot Pack v1.0.1

Choose a tag to compare

@caminator06 caminator06 released this 01 Sep 18:56

Documentation sync with the new canonical public API reference. No template or skill behavior changes; existing installs keep working.

What changed

  • The public API reference now lives at https://merchjar.com/api/ (rendered from the OpenAPI contract, machine-readable at https://merchjar.com/api/openapi.json). The in-pack reference/MJ_API_REFERENCE.md points there and is the Copilot's working summary plus operational gotchas.
  • Rate limits corrected: 1,200 requests per minute per API key (previously documented as 120), plus the separate segment-preview burst limit (3 requests, refilling one every 2 seconds per account).
  • New API surfaces documented: segment schedules, audit-log change items, per-entity bid history, and Sponsored Products entity creation. Target, negative-target, and product-ad creation are live; campaign and ad-group creation are documented as known-broken until a schema fix ships.
  • Fixed a dead template-registry link in the README (templates: https://merchjar.com/templates/).
  • Removed a stale library cache file that shipped inside v1.0.0's zip.

Download

Merch Jar AI Copilot Pack v1.0.0

Choose a tag to compare

@caminator06 caminator06 released this 27 Aug 03:23

First public release of the Merch Jar AI Copilot Pack.

The pack is a thin client: it ships the operating brain, nine skills, and a small fetch tool, then pulls automation templates from this repository's library on demand. The six core automations (bid management, budget management, search-term waste, product-ad waste, impression recovery, underperformer pausing) come pre-installed on every Merch Jar account, so the Copilot starts by reading what's already there.

New in this release

  • Custom fields. Put business data Amazon doesn't have onto your account (profit margins, product phase, inventory flags, labels) and build segments that automate against it. The new enrich-account skill handles setup, and every value the Copilot writes carries an audit tag you can trace.
  • Template library. All seven library templates are cataloged in manifest.json, attached to this release. The Copilot fetches, searches, and update-checks against it.

Install
Download the zip below, unpack it, and point your AI client (Claude, ChatGPT, or any agent that reads a folder) at it. Setup guide: https://www.merchjar.com/help/docs/api-ai-copilot-quickstart

Requires a Merch Jar account and an API key with all scopes enabled (create one at https://app.merchjar.com/api-keys).

Internal development history (v10 through v12) is preserved in the pack CHANGELOG.