sparkx-search-term-diagnosis SKILL.md skillA

sparkx-search-term-diagnosis 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-search-term-diagnosis@v1.0.4

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

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
sparkxai/sparkxai-mcp
Path
skills/sparkx-search-term-diagnosis/SKILL.md
Versions recorded
4
Latest version
v1.0.4, committed Oct 27, 2026
First version recorded
Oct 13, 2026
Size
14,396 bytes
Repository stars
19
License
none declared

Diagnose where ad spend goes at the search-term level: tag every search term (keyword vs ASIN, branded vs non-branded, order tier), then report spend distribution, brand vs non-brand, zero-order waste with negative candidates, harvest candidates for exact match, and fragmented exact keywords - with fixed, reproducible rules and thresholds derived from the store's own order value and target ACOS. Read-only; execution goes to sparkx-edit-ads. Use when the user asks "上个月钱花哪了", "帮我找一批该否的词…

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

# Search Term Diagnosis (搜索词流量结构诊断)

## Scope: a read-only orchestration skill

No MCP tool of its own. It reads with three tools and hands execution to one skill:

| What | Tool | Owning skill - read it first |
|---|---|---|
| Search terms, keyword performance, totals | `get_ads_perf` | [sparkx-query-ads-performance](../sparkx-query-ads-performance/SKILL.md) |
| Exact keywords and existing negatives, campaigns, managed groups, brand names | `get_entity_metadata` | [sparkx-query-entity-metadata](../sparkx-query-entity-metadata/SKILL.md) |
| Keyword creation/change history and recent campaign/ad-group changes | `get_operation_log` | [sparkx-query-operation-log](../sparkx-query-operation-log/SKILL.md) |
| Adding negatives / exact keywords, pausing a keyword | `batch_update_ads` | [sparkx-edit-ads](../sparkx-edit-ads/SKILL.md) |

> **Dependency - install the four skills above alongside this one.** Skills install as
> sibling directories under your agent's skills root (see the
> the installation notes in [README](../README.md)); the `../sparkx-.../` links resolve against it.
> Auth, errors, pagination, date limits and currency rules are in the query skills'
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add sparkxai/sparkxai-mcp/sparkx-search-term-diagnosis@sha256:4b7869b24a5765db

The line at the top of this page pins the label v1.0.4, 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_c3o3ph2th5t2i4p4.svg)](https://markdownregistry.com/a/art_c3o3ph2th5t2i4p4)

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

Versions

The registry has recorded 4 versions of this file, between Oct 13, 2026 and Oct 27, 2026, about one every 5 days.

versioncommittedcommitsizeaudit
v1.0.4 latest2026-10-27 0ba4904 14,396 BA view · diff
v1.0.32026-10-22 223b6df 12,682 BA view · diff
v1.0.22026-10-20 902e7d0 12,672 BA view · diff
v1.0.02026-10-13 4d4d72e 12,672 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (14396 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 prompt-injection phrasing
  • 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

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_c3o3ph2th5t2i4p4
GET https://markdownregistry.com/api/v1/resolve?ref=sparkxai/sparkxai-mcp/sparkx-search-term-diagnosis
GET https://markdownregistry.com/api/v1/blob/4b7869b24a5765db62ad6999e7740504a04c07f706b5b041bb4d4a53c7ce4450

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-ads SKILL.md skill
sparkxai/sparkxai-mcp · skills/sparkx-edit-ads/SKILL.md · Edit live Amazon Sponsored ad entities in bulk through the single tool `batch_update_ads` - campaign daily budget /…
v1.1.7 · audit B · 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

Every file in sparkxai/sparkxai-mcp

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