# Send Ecommerce Price Watcher to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "ecommerce-price-watcher",
    "name": "Ecommerce Price Watcher",
    "source": "tencent",
    "type": "skill",
    "category": "数据分析",
    "sourceUrl": "https://clawhub.ai/pbalajiips/ecommerce-price-watcher",
    "canonicalUrl": "https://clawhub.ai/pbalajiips/ecommerce-price-watcher",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/ecommerce-price-watcher",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ecommerce-price-watcher",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/price_watch.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/ecommerce-price-watcher"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/ecommerce-price-watcher",
    "downloadUrl": "https://openagent3.xyz/downloads/ecommerce-price-watcher",
    "agentUrl": "https://openagent3.xyz/skills/ecommerce-price-watcher/agent",
    "manifestUrl": "https://openagent3.xyz/skills/ecommerce-price-watcher/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/ecommerce-price-watcher/agent.md"
  }
}
```
## Documentation

### Ecommerce Price Watcher

Monitor product URLs, keep price history, detect offers, and output alert-ready JSON.

### Quick start

Use scripts/price_watch.py.

# URL mode
python3 skills/ecommerce-price-watcher/scripts/price_watch.py add \\
  --url "https://example.com/product" \\
  --target-price 399990 \\
  --currency CLP

# Item mode (discover URLs from query)
python3 skills/ecommerce-price-watcher/scripts/price_watch.py add-item \\
  --query "iPhone 13 128GB Chile" \\
  --target-price 349990 \\
  --currency CLP \\
  --trusted-only \\
  --max-results 5

python3 skills/ecommerce-price-watcher/scripts/price_watch.py check --all

### Commands

add: add a single product URL
add-item: discover product URLs from an item query, then add watches
list: list watched products
check --id <id>: check one product now
check --all: check all products now
remove --id <id>: delete watcher
history --id <id>: print full price history

### Alert behavior

A check produces alerts when at least one condition matches:

price_drop: current price < previous price
target_hit: current price <= target price

Alert payload includes:

product id
title
old/new price
drop percent (when available)
URL
timestamp

### Item-query mode details

add-item uses a lightweight search discovery flow to find candidate product links.

--trusted-only restricts discovered URLs to a curated trusted domain list.
--max-results controls how many links are added.
Duplicate URLs are skipped safely.

This gives users natural language entry ("track iPhone 13 128GB") instead of forcing direct URLs.

### Parsing strategy

Use a layered parser:

JSON-LD offers.price
Open Graph/meta price fields
Generic HTML regex fallback

When multiple prices are found, choose the lowest positive value as the current offer candidate.

### Security standards

Accept only http/https URLs.
Enforce request timeout.
Enforce response body size cap.
Do not execute remote JavaScript.
Store no API keys/tokens in watcher data.
Treat all page content as untrusted.
Return structured JSON for safe downstream automation.

### Limits and operational notes

Some stores block bot-like requests (403). This is expected on certain sites.
Price extraction is best-effort and may need store-specific adapters over time.
For production alerting, run check --all on schedule and forward only non-empty alerts.

### Suggested scheduled usage

Run every 30–120 minutes via cron, then send each alert to Telegram/WhatsApp/Discord.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: pbalajiips
- Version: 1.1.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-23T16:43:11.935Z
- Expires at: 2026-04-30T16:43:11.935Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/ecommerce-price-watcher)
- [Send to Agent page](https://openagent3.xyz/skills/ecommerce-price-watcher/agent)
- [JSON manifest](https://openagent3.xyz/skills/ecommerce-price-watcher/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/ecommerce-price-watcher/agent.md)
- [Download page](https://openagent3.xyz/downloads/ecommerce-price-watcher)