Capture competitor promotions

Skill ljh1097912305-wq/competitor-promo-agent-kit/skills/capture-competitor-promotions

Portable Agent Skill, CLI, and MCP server for evidence-backed competitor promotion audits.

Install

npx -y skills add ljh1097912305-wq/competitor-promo-agent-kit --skill capture-competitor-promotions

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Capture current promotional actions from competitor official websites, collect evidence screenshots, and create an Excel comparison table with screenshots embedded in each brand row. Use for competitor promotion audits, official-site campaign monitoring, current sale checks, 竞品官网促销截图、官网活动对比、Prime Day 或节日大促监测, and evidence-backed promotion spreadsheets.

SKILL.md

3.8 KB, as published. Nobody here has run it

Capture Competitor Promotions

Create a current, evidence-backed comparison of promotions shown on official brand websites.

Evidence rules

Use official brand-owned websites as evidence. Do not use marketplaces, search snippets, affiliate pages, or news articles as proof of the current website promotion.
Describe the promotion actually visible on the captured page. Do not force a Prime Day, holiday, or campaign association unless the official page explicitly makes it.
Capture one screenshot when it proves the action. Use a second or third only when a separate page or viewport is necessary. Never exceed three screenshots per brand.
Record exact visible claims. Do not infer discount amounts, dates, gifts, promo codes, or shipping terms.
If the captured official pages show no explicit promotion, write No explicit promotion found on captured official pages and preserve the evidence.
Keep each evidence URL and capture timestamp with the brand record.

Workflow

Resolve and verify each official website URL.
Capture the homepage first with capture_promotion_pages.
Inspect the returned screenshot, visible text, final URL, and promotion-link candidates.
If the homepage is sufficient, stop capturing that brand. If needed, capture the most relevant official promotion page. Keep the total at three or fewer.
Convert only verified claims into structured promotion records.
Call build_promotion_report so the screenshots are embedded in the corresponding brand row.
Return the workbook and the capture manifest. Mention capture errors or unavailable sites explicitly.

Tool use

`capture_promotion_pages`

Pass exact official URLs and at most three page specifications per brand. Prefer a normal viewport screenshot. Use selector only when a stable element clearly contains the complete promotion.

The tool returns:

screenshot artifacts;
requested and final URLs;
page title and capture time;
normalized visible page text;
promotion-link candidates;
a JSON capture manifest.

Treat promotion-link candidates as navigation hints, not as verified promotion claims.

`build_promotion_report`

Create one record per brand with:

brand
officialUrl
promotionName
mechanisms
discounts
gifts
priceExamples
promotionPeriod
promoCode
shipping
evidenceScreenshots
evidencePages
capturedAt
notes

Use screenshot paths returned by the capture tool. The workbook must keep screenshots in the matching brand row.

`read_promotion_artifact`

Use this when a remote MCP client needs the generated JSON, screenshot, or workbook returned as an embedded resource instead of a server-local path.

CLI fallback

When MCP is unavailable but shell execution is available:

promo-audit capture --input capture.json --output ./data/capture
promo-audit report --input report.json --output ./data/comparison.xlsx

Read the manifest contract before constructing report records manually.

Quality check

Before delivery, verify:

every brand has an official URL;
every claim is supported by captured page content;
each brand has one screenshot when possible and no more than three;
screenshots appear in the correct Excel row;
evidence URLs and timestamps are retained;
missing or blocked evidence is labeled rather than guessed.