sparkx-edit-ads SKILL.md skillB

sparkx-edit-ads from sparkxai/sparkxai-mcp is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add sparkxai/sparkxai-mcp/sparkx-edit-ads@v1.1.7

Pins v1.1.7 in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 16 of 17 checks passed
Kind
SKILL.md skill
Repository
sparkxai/sparkxai-mcp
Path
skills/sparkx-edit-ads/SKILL.md
Versions recorded
9
Latest version
v1.1.7, committed Nov 3, 2026
First version recorded
Sep 8, 2026
Size
30,268 bytes
Repository stars
19
License
none declared

Edit live Amazon Sponsored ad entities in bulk through the single tool `batch_update_ads` - campaign daily budget / state / bidding strategy, keyword and target status and bids, promoted products (product ads), negative keywords and negative product targets, campaign portfolio membership, portfolio budgets/dates, and ad group state. 25 entity+action routes; 12 of them can run a two-phase platform confirmation. Use when the user wants to change / pause / enable / archive / raise / lower / add /…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Edit Ads

One tool, `batch_update_ads(entity, action, request, userContext)`, covers every write.
Use the exact camelCase `budget.type` and `bid.type` values from the tool schema
(for example, `setTo` or `increasePercent`), without spaces. Percent modes use
`amount: 10` for 10%, not `0.1`. Legacy space-separated inputs are accepted for
compatibility; use camelCase when constructing new requests.
`entity` + `action` select one of **25 registered routes**; an unregistered pair is refused.

Read [`references/platform-notes.md`](references/platform-notes.md) once first - scope,
the response envelope, the full `errorType` list, rate limits, and how to tell
"it failed" from **"we do not know whether it applied"**.

## These writes touch live spend

Every route here changes a real campaign that is spending real money right now.

**Treat every `state = archived` write as irreversible.** Once an object is archived the
archived-state guard refuses any further write to it through this tool, so there is no
un-archive path here - that applies to keywords, targets, negative keywords and negative
targets just as much as to campaigns.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add sparkxai/sparkxai-mcp/sparkx-edit-ads@sha256:9e732f8b22cde5d6

The line at the top of this page pins the label v1.1.7, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_7nmqxo7p6cxnq2z3.svg)](https://markdownregistry.com/a/art_7nmqxo7p6cxnq2z3)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 9 versions of this file, between Sep 8, 2026 and Nov 3, 2026, about one every 7 days. Its first recorded version is graded A and its latest B.

versioncommittedcommitsizeaudit
v1.1.7 latest2026-11-03 ca50742 30,268 BB view · diff
v1.1.62026-10-27 0ba4904 30,268 BB view · diff
v1.1.52026-10-22 223b6df 29,329 BB view · diff
v1.1.42026-10-20 902e7d0 29,329 BB view · diff
v1.1.22026-09-23 06df073 27,217 BB view · diff
v1.1.12026-09-18 1b3f28f 27,010 BB view · diff
v1.1.02026-09-17 387383b 27,014 BB view · diff
v1.0.12026-09-11 7a36486 25,929 BB view · diff
v1.0.02026-09-08 87fbf11 19,754 BA view

Audit of the latest version

B  16 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No prompt-injection phrasing (matched: do not tell the user)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (30268 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.

Source

GitHub

sparkxai/sparkxai-mcp · 19 stars · license none declared · pushed 2026-11-03 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_7nmqxo7p6cxnq2z3
GET https://markdownregistry.com/api/v1/resolve?ref=sparkxai/sparkxai-mcp/sparkx-edit-ads
GET https://markdownregistry.com/api/v1/blob/9e732f8b22cde5d623abbcae0061d968d9ed7ae89e64acd6303bdfe0cd720ff9

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from sparkxai/sparkxai-mcp

sparkx-ads-structure-analysis SKILL.md skill
sparkxai/sparkxai-mcp · skills/sparkx-ads-structure-analysis/SKILL.md · Analyze how ad spend and efficiency break down across a structural dimension — campaign type (SP/SB/SD)…
v1.1.6 · audit A · 19 stars
sparkx-create-ai-group SKILL.md skill
sparkxai/sparkxai-mcp · skills/sparkx-create-ai-group/SKILL.md · Create a NEW AI managed group (托管组) for Amazon Sponsored ads and place campaigns under it when required. Routes by ad…
v1.2.4 · audit A · 19 stars
sparkx-create-campaign SKILL.md skill
sparkxai/sparkxai-mcp · skills/sparkx-create-campaign/SKILL.md · Create new Amazon Sponsored Products campaigns in bulk through `create_sp_sb_campaign`, or add ad groups to an existing…
v1.0.5 · audit A · 19 stars
sparkx-delete-ai-group SKILL.md skill
sparkxai/sparkxai-mcp · skills/sparkx-delete-ai-group/SKILL.md · Delete (archive) an AI managed group (托管组) itself - SD, SP, or SB - releasing its campaigns or migrating them to…
v1.0.9 · audit A · 19 stars
sparkx-edit-ai-group SKILL.md skill
sparkxai/sparkxai-mcp · skills/sparkx-edit-ai-group/SKILL.md · Modify an EXISTING AI managed group (托管组) for Amazon Sponsored ads - change target ACOS/ROAS, budget, turn its AI…
v1.2.4 · audit A · 19 stars
sparkx-monthly-ads-report SKILL.md skill
sparkxai/sparkxai-mcp · skills/sparkx-monthly-ads-report/SKILL.md · Generate a monthly ad performance recap for ads managers / account managers at month-end. Includes full-month KPIs (MoM…
v1.2.2 · audit A · 19 stars
sparkx-product-diagnosis SKILL.md skill
sparkxai/sparkxai-mcp · skills/sparkx-product-diagnosis/SKILL.md · Diagnose product-level (ASIN) health: rank products by spend/sales/ACOS, segment the catalog into a portfolio tier…
v1.2.3 · audit A · 19 stars
sparkx-promo-reset SKILL.md skill
sparkxai/sparkxai-mcp · skills/sparkx-promo-reset/SKILL.md · After a promotion (Prime Day, Prime Big Deal Days, Black Friday / Cyber Monday, holiday events), find every bid…
v1.0.4 · audit A · 19 stars
sparkx-query-ads-performance SKILL.md skill
sparkxai/sparkxai-mcp · skills/sparkx-query-ads-performance/SKILL.md · Query advertising performance metrics: spend, clicks, sales, ACOS, ROAS, etc. For analyzing ad performance, comparing…
v1.4.9 · audit A · 19 stars
sparkx-query-entity-metadata SKILL.md skill
sparkxai/sparkxai-mcp · skills/sparkx-query-entity-metadata/SKILL.md · Query advertising entity metadata: name, status, configuration, settings (no time range or metrics). For finding entity…
v1.4.9 · audit A · 19 stars
sparkx-query-operation-log SKILL.md skill
sparkxai/sparkxai-mcp · skills/sparkx-query-operation-log/SKILL.md · Query SparkX AI platform operation logs: user and AI action history on ad entities. For tracking change history…
v1.3.8 · audit A · 19 stars
sparkx-search-term-diagnosis SKILL.md skill
sparkxai/sparkxai-mcp · skills/sparkx-search-term-diagnosis/SKILL.md · Diagnose where ad spend goes at the search-term level: tag every search term (keyword vs ASIN, branded vs non-branded…
v1.0.4 · audit A · 19 stars

Every file in sparkxai/sparkxai-mcp

Browse by kind, by grade B, or by owner.